自作プラグイン/plist

カテゴリ：プラグイン 自作 追加 未公開

指定したページの一覧をテンプレートに沿って作成するプラグイン

タグもしくは親ページを指定し、対象のページ一覧をテンプレートに沿った形で作成するプラグイン。

一覧の表示形式はテーブルかフレックスボックスかで選択できる。また、テンプレートはプラグインの引数として直接設定できるほか、あらかじめ用意した別ページにあるテンプレートを読み込むいこともできる。

テンプレートを作成する際、各ページのインフォボックスやセクション、テーブルのセルや画像を抽出することができる。

ダウンロード

プラグイン設定

使用方法

#plist(<タグ指定or親ページ指定>[,オプション]){{{{
[テンプレート]
}}}}

テンプレートを直接設定する場合はマルチライン部分を使用する。なお、テンプレート内で三重の波括弧を使用するため、マルチライン部分の波括弧は四重以上にする必要がある。

オプション

style =

一覧の表示形式。table、flex、plainから選択可能。デフォルトはtable。

tag =

一覧表示するページをタグで指定する。'|'で区切って複数指定も可能。指定方法はtaglistプラグイン等と同じ。例：tag = プラグイン^自作|プラグイン^追加

root =

一覧表示するページの親ページを指定する。'|'で区切って複数指定も可能。例：root = 自作プラグイン

regexp =

一覧表示するページを正規表現で指定する。例：regexp = ^:config/

except =

一覧表示から除外するページを指定する。正規表現を使用。例：except = ^コメント/

separator=

plain専用。各要素の区切り。デフォルトは\n (改行)。

item-width =

flex専用。各アイテムの幅を指定する。指定方法はflexプラグインと同じ。例：item-width = 200

justify-content =

flex専用。各アイテムの整列方法を指定する。指定方法はflexプラグインと同じ。例：justify-content = center

search

flex専用、各要素内のページ名を検索できる検索バーを設置する。

class =

追加のクラスを指定する。

template =

読み込むテンプレートを指定する。例えばtemplate = hogeと指定した場合、:config/plugin/plist/hogeの内容がテンプレートとして読み込まれる。テンプレートは使用方法で示したようにマルチライン部分で直接設定することもできる。

テンプレートの設定方法

テンプレートの設定方法はinfoboxプラグインやinctmpプラグインに近い。三重の波括弧でキーを囲い、その部分が表示時に各ページの指定した内容に置き換えられる。

キーは抽出したい内容によってinfobox、section、cell、imageなどが使用でき、キーの後ろに「:」で区切ってオプションを記述できる。また、その他にも「_page」「_pagelink」「_base」「_baselink」といったキーを指定し、ページ名やベースネーム、それらのリンクに置き換えることもできる。

table形式の場合はヘッダーや列の設定を含め、テンプレートとなる行を書く。flex形式の場合は各アイテムのテンプレートを書く。

例：table形式の場合

|~プラグイン名|~バージョン|h
|CENTER:|CENTER:|c
|{{{_pagelink}}}|{{{infobox:ver}}}|

例：flex形式の場合

{{{image:1,nolink,200x}}}
{{{_pagelink}}} 

インフォボックス

各ページのインフォボックスの内容を抽出する。記述方法は{{{infobox:<オプション>}}}。オプション部分はinc_infoboxプラグインのオプション指定と同じ。

例：{{{infobox:ver,replace=v%s}}}

セクション

各ページの内容を見出し単位で抽出する。記述方法は{{{section:<オプション>}}}。オプション部分はinc_sectionプラグインのオプション指定と同じ。

例：{{{section:ダウンロード,num=2:5}}}

テーブルセル

各ページにある表の内容をセル単位で抽出する。記述方法は{{{cell:<オプション>}}}。オプション部分はgetcellプラグインのオプション指定と同じ。

例：{{{cell:filter=1.0.0,col=3}}}

画像

各ページにあるn番目の画像を抽出する。記述方法は{{{image:<番号>,<オプション>}}}。オプション部分はrefプラグインのオプション指定と同じ。

例：{{{image:1,nolink,200x}}}

使用例

表示

プラグイン名	バージョン	サムネイル
ac	v1.6
attachlist	v1.1
bar	v0.9
box	v3.0.0
calc	v1.0.0
card	v3.3
datatable	v1.0.1
expand	v1.2
fa	v1.4
fig	v1.4
flex	v1.5.0
gallery	v2.8
getcell	v1.1.3
inc_infobox	v1.1.1
inc_section	v1.0.5
inctmp	v1.1.1
infobox	v1.1.0
lyt	v1.0.0
mailform	v1.0
marker	v1.1
math	v1.0.1
newtpl	v1.3.1
note	v0.4
num_format	v1.0.0
plist	v1.1.1
select	v1.3
slider	v1.2.2
slideshow	v0.8
spoiler	v1.0.1
steamapi	v1.1.8
step	v0.6
swiper	v1.1.3
switch	v1.0.1
tab	v2.3.3
tableif	v0.1
tooltip	v0.6
twitter	v1.1
ul	v0.2
youtube	v1.5

ソース

#plist(root=自作プラグイン){{{{
|~プラグイン名|~バージョン|~サムネイル|h
|BOLD:|||c
|{{{_baselink}}}|{{{infobox:ver,replace=v%s}}}|{{{image,1,nolink,100x}}}|
}}}}

追加したい機能

備考

• 1度表示した内容はページごとにキャッシュされるので、2回目以降の表示は高速化する。キャッシュはプレビューで表示するか、Wiki内のいずれかのページが更新される (recentが更新される) と新たに作成される。

コメント