维基百科:嵌入包含
此维基百科页面需要更新。 (2023年1月25日) |
嵌入包含(transclusion)通常是指将一份文档以链接的形式置入另一份文档之中以作为参考文献。这是MediaWiki的模板功能的实现基础,能够将同样的内容置入多个不同的文件中,若要编辑该内容时不须个别进行编辑。
嵌入包含运作方式
要将任何来源(source)嵌入(transclude)至其他的目标(target)页面中(这里是指在单一的 MediaWiki 计划中,例如中文维基百科),要使用以下代码:
{{某個頁面}}
当包含这段代码的目标页面 A 在进行运算时,MediaWiki 引擎不会将这段代码以文字看待。而会将整个来源页面 B(也就是上述代码中的“某個頁面”)的完整内容加入。
如果你需要将一段特定的文字从一个页面复制到另一个页面,使用这个方式,你就不需要不断的进行复制和贴上的动作。例如,你可能决定要在每一个维基新人的讨论页张贴欢迎讯息;你就可以用嵌入包含的方式来进行(虽然这不是最好的应用!)。
嵌入包含能够在“模板”页面和目标页面之间建立一个“活”的连结。当模板有所更动时,所有使用它的页面也会随之变动。
例如你可能决定建立一个包含你的住家地址的(模板)页面,并且不只将这个模板用在你的个人页面,也会放置在你所有朋友的页面中。当你把电视和舒服的沙发搬到另一间公寓后,你只需要变更你的地址模板,而这个新的地址会自动在你所有朋友的页面中做出更新。
范例
本页面正是使用了模板的嵌入包含。上方的“嵌入包含运作方式”章节实际上是将“Wikipedia:嵌入包含/嵌入包含运作方式”嵌入包含至本页面中。该段落是以参考文献的方式引用至此,使用 MediaWiki 的语法 {{Wikipedia:嵌入包含/嵌入包含運作方式}} 来将该页面嵌入至此。
请注意在主要(条目)名字空间以嵌入包含方式引入其他页面的内容目前还是一个讨论中的议题(请参见下方段落的连结)。若要将在其他条目内的相关内容加入一个条目中时,建议使用 Template:Main 或 Template:Further 模板。
模板
参见
- 让来自维基共享资源的模板能嵌入包含的要求(跨维基模板以及其他)(英文)
- Help:替换引用(Substitution,与嵌入包含相反的应用。此方式能够将引用的内容固定下来,不随模板的更新而变化。)