檢視Template:嵌入片段/doc的原始碼



== 简介 ==

该模板用于将一个页面中的部分代码作为“模板”嵌入到其他页面，通常是一些重复的信息（如音乐条目的专辑信息等），以达到精简代码、方便修改的目的。

[[Template:Embed]]也重定向于此模板。

== 用法 ==

1. 在被嵌入的页面中将要嵌入的代码使用<code><nowiki><!-- embed:id --> 内容... <!-- embed-end:id --></nowiki></code>包裹起来，如果页面中只有一处需要被嵌入的地方，也可以省略id，直接这样书写：<code><nowiki><!-- embed --> 内容... <!-- embed-end --></nowiki></code>。<code><nowiki><!--  --></nowiki></code>是HTML文档中的注释标签，它不会显示在要展示的内容中。

2. 在要调用的页面使用如下代码嵌入
<pre>
{{嵌入片段
|page = <!-- 要嵌入的代码所在的页面，自动处理重定向 -->
|id = <!-- 在那个页面设置的id，若省略将使用页面中第一处被标记为embed的地方 -->
}}
</pre>

一个页面中可以设置多个代码片段，根据id来区别进行调用。

'''在使用时请务必注意预览界面的最下方，“分析器解析数据”表格中的“展开后”大小一栏。因为内容都是由模板生成的，当载入大量内容时极有可能超出限制，导致后续的其他模板都无法正常载入（表现为只显示一个指向那个模板的链接）。'''

可以传参，在要嵌入的代码中设置参数的写法与一般模板相同，注意不要将参数名设置为“page”或“id”。

传递参数直接在模板后面传入即可，例如：

假设在页面A有如下代码（内容）：
<pre>
其他内容...
<!-- embed:test -->
姓名：{{{1|Alice}}}            <!-- 注意这里，为了在原页面可以正常显示，请始终在后面设置一个默认值 -->
年龄：{{{age|16}}}
<!-- embed-end:test -->
其他内容...
</pre>
在页面B进行嵌入：
<pre>
{{嵌入片段|page=A|id=test|Lee|age=17}}
</pre>

== 示例 ==
以下内容来自页面：[[不停歇的进行曲]] 中的代码片段。

{{#tag:pre|
{{CollectCodeData
|pages=不停歇的进行曲
|ptns=/<!%-%- embed:album %-%-%>.-<!%-%- embed%-end:album %-%->/
}}
}}
在这个页面使用的代码：
<pre>
{{嵌入片段|page=不停歇的进行曲}}
</pre>
效果：
{{嵌入片段|page=不停歇的进行曲}}
<includeonly>[[分类:功能模板]]</includeonly>
<noinclude>[[Category:模板文档]]</noinclude>