View source for Help:Transclusion and Substitution

== Transclusion ==

=== Basics ===

Transclusion is the inclusion of the content of a document into another document by reference. In the Wikipedian context, it is the use of the template functionality of MediaWiki to include the same content in multiple documents without having to edit those documents separately. Template transclusion is the common way to use template messages, and is implemented by using a template tag, with this form below:

:<pre>{{Template name}}</pre>

It is however possible to do this with ANY page! If the page to be transcluded is in the Main namespace (without any prefixes, like "Category","Talk","Template"), you have to add a Semilcolon (:) before the pagename:

:<pre>{{:Page name}}</pre>

=== Partial Transclusion ===

By using "noinclude", "onlyinclude" and "includeonly" markup, it is possible to transclude part of a page rather than all of it. Such partial transclusions can also be achieved by transcluding from other pages such as subpages. It is often useful not to transclude some information, such as template documentation.

* Text between '''<nowiki><noinclude></nowiki>''' tags '''will not''' be Transcluded, but '''will''' still be visible on the original page.
* Text between '''<nowiki><includeonly></nowiki>''' tags '''will''' be Transcluded, but '''will not''' be visible on the original page.
* Text between '''<nowiki><onlyinclude></nowiki>''' tags '''will''' be Transcluded, but all text '''outside''' the tags '''will not''' be transcluded.


== Substitution ==

Substitution is the one-time copying of any other page's content into the page currently being edited, instead of transcluding the page (usually <nowiki>{{:page name}}</nowiki>). To substitute, add '''subst:''' after the opening braces:

:<pre>{{subst:page name}}</pre>

If you would edit "Page name" after the Substitution, the content on the other page will not be changed (unlike with Transclusion).

''Note: Partial Substitution works the same as Partial Transclusion.''