プラグイン使用方法/includex のバックアップ(No.1)

必須
ページ名
とりこむページ名

オプション
option=bool なオプションは共通して、 option, option=true, option=on でそのオプションが有効になり、option=false, option=off で無効になります。
num=数字
表示件数指定。正数は前からＮ件目、負数は後ろからＮ件目の意味。

num=1:10 で先頭１件目から１０件目までの意味。num=-10:-1 で後ろ１０件目から後ろ１件目までの意味。num=2: で先頭２件目から最後までの意味。

num=5+2 で先頭５件目から、そこから２件先まで(5,6,7)の意味。

filter=正規表現
各行を正規表現で限定する。Wikiソースに対する grep 的なもの。全文検索。

ヒント： eregで判定を行います。

except=正規表現
除外全文検索。Wikiソースに対する grep -v 的なもの。

ヒント： eregで判定を行います。
except=Test|sample → Test または sample を含む行を除く。

ヒント：例えばページの１部だけを取り込んでいるのに #contents によるリストが表示されて邪魔だと思ったときに except=^#contents として消去したりします。

titlestr=name|off|basename|relname|title
ページタイトル（<h1>ページ名</h1>）の表示形式。デフォルトは off。

name: include プラグインと同じくページ名を使用する。

off: ページタイトルを表示しない。

basename: ページ名の basename, つまり仮想階層を使用している場合のファイル名に相当する部分。

relname: 現在ページからの相対的ページ名。例：現在ページ PukiWiki かつ include 先が Plugin/Hoge/includex.inc.php → Hoge/includex.inc.php

title: TITLE: 行があればその文字を、なければ name を表示。

備考：TITLE: の取得には ../contentsxのコードを再利用します。インストールしておいてください（なければ常に name になります）。TITLE: とは Pukiwiki Plus! において HTML のタイトルを設定する書式です。本家の場合、default.ini.php の $line_rules で "^(TITLE):(.*)$" => "", と設定し、TITLE: 行を表示しないようにすればよいでしょう。おそらく。

titlelink=bool
ページタイトル（<h1>ページ名</h1>）でリンクを貼るか否か。

ヒント: pukiwiki.ini.php で $fixed_heading_edited を 1 に設定しておくと、ページタイトルの脇に編集リンク用の編集アイコンも表示されます。$fixed_heading_edited は pukiwiki plus におけるパラグラフ編集機能を利用する際の、それぞれの見出しの脇に編集アイコンを表示するか否かの設定です。

permalink=リンク文字列
include した後にそのページへのリンク、 Permalink を表示する。ブログ的に。

section=(num=数字,depth=数字,filter=正規表現,except=正規表現,cache=on|off|reset)
取り込むセクションを見出しに対する制限で限定。

備考：内部で ../contentsxを使用します。contentsx のキャッシュから見出し行番号を取得したりしています。
オプションの効用は上の同名オプションから察しが付くと思いますが、より詳しくは ../contentsxを参照してください。

ヒント：num=0 は先頭から第一見出しまでの部位を意味します。同じ意味になりそうな depth=0 は定義していません。

Obsolete
title=on|off|nolink|basename (titlestr, titlelink に移行してください)
ページタイトル（<h1>ページ名</h1>）の表示形式。デフォルトは on。on の場合はページタイトルを参照リンク付きで表示する。off の場合はページタイトルを表示しない。nolink の場合はページタイトルをリンクなしで表示する。basename の場合はページ名の basename, つまり仮想階層を使用している場合のファイル名に相当する部分を用いてページタイトルを表示する。

アルファ機能
head=bool
head=off で取り込む文章の第一行が見出しの場合消去。head は最初(head) の headline の意。ページタイトル h1 のすぐ次に見出しが来る、かつそのときの見た目が気になるような時に使用する。

Edit