Extension:CategoryTree

From mediawiki.org
This page is a translated version of the page Extension:CategoryTree and the translation is 82% complete.
この拡張機能は MediaWiki 1.31 以降に同梱されています。 そのため再度ダウンロードする必要はありません。 しかし、提供されているその他の手順に従う必要はあります。
MediaWiki 拡張機能マニュアル
CategoryTree
リリースの状態: 安定
実装 タグ , パーサー関数 , 特別ページ
説明 ウィキのカテゴリ構造の動的なビューをツリーとして提供する。
作者 Daniel Kinzler (Duesentriebトーク)
最新バージョン 継続的な更新
互換性の方針 MediaWiki とともにリリースされるスナップショット。 master には後方互換性がありません。
MediaWiki 1.25+
ライセンス GNU 一般公衆利用許諾書 2.0 以降
ダウンロード
README
  • $wgCategoryTreeAllowTag
  • $wgCategoryTreeCategoryPageOptions
  • $wgCategoryTreePageCategoryOptions
  • $wgCategoryTreeMaxDepth
  • $wgCategoryTreeSidebarOptions
  • $wgCategoryTreeDefaultOptions
  • $wgCategoryTreeMaxChildren
  • $wgCategoryTreeSpecialPageOptions
  • $wgCategoryTreeOmitNamespace
  • $wgCategoryTreeSidebarRoot
  • $wgCategoryTreeDisableCache
  • $wgCategoryTreeCategoryPageMode
  • $wgCategoryTreeDefaultMode
  • $wgCategoryTreeUseCategoryTable
  • $wgCategoryTreeHijackPageCategories
Quarterly downloads 346 (Ranked 15th)
Public wikis using 10,554 (Ranked 11th)
translatewiki.net で翻訳を利用できる場合は、CategoryTree 拡張機能の翻訳にご協力ください
問題点 未解決のタスク · バグを報告

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

インストール

  • ダウンロードして、ファイルをextensions/フォルダー内のCategoryTreeという名前のディレクトリ内に配置します。
    開発者とコード寄稿者は、上記の代わりに以下を使用してGitからインストールします:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CategoryTree
  • 以下のコードを LocalSettings.php ファイルの末尾に追加します:
    wfLoadExtension( 'CategoryTree' );
    
  • Yes 完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。

使用法

CategoryTreeは、3つの使い方があります。

  • カテゴリページに直接表示されます。
  • カテゴリ構造をWikiページにインラインで表示するための「カスタムタグ」(または「パーサー関数」)として。
  • また、特設ページとして

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

<categorytree> タグ

例。実行結果は下のボックスと右にあります:

<categorytree mode="pages">Manual</categorytree>

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

mode
ツリーに表示されるページを決定します。これは namespaces オプションを使用することでオーバーライドできます。許可される値は次の通りです:
categories
下位カテゴリだけ表示する(構成定数の 0)
pages
画像以外の下位カテゴリとページを表示する(構成定数の 10)、ページ数の上限は200件
all
すべてのページ、下位カテゴリ、画像などを表示する(構成定数の 20)
parents
下位カテゴリの代わりに親カテゴリの一覧を表示する (構成定数の 100)。これはCategoryTreeに"inverse"オペレーションをさせます(2008年7月の r36892 以降でサポートされます)。
depth
最初に表示されるツリーのレベルを決めます。既定値は1で、0はルートノードのみを意味します。最大値は指定されるモード、と $wgCategoryTreeMaxDepth オプションに依存します(2007年5月30日の r20410r20840 の間に導入されました; 2008年6月の r36864 以降の $wgCategoryTreeDynamicTag でも、十分な機能があります)
onlyroot
初期の状態でツリーの"root"ノードのみを表示するようにするにはこれを "on" に設定します。depth="0" と同等です。(2007年3月13日の r20385 で導入されました) 2008年7月の r36864 で廃止予定になりました: 代わりに depth="0" を使用してください。
hideroot
ツリーの"root"ノードを隠すにはこれを "on"、すなわち hideroot=on にセットします。この例ではカテゴリのFooは表示されません。
hideprefix
ツリーのエントリから隠される名前空間の接頭辞を決定します(2008年7月の r36864 以降)。可能な値は次の通りです:
always
常に接頭辞を隠します。すべてのページが同じ名前空間に属する場合に使います (構成定数の 10)。
never
カテゴリに対してでも、名前空間の接頭辞を決して隠さない(構成定数の 0)。
auto
カテゴリの名前空間を隠します。カテゴリのみが表示される場合、mode="categories" と同じです(構成定数の 30)。これは古い既定の挙動と同等です(2008年6月以前)。
categories
カテゴリの名前空間を隠しますが、他のすべての接頭辞を表示します(構成定数の 20)。これは新しい既定の挙動です(2008年7月の r36864 以降)。
showcount
下位カテゴリの数を表示するにはこれを "on"、すなわち showcount="on" に設定します(2008年7月の r36864 以降)。 これはページのインラインのカテゴリツリーに対しては既定で無効ですが、カテゴリ一覧および Special:CategoryTree では既定で有効になります。
notranslations
を設定すると、カテゴリに係るページに対応する翻訳ページ、すなわちnotranslations="on"がすべて非表示になります(Gerrit change 526234以降、2019年11月)。 デフォルトでは無効になっています。 このオプションを「on」に設定すると、異なる翻訳(例:Page, Page/ja, Page/fr, Page/de)の代わりに標準翻訳の「Page」だけが表示され、すべての翻訳が抑制されます。
これは "showcount "には影響しないので、まだバグです。
namespaces
ツリーにページを表示する名前空間のリスト (r36864, 2008年7月以降)。リストの項目は、スペースで区切られた名前空間名でなければなりません。標準名前空間は、"-" または "0" で表すことができます。下位カテゴリは、Category 名前空間がリストに存在する場合にのみ表示されます。
class, style、id、etc
<categorytree> タグはブロック要素用の標準のすべてのHTML属性をサポートします(2008年7月の r36864 以降で、それ以前は style のみがサポートされました)。

'名前空間' パラメータに関する注意事項

カテゴリは名前空間です。カテゴリは既定ですべてのモードで表示されますが、namespaces パラメーターを指定すると、一覧に存在しない他の名前空間と同様に非表示にできます。特定の名前空間に属するページ、および下位カテゴリに含まれるページを列挙する場合は、単に Category を名前空間リストに追加してください。

例:

  • Category:Manual: にある標準名前空間のページを列挙します:
<categorytree mode="pages" namespaces="Main">Manual</categorytree>
  • Category:Manual: にある標準名前空間のページおよび下位カテゴリを列挙します:
<categorytree mode="pages" namespaces="Main Category">Manual</categorytree>

modeパラメータは、namespacesで上書きされます。

  • Category の名前空間のみを尋ねる場合は、mode=categoriesと同等です。
  • ファイル名空間がリスト上に存在する場合は、mode=allと同じになります。
  • それ以外の場合は、mode=pagesが使用されます。つまり、サイト構成が変更されていなければ、以下は等価です(最初の二つは常に等価、三つ目は$wgCategoryTreeDefaultModeがデフォルトのCategoryTreeMode::CATEGORIESである場合のみ)。
<categorytree mode="categories">Manual</categorytree>
<categorytree namespaces="Category">Manual</categorytree>
<categorytree>Manual</categorytree>

{{#categorytree}} パーサー関数

r25825 (2007-9-13)以降、ページのカテゴリツリーを置くのにパーサー関数の構文を使用することもできます。これは、例えば {{#categorytree:Foo}} などの異なる構文を使った <categorytree> タグのように機能します。オプションは名前付きのテンプレート名、例えば {{#categorytree:Foo|hideroot|mode=pages}} の構文を使って指定できます。

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

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

Special:CategoryTree ページ

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

設定

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

You can no longer use CT_* constants in LocalSettings.php. Instead use 0 for category mode, 10 for pages, 20 for all, 100 for parents.
$wgCategoryTreeMaxChildren
ツリーノードに表示できる子の最大数です。既定値は200です。
$wgCategoryTreeAllowTag
<categorytree> タグを有効にします。既定値はtrueです。
$wgCategoryTreeDynamicTag
<categorytree> でツリーの最初のレベルのツリーを動的に読み込みます。この方法では、キャッシュを無効にする必要はありません。既定値はfalseです。
$wgCategoryTreeDisableCache
disables the parser cache for pages with a <categorytree> tag, or provides max cache time in seconds. Default is 21600 which is 6 hours.
$wgCategoryTreeUseCache
匿名利用者のHTTPキャッシュを有効にします。既定値はfalseです。
$wgCategoryTreeOmitNamespace
ページとカテゴリで名前空間を表示しない。既定値はfalseで、カテゴリのみを表示しない限り名前空間が表示されます。 2008年7月の r36864 で廃止予定になったため代わりに $wgCategoryTreeDefaultOptions['hideprefix'] を使用してください
$wgCategoryTreeMaxDepth
<category> タグで深さのパラメーターを使用して初期に展開されるそれぞれのmodeの最大の深さを決める配列です。既定では、これは"categories"モードで2に、他のモードでは1に設定されます。例えばcategoriesには3、他のモードには2に設定するには、$wgCategoryTreeMaxDepth = [10 => 2, 20 => 2, 0 => 3, 100 => 2]; を使用できます。
$wgCategoryTreeDefaultMode
<categorytree> タグでmode属性が設定されていないときの既定のモード。可能な値は 0 (既定値 - カテゴリ)、10 (ページ)、20 のいずれかです。
$wgCategoryTreeCategoryPageMode
カテゴリページでツリーをレンダリングするときに使用するモード。2008年7月の r36864 に廃止予定になりました。代わりに $wgCategoryTreeCategoryPageOptions['mode'] を使用します。
$wgCategoryTreeSidebarRoot
カテゴリ ツリーをサイドバーに統合するために使用するルート カテゴリ(2008年7月の r36920 以降)。 設定されていない場合、ツリーは統合されません (これは既定値)。 サイドバーへの CategoryTree の統合は SkinTemplate に基づく外装のみ機能します。すなわち、Modern、Monobook、Chick、Simple、MySkin は機能しますが、Standard、Nostalgia、CologneBlue は機能しません。 This is currently broken for MediaWiki 1.35.1 and the vector skin, see phab:278306.
$wgCategoryTreeDefaultOptions
既定のオプションは配列として適用します(2008年7月の r36864 以降)。利用可能なオプションは上記の通りです。例: $wgCategoryTreeDefaultOptions['mode'] = 'pages';
$wgCategoryTreeCategoryPageOptions
カテゴリページで配列として使用するオプション(2008年7月の r36864 以降)。
$wgCategoryTreeSpecialPageOptions
Special:CategoryTree で配列として使用するオプション(2008年7月の r36864 以降)
$wgCategoryTreeSidebarOptions
サイドバーでツリーを表示するときに配列として使用するオプション(2008年7月の r36920 以降)

システムメッセージ

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つのパラメーターをとります:

パラメーター 意味
$1 下位カテゴリの個数
$2 記事の数 (カテゴリページやファイルページは含まない)
$3 アップロードされたファイルの個数
$4 カテゴリページとファイルページを含む、メンバーページの合計数
$5 Something close to ($1 C, $2 P, $3 F) but with anything that is 0 omitted.

More precisely, a comma separated list of the number of pages (mediawiki:categorytree-num-pages), subcategories (mediawiki:categorytree-num-categories), and files (mediawiki:categorytree-num-files) in the category, or empty (mediawiki:categorytree-num-empty) in the case the category has no members. In versions prior to those around 1.19 this value was different. See older version of these docs.

既定値は ($5) です。

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

{{#ifeq:$1|0||$1 categories}}

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

省略版:

({{#ifeq:$4|0|empty|{{#ifeq:$1|0||$1 C{{#ifeq:{{#expr:$3+$2}}|0||,}}}} {{#ifeq:$2|0||$2 P{{#ifeq:$3|0||,}}}} {{#ifeq:$3|0||$3 F}}}})

完全名版:

({{#ifeq:$4|0|empty|{{#ifeq:$1|0||$1 categories{{#ifeq:{{#expr:$3+$2}}|0||,}}}} {{#ifeq:$2|0||$2 pages{{#ifeq:$3|0||,}}}} {{#ifeq:$3|0||$3 files}}}})

トラブルシューティング

CategoryTreeをインストールした後でウィキが壊れる

  • エラー出力機能 をオンにする
  • すべてのファイルがインストールされていることを確認する
  • CategoryTree拡張機能のすべてのファイルが644モードで、CategoryTreeディレクトリが755モードであることを確認してください

LocalSettings.php のオプションの効果がない

  • 拡張機能のファイルをインクルードした後でオプションを指定していることを確認してください。

<span id="Clicking_the__has_no_effect,_gives_a_JavaScript_error_or_just_sits_on_loading">

をクリックしても効果がない、JavaScriptエラーまたはloadingになる

  • 期待通りに動かない場合システムメッセージで <categorytree> タグを使用していることを確認してください(MediaWiki-Namespace) - これは既知の警告です。次善策は、下記の#サイドバーでCategoryTreeを使うを参照してください。
  • LocalSettings.php で拡張機能のファイルをインクルードする$wgUseAjax = true; があることを確認してください。
  • 拡張機能の最新バージョンを使用していることを確認してください - 開発の最先端のバージョンは git:mediawiki/extensions/CategoryTree です。
  • 書き換えルールまたはエイリアスを使っている場合(例えば"very short URLs"がある - ドキュメントルートでウィキページ)、/skinsディレクトリと同じように/extensionsディレクトリに例外ファイルがあることを確認してください。下記の項目も参照してください。

Clicking the shows no sub-categories error

  • Try to fix this by adding this code to LocalSettings.php: $wgCategoryTreeDefaultOptions['namespaces'] = [ 0, NS_CATEGORY, NS_FILE ];

ブラウザーが CategoryTree.js かつ/または CategoryTree.css に対してbad MIMEタイプを報告する

  • Webサーバーが.jsと.cssファイルに対して正しいmimeタイプを使っていることを確認してください
  • ブラウザーでURLを直接入力し ページが完全に提供されエラーが表示されていないことを確認してください; とりわけ:
  • 書き換えルールまたはエイリアスを使っている場合(たとえば"very short URLs"がある - ドキュメントルートでウィキページ)、/skinsディレクトリと同じように/extensionsディレクトリに例外ファイルがあることを確認してください。下記の項目も参照してください。

<span id="Member_counts_are_wrong,_grey_arrows__are_shown_instead_of_">

メンバーの件数が間違っている、 の代わりに が表示される

MediaWiki 1.13以降では、CategoryTreeはカテゴリのメンバーの数を表示し、その番号に基づく子を持たないツリーのノードに灰色の矢印 を表示します。この情報は新しい category テーブルに基づいています。しかしながら、そのテーブルに現在の値を投入しても1.13にアップグレードするときは常に機能しません。その場合、populateCategory.php メンテナンススクリプトを実行し、必要であれば --force オプションをつけます。

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 display: none; to display: inline !important;.

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

ボット利用者のための注記

カテゴリページのHTMLを構文解析するボットとスクリプトは従来の出力を強制するURLの notree パラメーターを使用できます。しかしながらHTML出力は一般的には安定していないので、カテゴリの一覧を取得するには ll|API:Main page を使用するようスクリプトを変更することをお勧めします。

"Category Not Found"メッセージ

Category Treeプラグインを実装しツリーを表示するコードを追加した後で、Category Not Foundというメッセージが見える場合、コンテントをカテゴリページに追加する必要があります。基本的にカテゴリページを赤くすることはできません。カテゴリ名をクリックし、テキストをカテゴリページに追加すれば、ツリーはきちんと機能します。

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.

ハック

システムメッセージとカスタム外装でCategoryTreeを使用

CategoryTreeの古いバージョンでは、この動かすためにコードを修正しなければなりません: CategoryTree.php ファイルで efCategoryTreeParserOutput 関数を見つけ、条件ブロックを削除すれば次のようになります:

function efCategoryTreeParserOutput( &$outputPage, &$parserOutput )  {
    CategoryTree::setHeaders( $outputPage );
    return true;
}

サイドバーでCategoryTreeを使用

JavaScriptの使用

MediaWiki 1.13 (r36917)の r36920 (2008年7月)以降では、$wgCategoryTreeSidebarRoot をルートとして使用したいカテゴリに設定するだけでCategoryTreeをサイドバーに統合できます。これはSkinTemplateを継承する外装、すなわちModern、Monobook、Chick、Simple、MySkinのみに機能しますが、Standard、Nostalgia、CologneBlueは機能しません。

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

CategoryTreeかつ/またはMediaWikiの以前のバージョンに関して、サイドバーの通常のウィキテキストを有功にするためにmodを MonoBook.php にインストールする必要があります。サイドバー内でウィキテキスト --DJ 19:26, 24 January 2008 (UTC) を参照してください。

"CategoryTree"のリンクをツールボックス(サイドバー )に追加するには、次のコードを外装 のJavaScriptのページ(例えば monobook.js)に追加しURL "w:Special:CategoryTree"をカスタマイズします。

function AppendCategoryTreeToSidebar() {
    try {
        var node = document.getElementById( "p-tb" )
                           .getElementsByTagName('div')[0]
                           .getElementsByTagName('ul')[0];
 
        var aNode = document.createElement( 'a' );
        var liNode = document.createElement( 'li' );
 
        aNode.appendChild( document.createTextNode( 'CategoryTree' ) );
        aNode.setAttribute( 'href' , '[[w:Special:CategoryTree]]' );
        liNode.appendChild( aNode );
        liNode.className = 'plainlinks';
        node.appendChild( liNode );
    } catch(e) {
        // lets just ignore what's happened
        return;
    }
}
 
addOnloadHook( AppendCategoryTreeToSidebar );

このコードのより汎用的な版は Manual:インターフェイス/サイドバー#content of sidebar and toolbox (javascript) で見つかります。

Step by step if works easy:

$wgCategoryTreeSidebarRoot = 'Category:article_name';

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, ** sidebarcategorytree-url|sidebarcategorytree
  • Create a [[MediaWiki:Sidebarcategorytree]] with, say: {{#ifeq: {{NAMESPACE}}|Category|View as category tree|Category tree}}
  • Create a [[MediaWiki:Sidebarcategorytree-url]] with, say: {{#ifeq: {{NAMESPACE}}|Category|Special:CategoryTree/{{BASEPAGENAME}}|Special:CategoryTree/Categories}}

See also