Template:Documentation subpage/doc: Difference between revisions

>PJosepherum
m 1 revision imported
iw>FRacco
m please check english translation
Line 1: Line 1:
{{Documentation subpage}} __NOTOC__
{{TemplateBox
== Usage ==
|1=1
: {{tlx|Documentation subpage}}
|1d=
: or
{{LangSwitch
: {{tlx|Documentation subpage |[[{{var|Page where the documentation [[Wikipedia:Transclusion|transcluded]]}}]]}}
|bar=Is da Parametar aufm Weat „override“ gsetzt, wead de Vurlog ozoagt. Dea Weat wead heagnomma, wenn de Dokumentazionsuntaseitn ned „/doc“ is.
|de=Ist der Parameter auf den Wert „override“ gesetzt, wird diese Vorlage angezeigt. Dieser Wert wird benutzt, wenn die Dokumentationsunterseite nicht „/doc“ ist.
|ca=Si es posa com a “override“, permet forçar la visualització d'aquesta plantilla. S'ha d'emprar només si la pàgina de documentació no finalitza en « /doc ».
|en=If set to “override”, allows to force the display of this template. Use only if the documentation page does not end in „/doc“.
|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 ».
}}
|1def=
|1stat=optional
|2=page
|2d=
{{LangSwitch
|bar=Ganza Seitnnama vo da Vurlog, zu dea de Beschraibung kheardt. Dea Parametar wead nua heagnomma, wenn de Dokumentazionsseitn koa Untaseitn vo da Vurlog is, zu dea de Beschraibung kheardt.
|ca= Nom complet de la pàgina on es descriu la plantilla. Utilitzar només si la pàgina de documentació no és una subpágina de la plantilla descrita.
|de=Ganzer Seitenname der beschriebenen Vorlage. Diser Parameter wird nur verwendet, wenn die Dokumentationsseite keine Unterseite der beschriebenen Vorlage ist.
|en=Full page name of the described template. Use only if the documentation page is not a subpage of the described template.
|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.
}}
|2def=
|2stat=optional
|name=Documentation subpage
|desc=
{{LangSwitch
|bar=De Vurlog <code><nowiki>{{documentation subpage}}</nowiki></code> wead an ålle Vurlogn-Dokumentazionsseitn oben hiigschriibn. De Vurlog muas ned in &lt;noinclude&gt; definiirt weadn, då de Vurlog nua auf de Untaeitn „/doc“-Seiten ozoagt werdn.
* Wenn de Untaseitn an andern Nama hådt ois „doc“, muas <code><nowiki>{{documentation subpage|override}}</nowiki></code> heagnomma werdn.
* Wenn se de Vurlognseitn vom Basisnama dea Seitn untaschaidet, muas <code><nowiki>{{documentation subpage|page=</nowiki>''Template:Example''<nowiki>}}</nowiki></code> heagnomma werdn.
|de=Die Vorlage <code><nowiki>{{documentation subpage}}</nowiki></code> wird an allen Vorlagen-Dokumentationsseiten oben angebracht. Die Vorlage muss nicht in &lt;noinclude&gt; definiert werden, da die Vorlage nur auf den Unterseiten „/doc“-Seiten angezeigt werden.
* Wenn die Unterseite anders benannt ist als „doc“, muss <code><nowiki>{{documentation subpage|override}}</nowiki></code> benutzt werden.
* Unterscheidet sich die Vorlageseite vom Basisnamen der Seite, muss <code><nowiki>{{documentation subpage|page=</nowiki>''Template:Example''<nowiki>}}</nowiki></code> verwendet werden.
|en=Place <code><nowiki>{{documentation subpage}}</nowiki></code> at the top of all template documentation subpages. It does not need to be in &lt;noinclude&gt; tags because it will only show up on “/doc” subpages.
* If the subpage is named something other than “/doc”, use <code><nowiki>{{documentation subpage|override}}</nowiki></code>.
* If the template page is different from the base page name, use <code><nowiki>{{documentation subpage|page=</nowiki>''Template:Example''<nowiki>}}</nowiki></code>.
|fr=Placez <code><nowiki>{{documentation subpage}}</nowiki></code> en haut des sous-pages de documentation de modèle. Il n’est pas nécessaire de le placer dans des balises &lt;noinclude&gt; car il n’apparaître que sur les sous-pages nommées « /doc ».
* Si le nom de la sous-page se termine en autre chose que « /doc », utilisez <code><nowiki>{{documentation subpage|override}}</nowiki></code>.
* Si la page du modèle décrit est différente du nom de la page de base, utilisez <code><nowiki>{{documentation subpage|page=</nowiki>''Template:Exemple''<nowiki>}}</nowiki></code>.
}}
|namespace=Template
|usergroup=all
|placement=top
|usage-notes=
|type=documentation
|example=
|i18n-method=autotranslate
|i18n-desc=
|i18n-mediawiki-msg=
|seealso=[[m:Template:Documentation]], [[:en:Wikipedia:Template documentation]] <!--
-->{{LangSwitch|
|bar=(zua Dårstellung wia de Vurlog heagnomma wird)
|de=(zur Darstellung wie die Vorlage benutzt wird)
|en=(for how this template is used)
|fr=(pour le guide d'utilisation de ce modèle)
}}
|setscats=
|lines=multi
|shorthand=
|relieson=
}}<includeonly>


===Userbox documentation===
[[Category:Autotranslated templates|{{PAGENAME}}]]
To set this template to use "userbox" and "userbox page" rather than "{{lc:{{ns:Template}}}}" and "{{lc:{{ns:Template}}}} page" or "{{lc:{{ns:User}}}} template" and "{{lc:{{ns:User}}}} template page", use:
[[Category:Template namespace templates|{{PAGENAME}}]]
: {{tlx|Userbox documentation subpage}}
</includeonly>
: or
: {{tlx|Userbox documentation subpage |&#91;&#91;{{var|userbox page}}&#93;&#93;}}
 
===Text customization===
The parameters {{para|text1}} and/or {{para|text2}} can be used to set the text of, respectively, the template's first and second lines. If ''text1'' is set but not ''text2'', both lines' text will derive from ''text1'':
{{Hidden begin |showhide=left |title=With ''text1'' and ''text2''}}
<code><nowiki>{{Documentation subpage |text1='''''text1 appears here''''' |text2='''''text2 appears here'''''}}</nowiki></code>
{{Documentation subpage |[''page''] |text1='''''text1 appears here''''' |text2='''''text2 appears here''''' |override={{lc:{{SUBPAGENAME}}<!-- Hack to allow example to appear, even when viewed from [[Template:Documentation subpage]] -->}}}}
{{Hidden end}}
{{Hidden begin |showhide=left |title=With ''text2'' only}}
<code><nowiki>{{Documentation subpage |text2='''''text2 appears here'''''}}</nowiki></code>
{{Documentation subpage |[''page''] |text2='''''text2 appears here''''' |override={{lc:{{SUBPAGENAME}}<!-- Hack to allow example to appear, even when viewed from [[Template:Documentation subpage]] -->}}}}
{{Hidden end}}
{{Hidden begin |showhide=left |title=With ''text1'' only}}
<code><nowiki>{{Documentation subpage |text1='''''text1 appears here'''''}}</nowiki></code>
{{Documentation subpage |[''page''] |text1='''''text1 appears here''''' |override={{lc:{{SUBPAGENAME}}<!-- Hack to allow example to appear, even when viewed from [[Template:Documentation subpage]] -->}}}}
{{Hidden end}}
 
== Display ==
This template should normally be placed at the top of /doc pages. It changes output depending on where it is viewed:
* On a /doc page, it displays a box explaining template documentation and links to the template page.
* On other pages&nbsp;– i.e. pages transcluding the /doc page&nbsp;– the template will not show. The template page itself (which contains <code>{{tl|Documentation}}</code>) will automatically note that the documentation is [[Wikipedia:Transclusion|transcluded]] from a subpage.
 
== Functions ==
In addition to its message, the template adds pages to [[:Category:Template documentation pages]], [[:Category:User documentation pages]], or similar (named after the subject space), but only for documentation pages in namespaces with the subpage feature. It defaults the [[m:Help:Categories#Sort order|sort key]] to the page name without namespace: Template:Foo, for example, would be sorted as "Foo", i.e. under "F".
 
== See also ==
{{Documentation/see also}}
 
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox |
| <!--Categories below here, please; interwikis to Wikidata.-->
[[Category:Template documentation| ]]
[[Category:Template namespace templates]]
 
[[tn:Template:Documentation subpage]]
}}</includeonly>