Catlist プラグイン
互換性のある DokuWiki バージョン
Angua, Adora Belle, Weatherwax, Binky, Ponder Stibbons, Hrun
ページと名前空間の再帰的な一覧
この拡張は二年以上更新されていません。もはや維持管理や対応がされておらず、互換性に問題がある可能性があります。
この拡張機能は 'plugin' または 'template' 名前空間にないため、無視されます。
類似 addnewpage, dir, dirlisting, nspages, nstoc, pageindex, pagelist, pagequery, pglist, subpages
概要
このプラグインは、様々な形式（一覧、行…）で再帰的にページと名前空間を一覧表示します。 ページや名前空間や正規表現の内容を除外することもできます。 見出しをカスタマイズするオプションもあります。 権限があれば、名前空間にある「ページ追加」ボタンで簡単にページ作成できます。
スクリーンショット
構文
凡例：[必須項目], (任意項目)
<catlist (namespace:) -option1 -option2...>
namespace が指定されない場合、今いるページの名前空間を使用します。
オプション：
| 表示オプション | |
|---|---|
[Default] -displayList | <ul> と <li> で表示する。上記のスクリーンショットの最初のような表示です。 |
-displayLine | ページと名前空間を一行で表示する。名前空間内の内容は [ と ] で囲む。警告 表示バグがあります。 |
-noNSInBold | 名前空間と太字見出し（<strong>）を表示しない。 |
| Force links options | |
-forceLinks | スタートページがなくても、名前空間リンクを強制的に表示する。 |
| 除外オプション | |
-exclupage(:“regex”) | 正規表現 があった場合、一致したページを除外。それ以外は全てのページを除外。 |
-excluns(:“regex”) | 正規表現 があった場合、一致した名前空間を除外。それ以外は全ての名前空間を除外。 |
-exclunsall(:“regex”) | 正規表現 があった場合、一致したサブ名前空間の内容を除外。それ以外は全てのサブ名前空間の内容を非表示。 |
-exclunspages(:“regex”) | 正規表現 があった場合、一致したサブ名前空間のページを除外。それ以外は全てのサブ名前空間のページを除外。 |
-exclunsns(:“regex”) | 正規表現 があった場合、一致したサブ名前空間のサブ名前空間を除外。それ以外は全てのサブ名前空間のサブ名前空間を除外。 |
注： 正規表現に区切り文字を追加しないでください。区切り文字は / です。 |
|
-excludeOnID | ID に基づいて除外 (namespace:subnamespace:page) |
-excludeOnName | 名前空間を除いた名前に基づいて除外 (page) |
-excludeOnTitle | ページの最初の見出しに基づいて除外 (The Page) |
-maxDepth:depth | depth 以上再帰しない。 |
| 見出しオプション | |
-noHead | 見出しを表示しない。 |
-smallHead | Display headline into a simple <span>, not into a title |
-noLinkStartHead | 名前空間一覧にスタートページへのリンクを表示しない。 |
[Default -h1] -h[1-5] | 指定されたレベルのタイトルを見出しとして表示する。 |
-titleHead:“Title” | 名前空間一覧のスタートページタイトルを指定された Title に置き換える。 |
| ページ追加ボタンオプション | |
-noAddPageButton | 表示された名前空間に「ページ追加」ボタンを表示しない。 |
-addPageButtonEach | サブ名前空間毎に「ページ追加」ボタンを表示する（ページの作成権限がある場合） |
| ソートオプション （デフォルトはファイルシステムのソート順） | |
-sortAscending | 昇順でソート（アルファベット順） |
-sortDescending | 降順でソート（アルファベット順） |
ヒント
名前空間（mynamespace）の mypage1 と mypage2 以外の全ページを除外したい。
サブ名前空間のページは除外したくない。
これは正規表現では少し難しいが、あれこれ単純化した結果、これがその解決策です：
<catlist blocs: -excluPage:"mynamespace:[^:]*(?<!mypage1|mypage2)$">
小さな CSS コードの -columns: オプションで列のスタイル設定が可能です：
<html>
<style>
.catlist_columns {
-webkit-column-rule: 1px solid #BBB;
-moz-column-rule: 1px solid #BBB;
column-rule: 1px solid #BBB;
}
</style>
</html>
インストール
プラグイン管理と最新バージョンを示す上記ダウンロード URL を使用して、プラグインをインストールします。 手動でインストールする方法は、プラグインを参照してください。
これらのリンクからもインストールできます。
開発
Development を参照して下さい。
議論
Discussion を参照して下さい。