模板:Auto cat/doc

此頁面是Template:Auto cat的模板文件文檔。
此頁面可能包含了模板的使用說明、分類和其他內容。

這個模板用於分類頁面，以自動添加分類模板。其調用Module:auto cat，該模組會解讀分類名稱，用正確的參數嵌入正確的模板。

大多數情況下，使用此模板時不需要參數。一些分類具有可選或必填的參數來幫助分類；見下文。

大多數類別由 poscatboiler 系統處理。有關更多資訊，請參閱Module:category tree/poscatboiler/data/doc。

大多數類別在右上角都有一個編輯分類資料按鈕，可直接將您帶到實現該類別的模組。

若要更輕鬆地添加這個模板，您可以把代碼 importScript('User:Erutuon/addAutoCat.js'); 放在您的common.js中。這將在第一個標題的正下方添加按鈕。點擊按鈕添加模板並保存，或者添加模板並預覽。

此模板當前可識別使用以下模板的分類：

請注意，以前此處列出了更多模板。這些模板處理的所有分類現在都由 poscatboiler 系統處理。有關更多資訊，請參閱Module:category tree/poscatboiler/data/doc。另請參閱特定子頁面以獲取實現其中許多頁面的處理程序的示例，例如Module:category tree/poscatboiler/data/terms by etymology。

參數

某些分類允許或要求 {{auto cat}} 參數來幫助分類。

這種分類形如Category:含有前綴auto-的英語詞、Category:含有後綴-하다的朝鮮語詞。目前公認的詞綴類型有前綴、後綴、中綴、間綴、環綴和插綴。對於這些分類，允許（但非必填）使用以下參數：

|alt=: 帶有變音符號的詞綴。僅用於詞條中帶有額外變音符號的語言（例如拉丁語、俄語、阿拉伯語和古英語），並且僅當存在這些變音符號時才需要使用此參數。例如，對於Category:含有後綴-inus的拉丁語詞，可以填入 {{auto cat|alt=-īnus}}，使分類描述中的後綴和頁面頂部名稱顯示為帶有長音符的 -īnus。
|sort=: 用於排序的鍵值。大多數情況下僅日語需要此參數。例如，對於Category:有前綴真っ-的日語詞，可以填入 {{auto cat|sort=まっ}}，這樣頁面就就能在其母分類Category:依前綴分類的日語詞中正確排序。
|tr=: 手動轉寫。如果自動轉寫不正確，或者該語言沒有自動轉寫，偶爾需要對非拉丁字母語言（例如，波斯語和希伯來語）進行轉寫。
|sc=: 文字系統代碼。幾乎不使用。

這種分類包括Category:東干語和Category:原始漢藏語等。這些分類是維基詞典中代表的各種語言的根分類，有必填的參數（使用該語言的一個或多個國家／地區），以及額外的可選參數：

|1=、|2=、|3=、……: 使用該語言的國家或地區。請參見Category:各國家與地區語言和其子分類。除非該語言是重構語言（如原始印歐語）或人造語言（例如世界語），否則至少需要填入一個國家／地區。如果確實無法得知其使用的地域，請填入 UNKNOWN。
|extinct=1: 將該語言指定為已滅絕語言。
|setwiki=: 關於該語言分類所連結到的維基百科條目的名稱。如果省略，將使用該語言的維基數據詞項中的維基百科條目，或使用該語言的分類名稱（如東干語）。填入 |setwiki=- 可以讓分類頁不顯示維基百科條目連結。最好將該語言的維基數據條目添加到該語言的數據文件中，而不是在此模板中手動填寫。
|setwikt=: 該語言的維基詞典版本的代碼。如果省略，將使用該語言的維基詞典語言代碼。填入 |setwikt=- 則不顯示維基詞典連結。
|setsister=: 維基共享資源上的分類名稱（當中包含與語言相關的文件）。如果省略，將使用類別名稱（例如東干語）。填入 |setsister=- 則不顯示維基共享資源分類連結。
|entryname=: 連結到本維基詞典上的漢語詞彙。如果省略，將使用語言的規範名稱（如東干語）。填入 |entryname=- 則不顯示條目連結。

|sort=: 用於排序的鍵值，用於在其父類別中對頁面進行排序（如Category:按漢字分類的日語詞）。當自動生成的排序鍵錯誤時才需要。例如，Category:帶Î的西班牙語詞應填入{{auto cat|sort=I}}，而Category:寫作「衛」的日語詞應填入{{auto cat|sort=行10}}。日語和沖繩語詞目前使用Module:zh-sortkey來生成排序鍵，但其筆畫數依據中文規範，因此在極少數情況下會產生對日文而言錯誤的結果（例如，上例中自動生成的排序鍵為 行09 而非 行10。
|char=: 如果分類名稱中有一個描述性的詞（如 gershayim），則此詞應該是實際引用的字符（在這種情況下，（本模板應該用於Category:命名空間頁面。））；除此之外，這個參數不應該被使用。
|context=, |context2=: 出於兼容性目的而提供，但未使用。

這些分類形如Category:寫作「學」讀作「がく」的日語詞和Category:寫作「光」讀作「ふぃちゃい」的日語詞。這些分類收錄包含使用某讀音的漢字的所有詞彙（其中讀音以平假名書寫）。這些分類有用於指定讀音類型的必填參數：

|1=、|2=、|3=、……（必填）: 讀音類型，即kun、on、goon、kan'on、kan'yōon、tōon、sōon 或 nanori 當中的其中一個或多個。例如，Category:寫作「學」讀作「がく」的日語詞應填入 {{auto cat|goon|kan'on}}，而Category:寫作「光」讀作「ふぃちゃい」的日語詞應填入 {{auto cat|kun}}。特定的讀音類型通常可以在相關漢字的專門頁面上找到。