Template:Documentation subpage/doc: Difference between revisions
Tacsipacsi (talk | contribs) use TemplateData, one-line format is better |
m see also + |
||
(9 intermediate revisions by 6 users not shown) | |||
Line 1: | Line 1: | ||
<!-- Add categories where indicated at the bottom of this page and interwikis at Wikidata --> |
|||
{{TemplateBox |
{{TemplateBox |
||
|1=1 |
|1=1 |
||
Line 8: | Line 9: | ||
|1d-fr=Si passé comme « override », permet de forcer l’affichage de ce modèle. N’utiliser que si la page de documentation page ne se termine pas en « /doc ». |
|1d-fr=Si passé comme « override », permet de forcer l’affichage de ce modèle. N’utiliser que si la page de documentation page ne se termine pas en « /doc ». |
||
|1type=line |
|1type=line |
||
|1sv=override |
|||
|1av=override |
|||
|1def= |
|1def= |
||
|1stat=optional- |
|1stat=optional- |
||
Line 22: | Line 25: | ||
|2d-fr=Nom de page complet du modèle décrit. N’utiliser que si la page de documentation n’est pas une sous-page du modèle décrit. |
|2d-fr=Nom de page complet du modèle décrit. N’utiliser que si la page de documentation n’est pas une sous-page du modèle décrit. |
||
|2type=wiki-page-name |
|2type=wiki-page-name |
||
|2def=<nowiki>{{BASEPAGENAME}}</nowiki> |
|2def=<nowiki>{{NAMESPACE}}:{{BASEPAGENAME}}</nowiki> |
||
|2stat=optional- |
|2stat=optional- |
||
|name=Documentation subpage |
|name=Documentation subpage |
||
|desc-en=Place this template at the top of all template documentation subpages. It does not need to be in <nowiki> |
|desc-en=Place this template at the top of all template documentation subpages. It does not need to be in <no<nowiki />include> tags because it will only show up on “/doc” subpages. |
||
|desc-bar=De Vurlog <nowiki>{{documentation subpage}}</nowiki> wead an ålle Vurlogn-Dokumentazionsseitn oben hiigschriibn. De Vurlog muas ned in <nowiki> |
|desc-bar=De Vurlog <nowiki>{{documentation subpage}}</nowiki> wead an ålle Vurlogn-Dokumentazionsseitn oben hiigschriibn. De Vurlog muas ned in <no<nowiki />include> definiirt weadn, då de Vurlog nua auf de Untaeitn „/doc“-Seiten ozoagt werdn. |
||
|desc-de=Diese Vorlage wird an allen Vorlagen-Dokumentationsseiten oben angebracht. Die Vorlage muss nicht in <nowiki> |
|desc-de=Diese Vorlage wird an allen Vorlagen-Dokumentationsseiten oben angebracht. Die Vorlage muss nicht in <no<nowiki />include> definiert werden, da die Vorlage nur auf den Unterseiten „/doc“-Seiten angezeigt werden. |
||
|desc-fr=Placez <nowiki>{{documentation subpage}}</nowiki> en haut des sous-pages de documentation de modèle. Il n’est pas nécessaire de le placer dans des balises <nowiki> |
|desc-fr=Placez <nowiki>{{documentation subpage}}</nowiki> en haut des sous-pages de documentation de modèle. Il n’est pas nécessaire de le placer dans des balises <no<nowiki />include> car il n’apparaître que sur les sous-pages nommées « /doc ». |
||
|namespace=Template |
|namespace=Template |
||
|usergroup=all |
|usergroup=all |
||
Line 39: | Line 42: | ||
|i18n-desc= |
|i18n-desc= |
||
|i18n-mediawiki-msg= |
|i18n-mediawiki-msg= |
||
|seealso=[[m:Template:Documentation]], [[:en:Wikipedia:Template documentation]] <!-- |
|seealso=* [[m:Template:Documentation]], [[:en:Wikipedia:Template documentation]] <!-- |
||
-->{{LangSwitch| |
-->{{LangSwitch| |
||
|bar=(zua Dårstellung wia de Vurlog heagnomma wird) |
|bar=(zua Dårstellung wia de Vurlog heagnomma wird) |
||
Line 46: | Line 49: | ||
|fr=(pour le guide d'utilisation de ce modèle) |
|fr=(pour le guide d'utilisation de ce modèle) |
||
}} |
}} |
||
* {{tl2|Doc-inline}}, {{tl2|doc-end}} |
|||
⚫ | |||
|lines=one |
|||
⚫ | |||
* {{C|Template documentation|+}} – Documentation subpages in the {{ll|Help:Namespaces#Template|Template}} and other namespace. |
|||
* {{C|Module documentation|+}} – Documentation subpages in the {{ll|Help:Namespaces#Module|Module}} namespace. |
|||
* {{C|User documentation|+}} – Documentation subpages in the {{ll|Help:Namespaces#User|User}} namespace. |
|||
|shorthand= |
|shorthand= |
||
| print = line |
|||
|relieson= |
|||
|useTemplateData=only |
| useTemplateData = only |
||
⚫ | |||
| 3 = category |
|||
⚫ | |||
| 3label-en = Category |
|||
| 3description-en = The category to add the documentation subpage to. |
|||
| 3default-en = |
|||
Depends on the namespace: |
|||
; Template or other namespace |
|||
: <nowiki>[[Category:Template documentation]]</nowiki> |
|||
; Module namespace |
|||
: <nowiki>[[Category:Module documentation]]</nowiki> |
|||
; User namespace |
|||
: <nowiki>[[Category:User documentation]]</nowiki> |
|||
<nowiki/> |
|||
| 3stat = optional- |
|||
| 3type = line |
|||
}} |
|||
⚫ | |||
<!-- Categories below this line; interwikis at Wikidata --> |
|||
⚫ | |||
[[Category:Template documentation| ]] |
|||
[[Category:Template namespace templates]] |
[[Category:Template namespace templates]] |
||
</includeonly> |
}}</includeonly> |
Latest revision as of 21:03, 30 January 2024
Place this template at the top of all template documentation subpages. It does not need to be in <noinclude> tags because it will only show up on “/doc” subpages.
The template automatically sets the following categories:
- Category:Template documentation – Documentation subpages in the Template and other namespace.
- Category:Module documentation – Documentation subpages in the Module namespace.
- Category:User documentation – Documentation subpages in the User namespace.
Usage
{{Documentation subpage}}
Template parameters
- TemplateData
TemplateData is a way to store information about template parameters (the description of those and of the whole template) for both humans and machines. It is used by VisualEditor and possibly other tools like Upload Wizard.
Existing template documentation
At Wikimedia Commons, it is recommended to use {{TemplateBox}} with either useTemplateData=1
or useTemplateData=only
on the /doc
subpage and transcluding it with {{Documentation}} into the template. <nowiki>
-tags can be wrapped around the arguments, if required, to avoid templates being expanded.
Newly created template documentation and imports
Another option, especially for imported templates, or for users with JSON experience, is placing raw <templatedata>
-tags into the Wikitext of the template, as described in various Wikipediae.
Wikipedia's help about TemplateData • Commons-specific information
Place this template at the top of all template documentation subpages. It does not need to be in <noinclude> tags because it will only show up on “/doc” subpages.
Parameter | Description | Type | Status | |
---|---|---|---|---|
override | 1 | If set to “override”, allows to force the display of this template. Use only if the documentation page does not end in “/doc”.
| Line | optional |
Category | category | The category to add the documentation subpage to.
| Line | optional |
page | page | Full page name of the described template. Use only if the documentation page is not a subpage of the described template.
| Page name | optional |
Additional information
The template is intended to be used in the following namespaces: the Template namespace
The template is intended to be used by the following user groups: all users
Placement: At the top of the page
See also
- m:Template:Documentation, en:Wikipedia:Template documentation (for how this template is used)
{{Doc-inline}}
,{{doc-end}}
Localization
This template is localized through {{Autotranslate}}. The layout of the template can be found under Template:Documentation subpage/layout.
To add your language to the list of languages supported by this template, please copy the code of Template:Documentation subpage/en (or any other language version you prefer to translate) and replace the text strings in there (the form below can be used to create a translation, the English version is preloaded in the edit box). Please change the parameter lang
from en
(or whatever language you are translating) to the language code of your language.