模板: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}}。特定的读音类型通常可以在相关汉字的专门页面上找到。