Template:Template doc/sandbox
From Wikipedia, the free encyclopedia
 |
{{Template doc}} is merging with {{Documentation}} or {{Documentation, template}}. Merging with {{Documentation}} simplifies the heading and implementation. |
Template documentationThis 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.
[edit] 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:Template doc/Preload (backlinks, edit) is preloaded.
Add categories and interwiki links to the /doc subpage inside <includeonly></includeonly>.
[edit] Advantages
- It allows templates to be protected where necessary, while allowing anyone to edit the documentation.
[edit] 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 "<".
[edit] Template parameter differences
[edit] 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}}
