Crafting usage/doc

{{documentation header}}
<!-- Documentation here -->
{{lua}}
该模板会在页面的“合成材料”段落显示使用该材料的合成配方。

只会在 <code>Category:Recipe using <ingredient></code> （[[:Category:Recipes|分类列表]]）里搜索配方，仅接受使用了 {{tl|crafting}}的结果。

如果找不到有效的配方，页面将会被加上 [[:Category:空合成用途]]。

== 用法 ==

* <code>{{{1}}}</code>：用于控制要搜索的配方，默认为页面名称。可指定多个配方，使用逗号进行分隔。
* <code>{{{match}}}</code>：指定配方的匹配程度，默认为精准匹配。可指定多个匹配类型，使用逗号进行分隔。如果指定了多个材料，但只有1种匹配类型，这个匹配类型将会用于所有配方的匹配。
** <code>start</code> 表明匹配指定材料开头的配方。例如：“Redstone”将会匹配“Redstone Torch”、“Redstone Block”、“Redstone”等，但不会匹配到“Block of Redstone”、“Some Redstone thing”等。
** <code>end</code> 表明匹配指定材料末尾的配方。例如“Redstone”将会匹配“Block of Redstone”、“Redstone”等，但不会匹配“Redstone Block”、“Some Redstone thing”等。
** <code>any</code> 表明匹配任何含该材料的配方。例如：“Redstone”将会匹配“Block of Redstone”、“Redstone”、“Redstone Block”、“Some Redstone thing”等，但不会匹配“Red stone”、“Block of Reddishstone”等。
* <code>{{{category}}}</code>：要搜索的分类的配方名称，默认为 <code>Recipe using {{{1}}}</code>
* <code>{{{ignore}}}</code>：一个正则表达式字符串，以忽略没有命名空间以及下划线的空格。管道字符必须使用<code>¦</code>。
* <code>{{{description}}}</code>：如果配方带描述，将会自动显示配方的描述。但如果设置为0，描述列将会强制隐藏，如果设置为1，将会强制显示。
* <code>{{{continue}}}</code>：如果设置了，表格将不会结束，允许手动添加附加的配方。与普通的 {{tl|crafting}} 用法相同。最后一个配方必须设置 <code>{{{foot}}}</code>。这在缺失一些配方的情况下是权宜之计，或者加上 {{{ignore}}} 来手写一个配方，以进行更高高度的自定义。

== {{t|Crafting}} usage ==

These args are used on the {{t|crafting}} templates themselves, but are read by this template.
* <code>{{{ignoreusage}}}</code>: This can be added to crafting recipes which should be ignored by this template. Best for recipes which need to be ignored by multiple {{t|crafting usage}} templates.
* <code>{{{arggroups}}}</code>: Used to manually specify which arguments are grouped (see below). Use the arg names (A1, A2, etc.) if the recipe is shaped, or numbers if the recipe is shapeless. Grouped args are separated by commas, and groups are separated by semi-colons. For example: <code>A1,B1,A2;C1,Output</code> would make A1, B1 and A2 a group and C1 and Output a group.

If not all frames of an animation is used, any value set in the <code>name</code> or <code>ingredients</code> arguments will be removed.

== Arg groups ==

In order to correctly understand how the animations in a recipe should be displayed, the template needs to know which arguments are related. For example: in the bed recipe, any wood plank and any wool color can be mixed, and they will all produce the same color bed, thus none of them are related. However in the firework star recipe, the dye and the resulting firework star ''are'' related, but the extra ingredient isn't (any extra ingredient can be used with any color of firework star, but the correct dye has to be used to get the correct firework star).

For animations with different amount of frames, the template knows that they are not grouped, because the animation would get out of sync. However, if they have the same amount of frames, the template assumes they are a group. In cases where this isn't true, {{{arggroups}}} should be used.

{{LoadPage|Template:Crafting usage/doc/example|Example}}

<includeonly>
<!-- 模板分类/跨语言链接 -->
[[Category:物品栏模板]]
[[Category:表格模板]]
[[en:Template:Crafting usage]]
</includeonly>
<noinclude>
<!-- 文档分类/跨语言链接 -->
[[en:Template:Crafting Usage/doc]]
</noinclude>