模板: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」參數的值（即分類單元學名）作為預設排序索引。	字串	非必填