維基百科:嵌入包含

嵌入包含英語:Transclusion)通常是指將一份文件以鏈接的形式置入另一份文件之中以作為參考文獻。這是MediaWiki的模板功能的實現基礎,能夠將同樣的內容置入多個不同的文件中,若要編輯該內容時不須個別進行編輯。

嵌入包含運作方式

 

要將任何來源(source)嵌入(transclude)至其他的目標(target)頁面中(這裡是指在單一的 MediaWiki 計畫中,例如中文維基百科),要使用以下代碼:

{{某個頁面}}

當包含這段代碼的目標頁面 A 在進行運算時,MediaWiki 引擎不會將這段代碼以文字看待。而會將整個來源頁面 B(也就是上述代碼中的「某個頁面」)的完整內容加入。

 

如果你需要將一段特定的文字從一個頁面複製到另一個頁面,使用這個方式,你就不需要不斷的進行複製和貼上的動作。例如,你可能決定要在每一個維基新人的討論頁張貼歡迎訊息;你就可以用嵌入包含的方式來進行(雖然這不是最好的應用!)。

嵌入包含能夠在「模板」頁面和目標頁面之間建立一個「活」的連結。當模板有所更動時,所有使用它的頁面也會隨之變動。

例如你可能決定建立一個包含你的住家地址的(模板)頁面,並且不只將這個模板用在你的個人頁面,也會放置在你所有朋友的頁面中。當你把電視和舒服的沙發搬到另一間公寓後,你只需要變更你的地址模板,而這個新的地址會自動在你所有朋友的頁面中做出更新。

範例

本頁面正是使用了模板的嵌入包含。上方的「嵌入包含運作方式」章節實際上是將「Wikipedia:嵌入包含/嵌入包含運作方式」嵌入包含至本頁面中。該段落是以參考文獻的方式引用至此,使用 MediaWiki 的語法 {{Wikipedia:嵌入包含/嵌入包含運作方式}} 來將該頁面嵌入至此。

請注意在主要(條目)名字空間以嵌入包含方式引入其他頁面的內容目前還是一個討論中的議題(請參見下方段落的連結)。若要將在其他條目內的相關內容加入一個條目中時,建議使用 Template:MainTemplate:Further 模板。

MediaWiki 嵌入包含相關的頁面

模板

參見