LIMSWiki:Transclusion - Revision history

Shawndouglas: Added notes about limitations

2015-12-03T19:02:22Z

Added notes about limitations

← Older revision		Revision as of 19:02, 3 December 2015
Line 179:		Line 179:

	For additional help, see the MediaWiki page [[mediawikiwiki:Manual:$wgEnableScaryTranscluding\|Manual:$wgEnableScaryTranscluding]].		For additional help, see the MediaWiki page [[mediawikiwiki:Manual:$wgEnableScaryTranscluding\|Manual:$wgEnableScaryTranscluding]].
			<br />

	~~<br />~~
	==Interwiki linking==		==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.		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.
Line 193:		Line 193:

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

			==Transclusion and associated limitations on wiki/interwiki functions==
			Transclusion is definitely a useful tool, as noted in the above documentation. However, using transclusion on this and other related wikis has an unintended side effect that must be pointed out, specifically with how PDFs on the wiki and on Pediapress are rendered.

			===Interwiki transclusion of transcluded content can't be properly printed to PDF===
			We call this the ol' "transclusion of a transclusion" problem. Specifically, problems arise when taking content from one wiki that is itself intrawiki transcluded and attempt to use interwiki transclusion to place it in another wiki. For example, Wiki X's page titled "Widget A" has text from another Wiki X page titled "History of Widget A" transcluded to it. Then the "Widget A" page is interwiki transcluded to Wiki Y. The problem isn't that the "Widget A" page material won't show up properly on Wiki Y, because it does in fact appear there in total without issue. The problem is specifically with the [https://www.mediawiki.org/wiki/Extension:Collection MediaWiki Collection extension], which allows users to create books and download wiki content in PDF format. If you interwiki transclude content that includes intrawiki transcluded content, the PDF generated on the wiki and on Pediapress will be incomplete because the extension is ''not'' designed to be able to drill down that far. Avoid interwiki transclusion of a transclusion if you must be able to generate a PDF/Pediapress copy of the interwiki transcluded page.

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

Shawndouglas: Updated with information about Labeled Section Transclusion

2015-11-06T19:42:07Z

Updated with information about Labeled Section Transclusion

← Older revision		Revision as of 19:42, 6 November 2015
Line 13:		Line 13:
	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.		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.

			<br />
	==Usage==		==Usage==

Line 76:		Line 77:
	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.		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.

			<br />
			==Labeled Section Transclusion==
			{{As of\|November 2015}}, the [[mediawikiwiki:Extension:Labeled Section Transclusion\|Labeled Section Transclusion]] extension has been added to LIMSwiki. This means that one or more designated sections of a LIMSwiki page can be transcluded into another LIMSwiki page. Note, however, that this currently doesn't work with interwiki transcluded content. (See [[LIMSWiki:Transclusion#Interwiki transclusion\|the interwiki transclusion section]] below for more.)

			===How it works - By section tag===
			====Step 1: Mark off sections====
			Mark off sections in the text using <nowiki><section></nowiki> tags like this:

			<nowiki><section begin=chapter1 /><translate>this is a chapter</translate><section end=chapter1 /></nowiki>

			Note that this uses two individual markers, rather than normal XML open/close tags, which simplifies nested or overlapping sections. This allows you to insert section tags without worrying about interfering with other sections.

			====Step 2a: Transclude the section====
			Call the parser function ''#lst'' to transclude it, i.e. to transclude a section called ''chapter1'' from a page called ''articleX'':

			<nowiki>{{#lst:articleX\|chapter1}}</nowiki>

			The target article defines the location of the section; its behavior is determined by the parser function.

			====Step 2b: Transclude the page but excluding the section====
			To transclude a page, but exclude a specified section, use the ''#lstx'' function:

			<nowiki>{{#lstx:articleX\|chapter1}}</nowiki>

			Optionally, you may add replacement text to the excluded section.

			<nowiki>{{#lstx:articleX\|chapter1\|replacement_text}}</nowiki>

			Example:

			<nowiki>{{#lstx:articleX\|chapter1\|See chapter 1 in [[articleX]].}}</nowiki>

			The replacement text will appear in the area where the section is skipped (excluded).

			===How it works - By headings===
			There is optional support for transcluding sections of text marked with the normal headings, i.e. <code>==this section==</code>. If installed, this is done with the ''lsth'' function.

			====Transclude the introduction====
			To transclude the introduction of a page (i.e. the content before the first heading), use

			<nowiki>{{#lsth:pagename}}</nowiki>

			====Transclude a specific section====
			You can also transclude the whole content of the <tvar\|section1>''sectionX''</> (which includes all its sub-sections but excludes the heading of <tvar\|section2>''sectionX''</> itself).

			<nowiki>{{#lsth:pagename\|sectionX}}</nowiki>

			Things to note:
			# Only the first occurrence of the ''sectionX'' is transcluded if you have more than one section with the same name.
			# Make sure you type what the heading of ''sectionX'' is <u>in wiki code</u>, not how it is displayed. For example if the heading of the section is <code><nowiki>==List of [[Extension]]==</nowiki></code>, you should type "<code><nowiki>List of [[Extension]]</nowiki></code>" not "<code><nowiki>List of Extension</nowiki></code>".
			# The matching is case '''in'''sensitive, to prevent links from breaking due to case changes.

			====Transclude multiple sections====
			You can also transclude from the first occurrence of ''sectionX'' (excluding the heading of ''sectionX'' itself) until it reaches the next occurrence of ''sectionY''. Note that ''sectionY'' acts as a stop point so the transclusion doesn't contain the content of ''sectionY''.

			<nowiki>{{#lsth:pagename\|sectionX\|sectionY}}</nowiki>

			===Notes about the extension===
			The following are considerations concerning this extension. For the complete documentation, see the [[mediawikiwiki:Extension:Labeled Section Transclusion\|Labeled Section Transclusion]] page on MediaWiki.

			====Discontiguous sections====
			It is possible to have multiple sections with the same name; in this case, every section with that name will be included/excluded. This is especially useful to mark various discussions.

			====Section ranges====
			These functions have an additional, optional argument to specify a section range; i.e. <nowiki>{{#lst:articleX\|chapter1\|chapter3}}</nowiki>, to include everything from the beginning of chapter 1 to the end of chapter 3. This allows using empty marker pairs to mark one end of the section, possibly in a template. A similar mechanism is currently used at the French Wikisource.

			====Substitution====
			This also works with substitution; it's even possible for an article to substitute a section of itself. One use of this provides a neat way to archive talk pages: Mark the text to be archived using <nowiki><section begin=archive /></nowiki>, etc. Then create an archive page with the text, using <nowiki>{{subst:#lst:talk_page\|archive}}</nowiki>, which copies archived sections. Lastly, replace the contents of talk_page with <nowiki>{{subst:#lstx:talk_page\|archive}}</nowiki> to remove those sections.

			====Limitations====
			* While it is possible to use this extension across namespaces, [[mediawikiwiki:Manual:$wgEnableScaryTranscluding\|interwiki references]] are not resolved. It is not yet possible, for example, to include part of a Wikipage page into a remote MediaWiki installation.
			* Section tags cannot themselves be transcluded in order to work on other pages. This means, for instance, that these tags cannot be embedded in a template using [[mediawikiwiki:Help:Templates#Parameters\|template parameters]] and [[mediawikiwiki:Parser functions\|parser functions]]. The <code>#tag</code> magic word does not work with section tags. <code>#tag</code> produces balanced tags, while the section tags uses singular tags. See [https://phabricator.wikimedia.org/T39256 T39256].
			* As of 2014, section tags don't have any effect when used inside a template parameter. If page A contains a text <nowiki>{{B\|X}}</nowiki>, there's no way <nowiki>{{#lst:A\|...}}</nowiki> can access X.

			<br />
	==Interwiki transclusion==		==Interwiki transclusion==

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

			<br />
	==Interwiki linking==		==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.		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.

Shawndouglas: /* Interwiki linking */ Fixed

2015-04-06T18:29:30Z

Interwiki linking: Fixed

← Older revision		Revision as of 18:29, 6 April 2015
Line 111:		Line 111:
	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]].		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 2''': <code><nowiki>[[lablynxwiki:ELab\|ELab]]</nowiki></code> will yield [[lablynxwiki:ELab\|ELab]].

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

Shawndouglas: Created as needed.

2015-04-06T18:27:43Z

Created as needed.

New page

'''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></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]].


[[Category:LIMSwiki help documentation]]