Template:Documentation/doc: Difference between revisions
ArrowHead294 (talk | contribs) mNo edit summary |
ArrowHead294 (talk | contribs) mNo edit summary |
||
Line 19: | Line 19: | ||
On pages consisting of exclusively code (modules, CSS, JS, etc), place this template on the <code>/doc</code> subpage and pass the notes, along with {{tlx|dochead}}, in as the first unnamed parameter: | On pages consisting of exclusively code (modules, CSS, JS, etc), place this template on the <code>/doc</code> subpage and pass the notes, along with {{tlx|dochead}}, in as the first unnamed parameter: | ||
{{escape notice}} | {{escape notice}} Additionally, when {{tlx|lua}} is used on a module documentation page to indicate dependencies, each paragraph of text may need to be encased in its own paragraph (<code><p>)</code> element: | ||
<pre> | <pre> | ||
{{documentation| | {{documentation| | ||
{{dochead}} | {{dochead}} | ||
... | |||
}} | |||
</pre> | |||
<pre> | |||
{{documentation| | |||
{{dochead}}{{lua|...|...|}} | |||
<p>Paragraph 1</p> | |||
<p>Paragraph 2</p> | |||
<p>Paragraph 3</p> | |||
... | ... | ||
}} | }} |
Revision as of 11:52, 19 May 2025
The {{documentation}}
template is used to contain information and instructions for templates and modules. The actual information is located in the /doc
subpage.
Wikipedia's documentation template has modules that help render the dialog boxes, but here the box is hard-coded to simplify things.
Templates
On templates, place {{documentation}}
on the page itself, place the relevant categories afterwards, and enclose them in <noinclude>
tags:
<noinclude> {{documentation}} [[Category: ...]] ... </noinclude>
Modules
On pages consisting of exclusively code (modules, CSS, JS, etc), place this template on the /doc
subpage and pass the notes, along with {{dochead}}
, in as the first unnamed parameter:
Note: Pipe characters (|
) must be escaped as {{!}}
or {{pipe}}
, equals signs must be escaped as {{=}}
(this may apply to tags as well, e.g. <div style{{=}}"…">
), and other special characters and character sequences may need to be escaped accordingly, except for ones inside <nowiki>
, <pre>
, <math>
, and <syntaxhighlight>
tags. Additionally, when {{lua}}
is used on a module documentation page to indicate dependencies, each paragraph of text may need to be encased in its own paragraph (<p>)
element:
{{documentation| {{dochead}} ... }}
{{documentation| {{dochead}}{{lua|...|...|}} <p>Paragraph 1</p> <p>Paragraph 2</p> <p>Paragraph 3</p> ... }}
Wikipedia has Module:Documentation which takes care of things automatically, but here, this is used as a workaround to avoid the need for modules.
See also
- Template:Dochead – used to categorise and add appropriate headers onto documentation pages.