Extension:DynamicPageList3/ja

拡張機能DynamicPageList3はMediaWikiのためのレポートツールで、様々なフォーマットと詳細でカテゴリのメンバーや交差点をリストアップします. 完全なドキュメントは、マニュアルを参照してください.

基本的な選択パラメータのセットで起動すると、DPLは1つまたは複数のカテゴリに分類されたページのリストを表示します. また、著者、名前空間、日付、名前のパターン、テンプレートの使用、他の記事への参照などの要素に基づいて選択されることもある. アウトプットの形は様々で、中には厳選された記事の要素を取り入れたものもあります.

This extension is invoked with the parser function  or parser tag. A Wikimedia-compatible implementation of certain features can be invoked with.

複雑なルックアップは、計算コストのかかるデータベースクエリーになる可能性があります. しかし、デフォルトでは、すべての出力は、ページロードのたびにクエリを再実行する必要性を減らすために、1時間の期間、キャッシュされます. The DPL:Parameters: Other Parameters manual page contains information on parameters that can be used to disable the cache and allow instant updates.


 * マニュアルと完全なドキュメンテーション
 * Documentation at Gamepedia Help Wiki


 * ソース コード


 * GitHubでのバグと機能要求


 * ライセンス条件
 * DynamicPageList3 is released under GNU General Public License, version 2.

設定
These are DPL's configuration settings along with their default values.

これらを変更するには、拡張機能をwikiに含める前に定義されていることを確認します.

The global variable is automatically respected by DPL.

It will prevent the contents of the listed namespaces from appearing in DPL's output.

Functional Richness
DynamicPageList has many features which are unlocked based on the maximum functional richness level.

There are some that can cause high CPU or database load and should be used sparingly.
 * - equivalent to Wikimedia's
 * - 書式設定パラメータを追加
 * - テンプレートとページリンクにパフォーマンスと同等の機能を追加
 * - より高価なページインクルード機能や正規表現クエリを使用可能
 * - は、エキゾチックで潜在的に危険な一括更新と削除の操作を許可します. テスト・開発用のデバッグ・パラメータを含む.

DPLの機能拡張
拡張DPLは、パーサ関数 、またはパーサ拡張タグを使用することで呼び出されます.
 *  See Manual - General Usage and Invocation Syntax and DPL:Parameters: Criteria for Page Selection 

後方互換性
ウィキメディアのDPL拡張と互換性のある機能は、で呼び出すことができます.

Further information can be found on the Compatibility manual page.

使用理念と概要
With the assumption there are some articles written about countries those articles will typically have three things in common:
 * 共通のカテゴリーに属することになる
 * They will have a similar chapter structure, i.e. they will contain paragraphs named 'Religion' or 'History'
 * They will use a template which is used to present highly structured short data items ('Capital', 'Inhabitants', ..) in a nice way (e.g. as a wikitable)

国別のレポート作成
If there was a need to assemble a report of what countries practice a certain religion this could be easily done with the  and   parameters.

DPLを使えば、可能性があります.


 * Generate a list of all those articles (or a random sample)
 * Show metadata of the articles (popularity, date of last update, ..)
 * Show one or more chapters of the articles ('transclude' content)
 * Show parameter values which are passed to the common template
 * Order articles appropriately
 * Present the result in a sortable table (e.g.)
 * Generate multiple column output

Which steps are necessary?
 Find the articles you want to list: 


 * Select by a logical combination (AND,OR,NOT) of categories
 * Specify a range for the number of categories the article must be assigned to
 * Select by a logical combination (AND,OR,NOT) of namespaces
 * Define a pattern which must match the article's name
 * Name a page to which the article must or must not link
 * Name a template which the article must or must not use
 * Name a text pattern which must occur within external links from a page
 * Exclude or include redirections
 * Restrict your search to stable pages or quality pages ("flagged revisions")
 * Use other criteria for selection like author, date of last change etc.
 * Define regular expressions to match the contents of pages you want to include

 Order the result list of articles according to 


 * 記事名
 * 記事のサイズ
 * Date of last change
 * Last user to make an edit

 Define attributes you want to see 


 * 記事名
 * Article namespace
 * 記事のサイズ
 * Date of last change
 * Date of last access
 * Last user to make an edit

 Define contents you want to show 


 * 全文
 * 特定のセクションの内容（見出しで識別されます. ）
 * テキスト部分（記事中の特殊なマーカータグで定義されているもの）
 * テンプレート呼び出しの値
 * カスタムテンプレートを使って出力を表示する

'''出力形式を定義します. '''


 * デフォルト出力のヘッダーとフッターを指定する
 * 順序付きリスト、非順序付きリストを使用する
 * テーブルを使用
 * Format table fields individually by applying templates to their content
 * カテゴリ形式のリストを使用する
 * 記事またはそのセクションの1つ以上へのリンクを追加する
 * 記事またはそのセクションの1つ以上へのリンクを追加する

パフォーマンス
DPL's code execution and database access is typically fast for typical category and article look ups.

しかし、緩いLIKEやREGEXPマッチパラメータを使用したり、大きなデータセットを要求すると、データベースアクセス時間が長くなることがあります.

また、パーサーの時間も考慮する必要があります.

例えば、画像結果のクエリーを表示するテンプレートに入れれば、それぞれにパーサーのメディア変換が行われることになる.

このため、メディア変換1回につき2MBのRAMをすぐに食いつぶしてしまうことがあります.

参考資料
DPLは、ここで説明しきれないほど多くのことができます.

A complete manual is available with full parameter documentation.
 * – まとめと比較.