Pagelistプラグイン

まず、番号なしリストを手作業で作成。そのリストをpagelistプラグインに通すと、

  • ページの作成日・更新日・コメント数などを自動的に表示出来る
  • リストをテーブルに変換出来る

なお、BlogプラグインDiscussionプラグインEditorプラグインTagプラグインTaskDirプラグインを使うには、Pagelistプラグインのインストールが必須。

文法

<pagelist>
  * [[pagename]]
  * [[ns1:pagename2]]
</pagelist>

フラグ

<pagelist&header&comments>
…
</pagelist>

のように、フラグを「&」でつないでpagelist部分に書く。

フラグ 標準設定 選択肢
style - 横線のみのテーブル table または list DokuWiki標準のテーブルかリスト
showheader noheader Pagelistが生成するテーブルの項目名を表示しない header 項目名を表示する
showdate date 作成日か最終更新日を表示 nodate 日付を隠す
showuser user 作成者か編集者を表示 nouser 隠す
showdesc nodesc 概要を表示しない desc メタデータから概要を引き出して表示
showcomments nocomments コメント数を表示しない comments Discussionプラグインがインストールされてたらコメント数を表示
showtags notags タグを表示しない tags Tagプラグインがインストールされてたらタグを表示
showfirsthl firsthl 第一見出しを表示 nofirsthl ページ名を表示

なお、サイト設定画面でもいろいろ設定出来る。

既知の問題

問題というより仕様だけど、横幅を指定するフラグがないため、sidebarプラグインを使う場合などにややデザインの乱れが起こる事があります。また、

  1. 手書きで書いたページリストや、他のプラグインから渡されたページリストを元にして
  2. 各ページの作成日や編集者名などを引き出し
  3. テーブルやリスト形式で表示する

という動作なので、このプラグインだけでは、リストの自動収集・並べ替え・条件に合うリストだけ表示、といった事は出来ません。

このプラグインの機能を利用する他のプラグインは、

  1. 自らの能力で、ページの自動収集や並べ替えなどを行う
  2. Pagelistの機能を借りて、各ページの細かいデータを補う

という動作をするものが多いです(BlogプラグインとかEditorプラグインとか)。

 
dokuwiki/plugin/pagelist.txt · 最終更新: 2009/04/30 02:37 by admin
 
特に明示されていない限り、本Wikiの内容は次のライセンスに従います:CC Attribution-Noncommercial-Share Alike 3.0 Unported
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki