Extension:CategoryTree/ja

CategoryTree拡張機能はウィキのカテゴリ構造の動的なビューをツリーとして提供します. これは必要に応じてツリーの一部をロードするためにAJAXを使います. CategoryTreeは外部ツールとしてもともとはDaniel Kinzlerによって開発されました(meta:User:Duesentrieb/CategoryTreeを参照). のちにこれはTim Starlingの助けによってMediaWikiソフトウェアに統合されました.

使用法
CategoryTreeは3つの方法で使用できます:
 * カテゴリページ内で直接使用する
 * ウィキページでインラインのカテゴリ構造を表示する"カスタムタグ"(または"パーサー関数")
 * 特別ページとして追加する

CategoryTree拡張機能はカテゴリページに一覧が表示される下位カテゴリに ► "expand" ウィジェットを追加します.

&lt;categorytree&gt; タグ
例. 実行結果は下のボックスと右にあります:

カスタムタグは &lt;categorytree&gt; と呼ばれます. たとえば、ウィキページに &lt;categorytree&gt;Foo&lt;/categorytree&gt; を記載すると、そのページでFooカテゴリの内容が動的なツリーとして表示されます (右の例を参照). HTMLライクな構文を使って、タグは次の属性を受け入れます:


 * mode: ツリーに表示されるページを決定します. これは  オプションを使用することでオーバーライドできます. 許可される値は次の通りです:
 * categories: 下位カテゴリだけ表示する(構成定数の )
 * pages: 画像以外の下位カテゴリとページを表示する(構成定数の )、ページ数の上限は200件
 * all: すべてのページ、下位カテゴリ、画像などを表示する(構成定数の )
 * parents: 下位カテゴリの代わりに親カテゴリの一覧を表示する (構成定数の ). これはCategoryTreeに"inverse"オペレーションをさせます(2008年7月の  以降でサポートされます).


 * depth: 最初に表示されるツリーのレベルを決めます. 既定値は1で、0はルートノードのみを意味します. 最大値は指定されるモード、と  オプションに依存します(2007年5月30日の  と  の間に導入されました; 2008年6月の  以降の   でも、十分な機能があります)
 * onlyroot : 初期の状態でツリーの"root"ノードのみを表示するようにするには これを "on" に設定します.  と同等です. (2007年3月13日の  で導入されました) 2008年7月の  で廃止予定になりました: 代わりに   を使用してください.
 * hideroot: ツリーの"root"ノードを隠すにはこれを "on"、すなわち  にセットします. この例ではカテゴリのFooは表示されません.
 * hideprefix: ツリーのエントリから隠される名前空間の接頭辞を決定します(2008年7月の 以降). 可能な値は次の通りです:
 * always: 常に接頭辞を隠します. すべてのページが同じ名前空間に属する場合に使います (構成定数の ).
 * never: カテゴリに対してでも、名前空間の接頭辞を決して隠さない(構成定数の ).
 * auto: カテゴリの名前空間を隠します. カテゴリのみが表示される場合、 と同じです(構成定数の  ). これは古い既定の挙動と同等です(2008年6月以前).
 * categories: カテゴリの名前空間を隠しますが、他のすべての接頭辞を表示します(構成定数の ). これは新しい既定の挙動です(2008年7月の  以降).


 * showcount: 下位カテゴリの数を表示するにはこれを "on"、すなわち  に設定します(2008年7月の  以降). これはページのインラインのカテゴリツリーに対しては既定で無効ですが、カテゴリ一覧および Special:CategoryTree では既定で有効になります.
 * namespaces: a list of namespaces from which pages should be shown in the tree (since, July 2008). The entries in the list must be namespace names, separated by spaces. The main namespace can be represented by "-" or "0". Subcategories will be shown only if Category namespace is present on the list.
 * class, style、id、etc: &lt;categorytree&gt; タグはブロック要素用の標準のすべてのHTML属性をサポートします(2008年7月の  以降で、それ以前は   のみがサポートされました).

Notes on the 'namespaces' parameter
Category is a namespace. Categories are shown in all modes by default, but specifying the  parameter hides them just like any other namespace not present on the list. If you want to list pages in a given namespace, including pages in subcategories, simply add Category to the namespace list.

例:


 * Listing main namespace pages in Category:Manual:


 * Listing main namespace pages and subcategories in Category:Manual:

The  parameter is overridden by  :
 * if only Category namespace is asked, it's equivalent to ;
 * if file namespace is present on the list, it will imply ;
 * otherwise  will be used. It means that if the site configuration hasn't been changed, the following are equivalent (the first two are always equivalent, the third only if   is the default  ):

パーサー関数
(2007-9-13)以降、ページのカテゴリツリーを置くのにパーサー関数の構文を使用することもできます. これは、例えば  などの異なる構文を使った &lt;categorytree&gt; タグのように機能します. オプションは名前付きのテンプレート名、例えば  の構文を使って指定できます.

パーサー関数の構文を使用することには カテゴリを指定する際にマジックワード、テンプレートとテンプレートパラメーターが使える利点があります. いくつかの例です:


 * "this pages"カテゴリツリーを表示するにはマジック変数を使う(カテゴリ説明ページに役立ちます):.
 * カテゴリを指定するにはテンプレートを使う:  - ルートカテゴリの名前は Template:Root_category の内容によって定義されます.
 * テンプレート内部でCategoryTreeを使うとき、カテゴリを指定するにはテンプレートパラメーターを使います: Template:Baz では  を使って呼び出すことができます.

Special:CategoryTreeページ
特別ページはSpecial:CategoryTreeと呼ばれます. カテゴリの名前を入力しブラウザーでコンテンツにアクセスします.

設定
ファイルで指定できるオプションがいくつかあります:


 * $wgCategoryTreeMaxChildren: ツリーノードに表示できる子の最大数です. 既定値は200です.
 * $wgCategoryTreeAllowTag: &lt;categorytree&gt; タグを有効にします. 既定値はtrueです.
 * $wgCategoryTreeDynamicTag: &lt;categorytree&gt; でツリーの最初のレベルのツリーを動的に読み込みます. この方法では、キャッシュを無効にする必要はありません. 既定値はfalseです.
 * $wgCategoryTreeDisableCache: disables the parser cache for pages with a &lt;categorytree&gt; tag, or provides max cache time in seconds. Default is 21600 which is 6 hours.
 * $wgCategoryTreeUseCache: 匿名利用者のHTTPキャッシュを有効にします. 既定値はfalseです.
 * $wgCategoryTreeOmitNamespace : ページとカテゴリで名前空間を表示しない. 既定値はfalseで、カテゴリのみを表示しない限り名前空間が表示されます. 2008年7月の で廃止予定になったため代わりに   を使用してください
 * $wgCategoryTreeMaxDepth: &lt;category&gt; タグで深さのパラメーターを使用して初期に展開されるそれぞれのmodeの最大の深さを決める配列です. 既定では、これは"categories"モードで2に、他のモードでは1に設定されます. 例えばcategoriesには3、他のモードには2に設定するには、 を使用できます.
 * $wgCategoryTreeDefaultMode: &lt;categorytree&gt; タグでmode属性が設定されていないときの既定のモード. 可能な値は  (既定値)、 、  のいずれかです.
 * $wgCategoryTreeCategoryPageMode : カテゴリページでツリーをレンダリングするときに使用するモード. 2008年7月の に廃止予定になりました. 代わりに   を使用します.
 * $wgCategoryTreeForceHeaders: trueの場合、必要に応じてではなく、すべてのページでCategoryTreeが必要なスクリプトを強制します. CategoryTreeが通常の方法で例えばカスタム外装またはシステムメッセージに埋め込まれるときに必要な場合があります(2008年7月の 以降).
 * $wgCategoryTreeSidebarRoot: カテゴリツリーをサイドバーに統合するために使用するルートカテゴリ(2008年7月の 以降). 設定されていない場合、ツリーは統合されません(これは既定値). サイドバーへのCategoryTreeの統合はSkinTemplateにもとづく外装のみ機能します. すなわち、Modern、Monobook、Chick、Simple、MySkinは機能しますが、Standard、Nostalgia、CologneBlueは機能しません.
 * $wgCategoryTreeDefaultOptions: 既定のオプションは配列として適用します(2008年7月の 以降). 利用可能なオプションは上記の通りです. 例:
 * $wgCategoryTreeCategoryPageOptions: カテゴリページで配列として使用するオプション(2008年7月の 以降).
 * $wgCategoryTreeSpecialPageOptions: Special:CategoryTreeで配列として使用するオプション(2008年7月の 以降)
 * $wgCategoryTreeSidebarOptions: サイドバーでツリーを表示するときに配列として使用するオプション(2008年7月の 以降)

categorytree-member-num
By default, when listing subcategories on a category page, each subcategory is followed by an integer, indicating how many subcategories lie beneath it, how many pages it contains, and how many files are in the category (if applicable):


 * My category name (5 C, 2 P, 1 F)

システムメッセージの MediaWiki:Categorytree-member-num をオーバーライドすることでこのふるまいを変更できます. これは5つのパラメーターをとります:

既定値は  です.

ヒント: 異なる部分を条件ごとに表示するif/then/elseロジックを提供するには 拡張機能を使用します. 例:

すべての情報を出力するときにカンマと空白を管理する設定:

省略版: 

完全名版: 

Wiki is broken after installing CategoryTree

 * Turn on
 * Make sure you have all files installed
 * Make sure all of the CategoryTree extension files have mode 644, and the CategoryTree directory has mode 755.

Options in LocalSettings.php have no effect

 * Make sure you specify the options after including the extension.

Clicking the ► has no effect, gives a JavaScript error or just sits on loading

 * Note that using the &lt;categorytree&gt; tag in system messages (MediaWiki namespace) may not work as expected - this is a known caveat. For a workaround, see Using CategoryTree in the Sidebar below.
 * Make sure you have  in your LocalSettings.php before including the extension.
 * Make sure you are using the latest version of the extension - the bleeding edge is at
 * If you are using rewrite rules or aliasing (e.g. to have "very short URLs" - i.e. wiki pages in the document root or perhaps redirecting to a www-version of the requested URL), make sure you have an exception in place for the /extensions directory, just like you would for the /skins directory. Also see below.

Clicking the ► shows no sub-categories error

 * Try to fix this by adding this code to LocalSettings.php:

Browser reports a bad MIME type for CategoryTree.js and/or CategoryTree.css

 * Make sure your web server uses the correct MIME types for .js and .css files
 * Enter the URLs directly into the browser and see if it is serving the pages at all, and not some error page; especially:
 * If you are using rewrite rules or aliasing (e.g. to have "very short URLs" - i.e. wiki pages in the document root), make sure you have an exception in place for the /extensions directory, just like you would for the /skins directory.

Member counts are wrong, grey arrows ► are shown instead of ►
Since MediaWiki 1.13, CategoryTree can show the number of members of a category, and can show a grey arrow ► for tree nodes that do not have any children based on that number. This information is based on the new. However, populating that table with the current values does not always work when upgrading to 1.13. In that case, run the  maintenance script, if necessary with the   option.

► ► ▼ toggles shown only on the first level of the category tree view
In case you get only one level depth while visualing the tree, try to set in modules/ext.categoryTree.styles.css file  to.

The JavaScript intended to switch the tag style is somehow buggy.

Note to bot users
Bots and scripts that parse the HTML of category pages can use the notree URL parameter to force the traditional output. However, HTML output is generally not stable, so it is recommended to change your script to use the to fetch category listings and similar.

"Category Not Found" message
After you implement the CategoryTree plugin and add the code to show the tree, if you see a message that says Category Not Found, you need to add some content in your category pages. The category pages can't be red pages, basically. Click your category names, add some text in the category page, and then your tree should work fine.

Next 200 links do not work with CategoryTree installed
Make sure the right version of this extension is installed, relative to the version of MediaWiki you have installed. In particular, versions of this extension made for versions of MediaWiki prior to 1.17 are not compatible with MediaWiki 1.17 and greater, and will cause issues where all the paging links on category pages are broken.

No pages are shown when using the "namespaces" parameter
See above.

Using CategoryTree in system messages and custom skins
To use the CategoryTree in system messages or the sidebar, that is, to use it as part of the user interface instead of page content, you have to set  to , so that the support scripts are linked on every page (normally, they are only linked "on demand", but that detection does not work for system messages). This works since (July 2008). If you try this without forcing the scripts to be included, you will find that Clicking the ► has no effect, gives a JavaScript error or just sits on loading.

In older versions of CategoryTree, you have to modify the code to make this work: find the  function in the file CategoryTree.php, and remove the condition; i.e. it should then look like this:

Using JavaScript
Since (July 2008) with MediaWiki 1.13, you can integrate a CategoryTree in the sidebar simply by setting   to the category you want to use as a root. This only works with skins based upon SkinTemplate however, that is, Modern, Monobook, Chick, Simple, and MySkin, but not Standard, Nostalgia or CologneBlue.

If you use  in LocalSettings.php to drop your own wikitext article into the Sidebar, and then add CategoryTree items to it, you'll need to set   to ensure that every page works.

If you want the CategoryTree on a different position in the sidebar, you can reference it on MediaWiki:Sidebar as "categorytree-portlet".

For earlier versions of CategoryTree and/or MediaWiki, you'll need to install a mod to MonoBook.php to enable normal wikitext in the sidebar, see --DJ 19:26, 24 January 2008 (UTC)

To append a link "CategoryTree" to your toolbox add following code to the JavaScript page (e.g. monobook.js) of your  and customize the URL "w:en:Special:CategoryTree".

A more generic version of this code can be found at.

Step by step if works easy:
 * Add these lines to :

Using MediaWiki: namespace pages
If you want to create a link that goes to the generic categorytree (displayed as Category tree) when you're on a non-category page, and to a particular categorytree (displayed as View as category tree, with foo being the name of the category you're viewing) when you're on a category page:
 * Add to your MediaWiki:Sidebar (right above the SEARCH is a good place) a line,
 * Create a MediaWiki:Sidebarcategorytree with, say:
 * Create a MediaWiki:Sidebarcategorytree-url with, say:

Parameters to request
It is possible to override the default site configuration of "mode" by providing it to as URL parameter. For example


 * - use default mode
 * - use categories mode
 * - use page mode
 * - use all mode
 * - use parent mode