Help:嵌入包含

本页使用了标题或全文手工转换,现处于不转换模式
帮助页面

嵌入包含transclusion)通常是指将一份文档以链接的形式置入另一份文档之中以作为参考文献。这是MediaWiki的模板功能的实现基础,能够将同样的内容置入多个不同的文档中,若要编辑该内容时不须个别进行编辑。

嵌入包含运作方式

要将任何来源(source)嵌入(transclude)至其他的目标(target)页面中(这里是指在单一的MediaWiki计划中,例如求闻百科),要使用以下代码:

{{某個頁面}}

当包含这段代码的目标页面A在进行运算时,MediaWiki引擎不会将这段代码以文字看待。而会将整个来源页面B(也就是上述代码中的“某個頁面”)的完整内容加入。

如果你需要将一段特定的文字从一个页面复制到另一个页面,使用这个方式,你就不需要不断的进行复制和贴上的动作。例如,你可能决定要在每一个新用户的讨论页张贴欢迎讯息;你就可以用嵌入包含的方式来进行(虽然这不是最好的应用!)。

嵌入包含能够在“模板”页面和目标页面之间建立一个“活”的连结。当模板有所更动时,所有使用它的页面也会随之变动。

例如你可能决定建立一个包含你的住家地址的(模板)页面,并且不只将这个模板用在你的个人页面,也会放置在你所有朋友的页面中。当你把电视和舒服的沙发搬到另一间公寓后,你只需要变更你的地址模板,而这个新的地址会自动在你所有朋友的页面中做出更新。

示例

本页面正是使用了模板的嵌入包含。上方的“嵌入包含运作方式”章节实际上是将“Help:嵌入包含/嵌入包含运作方式”嵌入包含至本页面中。该段落是以参考文献的方式引用至此,使用MediaWiki的语法 {{Help:嵌入包含/嵌入包含运作方式}} 来将该页面嵌入至此。

请注意在主要(条目)名字空间以嵌入包含方式引入其他页面的内容目前还尚有争议。若要将在其他条目内的相关内容加入一个条目中时,建议使用 Template:MainTemplate:Further 模板。

参见