見栄えの良い表または番号なしリストのページ一覧(前任の作者:Esther Brunner, Gina Häußge, Michael Klier)
Compatible with DokuWiki
rincewind, adora belle, weatherwax, binky, ponder stibbons
This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.
This extension is not in the 'plugin' or 'template' namespace and is therefore ignored.
Similar to catlist, dir, nspages, pglist, subpages
Needed for authorstats, blog, cloud, dir, discussion, pageimage, tag, tagfilter, tagsections, task, tiledblog
ページ一覧プラグインは、wikiページの一覧を引数とし、それらについての情報をきれいにフォーマットした表を提供します。 プラグインには、ページ一覧の情報と形式を制御するための多数のフラグがあります。 ブログ・Discussion・Editor・タグ・Task・Dirプラグインという人気のヘルパープラグインとして、特別なページ参照一覧を提供できます。
内部リンクの番号なしリストを <pagelist>
タグで単純にラップします。
下の例のように、特定の内部のページ参照を提供するかそれらを供給するプラグインを持っています:
<pagelist&[flags]> * [[..:blog:|Blog Plugin]] * [[..:discussion:|Discussion Plugin]] * [[..:editor:|Editor Plugin]] * [[..:tag:|Tag Plugin]] * [[..:wrap|Wrap Plugin|This is shown in the description cell]] </pagelist>
[flags] | フラグはページ一覧の外観を変更するために使用します。フラグを参照。 | 任意項目 |
---|
設定 | デフォルト | 代替 | ||
---|---|---|---|---|
style | default | 水平線付きの表 | table , list or simplelist | 標準の DokuWiki 表、一覧形式 |
showheader | noheader | ページ一覧表の見出し行を隠す | header | 見出し行を表示 |
showdate | date | 作成日・最終更新日を表示 | nodate | 日付を隠す |
showuser | user | 作成者・編集者を表示 | nouser | ユーザーを隠す |
showdesc | nodesc | 説明を隠す | desc | 説明を表示(メタデータから) |
showcomments | nocomments | コメント数を隠す | comments | コメント数を表示(議論プラグインがインストールされている場合) |
showtags | notags | タグを隠す | tags | タグを表示(タグプラグインがインストールされている場合) |
showfirsthl | firsthl | 最初の見出しを表示 | nofirsthl | ページ名を表示 |
rsort/sort | nosort | ページのソートなし | rsort/sort | ページ名の(逆)アルファベット順にページをソート |
<pagelist&header&comments> //表示ページの番号なしリスト// </pagelist>
上記の例では、ページ一覧は、見出し行とコメント数(議論プラグインがインストールされている場合)と共に表に記載されるページの情報を表示します。 ユーザー(またはプラグイン)は一覧に表示するページを指定する必要があります。
プラグインは、管理者メニュー内の設定管理画面を使用して設定できます。 例えばブログプラグインのアーカイブ部品のような、ページ一覧プラグインのヘルパー部品を使用しているプラグインにも、設定内容は適用されます。
style | 一覧形式(デフォルト、リスト、テーブル) |
---|---|
showheader | 表見出しの表示 |
showdate | 日付項目の表示(隠す、作成日、修正日) |
showuser | ユーザー項目の表示(隠す、作成者、編集者) |
showdesc | ページの最初の段落から作った短い説明の表示 (隠す、最大160文字、最大500文字) |
showcomments | コメントの表示(議論プラグインが必要) |
showlinkbacks | リンクバックの表示(リンクバックプラグインが必要) |
showtags | タグの表示(タグプラグインが必要) |
sort | ページ名でソート |
自分のプラグインでページ一覧プラグインの機能を簡単に利用できます。 以下は基本的なコード例です:
$pages = array( array('id' => 'wiki:dokuwiki'), array('id' => 'wiki:syntax'), ); $pagelist =& plugin_load('helper', 'pagelist'); if (!$pagelist) return false; // failed to load plugin $pagelist->startList(); foreach ($pages as $page){ $pagelist->addPage($page); } $renderer->doc .= $pagelist->finishList();
バグや機能要求はバグトラッカーへお願いします。
ここはプラグインに関する一般的な議論のための場所です。 バグや機能要求は、このページにリンクされたバグトラッカーへ提出して下さい。
Discussion を参照してください。