此維基百科頁面需要更新。 (2023年1月25日) |
嵌入包含(transclusion)通常是指將一份文档以链接的形式置入另一份文档之中以作為參考文獻。这是MediaWiki的模板功能的实现基础,能夠將同樣的內容置入多個不同的文件中,若要編輯該內容時不須個別進行編輯。
嵌入包含運作方式
要將任何來源(source)嵌入(transclude)至其他的目標(target)頁面中(這裡是指在單一的 MediaWiki 計畫中,例如中文維基百科),要使用以下代碼:
{{某個頁面}}
當包含這段代碼的目標頁面 A 在進行運算時,MediaWiki 引擎不會將這段代碼以文字看待。而會將整個來源頁面 B(也就是上述代碼中的「某個頁面」)的完整內容加入。
如果你需要將一段特定的文字從一個頁面複製到另一個頁面,使用這個方式,你就不需要不斷的進行複製和貼上的動作。例如,你可能決定要在每一個維基新人的討論頁張貼歡迎訊息;你就可以用嵌入包含的方式來進行(雖然這不是最好的應用!)。
嵌入包含能夠在「模板」頁面和目標頁面之間建立一個「活」的連結。當模板有所更動時,所有使用它的頁面也會隨之變動。
例如你可能決定建立一個包含你的住家地址的(模板)頁面,並且不只將這個模板用在你的個人頁面,也會放置在你所有朋友的頁面中。當你把電視和舒服的沙發搬到另一間公寓後,你只需要變更你的地址模板,而這個新的地址會自動在你所有朋友的頁面中做出更新。
範例
本頁面正是使用了模板的嵌入包含。上方的「嵌入包含運作方式」章節實際上是將「Wikipedia:嵌入包含/嵌入包含運作方式」嵌入包含至本頁面中。該段落是以參考文獻的方式引用至此,使用 MediaWiki 的語法 {{Wikipedia:嵌入包含/嵌入包含運作方式}} 來將該頁面嵌入至此。
請注意在主要(條目)名字空間以嵌入包含方式引入其他頁面的內容目前還是一個討論中的議題(請參見下方段落的連結)。若要將在其他條目內的相關內容加入一個條目中時,建議使用 Template:Main 或 Template:Further 模板。
模板
參見
- 讓來自維基共享資源的模板能嵌入包含的要求(跨維基模板以及其他)(英文)
- Help:替換引用(Substitution,與嵌入包含相反的應用。此方式能夠將引用的內容固定下來,不隨模板的更新而變化。)