ls2_1.inc.php

org:自作プラグイン/ls2_1.inc.php のミラーです。

ls2_1.inc.php の開発は停止します。改めて一から書き直した lsx.inc.php? に移行してください。 -- 2006-05-17 (Wed) 01:30:43

ls2 拡張。リストする階層が指定できる (old)

Table of Contents

説明 標準プラグイン ls2 からの変更点(初版) その後の追加機能 書式 パラメータ ダウンロード 使用例 初版機能 その後の追加機能 コメント

説明

ls2 拡張*1。org:自作プラグイン/ls3.inc.php とは違い、 ページ名による階層構造だけでリストする純粋な ls2 の拡張です。 MenuBar に #ls2_1(hogehoge/,depth=1,relative) のようにおいておくと便利です。

標準プラグイン ls2 からの変更点(初版)

• 階層指定可能。
• 階層的リスト表示機能。
• 相対パス的表示機能。
• pukiwiki.ini.php で設定する $non_list の利用。
• include の無限ループを修正。
• link 時に常に include, title オプションが付加されていたが、単純に同時指定したオプションを利用するように変更。 それと同時にリンク名として利用される引数を「オプションと判定されない引数以降のすべての引数」から link=リンク名 と指定するように変更 *2。

その後の追加機能

• 表示件数指定機能
• 除外ページ指定機能
• 更新日時表示機能
• New 表示機能
• 更新日時によるソート機能
• 正規表現によるページのフィルタ機能
• インライン表示機能。

書式

#ls2_1(パターン[,オプション])

&ls2_1(パターン[,オプション]);

インラインプラグイン時は強制的に display=inline となります。link オプションも可能です。

パラメータ

• パターン(最初に指定)

  リストするページ名のパターン。省略するときもカンマが必要。 省略時はカレントページ+"/"が指定されたことになる。 また / を指定した場合はすべてのページにマッチする。 また // を指定した場合は"カレントページ"が指定されたことになる(もろ後付け)。

• title=true|false

  ページ中の見出しもリストする。 title だけでも title=true の意味になる。

• include=true|false

  インクルードしているページもリストする。 include だけでも include=true の意味になる。

• link=リンク表示文字列

  actionプラグインを呼び出すリンクを表示。 link だけの場合は「パターン」の部分を使用したリンク表示文字列が作られる。

• reverse=true|false

  ページの並び順を反転し、降順にする。reverse だけでも reverse=true の意味にる。
  Note: hierarchy,relative コンビとの併用はきっと納得のいかない表示になります(昇順用に設計されたオプションなので)。

• compact=true|false

  リストのレベルを調整する。compact だけでも compact=true の意味になる。
  ファイル中の PLUGIN_LS2_1_LIST_COMPACT で初期値を設定できます。デフォルトでは TRUE です。

• title_compact=true|false

  title オプション用の compact 機能。title_compact だけでも title_compact=true の意味になる。
  ファイル中の PLUGIN_LS2_1_LIST_TITLE_COMPACT で初期値を設定できます。デフォルトでは TRUE です。

• depth=\d*[-+]?\d**3

  階層指定。1 なら 1 階層下のページのみを表示する。 2-4 のような指定も可能 (2,3,4 の意)。2- のように指定すると 2 階層下以下のページ。 2+1 のような指定も可能 (2 とそこから 1 階層下。つまり 2,3 の意)。

• relative=true|false

  相対パス的表示。relative だけでも relative=true の意味になる。
  ファイル中の PLUGIN_LS2_1_RELATIVE で初期値を設定できます。デフォルトでは FALSE です。

• display=hierarchy|flat|inline

  リスト表示形式の指定。hierarchy では見出しのレベルに応じた階層的リスト表示。 flat では見出しのレベルによらず平らに表示。inline では横一列に表示。
  ファイル中の PLUGIN_CONTENTS2_1_DISPLAY で初期値を設定できます。デフォルトは flat です。
  Note1: 下位互換性のため hierarchy, hierarchy=true でも display=hierarchy になるようにしてあります。
  Note2: インライン型プラグインとして使用する場合は強制的に display=inline になります。
  Note3: 以前の動作とあわせるために、あえて見出しには display=flat が利かないようにしてあります。

• inline_before=文字列

  display=inline 時の前につける文字を設定。
  ファイル中の PLUGIN_LS2_1_DISPLAY_INLINE_BEFORE で初期値を設定できます。デフォルトでは '[ ' です。

• inline_delimiter=文字列

  display=inline 時の区切り文字を設定。
  ファイル中の PLUGIN_LS2_1_DISPLAY_INLINE_DELIMITER で初期値を設定できます。デフォルトでは ' | ' です。

• inline_after=文字列

  display=inline 時の後ろにつける文字を設定。
  ファイル中の PLUGIN_LS2_1_DISPLAY_INLINE_AFTER で初期値を設定できます。デフォルトでは ' ]' です。

• non_list=true|false

  pukiwiki.ini.php で定義される $non_list によるリスト排除。non_list だけでも non_list=true の意味になる。
  ファイル中の PLUGIN_LS2_1_NON_LIST で初期値を設定できます。デフォルトでは TRUE です。

• number=-?\d+ *4

  リンク表示件数指定。Blog2プラグインを使用するときに便利らしいです。 number=10 で頭から10件表示します。number=-10 のように - をつけると後ろの10件になります。 それでも逆順にはならないので reverse を使用してください。

• title_number=\d+

  titleの表示件数指定。title_number=10で頭から10件表示します。 現在 - 機能はありません。title_number=1 でページの先頭見出しを表示することになります。 先頭見出しを必ず書く人は多いそうなのでそれを表示するのに便利かもしれません。

• except=正規表現

  リストしないページを正規表現にて指定。$non_list だけでは足りないときに使用。 relative の場合でもページ名全体で判定。
  ヒント： マッチングには ereg を使用します。 except=Test|sample → Test または sample を含むページを除く。

• datesort=true|false

  更新日時順（新しいほど上)に表示。datesort だけでも datesort=true の意味になる。
  Note: hierarchy,relative コンビとの併用はきっと納得のいかない表示になります (hierarchy,relative はページ名の昇順ソート時用のオプションなので)。
  Note2: include されるページに対しては無視なので include オプションと併用しても無駄です。
  Note3: 旧 new オプションです。注意してください。

• date=true|false

  ページの更新日時も表示。date だけでも date=true の意味になる。

• new=true|false

  New!も表示。new だけでも new=true の意味になる。
  New! が表示される条件は標準プラグイン new の条件を使用しています。 new プラグインが存在しない場合は独自設定（といっても new からコピーしたもの）を使用します。

• filter=正規表現

  ページパターンをさらに正規表現で限定する。 パターンを / (全ての意味) にしてこちらだけを使うのもあり。
  ヒント: マッチングには ereg を使用します。

ダウンロード

拡張子の番号をはずして、plugin ディレクトリに放りこんでください。

使用例

初版機能

PLUGIN_LS2_1_LIST_COMPACT = FALSE; と設定されているものとして読んでください。 現在はデフォルトで TRUE です。

以降は test というページで記述したものとする。

---

#ls2_1

とすると以下のように表示されるページ群があったとする。

• test/a
• test/a/aa
• test/a/aa/aaa
• test/a/bb/bbb
• test/c/cc/ccc

---

#ls2_1(,depth=1)

• test/a

---

#ls2_1(,depth=1-2)

• test/a
• test/a/aa

---

#ls2_1(,depth=2+1)

• test/a/aa
• test/a/aa/aaa
• test/a/bb/bbb
• test/c/cc/ccc

---

#ls2_1(,relative)

• a
• a/aa
• a/aa/aaa
• a/bb/bbb
• c/cc/ccc

---

#ls2_1(,display=hierarchy)

• test/a
  • test/a/aa
    • test/a/aa/aaa
    • test/a/bb/bbb
    • test/c/cc/ccc

---

#ls2_1(,display=hierarchy,compact)

上位のページが存在していない場合は詰まる。compact は display=hierarchy 用のオプション。 test/a/bb/bbb, test/c/cc/ccc が詰まっている。

• test/a
  • test/a/aa
    • test/a/aa/aaa
  • test/a/bb/bbb
• test/c/cc/ccc

---

#ls2_1(,relative,display=hierarchy)

compact を併用しない relative,display=hierarchy は少しわかりづらい。test/a/aa/c/cc/ccc かと思ってしまう。

• a
  • aa
    • aaa
    • bb/bbb
    • c/cc/ccc

---

 #ls2_1(,relative,display=hierarchy,compact)

• a
  • aa
    • aaa
  • bb/bbb
• c/cc/ccc

---

include, title, link, reverse に関しては標準プラグイン ls2 と意味合いは同等。 ls2 の compact は ls2_1 の title_compact です。

その後の追加機能

ここでも

#ls2_1

とすると以下のように表示されるページ群があったとする。

• test/a
• test/a/aa
• test/a/aa/aaa
• test/a/bb/bbb
• test/c/cc/ccc

---

#ls2_1(,number=2)

• test/a
• test/a/aa

---

#ls2_1(,number=-2)

• test/a/bb/bbb
• test/c/cc/ccc

---

#ls2_1(,except=cc|/a$)

• test/a/aa
• test/a/aa/aaa
• test/a/bb/bbb

---

#ls2_1(,date)

• test/a 2004-10-10 (日) 23:03:05
• test/a/aa 2004-11-30 (金) 12:11:43
• test/a/aa/aaa 2004-03-03 (月) 16:04:05
• test/a/bb/bbb 2004-12-26 (水) 23:55:55
• test/c/cc/ccc 2004-10-11 (月) 01:02:04

と出力されるとする。

---

#ls2_1(,datesort,date,new)

• test/a/bb/bbb 2004-12-26 (水) 23:55:55 New
• test/a/aa 2004-11-30 (金) 12:11:43
• test/c/cc/ccc 2004-10-11 (月) 01:02:04
• test/a 2004-10-10 (日) 23:03:05
• test/a/aa/aaa 2004-03-03 (月) 16:04:05

---

#ls2_1(,datesort)

• test/a/bb/bbb
• test/a/aa
• test/c/cc/ccc
• test/a
• test/a/aa/aaa

---

#ls2_1(,display=flat)
&ls2_1(,display=flat);

[ test/a | test/a/aa | test/a/aa/aaa | test/a/bb/bbb | test/c/cc/ccc ]

コメント

Please go to ./Note?

---

*1 ls2 v1.23 の拡張です。
*2 ls2_1.inc.php v1.18 からです。それ以前は「オプションと判定されない最初の引数」でした
*3 \d*[-+]?\d* は正規表現による表記です。\d は数字のことです。
*4 -?\d+ は正規表現による表記です。