心百科:嵌入包含

搬运说明：本页内容源自维基百科，并根据心百科自身需要进行了适当修改。

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

嵌入包含运作方式

模板语法

如果来源页面为条目名字空间（Main，例如“心理学”），你必须在条目名称前加上一个半形冒号（:），例如 {{:心理学}}，没必要请不要使用这种来源页面，否则会造成不必要的混乱。

如果来源页面为模板名字空间（Template，例如模板:Documentation），只要直接使用名称就可以，例如 {{Documentation}}。

如果来源页面为其他的名字空间（例如 User:Example），你必须使用完整的名称，包含名字空间，例如 {{User:Example}}。

要将任何来源（source）嵌入（transclude）至其他的目标（target）页面中（这里是指在单一的 MediaWiki 计划中，例如中文维基百科），要使用以下代码：

{{某个页面}}

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

如果你需要将一段特定的文字从一个页面复制到另一个页面，使用这个方式，你就不需要不断地进行复制和粘贴的动作。例如，你可能决定要在每一个维基新人的讨论页张贴欢迎讯息；你就可以用嵌入包含的方式来进行（虽然这不是最好的应用！）。

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

例如你可能决定建立一个包含你的住家地址的（模板）页面，并且不只将这个模板用在你的个人页面，也会放置在你所有朋友的页面中。当你把住所搬到另外的地方，你只需要变更你的地址模板，而这个新的地址会自动在你所有朋友的页面中做出更新。

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

请注意在主要（条目）名字空间以嵌入包含方式引入其他页面的内容目前还是一个讨论中的议题（请参见下方段落的连结）。若要将在其他条目内的相关内容加入一个条目中时，建议使用 Template:Main 或 Template:Further 模板。