最重要：プラグインが機能するには PHP 5.3 以上が必要です。 手動でプラグインをインストールする方法についてはプラグインを参照して下さい。

NEWS—2013-10-07：編集ツールバーの新規ボタンから new popup syntax “​cheatsheet”。 新規言語：オランダ語。

NEWS—2013-10-06：新規抽出オプション：​links（ページリンク）・​backlinks（ページヘのバックリンク） ​filter=正規表現機能を使用して抽出できるスペース区切りのページIDの一覧です（詳細は下記参照）。

2013-03-27：Weatherwax互換。 グループヘッダーのバグ修正済。

2013-03-08：重要なアップデート

• Adora Belle and PHP 5.4.Adora Belle と PHP 5.4 互換
• display オプション：機能変更。全てのメタデータ／ソート領域をページリンク表示に使用できる。{} 内に領域名を記入する。例：“{name} ({mdate})” は “Page-name (01-Jan-1970)” を生成します。mdate はページの更新日です。
• 新規 layout オプション：table か column を選択
  • table：複数列を作成するのに保守的な HTML のテーブルを使用します。
  • column：代わりに CSS3カラムレイアウトが使用されます。より新しいブラウザが必要ですが、ウィンドウのサイズ変更の際、より良く動作します。
  • いくつかのオプションは判りやすさのために改名しました（下の構文一覧を参照）。
• filter オプションはよりエレガントに日付を処理します。You can filter the list based on dates, before, after, between, using real numeric dates, or even time periods in words (last week, 2 days ago, etc…)
• Many small tweaks, and overall code clean up.

GitHub 上の開発履歴：

• Merge pull request #51 from pacobyte/php7_array_declaration_fix (2018-01-22 10:51)
• Increase compatibility with PHP 7 (2018-01-22 02:37)
• Merge pull request #35 from topical/master (2015-03-19 18:40)
• fix caching (2015-03-19 15:06)
• Update plugin.info.txt (2014-11-18 06:39)
• Merge pull request #33 from sawachan/ja-lang (2014-08-16 09:56)
• Create lang.php (2014-08-04 08:04)
• Merge pull request #32 from gamma/master (2014-07-16 12:06)
• Fix for PHP Strict (2014-07-15 11:55)
• Fix for PHP Strict (2014-07-15 11:55)

PHP5.3 で実行しない場合、旧バージョンを利用できます。オプションはそれほど多くありませんが、それなりに便利です。 このバージョンはこれ以上アップデートされません。

バグや問題を報告は、可能な限り GitHub へお願いします。 できない場合はpagequery 議論やフォーラムへお願いします。 先頭にある指示には従ってください。

プラグイン ページには異なる要望に対応する色々なページ一覧／案内プラグインがあります。 Pagequery は、Wiki ページ一覧に対するまとまったオールインワン方式として、多くの考え方を統一しようとします。名前・タイトル・a-z index、年・月・日、名前空間、作成者。更に迅速です。

表面的には、本当に素晴らしい IndexMenu プラグイン とよく似た役割を果たすように見えるかもしれません。 しかし Pagequery の目的は高尚でも精巧でもありません。 IndexMenuは、名前空間と名前空間内のページを表示するに焦点を合わせています。 多くのオプションで名前空間とファイルのソートし、能動的に目次を案内・操作することが可能です。 Pagequery の目的は、ページ一覧を表示することです。 もちろん、希望すれば名前空間順にソートすることもできます。 しかし、主要な目標はページを検索すること、任意の順序でページ一覧を表示すること、グループ別（A-Z、年、月等）に綺麗に表示するすること、加えて複数列によって空間を最大限に活用することです。 両方を試してみれば、それぞれが「異なったかゆさをかいている」ことがすぐに判ります。

機能

• あらゆるソート順の Wiki の目次を作成：A-Z 順、更新日順、作成日順、作成者順、start pages
• Wiki 内の全ページを検索
• 特定の名前空間に検索範囲を制限
• 全文検索のような、ページ内容の単語による検索
• 正規表現を利用したページ名検索
• A-Z 順、名前順、年順、月順、日順、作成者順、多くの他のオプションによる一覧のソート
• それぞれの上にヘッダーを付けて一覧をグループに分割：A..Z、2010…2009、Jan..Dec、作成者名
• ページ名の代わりにページタイトルに基づくリンク表示
• ページのリンクにマウスを置いた時、便利な内容確認ツールチップを表示
• リンクに続けてページ内容のスッキリした断片を置くことで、素晴らしいブログのようなスタートページを作成
• スペースを最大限に活用：リンク一覧を複数列に表示
• 判りやすくするために、列に枠線を表示

単独で構築したのでは何の価値もありません：pagequery は巨人（つまり Dokuwiki のコア機能）の肩の上に構築されています。 内部では、素晴らしい組込みページとDokuwiki 内で利用できる全文検索機能を慎ましく利用しています。 このため、新たに検索構文を覚える必要はありません。 しかし、強力なソートとグループ化オプションを提供することで混合物に少し新しい何かをもたらします。

可能な用途例：

• 素晴らしい A-Z 索引、又は年／月索引付きの全 Wiki ページ一覧
• 最近変更されたページ一覧
• 特定の主題について議論のあるページ一覧（全文検索経由）
• あるユーザー作成の全ページ一覧

更新日でソートされ、年／月でグループ化された名前空間内の全ページ一覧例は以下のとおりです：

ページ文章内の一覧を表示したい場所に pagequery マークアップを挿入します。 同じページに異なる pagequery 一覧を持つこともできます。 ¹⁾

単純な場合：

{{pagequery>}}

複雑な場合：

{{pagequery>[query];fulltext;sort=key:direction,key2:direction;group;limit=10;cols=2;spelldate;proper}}

超複雑な場合…：

{{pagequery>[query];fulltext;sort=key:direction,key2:direction;group;limit=100;cols=6;spelldate;proper;snippet=5;border=inside;hidestart;case;natsort}}

NEW：判りやすくするために、プログラミング言語のように構文を複数行に展開できます。 空白は単純に無視されます。 例：

{{pagequery>query;
  fulltext;
  sort=key:direction,key2:direction;
  group;
  limit=100;
  cols=6;
  spelldate;
  proper;
  border=inside;
  hidestart;
  case;
  natsort
}}

下の一覧は、とんでもなく長く徹底して威圧的に見えることを知っています。 願わくば、粘り強く使用方法を学び始めた場合、これが可能かあれが可能かをすぐに尋ねるでしょう。 そうして、多くの人々が議論ページに持っているような、自分の特定の要望に pagequery を適応させることができます。 かなり柔軟ですが、これら全てのオプションはどこかで定義する必要があります。 それ故に下の長い一覧になるわけです。

原則として、異なるオプションはセミコロン(;)区切り、値（例：ソート内）はコンマ(,)区切り、複数値はコロン(:)区切りです。

ソートとグループ化を上手く行うにはいくつかの要領があります。 Pagequery には多くのソートオプションがありますが、そのほとんどはグループ化可能な設計になっています。 主なヘッダーで一覧をグループ化するつもりなら、広いカテゴリーから狭いカテゴリー順にソートするのが最も理にかなっています。

例えば：年 ⇒ 月 ⇒ 名前。 ソートアルゴリズムは最初に年順にページ一覧をソートし、それから年毎のページを月順にソートし、最後に月毎のページを名前順にソートします。 全ての名前が一意でもない限り、他の方法でソートするのはあまり意味がありません： その場合はグループ化もないでしょう！

上記のソートをグループ化した場合、以下のような構成になるでしょう：

• 年
  • 月
    • 名前
    • 名前
  • 月２
    • 名前
    • 名前
    • 等々…

基本的なルールは：特定度の低いオプションから開始し、より具体的なオプションに進むです。

新しいページを追加しましたが、私の素敵な pagequery 一覧に表示されません。何故ですか？

• 一覧が含まれているページのキャッシュをオフにする必要があります。ページのどこかに

   ~~NOCACHE~~ 

  を入れてください。瞬時に更新結果が表示されるはずです。

wikiに多くのデフォルトのスタートページを持っているが、名前空間の内容を一覧表示する時、スタートページを含めたくない。どうすれば消すことができますか？

• hidestart オプションを追加します。サイト設定管理のstartオプションが、使用中のスタートページ名に対応していることが前提です！

私はページ名の代わりにページタイトルを表示したい。どうすれば可能ですか？

• pagequeryマークアップのどこかに display=title オプションを入れなさい。

DokuWikiの新しいバージョンにwikiの内容を移行した後、pagequery がどのページにも表示されません。編集したページだけは、pagequery に再現します。任意のページが表示されません。

• SearchIndex プラグイン を使用してインデックスを作り直してください。又は、wiki の内容と同様にインデックスも移行してください。この問題は pagequery 自体とは何の関係もありません。

たとえば、特定の名前空間の全てのページを A-Z 索引で一覧表示したい場合、以下でやり方です：

{{pagequery>@namespace;fulltext;sort=a,name;group}}           [fulltext version]

あるいは：

{{pagequery>@namespace *;sort=a,name;group;proper;cols=2}}    [pagename version: allows regex's]

@namespace から結果を検索します（他の検索条件が存在しないので全てのページを取得します）。 一覧は最初の一文字（'sort=a'）で、次に各文字毎にアルファベット順（'sort=name'）でソートされます。 groupオプションは、最初の一文字だけで一覧をグループ化します（それぞれがユニークになるように名前でグループ化することはできません）。

３列で結果を表示し、“文書例”に下線なしでリンクする場合：

{{pagequery>@namespace *;sort=a,name;group;cols=3;proper}}

別の例として、作成年、作成月、でグループ化し、ページ名でソートし、２列表示し、実際の月名を表示し、更に“文書例”に下線なしでリンクし、テーブル列の周りに線を描く場合：

{{pagequery>@namespace *;sort=cyear,cmonth,name;group;spelldate;proper;cols=2;border}}

同じ条件ですが、ページ内で “help” という単語がを捜す（注：fulltext は“ページ名”ではなく”ページ内容“から探すことを意味します）：

{{pagequery>@namespace help;fulltext;sort=cyear,cmonth,name;group;spelldate;proper;cols=2}}

更新： ページ名（ページID）で検索する場合のみ、名前空間に対応しています。 全文検索と同じ構文を使用します。例；@namespace|^namespace。 相対名前空間にはまだ対応していません。 加えて、ページ名で検索する場合、正規表現を使用できます。

例：”drafts“　名前空間内の全ページを検索し、数字で始まるファイルを一覧化し、ページ名でソートする：

{{pagequery>@drafts [0-9]+.*;sort=name}}

又は、”happy:go:lucky“名前空間にある全ファイルを年、作成日でソートし、 適切な場合には、２列で表示、一覧のページ名ではなくページタイトルを表示する。

{{pagequery>@happy:go:lucky *;sort=cyear,cdate;group;proper;display={title};cols=2}}

うまくいけば、これらの例は、pagequeryの仕組みを理解するのに役立ちます。

pagequery 議論ページを参照してください。