模板: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”参数的值（即分类单元学名）作为默认排序索引。	字符串	可选