Help:Transclusion/How Transclusion Works: Difference between revisions

Revision as of 15:32, 15 March 2014

Latest revision as of 08:42, 3 May 2025

(44 intermediate revisions by 31 users not shown)

Line 1:

To '''transclude''' anycontent from a '''source''' page (within a single MediaWiki project, (such as en:English Wikipedia), includeonto thea following''target'' page, use <code><nowiki>{{SOURCEPAGE}}</nowiki></code> in the '''target''' page:'s code.

Whenever <code><nowiki>{{SOURCEPAGE}}</nowiki></code> is included on a target page, the WikiMedia software retrieves and embedes the entire content of <code>SOURCEPAGE</code> (i.e., {{Fake link|Template:SOURCEPAGE}}) at that ___location on the target page.

<code><nowiki>{{SOMEPAGE}}</nowiki></code>

=== Example ===

Whenever the target page '''A''' with this code is rendered, the engine will include ''in that place'' not the code itself, but the entire content of the source page '''B''', SOMEPAGE.

Consider an example, complemented by the illustration below, with target pages '''A''', '''P''', and '''Q''', and source page '''B'''.

If source page '''B''' is transcluded into '''A''', the content from '''B''' (for instance, the word "foo") will appear in place of the <code><nowiki>{{B}}</nowiki></code> code in page '''A'''. When transcluded, this content is not highlighted or boxed on the target page – it is integrated directly into the page's text (highlighted here only for illustration).<div style="margipadding: 0.5em;">[[File:Transclusion-multiple-foo.svg]]</div>

<div style="{{divstylenone}}">

[[File:Transclusion-multiple-foo.svg]]

</div>

=== How it works ===

For example, you might decide to place a welcome message on every newcomer's Talk Page. Transclusion creates a "live" link between the template-page and the target-page(s) upon which the message should appear. When the template is edited, all the target-pages are edited too.

Transclusion creates a 'live' link between a source page and all target pages where its content is transcluded to and used. Editing the source page automatically updates its content on all target pages that include it.

For example, if you create a (template)source page inwith Wikipediadetails withabout youra homeWikimedia mailing addressevent and thentransclude includeit thatonto templatethe nottalk onlypages onof your50 page,editors butyou allwish yourto friends' pagesinvite, too.any Later,updates afteryou movingmake to athe newsource house,page you(such thenas update your address template andchanging the ''new''event address___location) will automaticallyimmediately appearreflect on all your50 friends'talk pages.<noinclude>

[[mk:Википедија:Превметнување/Како работи превметнувањето]]

=== Edit source pages with caution ===

[[pt:Wikipedia:Transclusão/Como a transclusão funciona]]

Edits to a source page can impact all target pages using it. If a source page ''also'' contains its own transclusions from other source pages, avoid changes that may break these links, as this would affect the source page you are editing and all target pages that transclude it. This is known as 'breakage', and it is best to ensure any updates maintain the integrity of transcluded content across all pages. For example, [[Main Page]] is a large page that transcludes its content from multiple embed source pages such as [[Wikipedia:Today's featured list]].

</noinclude>