Terraria Wiki:Wiki入门/模板
模板用于在页面中插入相同的内容，其概念类似于编程中的“函数”。模板页面的前缀为 Template:（例如 Template:Tr）。模板通过“嵌入”页面的方式来使用，如此做会将模板页面上的全部内容添加到页面上。在使用时，模板通常由一对花括号表示：{{模板名称}}，这段代码会在页面上嵌入模板页面上的全部内容（即Template:模板名称页面的内容）。
每个模板除了其模板页面（Template:模板名称）以外，一般还会拥有一个文档页面（Template:模板名称/doc），这个文档页面通常也会显示在模板页面上。在不知道如何使用或修改一个模板时，推荐前往其模板页面查阅文档。
此外，模板在使用时通常还会包含参数：
- 参数通过 | 符号（竖线，也称 pipe）分隔。
- 本 wiki 上常见的参数包括隐式参数和带名称参数。
- 隐式参数表现形式为
{{模板名称|参数}}。 - 带名称参数表现形式为
{{模板名称|参数名称=参数}}。
- 隐式参数表现形式为
- 本 wiki 上常见的参数包括隐式参数和带名称参数。
一般来说，编辑时只需将对应模板从英文复制即可，无需改动太多内容。
不必掌握所有模板和参数的详细用法，下方列出的内容读者知晓即可，以防看到模板却不知道其意思的情况发生。
基础常用模板
- 点击章节标题可以跳转至对应模板的文档页面，那里有完整的模板使用方法和参数。
exclusive 系列
泰拉瑞亚在不同平台上更新进度不一，因此 Terraria Wiki 使用 exclusive 系列模板来区分各个平台的内容。它们包括{{exclusive}}、{{eversions}}、{{eicons}}、{{eil}}。
{{exclusive}}
用于标记页面的内容所属版本并存入分类。用法：{{exclusive|版本}}
- 示例页面：泰拉魔刃
“版本”部分可以填写具体版本号，如 1.3.0.1，也可以填写某个条目的英文名，如 Moon Lord；最终产出相同。英文区分大小写。以下exclusive系列模板中的“版本”部分同理。
- 示例：{{exclusive|Moon Lord}}会输出：
如果用于页面上的某一章节则需要使用{{exclusive|版本号|section=y}}。
- 示例页面：机关§沙机关
{{eversions}}
即 exclusive versions，用于显示对应版本。
| 用法 | 代码 | 功能 | 示例 |
|---|---|---|---|
| 基础用法 | {{eversions|版本}} | 用于显示对应版本。 | {{eversions|1.4.0.1}} ->  电脑版、 主机版、和 移动版。常用格式：在 电脑版、 主机版、和 移动版中，……
|
| not 参数 | {{eversions|版本|not=版本}} | 用于显示版本号在某些版本间的平台。 | {{eversions|1.2.2|not=1.4.0.1}} ->  前代主机版
|
| invert 参数 | {{eversions|版本|invert=y}} | 用于反向显示指定版本号版本的平台。 | {{eversions|1.4.1|invert=y}} -> 前代主机版和任天堂 版{{eversions|Suspicious Looking Skull|invert=y}} -> |
| short 参数 | {{eversions|版本|short=y}} | 此参数用于显示更加“简短”的各个版本名称，用于其他语言（如英语中 Desktop version -> Desktop）。中文 wiki 此参数无作用。 | 无 |
{{eicons}}
即 exclusive icons，和 {{eversions}} 用法相同，不过只显示图标。
| 用法 | 代码 | 功能 | 示例 |
|---|---|---|---|
| 基础用法 | {{eicons|版本}} | 用于显示对应版本图标。 | {{eicons|1.4.0.1}}文本 -> (电脑版、主机版、和移动版)文本 |
| small 参数 | {{eicons|版本|small=y}} | 显示较小的图标（如：在 infobox 模板使用）。 | {{eicons|1.4.0.1|small=y}} -> (电脑版、主机版、和移动版) |
| not 参数 | {{eicons|版本|not=版本}} | 用于显示版本号在某些版本间的平台。 | {{eicons|1.2.2|not=1.4.0.1}} -> (前代主机版) |
| invert 参数 | {{eicons|版本|invert=y}} | 用于反向显示指定版本号版本的平台。 | {{eicons|Ocram|invert=y}} -> (电脑版、主机版、和移动版) |
{{etext}}
用于格式化地显示带有{{eicons}}注释的文本，和 {{eicons}} 用法类似，并支持其所有参数。此外还有新增用法和参数，见下方：
| 用法 | 代码 | 功能 | 示例 |
|---|---|---|---|
| 基础用法 | {{etext|文字|e=版本}} | 用于显示文字及对应版本图标。 | {{etext|25|e=1.4.0.1}} -> 25(电脑版、主机版、和移动版) |
| t / after 参数 | {{etext|e=版本|t=文字}} | 将图标显示在文字前面。 | {{etext|e=1.4.0.1|t=120}} -> (电脑版、主机版、和移动版)120 |
| 建议用法 | 无 | 一般来说，建议在{{eicons}}用于标注一个数据的版本归属时改为使用{{etext}} | {{etext|8 分钟|e=1.4.3.3}} / {{etext|5 分钟|e=1.4.3.3|invert=y}} ->8 分钟(电脑版、主机版、和移动版) / 5 分钟(前代主机版、和3DS版) |
| 建议用法 2 | 无 | 当{{eicons}}在内容含义上是独立的时，不使用{{etext}} | {{eicons|1.4.0.1}} 其伤害被提升了，因此更加适合用于战斗。 |
{{etext}} 相比于“{{eicons}} +文本”的方式，主要的优点有：
- 将版本信息和对应的作用文字在HTML语义上打包成了一个整体。
- 图标和文字之间的空格处理会更优雅（模板内部可以针对不同场景和不同语言进行不同处理）。
- 若对应的版本输入信息无效，{{eicons}} 会输出错误信息，但 {{etext}} 不会，只会简单的不显示任何图标。
{{eil}}
即 exclusive icon link，用于写出带平台图标的链接。英文区分大小写。
| 用法 | 代码 | 功能 | 示例 |
|---|---|---|---|
| 基础用法 | {{eil|条目英文名}} | 显示带平台图标的链接。 | {{eil|Starlight}} -> 星光(电脑版、主机版、和移动版) |
| s/es 参数 | {{eil|条目英文名|s}} {{eil|条目英文名|es}} |
在英文 wiki 上显示复数。中文 wiki 上无作用。 | 无 |
{{item}}
用于显示更加详细的条目链接，包括条目图标和平台图标。英文区分大小写。
| 用法 | 代码 | 功能 | 示例 |
|---|---|---|---|
| 基础用法 | {{item|条目英文名}} | 显示带平台图标的链接。 | {{item|Zenith}} ->  天顶剑(电脑版、主机版、和移动版)
|
| 修改文本 | {{item|条目英文名|文本}} | 修改链接文本显示。 | {{item|Zenith|文本}} -> 文本(电脑版、主机版、和移动版)
|
| （英语）复数 | 上述修改文本为 s, es, ies, 或 ves。 | 在英文 wiki 中，这样会将文本显示为复数。中文 wiki 这样做无效果。 | 无 |
| size 参数 | {{item|条目英文名|size=数字px}} | 按像素调整图片大小。 | {{item|Zenith|size=100px}} -> 天顶剑(电脑版、主机版、和移动版)
|
| scale 参数 | {{item|条目英文名|scale=数字}} | 按比例调整图片大小。 | {{item|Zenith|scale=0.2}} ->  天顶剑(电脑版、主机版、和移动版)
|
| note 参数 | {{item|条目英文名|note=文本}} | 在同一行显示一条备注。 | {{item|Royal Gel|note=（{{tr|Expert Mode}}）}}}} ->  皇家凝胶（专家模式）(电脑版、主机版、和移动版)
|
| note2 参数 | {{item|条目英文名|note2=文本}} | 在另一行显示一条备注。 | {{item|Royal Gel|note2=（{{tr|Expert Mode}}）}}}} -> 皇家凝胶(电脑版、主机版、和移动版)（专家模式）
|
| icons 参数 | {{item|条目英文名|icons=yes/no}} | 调整是否显示平台图标。默认为“yes”。 | {{item|Royal Gel|icons=no}} -> 皇家凝胶
|
infobox 系列模板
这些模板用于显示条目的详细信息。包括：{{item infobox}}、{{npc infobox}}、{{buff infobox}}、{{drop infobox}}。
这类模板均使用数据库内数据来自动填入大部分参数，无需手动更改。从英文 wiki 复制后，检查页面上出现的英文部分进行翻译即可。
{{Drop infobox}}
用于列出本页面的物品能被哪些条目掉落。
- 一般格式：{{drop infobox|style=clear:right}}，添加在{{item infobox}}之后。
- 如果此模板中条目有缺失/错误，无需手动添加，而应当更新相关的生物自身的页面上的{{npc infobox}}模板，或是相关物品自身页面上的{{loot}}模板。
游戏难度模板
用于给文字加上统一的游戏难度格式。
| 功能 | 用法 | 示例代码 | 示例 |
|---|---|---|---|
| 旅行模式文本 | {{journey|文本}} | {{journey|123，文本}} | 123，文本 |
| 专家模式文本 | {{expert|文本}} | {{expert|123，文本}} | 123，文本 |
| 大师模式文本 | {{master|文本}} | {{master|123，文本}} | 123，文本 |
{{note}}
用于添加备注文字。一般出现在 infobox 模板中。
| 用法 | 代码 | 示例 |
|---|---|---|
| 基础用法 | {{note|一些文字}} | 一些文字 |
| small 参数 | {{note|一些文字|small=y}} | 一些文字 |
| paren 参数 | {{note|一些文字|paren=y}} | (一些文字) |
区分类模板
区分类模板放置在条目内容前，用于输出区分名称相似的页面的提示。
这些模板包括{{dablink}}、{{about}}、{{distinguish}}、{{redirect}}、{{for}}、{{forlist}}。关于更详细的用法，请点击各个模板名查看。下方表格只展示其基础用法。
| 模板 | 代码 | 示例 | 备注 |
|---|---|---|---|
| {{dablink}} | {{dablink|说明文字}} | 说明文字
|
填入描述。 |
| {{about}} | {{about|对此条目的说明}} | {{about|Wiki 教程}} -> 此页面是关于Wiki 教程的。对于其他用法，参考Wiki入门/模板（消歧义）。
|
填入描述 |
| {{distinguish}} | {{distinguish|要与此条目区分的条目名}} | {{distinguish|{{tr|Guide}}}} -> 不要与向导相混淆。
|
填入页面名称，默认无{{tr}}。 |
| {{redirect}} | {{redirect|重定向至此条目的页面|另一页面的描述|另一页面（|另一页面2的描述|另一页面2|...）}} | {{redirect|Not the bees!|{{tr|Not the Bees!}}{{tr|Achievement}}|{{tr|Achievements}}}} -> “Not the bees!”重定向到此处。对于不要蜜蜂！成就，参见成就。
|
填入页面名称、描述、页面名称（、描述、页面名称……）。注意：请不要将这个和重定向页面相混淆。 |
| {{for}} | {{for|对另一条目的说明|条目名}} | {{for|NPC|{{tr|Guide}}}} -> 关于NPC，参见向导。
|
填入描述、页面名称。默认无{{tr}}。 |
| {{forlist}} | {{forlist|对另一条目的说明|条目名（|对另一条目的说明2|条目名2|...）}} | {{forlist|{{tr|pet summoning item}}|{{tr|Seaweed}}|{{tr|fishing}}时获得的垃圾|{{tr|Seaweed (junk)}}|{{tr|plant}}|{{tr|Plant}}#{{tr|Seaweed}}}}-> |
填入描述、页面名称（、描述、页面名称……）。默认无{{tr}}。 |
{{language info}}
用于添加此页面的跨语言链接。放置在页面底端。
| Wiki | 用法 |
|---|---|
| 位于页面底端 | {{language info|en=英文 wiki 上的对应页面名}} |
嵌入
如上所述，模板通过“嵌入”的方式工作，但并非仅有模板可以被嵌入到其他页面中。实际上，花括号并不表示其中的是模板（如{{模板名称}}），而仅是“嵌入”页面的标记，只是对于模板页面的嵌入，只需要在花括号中填写模板名称。
对于常规的页面，也可以使用花括号将它们嵌入到其他页面中，但需要在页面名称前添加一个冒号。例如，{{:坠落之星}}可以将坠落之星这一页的所有内容嵌入到此处。
此外，在进行嵌入时，还可以使用嵌入标记来决定一段内容是否应当被嵌入到其他页面中。
| 嵌入标记 | 用途 |
|---|---|
| <noinclude> | <noinclude>这段文本只会被显示在此页面上。若此页面被嵌入到另一页面中，这段文本不会被包含在那个页面中。</noinclude> |
| <includeonly> | <includeonly>这段文本在此页面上不可见，而只会在此页面被嵌入到另一页面中时显示。</includeonly> |
| <onlyinclude> | <onlyinclude>这段文本在此页面和被嵌入的页面上都可见。此标记的用途：当此页面被嵌入到另一页面中时，仅有<onlyinclude>标记内的内容会被显示在另一页面上。</onlyinclude> |