模板:TemplateBox/doc

<translate> </translate>

The template provides a uniform way to provide basic information about the use of a template. See: Commons:Template documentation and Commons:TemplateData.

<translate> Usage</translate>

{{TemplateBox
 |desc               =
 |print              =
 |namespace          =
 |shorthand          =
 |usergroup          =
 |relieson           =
 |placement          =
 |usage-notes        =
 |1def               =
 |type               =
 |example            =
 |1stat              =
 |example-value      =
 |i18n-method        =
 |useTemplateData    =
 |i18n-desc          =
 |mustbesubst        =
 |setscats           =
 |1                  =
 |1d                 =
 |name               =
 |seealso            =
 |i18n-mediawiki-msg =
 |1d-td              =
 |1type              =
 |i18n-subpage       =
}}

模板参数

参数描述默认值状态
desc
desc-en
description
description-en
desc-td
description-td
description (template)description of what the template does Template:TemplateBox/use suffixempty必需
printprintThe way the parameters are typically arranged (horizontally or vertically). Possible values: multi - parameters arranged in multiple lines; one - one line; infobox - multiple lines and space padding in front of the =.LangSwitch Error: no default可选
1setset (param)Label and ID of a set in one. Multiple parameters can be grouped in a set, if either none or all of them must be supplied. Try to keep under 20-ish characters.empty可选
namespacenamespacenamespaces, the template is intended to be used in; possible values:

Template:TemplateBox/doc/nslist

Any other values will show as “unknown”.
LangSwitch Error: no default必需
shorthandshorthandshorthand for easy use (redirects to main template). See examples here and here of lists of redirects, and searches for more.empty可选
usergroupusergroupusergroup that is meant to use the template; possible values: Template:TemplateBox/doc/usergroupLangSwitch Error: no default必需
reliesonrelies onlist of templates on which the template's basic functionality reliesempty可选
placementplacementplacement on the page. Possible values:
top
bottom
licence
source
empty可选
usage-notesusage-notesnotes about the correct usage of the templateempty可选
1def
1def-td
1default
default (param)default value for the parameter (similarly 2def, 3def, …) Template:TemplateBox/use suffixempty可选
typetype (template)what type is the template (infobox, formatting, licence tag, …)empty可选
exampleexampleExample use (works with a single unnamed parameter only). There is also example2 for a second example.empty可选
1aliasesaliases (param)List of aliases. An alias is an alternative name for the parameter that may be used instead of (not in addition to) the primary name. Separate them by / (a slash)empty可选
1stat
1stat-td
1deprecated
1required
status (param)status of the parameter (similarly 2stat, 3stat, …); possible values:
required[需要解释]
optional
optional-
optional and not present in the standard form
deprecated
optional可选
example-valueexample-resultIf there is more than one parameter you would like to show or if there are named parameters, use: Template:TemplateBox/doc/example-valueempty可选
i18n-methodtranslation methodmethod the localization is achieved by. Known values:
autotranslate
using {{autotranslate}} or applying a similar method
switch
using {{LangSwitch}} in the template itself
-
no localization needed
custommediawiki-msg
using MediaWiki namespace messages
mediawiki-msg
using MediaWiki namespace messages, translated on translatewiki.net
ext.translate
using {{autotranslate}} or applying a similar method on a subpage that is marked for translation using the translate extension
empty可选
useTemplateDataexpose TemplateDataWhether the template should expose TemplateData - omitting means "false". Setting to 1, true, or yes means "true". Setting to only will suppress the house-made table. Setting useTemplateData to export will turn TemplateBox into a preformatted Copy & Paste template.empty推荐
i18n-desctranslation infoadditional info about the localizationempty可选
mustbesubstmust be substSet to "yes" (or any value) if the template must be substituted. This puts "subst:" into the template example under "usage".empty可选
lines
print
Use parameter print instead.empty可选
setscatscategorizes intowhat categories are automatically set by the template (put in a linked list of them)empty可选
1name (param)parameter name (similarly 2, 3, …). Note that if all of the parameters beginning with a number are removed from the template, the usage notes will state "The template takes no parameters."empty可选
1d
1d-en
1description
1description-en
description (param)description of the parameter (similarly 2d, 3d, …) Template:TemplateBox/use suffixempty可选
1label
1label-en
1label-td
1label-td-en
label (param)A (very) brief name for the parameter. Try to keep under 20-ish characters. 1label-de would be the German translation of this label. Template:TemplateBox/use suffixempty可选
nametitle (template)name of the template (needed for viewing the documentation on another page than the template page, in particular for viewing the documentation page separately){{BASEPAGENAME}}必需
seealsosee alsorelevant links (put in a list of them)empty可选
i18n-mediawiki-msgmediawiki-messageWhen using “mediawiki-msg” as method, optionally put the name of the message here. Falls back to:empty可选
1d-td
1d-td-en
1description-td
1description-td-en
TemplateData description (param)description of the parameter (similarly 2d-td, 3d-td, …) for Extension:TemplateData which does not accept Wiki-markup. If this parameter is omitted, 1d is used. You can always override the defaults specifically for TemplateData by appending -td to the parameter-name. You can specify a language by appending your language-code. E.g. 3d-td-en would be the English translation of the description of parameter 3 which will be used in TemplateData. Template:TemplateBox/use suffixempty可选
1typetype (param)The type of the parameter, for (soft) type hinting. Please refer to the list of possible values.empty可选
i18n-subpagetranslation-subpageWhen using “ext.translate” as method, optionally put the name of the sub-page here. A dot (.) means that the current template hosts the translation on its subpages directly.i18n可选

<translate> Additional information</translate>

<translate> The template is intended to be used in the following namespaces:</translate> <translate> the Template namespace</translate>

<translate> The template is intended to be used by the following user groups:</translate> <translate> all users</translate>

<translate> Placement:</translate> <translate> </translate>

in the '/doc' subpage of a template

<translate> Relies on:</translate>

<translate> ⧼Seealso⧽</translate>

<translate> </translate>

<translate> Localization</translate>

Template:Lang links

<translate> This template makes use of <tvar name="autotranslate">{{Autotranslate}}</tvar> and [[<tvar name="linktarget">:mw:Special:MyLanguage/Help:Extension:Translate</tvar>|the translate extension]].</translate> Template:Tmpl

[[[:Template:TranslateLink]] <translate> Translate this template now!</translate>]

About: TemplateData

{{Commons:TemplateData}}

Complications

( NOTE : the {{sed|1}} template links appears HERE : >>> ) Template:Sed A complication is that the template suppresses section editing links on the whole page of the documented template, and also on its documentation page, even for paragraphs outside the part produced by this template TemplateBox. Template:Sed can be used (as is done here) to create an edit link anyway.