- 此擴充功能已在Fandom上預設啟用。
CategoryTree(分類樹)是一個以樹的形式提供了wiki分類結構的動態視圖的擴充功能。它使用AJAX按需載入分類樹的結構。
目录
用法
CategoryTree擁有三種用法:
- 直接用在翻類頁面,
- 用作「自定義標籤」(或稱「解析器函數」),內嵌在wiki頁面展示分類結構,
- 以及用作特殊頁。
CategoryTree擴充功能將[+]或[×]“展開”小工具加入到分類頁面上列出的子分類,這裡[+]意味著存在更精細的子分類,而[×]意味著不存在。如果停用了JavaScript,那些小工具什麼用都沒有。
- 對於機器人使用者的注意事項:機器人和解析分類頁面HTML的指令碼可以使用URL參數
notree
強制結束傳統輸出。然而,HTML輸出通常是不穩定的,所以推薦您變更指令碼,使用query.php
或api.php
擷取分類清單之類內容。
標籤<categorytree>
範例:
<categorytree mode="pages" style="float:right; clear:right; margin-left:1ex; border:1px solid rgba(105, 105, 105, 0.2); padding:0.7ex; background-color: rgba(105, 105, 105, 0.08);">檔案</categorytree>
這個自訂標籤稱為<categorytree>。例如,如果您將<categorytree>Foo</categorytree>放入一個wiki頁面,它會以動態樹狀目錄形式顯示Foo分類的目錄(請參看右側的範例)。該標籤接受下方的屬性,使用類似HTML的語法:
- mode
- 決定樹狀分類中顯示那些頁面。使用
namespaces
選項可能會覆寫此選項。可用的值:- categories
- 僅顯示子分類(組態常數
CT_MODE_CATEGORIES
) - pages
- 顯示子分類和頁面,不顯示圖片(組態常數
CT_MODE_PAGES
),限制在200個頁面以內 - all
- 顯示所有頁面、子分類、圖片等等(組態常數
CT_MODE_ALL
) - parents
- 列出母分類而非子分類(組態常數
CT_MODE_PARENTS
)。這會將CategoryTree置入「inverse」作業
- depth
- 決定初始顯示多少層樹狀分類。預設值為1,0意味著只有根節點。最大值取決於指定的模式,以及
$wgCategoryTreeMaxDepth
選項。 - hideroot
- 設定為"on"可以隱藏樹狀分類的「根」節點,也就是範例中Foo分類提及的。
- hideprefix
- 決定命名空間前置詞何時應該從樹狀分類的項目中隱藏。可用的值為:
- always
- 一律隱藏前置詞。只有所有頁面來自於同一個命名空間時應該使用。(組態常數
CT_MODE_CT_HIDEPREFIX_ALWAYS
) - never
- 一律不隱藏命名空間前置詞,包括分類(組態常數
CT_MODE_CT_HIDEPREFIX_NEVER
) - auto
- 隱藏分類的命名空間,如果顯示的只有分類,則與mode="categories"相同(組態常數
CT_MODE_CT_HIDEPREFIX_AUTO
) - categories
- 一律隱藏分類的命名空間,顯示其他所有前置詞(組態常數
CT_MODE_CT_HIDEPREFIX_CATEGORIES
);這是預設的表現方式
- showcount
- 設定為"on"可以顯示子分類中項目的數量,也就是showcount="on"。這個選項對於頁面內置的分類樹預設為停用,但是在分類清單與Special:CategoryTree(特殊:分類樹)中預設為啟用。
- namespaces
- 來自哪些頁面之命名空間的清單應該於樹狀分類中顯示。清單中的項目必須是命名空間名稱,用空格分開。主命名空間可以用"-"或"0"表示。此選項會覆寫mode選項。
- class、style、id等等
- <categorytree>標籤支援所有適用於區塊元素的標準HTML屬性。
解析器函數{{#categorytree}}
您也可以使用「解析器函數」的語法在一個頁面中放置分類樹。這會像<categorytree>標籤一樣運作,只是使用不同的語法,例如,{{#categorytree:Foo}}
;可以使用命名模板參數的語法指定這些選項,例如,{{#categorytree:Foo|hideroot|mode=pages}}
。
使用解析器函數的語法的優勢是,指定要顯示的分類時,你可以使用魔術字、模板與模板參數。範例:
- 使用魔術變數顯示「此頁面」分類樹(可能在分類描述頁面有用):
{{#categorytree:{{PAGENAME}}}}
。 - 使用模板指定分類:
{{#categorytree:{{root category}}}}
-根分類的名稱可能會由Template:Root_category的內容定義。 - 在模板內部使用CategoryTree時,使用模板參數指定分類:Template:Baz中的
{{#categorytree:{{{1}}}}}
可以使用{{Baz|Foo}}呼叫。
Special:CategoryTree(特殊:分類樹)頁面
該特殊頁面稱為Special:CategoryTree(特殊:分類樹);在那裏你可以輸入一個分類的名稱,瀏覽其內容。
參見
- 使用說明:動態頁面列表#使用其他工具來達成DPL一般功能
- 範例
- MediaWiki上的擴充功能頁面:更多有關擴充功能CategoryTree的資訊
進一步的帮助與反馈
- 於帮助:帮助中心瀏覽或搜索其他帮助頁面。
- 查看Fandom社区中心以尋求更多協助與支持。
- 查看联系Fandom頁面,了解如何报告本條目中的任何錯誤或不清楚的步驟。