Template:Automatic taxobox/doc

自動生物分类框系統文档

本模板為通用自動生物分類框模板，只需填寫少量參數即可自動生成主要的生物分類信息，旨在減小編輯者的工作量，便於快速、統一調整各生物類條目的科學分類，節省維護條目所需的人力，並能使各條目的科學分類信息在顯示風格上保持一致。如需添加或修改分類，請點擊“科學分類”字樣右側的鉛筆圖標進入編輯界面。

以下許多頁面仍待创建，您可將英文維基百科上的對應頁面翻譯為中文，助力本站的建設工作，也可以在模板討論頁提出相關問題。

主要参数

• taxon：分類單元的學名。本模板會藉由該參數提供的值，调用名稱與之相匹配的分类学模板（名為“Template:Taxonomy/分類單元學名”）來自动生成科學分類信息。
• name：分類單元的中文名，作為分类框頂部的标题显示。未填寫|name=參數時，本模板會自動读取|taxon=參數所调用的分類學模板，將該模板中|link=參數的值作為分類單元中文名顯示，因此要顯示的中文名與該值相同時，可省略不填|name=參數，但這樣做會略微增加模板的工作量。
• fossil_range：分類單元的化石時期，可使用 {{geological range}} 模板（或其重定向 {{fossil range}}）生成更為直觀的時間軸。
• image：分類單元成員的圖片，只填寫圖片名稱，請勿填入完整的圖片链接語法（形如“[[File:图片主名.扩展名|thumb|圖片說明]]”）。用於標示圖片格式的“.jpg”“.png”等扩展名亦為圖片名稱的一部分，因此需一併填入，而標示命名空間的“File:”或“Image:”前綴則不是圖片名稱的一部分，因此無需填入。
• image_upright：圖片缩放倍數，用於调整圖片的相對顯示大小，尤其適用於寬高懸殊的圖片（較寬的圖片適合放大，較高的圖片適合縮小）。不缩放時图片的默认相對大小為1（100%），填寫大於1或小於1的值可分别将图片等比例放大或缩小至相应的倍数，如填写1.2会将图片放大1.2倍（120%），填写0.8则将图片缩小0.8倍（80%），圖片的實際顯示大小取決於用戶個人的设备以及在“参数设置 → 外观”中對缩略图尺寸的設置。曾用於指定缩略图絕對大小的参数|image_width=現已棄用，該參數對應的值是以像素（px）為單位的圖片寬度，會使圖片強制顯示為固定尺寸，不能因應用戶偏好而自動調整大小。条目中如有|image_width=參數应将其移除，或转换为|image_upright=——將原有的像素值除以220（缩略图的默认寬度）並根據需要取整，即可得到與它大致相當的縮放倍數，例如|image_width=240px大致相當於|image_upright=1.1（240÷220≈1.09）。
• image_caption：圖片的文字說明，末尾通常不加句號，但由多个分句组成的複句末尾应加句號。
• image2：第二張分類單元成員的圖片，用法同|image=參數。
• image2_upright：第二張圖片的縮放倍數，用法同|image_upright=參數。
• image2_caption：第二張圖片的文字說明，用法同|image_caption=參數。
• display_parents：用於指定分类框中所顯示的次要父類群的數量，只接受大於1的整數。本模板會根據此處的數值，自下而上回傳相應數量的父類群在分类框中顯示。為避免分类框繁瑣冗長，通常只應顯示某分類單元和它最低一級主要父類群之間的次要類群，最低主要父類群之上的次要類群則不應顯示。例如分類單元為一個目時，應顯示該目和它所屬的纲之間的總目、亚纲等次要類群，而不應顯示纲之上的總綱和亚门等。若某一次要類群具有重要的分類學意義，可在其分类学模板（名為“Template:Taxonomy/該類群的學名”）中加入代码|always_display=yes，使該類群在其所有子類群條目的分類框中顯示。
• authority：分類單元學名的作者引證信息。因不同界別的生物類群受不同的命名法規管束，故作者引證格式不盡相同。對於動物界的分類單元，此處填寫命名人姓名的常用縮寫和學名發表年份，如“Linnaeus, 1758”。對於植物、藻類或真菌分類單元，則填寫由 IPNI 或 Index Fungorum 数据库提供的標準化命名人姓名縮寫，如“L.”；若學名被修訂過，還需在其後方括注修訂人的標準化姓名縮寫。
• subdivision_ranks：分類單元主要下屬類群的分类层级，如科、亞科、属、种等。
• subdivision：分類單元主要下屬類群的列表，請使用項目符號“*”羅列。
• range_map：分類單元成員的地理分布圖，用法同|image=參數。
• range_map_upright：地理分布圖的縮放倍數，用法同|image_upright=參數。
• range_map_caption：地理分布圖的文字說明，用法同|image_caption=參數。
• synonyms：分類單元的異名，請使用項目符號“*”羅列。異名較多時請使用 {{collapsible list}} 模板生成可摺疊列表，以免影響版面美觀。
• synonyms_ref：異名的參考來源，需置於參考資料標籤（<ref>...</ref>）內。若參考來源已在條目別處添加，則此處應填入 <ref name="自定义的引文 ID"/>，或改用內文引注模板（如 {{r|自定义的引文 ID}}）。
• defaultsort 或 listas：用於指定條目分類的默认排序索引。本模板會自動調取|taxon=參數的值（即分類單元學名）作為默认排序索引，如需指定不同於該值的默认排序索引，則應手動填寫|defaultsort=參數以取代模板自動調取的值。由於本模板的元模板中已預置了魔術字{{DEFAULTSORT}}用以實現該參數的功能，因此即使未填寫該參數，也不應在條目中另行設置{{DEFAULTSORT}}，以免與該參數的默认值相衝突。在同一頁面中設置多個不同的{{DEFAULTSORT}}會觸發錯誤提示，並且只有最後一個{{DEFAULTSORT}}會被使用。

模板数据

以下是该模板的模板数据，适用于可视化编辑器等工具。

Automatic taxobox模板数据

无描述。

模板参数

此模板首选参数换行的代码块格式。

参数		描述	类型	状态
中文名	name	分類單元的中文名，作為分类框頂部的标题显示	字符串	可选
化石時期	fossil range	分類單元的化石時期	内容	可选
图片	image	分類單元成員的圖片	文件	推荐
图片替代文本	image alt	用於替代图片的文字描述。当图片无法显示时，将会显示填入该参数的文本。	字符串	可选
圖片縮放倍數	image upright	用於调整图片的顯示大小。較寬的圖片適合放大，較高的圖片適合縮小。	数字	可选
图片说明	image caption	图片的文字说明	字符串	可选
图片二	image2	第二张分類單元成員的圖片	文件	可选
图片二替代文本	image2 alt	用於替代第二张图片的文字描述。当第二张图片无法显示时，将会显示填入该参数的文本。	字符串	可选
图片二縮放倍數	image2 upright	用於調整第二張圖片的顯示大小，用法同“image_upright”參數	数字	可选
图片二说明	image2 caption	第二张图片的文字说明	字符串	可选
最近父類群顯示數量	display parents	用於指定分类框中所顯示的次要父類群的數量，只接受大於1的整數	数字	可选
分类单元學名	taxon	分类单元的拉丁学名。本模板會藉由該參數提供的值，调用名稱與之相匹配的分類学模板（名為“Template:Taxonomy/分類單元學名”）來自动生成科學分類信息。	字符串	必需
作者引證	authority	分類單元學名的作者引證信息。因不同界別的生物類群受不同的命名法規管束，故作者引證格式不盡相同。	字符串	必需
模式属	type genus	模式属的中文名与学名	字符串	可选
模式属作者引證	type genus authority	模式属的作者引證信息	字符串	可选
模式种	type species	模式种的中文名与学名	字符串	可选
模式种作者引證	type species authority	模式种的作者引證信息	字符串	可选
下屬類群层级	subdivision ranks	主要下屬類群的分類層級，如科、亞科、屬、種等	字符串	可选
下屬類群	subdivision	主要下屬類群的中文名与学名列表	字符串	可选
物种多样性	diversity	简要描述分类单元的物种多样性，如“约89种”	字符串	可选
物种多样性連結	diversity link	与分类单元的物种多样性相关的条目連結	字符串	可选
物种多样性参考资料	diversity ref	物种多样性的参考资料	内容	可选
分布地图	range map	分类单元的地理分布图	文件	可选
分布地图替代文本	range map alt	用於替代分布图的文字描述。当分布图无法显示时，将会显示填入该参数的文本。	字符串	可选
分布地图縮放倍數	range map upright	用於調整分布图的顯示大小，用法同“image_upright”參數	数字	可选
分布地图说明	range map caption	地理分布图的文字说明	字符串	可选
异名	synonyms	同义学名（分类单元不再使用的其他学名）列表	字符串	可选
异名参考资料	synonyms ref	同义学名列表的参考资料	内容	可选
默认排序索引	defaultsort	用於指定條目分類的默认排序索引。未填寫該參數時，本模板會自動調取“taxon”參數的值（即分類單元學名）作為默认排序索引。	字符串	可选