Template:Dochead/doc: Difference between revisions

From Xenharmonic Wiki
Jump to navigation Jump to search
ArrowHead294 (talk | contribs)
No edit summary
ArrowHead294 (talk | contribs)
mNo edit summary
Line 2: Line 2:
This template automatically inserts the default documentation header:
This template automatically inserts the default documentation header:


: {| style="margin: 15px 0px 15px 0px; width: 95%;"
: {| style="background-color: #f8f9fa; border: 1px solid #eaecf0; margin: 15px 0px 15px 0px; width: 95%;"
| <hr /><span style="font-size: 0.75em;">Documentation transcluded from [[/doc]]</span>
| <hr /><span style="font-size: 0.75em;">Documentation transcluded from [[/doc]]</span>
|}
|}
Line 17: Line 17:
On modules, unless <code>header=none</code> is passed, a header will appear which points to the template invoked:
On modules, unless <code>header=none</code> is passed, a header will appear which points to the template invoked:


: '''Note:''' Do not invoke this module directly. Use the corresponding template instead: [[Template:{{ROOTPAGENAME}}]].
: {| style="background-color: #f8f9fa; border: 1px solid #eaecf0; width: 95%;"
| '''Note:''' Do not invoke this module directly. Use the corresponding template instead: [[Template:{{ROOTPAGENAME}}]].
|}


The linked template can be changed by passing <code>temp=</code> followed by the name of the template.
The linked template can be changed by passing <code>temp=</code> followed by the name of the template.

Revision as of 19:38, 10 July 2024

This template automatically inserts the default documentation header:


Documentation transcluded from /doc

onto the main pages for certain items (mostly templates and modules), while also providing a link to the documentation subpage.

The header is wrapped in a <span> element so it can be hidden on documentation pages but visible on main pages where they are transcluded.

It also places items inside their respective categories, which eliminates the need to do this manually. Currently, it is configured to place modules and their documentation inside their respective categories (Category:Lua modules and Category:Module documentation).

Usage

This template is invoked by placing {{dochead}} at the top of a module or template's /doc subpage.

On modules, unless header=none is passed, a header will appear which points to the template invoked:

Note: Do not invoke this module directly. Use the corresponding template instead: Template:Dochead.

The linked template can be changed by passing temp= followed by the name of the template.

See also