සැකිල්ල:Template doc/doc

This is a documentation subpage for සැකිල්ල:Template doc (see that page for the සැකිල්ල itself).
It contains usage information, categories and other content that is not part of the original සැකිල්ල page.

This template is kept temporarily until pages are converted to the merged and improved {{Documentation, template}}.

Note differences in usage mean it cannot be redirected. See Template parameter differences below.

This template displays a "Template documentation" box just like you are seeing now.

Usage

Add to the main template at the end of the template code:

[--last line of your template code--]<noinclude>
 <!--
     PLEASE DO NOT ADD DOCUMENTATION/CATEGORIES/INTERWIKIS HERE
 -->
 {{Template doc}}
 <!--
     MAKE ADDITIONS TO THE /doc SUBPAGE INSTEAD, THANKS
 -->
 </noinclude>

or with a parameter: 1 = name of the documentation page.

Make sure the opening <noinclude> begins on the same line as the last character of the template code (or text), and not on a new line. Otherwise, extra space will be inserted below the template when it is used, which is usually not wanted.

If the template is already protected, ask an administrator to do this, or request an edit by using {{editprotected}} on the template’s talk page. If documentation, categories and interwiki links already exist in a section enclosed within a <nowiki> element, move them into the documentation subpage, as it is best not to have documentation split across two separate pages.

Click the "edit" link, which points to the /doc subpage, and write documentation there. If the /doc page does not exist yet සැකිල්ල:Template doc/Preload (සාකච්ඡාව, backlinks, සාකච්ඡාව) is preloaded.

Add categories and interwiki links to the /doc subpage inside <includeonly></includeonly>.

Advantages

It allows templates to be protected where necessary, while allowing anyone to edit the documentation.
Text on the template page itself adds to the amount of text which must be processed when displaying the template, which is limited for performance reasons: there is a pre-expand include size maximum of 2,048,000 bytes. Placing the documentation in a subpage avoids this (MediaWiki developers have recommended it for this reason).

Limitation

A pipe character in the documentation page which is not inside double or triple braces or double brackets disturbs proper functioning of this template, because the content of that page is assigned to a template parameter. Use | instead.

If the documentation contains includeonly or noinclude tags within nowiki tags, replace the "<" with "<".

Template parameter differences

Parameter for /doc path

{{Template doc}} uses 1={{PAGENAME}}

and then transcluded

{{Template doc inline}} using

1={{ {{SUBJECTSPACE}}:{{{1}}} }}

2={{SUBJECTSPACE}}:{{{1}}}

{{Documentation}} uses 1={{FULLPAGENAME}}
{{Documentation, template}} uses 1={{FULLPAGENAME}}
{{Template doc inline}} uses 2={{FULLPAGENAME}}

සැකිල්ල:Template doc/doc

Usage

Advantages

Limitation

Template parameter differences

Parameter for /doc path

See also

{{ Documentation }} family

{{ Template doc }} family

Meta Wiki {{ Documentation }} ancestor