Wordman: Added example

2010-07-22T21:27:53Z

Added example

Wordman: Fix

2010-07-22T21:17:38Z

Fix

Wordman: Defined and explained

2010-07-22T21:13:45Z

Defined and explained

New page

__NOEDITSECTION__{{Header{{{3}}}|{{{2}}}}}
{{:{{{1}}}}}
<noinclude>
== Usage ==

The include template allows you to embed the contents of another wiki page as a section within another page. The template creates a header followed by the contents of a specific page. At the far right of the header, it also creates a small link that sends you to the page being included.

For example, suppose you wanted to include the text of a particular artifact in more than one page, but only wanted to have one "master" copy. You could create the artifact on its own page, such as [[PolarCompass]]. Then, suppose you were building one page for "all my artifacts in alphabetical order" and another page of "all my artifacts by rating".

On the "all my artifacts in alphabetical order" page, you'd just include it, using the following:

<nowiki>{{Include|PolarCompass|Polar Compass|2}}</nowiki>

The order of the arguments matters here:

# <code>Include</code> is the name of the template.
# <code>PolarCompass</code> is the full link to the page.
# <code>Polar Compass</code> is the text you want to display as the header for the included section.
# <code>2</code> is the "level" you want the header. This corresponds to the number of = characters you want to give the header. So, setting this to "2" would be the same as using <code>==Polar Compass==</code> as the header markup, while setting this to "4" would be like using <code>====Polar Compass====</code>. This number can be between 2 and 5, inclusive.

To make this last argument make a bit more sense, take the second example: on the "all my artifacts by rating" page, you would probably have your "level 2" headers be things like <code>==Rating 1==</code>, so you'd want the include artifact to show up under a "level 3" header. Thus:

<nowiki>{{Include|PolarCompass|The Polar Compass|3}}</nowiki>

Note that the "level" setting does absolutely noting to the headers ''in the included page''. Generally speaking, it is better to only use includes on pages that contain no headers at all.

== The <code><nowiki><noinclude></nowiki></code> and <code><nowiki><includeonly></nowiki></code> tags ==

By default, including a page includes ''everything'' on that page (including Category tags). This will often not be exactly what you want. Fortunately, MediaWiki has some special tags that allow you to control what actually gets included.

Any markup surrounded by <code><nowiki><noinclude></nowiki></code> tags will only appear when the page is visited directly, not when it is being included. For example, the comments section in the [[PolarCompass]] page is surrounded by such tags, so that the comments section of that page doesn't get included.

The opposite is the <code><nowiki><includeonly></nowiki></code>, which only shows its contents when the page is included, not when it is accessed directly. In practice, this is used much less often.
</noinclude>

← Older revision		Revision as of 21:27, 22 July 2010
Line 32:		Line 32:

	The opposite is the <code><nowiki><includeonly></nowiki></code>, which only shows its contents when the page is included, not when it is accessed directly. In practice, this is used much less often.		The opposite is the <code><nowiki><includeonly></nowiki></code>, which only shows its contents when the page is included, not when it is accessed directly. In practice, this is used much less often.
		+
		+	== Examples ==
		+
		+	Pages that make use of including are:
		+
		+	*[[MartialArts/PertinaciousAutomatonStyle‎‎]]
	</noinclude>		</noinclude>

@@ Line 1: / Line 1: @@
-__NOEDITSECTION__{{Header{{{3}}}|{{{2}}}}}
+__NOEDITSECTION__{{Header{{{3}}}|{{{1}}}|{{{2}}}}}
 {{:{{{1}}}}}
 <noinclude>

Template:Include - Revision history

Wordman: Added example

Wordman: Fix

Wordman: Defined and explained