View source for LIMSWiki:Transclusion

'''Transclusion''' is the process of including the content of one document in another document by reference. It differs from [[LIMSWiki:Substitution|substitution]], which is a one-time, permanent copying of any content.  

When transcluding on LIMSwiki, the MediaWiki software will refer to the content of one page, the template, for inclusion into the content of any other page, the target page. Similar to the way any page name can become a link by placing its name in double square brackets, any page name can become a template by placing it in double curly braces, '''<tt><nowiki>{{</nowiki>''Namespace'':''Pagename''}}</tt>'''. Changes made to the template are then automatically reflected on all pages into which that page has been transcluded (though a [[Template:Purge|purge]] may sometimes be necessary).

If the template's page name does not begin with a namespace, it is assumed to be in the Template namespace. To refer to a page in the "Main" (article) namespace, it is necessary to prefix it with a colon (''':'''). Examples:
* '''<tt><nowiki>{{Purge}}</nowiki></tt>''' will transclude from the page [[:Template:Purge]] ({{Purge}})
* '''<tt><nowiki>{{Saved book}}</nowiki></tt>''' will transclude from the page [[:Template:Saved book]]
* '''<tt><nowiki>{{:ELab}}</nowiki></tt>''' will transclude from the page [[ELab]] (in the Main namespace)
* '''<tt><nowiki>{{LIMSWiki:Books}}</nowiki></tt>''' will transclude from the page [[LIMSWiki:Books]]

What will transclude from a page can be controlled with the tags <nowiki><noinclude>, <onlyinclude> and <includeonly></nowiki> placed in the source page wikitext. The use of tags enables the template to transclude partially, otherwise the double curly braces will always transclude all content.  For ''selective'' transclusion the <nowiki><includeonly></nowiki> parts of the template are named (with the help of parser functions) and that template is then called with the parameter <tt>transcludesection=''name''</tt>.

Transclusion events occur every time the page is ''loaded'', when the template is rendered. Another use of the same mechanism is a one-shot ''[[LIMSWiki:Substitution|substitution]]'' of the template call itself with its transcluded source page.  A template call <tt><nowiki>{{</nowiki>''fullpagename''}}</tt> with the "subst:" prefix <tt><nowiki>{{</nowiki>subst:''fullpagename''}}</tt> is transcluded once but never again, because the wikitext of that call is replaced (substituted) when its page is ''saved''.  What was a one-time template call becomes the actual wikitext of the template at the time of its call.

==Usage==

The basic syntax for transclusion on LIMSwiki is <code><nowiki>{{</nowiki>Namespace:Pagename<nowiki>}}</nowiki></code>, where <code>Namespace:Pagename</code> describes the title of a LIMSwiki page. 

On LIMSwiki, non-article pages have titles with a visible Namespace and Pagename. But encyclopedic articles only have a visible Pagename in their titles: for example, the article [[ELab]] has <code>ELab</code> as the Pagename; the Namespace, called Main Namespace, is not visible.

*Having the wikitext <code><nowiki>{{</nowiki>Namespace:Pagename<nowiki>}}</nowiki></code> in a page, will transclude the page titled <code><nowiki>Namespace:Pagename</nowiki></code> into that page. For example, if a page has the wiki markup <code><nowiki>{{</nowiki>LIMSWiki:Vandalism<nowiki>}}</nowiki></code> in it, it will transclude the page [[LIMSWiki:Vandalism]] into it.

*If the namespace is omitted, but the colon is included, like <code><nowiki>{{</nowiki>:Pagename<nowiki>}}</nowiki></code>, the encyclopedic article <code>Pagename</code> will be transcluded. For example, <code><nowiki>{{</nowiki>:ELab<nowiki>}}</nowiki></code> will transclude the article [[ELab]].

*If both namepace and colon are omitted, like <code><nowiki>{{</nowiki>Pagename<nowiki>}}</nowiki></code>, the <code>Template:Pagename</code> will be transcluded. For example, <code><nowiki>{{</nowiki>Purge<nowiki>}}</nowiki></code>, and also <code><nowiki>{{</nowiki>Template:Purge<nowiki>}}</nowiki></code>, will both transclude [[Template:Purge]].

*For transcluding subpages, the general syntax is <code><nowiki>{{Namespace:Pagename/subpagename}}</nowiki></code>. If it is a subpage of the page you are editing, then it is the general syntax, or <code><nowiki>{{/subpagename}}</nowiki></code>. For an encyclopedic article it is <code><nowiki>{{:Pagename/subpagename}}</nowiki></code>, although article subpages are normally disabled. For a template, it is the general syntax, or <code><nowiki>{{Pagename/subpagename}}</nowiki></code>. Note that subpages can only allowed in certain namespaces, such as User, Talk or LIMSwiki pages.

===Partial transclusion===
By using <nowiki><noinclude>, <onlyinclude> and <includeonly></nowiki> markup, it is possible to transclude ''part'' of a page, rather than all of it. Such partial transclusions can be achieved by transcluding from any pages, including subpages. It is often useful not to transclude some of a page, an example being with template documentation. 

For a Wikipedia-based example of how this technique can be applied to simplify the creation of summary articles, see how part of [[wikipedia:History of pathology|History of pathology]] (see the diff [http://en.wikipedia.org/w/index.php?title=History_of_pathology&diff=prev&oldid=207668817 here]) was transcluded into [[wikipedia:Pathology|Pathology]] (see the diff [http://en.wikipedia.org/w/index.php?title=Pathology&diff=prev&oldid=207669487 here]) using the <code><nowiki>{{:History of pathology}}</nowiki></code> markup. The Pathology article at that time (see [https://en.wikipedia.org/w/index.php?title=Pathology&oldid=207669487 here]) mainly consisted of transcluded lead paragraphs and other sections from a number of articles. Look at the source to see how this was done. (Since then, the Pathology article has been rewritten, and does not include all these transclusions.)

====Markup====
In transclusion, a source page is transcluded into a destination page. But with partial transclusion, only part of that source page will be transcluded into a destination page. But in addition, what is transcluded to a destination page does not have to be visible on the source page.

''Page rendering'' of a source page can be defined as the rendering of that source page when it is saved, which will be the same as the preview.  We can call this rendering '''''here'''''.

''Transclusion rendering'' of a source page can be defined as the rendering of a destination page that has a source page transcluded into it; but only that part of the destination page that was transcluded from the source page. The preview of the transclusion rendering will again be identical. We can call this rendering '''''there'''''.

There are three pairs of tags involved in cases where page rendering ''here'' should differ from transclusion rendering ''there''. As described earlier, these are <nowiki><noinclude>, <includeonly> and <onlyinclude></nowiki>. These tags are invisible, but affect both page rendering ''here'' and transclusion rendering ''there''. These tags pair-off to demarcate sections that will create differences. Each tag will describe exceptions to transcluding the whole page named.

<pre style="white-space:-moz-pre-wrap; white-space:-pre-wrap; white-space:-o-pre-wrap; white-space:pre-wrap; word-wrap:break-word;">
<noinclude>This section is visible here; but this section is not visible there. Sections outside of these tags will be visible both here and there.</noinclude>

<onlyinclude>This section is visible here; this section is also visible there. Sections outside of these tags will be visible here, but will not be visible there.</onlyinclude> 

<includeonly>This section is not visible here; but it is visible there. Sections outside of these tags will be visible both here and there.</includeonly></pre>
{| class="wikitable" style="text-align: center;"
! Wikitext
! What it rendered ''here'' (source page)
! What is transcluded ''there'' (destination page)
|-
|<code><nowiki><noinclude> text1 </noinclude> text2</nowiki></code> 
|<code>text1 text2</code>
|<code>text2</code>
|-
|<code><nowiki><onlyinclude> text1 </onlyinclude> text2</nowiki></code> 
|<code>text1 text2</code>
|<code>text1</code>
|-
|<code><nowiki><includeonly> text1 </includeonly> text2</nowiki></code>
|<code>text2</code>
|<code>text1 text2</code>
|}
An important point to note is that <nowiki><noinclude></nowiki> and <nowiki><onlyinclude></nowiki> do not affect at all what is page rendered ''here'' at all, unlike <nowiki><includeonly></nowiki>. The <nowiki><noinclude></nowiki> tags stops text inside the tags being transcluded ''there'', while <nowiki><onlyinclude></nowiki> has the opposite effect: it stops text outside of the tags from being transcluded ''there''.

Only <nowiki><includeonly></nowiki> stops text from being page rendered ''here''. But naturally enough it is transcluded ''there''. Text outside of the tags will both be rendered ''here'' and transcluded ''there''.

There can be several such sections. Also, they can be nested. All possible differences between ''here'' and ''there'' are achievable. One example is a content editor who picks an <nowiki><onlyinclude></nowiki> section, and then takes a <nowiki><noinclude></nowiki> section out of that; but then picks out yet another <nowiki><onlyinclude></nowiki> section to append to ''there''; but none of this affects their article in any way.
 
The other example is the template programmer, who will <nowiki><includeonly></nowiki> the code section and <nowiki><noinclude></nowiki> the documentation section of a page. 

A mis-example is, on a the user page, to use <nowiki><includeonly></nowiki> to "comment out" a section. While it might comment out sections ''here'', such invisible ink may prove to be troublesome; if transcluded, the comments would be revealed. Use <nowiki><!-- and --></nowiki> instead.

NoInclude as a name about transcluding is pretty straightforward. A mnemonic for the other two transclusions ''there'' is: Inclusion''ONLY''; and ''Yet Another ONLY''Inclusion.

==Interwiki transclusion==

Interwiki transclusion — sometimes known as scary transclusion — is the process of including the content of a page on a separate wiki in this wiki by reference.

When using interwiki transclusion on LIMSwiki, the MediaWiki software will refer to the content of one page or template on another wiki and attempt to render it in your wiki page. This functionality becomes available by enabling both <code>$wgEnableScaryTranscluding</code> and the <code>iw_trans</code> bit in the [[Special:MyLanguage/Interwiki table|interwiki table]]. Once enabled, several options become available for interwiki transclusion.

===Pure transclusion===
On LIMSwiki, most of the time you'll use pure transclusion. With this type of transclusion you'll be transcluding the foreign wiki ''page content'' to your wiki, not the wikicode of templates, etc. If you use pure transclusion to transclude a template, for example, you will see the documentation, if any, but the template will not function; it will be as if you were viewing the template page on the foreign wiki. Wikilinks on the transcluded page will appear to be blue links but will link to locations on the foreign wiki. 

To use pure transclusion for a wiki page: <code>{{wiki::main namespace page name}}</code> e.g. <nowiki>{{wikipedia::Biology}}</nowiki>

To use pure transclusion for a wiki template: <code>{{wiki:template name}}</code> e.g. <nowiki>{{wikipedia:Purge}}</nowiki>

Note two things:

1. Purely transcluding a wiki page requires '''two''' colons while purely transcluding a template (which you probably don't want to do unless you need the documentation) only requires one.

2. Names of available wikis that can be transcluded from can be found in the "Prefix" column of the [[Special:Interwiki]] page.

For additional help, see the MediaWiki page [[mediawikiwiki:Manual:$wgEnableScaryTranscluding|Manual:$wgEnableScaryTranscluding]].

===Other methods===
On rare occasions a wiki you want to transclude from has custom templates affecting the page, and those templates are not available on LIMSwiki. In this case, you can try raw transclusion and see if the results are acceptable. Raw transclusion expands all templates on the foreign page as if they come from your wiki instead of the other wiki. This will display the results of the wikicode on your wiki. Templates function to the extent required pages exist locally: i.e. where the template displays a link that doesn't exist on the local wiki, the link will be red; where the template includes other templates nested within its code, local templates by those names will be called, and unless the required templates exist in the required form, the template will be broken. 

However, this will also have the result of wikilinks on the transcluded page appearing to be red if a corresponding page isn't found on the target wiki. Therefor, this is typically not a good solution. It's often better to attempt to manually add templates from the foreign wiki and then use pure transclusion.

For additional help, see the MediaWiki page [[mediawikiwiki:Manual:$wgEnableScaryTranscluding|Manual:$wgEnableScaryTranscluding]].

==Interwiki linking==
Though not technically transclusion, interwiki linking is included here anyway as it's somewhat related. Interwiki linking is the process of placing a link to another foreign wiki page within a local wiki page using internal wikilink formatting. nterwiki links are hosted in the [[mediawikiwiki:Manual:Interwiki table|interwiki table]] of the Mediawiki database. Names of available wikis that can be transcluded from can be found in the "Prefix" column of the [[Special:Interwiki]] page. Choose a wiki name from the "Prefix" column and append it to a pagename on that wiki using internal link formatting.

'''Example 1''': <code><nowiki>[[mediawikiwiki:Manual:Interwiki table]]</nowiki></code> will create an internal link that goes to the page "Manual:Interwiki table" on the MediaWiki wiki site. Note, however, this will result in showing the wiki prefix as well: [[mediawikiwiki:Manual:Interwiki table]]

To avoid this, also add a pipe (|) and the display text you want to appear, e.g. <code><nowiki>[[mediawikiwiki:Manual:Interwiki table|interwiki table]]</nowiki></code> will yield [[mediawikiwiki:Manual:Interwiki table|interwiki table]].

'''Example 2''': <code><nowiki>[[limswiki:Health informatics|health informatics]]</nowiki></code> will yield [[limswiki:Health informatics|health informatics]].

'''Example 3''': <code><nowiki>[[wikipedia:Template:Purge|purge template on Wikipedia]]</nowiki></code> will yield [[wikipedia:Template:Purge|purge template on Wikipedia]].

For additional help, see the MediaWiki page [[mediawikiwiki:Manual:Interwiki|Manual:Interwiki]].

<!---Place all category tags here-->
[[Category:LIMSwiki help documentation]]