Template:Skin: Difference between revisions
Undo revision 6386637 by Rebulka (talk): translators may want to transliterate this name, may want to know how to agglutinate it etc. It being capitalized makes it clear that it’s a proper name, so it shouldn’t be translated literally; but it’s not something that should not be touched under any circumstances (like a piece of software code would be). |
m 1 revision imported |
||
(No difference)
| |||
Latest revision as of 05:06, 26 April 2024
<languages/> Page Template:Infobox/styles.css has no content.Page Template:Skin/styles.css has no content.Page Template:Extension/status.css has no content. Lua error: Module:TNT:172: '''Missing JsonConfig extension, or not properly configured; Cannot load https://commons.wikimedia.org/wiki/Data:I18n/Documentation.tab. See https://www.mediawiki.org/wiki/Extension:JsonConfig#Supporting_Wikimedia_templates'''.{{#if:Lua error in Module:Lua_banner at line 113: attempt to index field 'edit' (a nil value). Lua error: callParserFunction: function "#translation" was not found.
<translate> This template should be added to all skin pages on this wiki (but only the main page) to display an information box and categorise the skin.</translate>
<translate>
Usage
</translate>
|
<translate> Copy and paste:</translate> {{Skin|templatemode =
|name =
|localised name =
|status =
|hook1 =
|hook2 =
|newhook1 =
|newhook2 =
|username =
|author =
|description =
|image =
|imagesize =
|version =
|update =
|version preview =
|update preview =
|compatibility policy =
|mediawiki =
|php =
|composer =
|license =
|download =
|readme =
|changelog =
|example =
|parameters =
|compatibility =
|bugzilla =
|phabricator =
|vagrant-role =
}}
<translate> For help with parameter values, see [[<tvar name=1>#Content parameters</tvar>|below]].</translate> |
Page Template:Infobox/styles.css has no content.Page Template:Skin/styles.css has no content.Page Template:Extension/status.css has no content.{{#if: {{{phabricator}}} | Template:Ptag }}
{{#if:Placeholder.svg|
|{{#if:{{#translation:}}||}}}}
{{#if:{{{description}}}|
}}
{{#if:SomeAuthorSomeUser |
}}
{{#if: |
}}
{{#if:{{{version}}}|
}}
{{#if:{{{version preview}}}|
}}
{{#if:{{{compatibility policy}}}|
|{{#ifeq:nocats|nocats||{{#if:{{#translation:}}||}}}}
}}
{{#if:{{{mediawiki}}}|
}}
{{#if:{{{php}}}|
}}
{{#if:{{{composer}}}|
}}
{{#if:{{{example}}}|
|{{#ifeq:nocats|nocats||[[Category:Skins without an example{{#translation:}}]]}}
}}
{{#if:{{{parameters}}}|
}}
{{#if:hook1|
}}
{{#if:newhook1|
}}
{{#if:{{{compatibility}}}|
}}
{{#if:Script error: No such module "Extension".|
<td title="<translate nowrap> This only includes downloads from <tvar name=1>Special:SkinDistributor</tvar>.</translate> <translate nowrap> Other download methods such as git or bundled extensions are not included.</translate>"><translate> Quarterly downloads</translate>
}}
{{#if:Script error: No such module "Extension".|
}}
{{#if:Script error: No such module "Extension".|
}}
{{#if:{{{vagrant-role}}}|
}}
{{#if: {{{phabricator}}} |
}}
|
|||||||||||||||||||||||||||||||||||||||||||||||||
<translate>
Content parameters
</translate>
<translate> This section describes parameters that govern infobox content.</translate>
<translate> For help with <tvar name=1>templatemode</tvar> and other control parameters, please see [[<tvar name=2>#Control parameters</tvar>|Control parameters]].</translate>
| <translate> Parameter</translate> | <translate> Description</translate> |
|---|---|
| name | <translate> name of the skin</translate> |
| localised name | <translate> source text for localising name of the skin</translate>
<translate> Specify the same value as <tvar name=1> |
| status | <translate> current release status</translate>
<translate> One of:</translate>
| }}{{#if:unstable |unstable |unstable}}{{#ifeq:Category:Unstable skins| | }} - <translate> currently broken - do not use this skin in the latest MediaWiki version.</translate>
| }}{{#if:experimental |experimental |experimental}}{{#ifeq:Category:Experimental skins| | }} - <translate> early stages of development, may change drastically</translate>
| }}{{#if:beta |beta |beta}}{{#ifeq:Category:Beta status skins| | }} - <translate> stable but not fully tested</translate>
| }}{{#if:stable |stable |stable}}{{#ifeq:Category:Stable skins| | }} - <translate> stable - the skin works in the latest MediaWiki version without any fatal errors.</translate>
| }}{{#if:unmaintained |unmaintained |unmaintained}}{{#ifeq:Category:Unmaintained skins| | }} - <translate> unmaintained - only use if the linked repository is archived or the maintainer has not responded to an enquiry about the maintained status.</translate> <translate> If using this status, please link to a patch or issue/bug report as a reference using an HTML comment.</translate> <translate> If the skin is broken use <tvar name=1>
| }}{{#if:unknown |unknown |unknown}}{{#ifeq:Category:Skins with unknown status| | }} - <translate> default</translate> <translate> If the status is anything other than the above, it will be ignored and the default value of 'Unknown' will be displayed in the template instead.</translate>
| }}{{#if:<translate> release status colour scheme</translate> |<translate> release status colour scheme</translate> |<translate> release status colour scheme</translate>}}{{#ifeq:Extension status| |}} |
| hook1 hook2 hook3 hook4 ... hook90 |
<translate> name of each hook used by the extension</translate>
<translate> Entering values in this field is a good way to get exposure for your extension and help other developers.</translate> <translate> Each documented hook will automatically add the extension to a category listing extensions that use that hook.</translate> <translate> This category is autolinked to each hook page so that programmers can easily find examples of extensions that use a particular hook.</translate> <translate> For built-in hooks:
| }}{{#if:Manual:Hooks |Manual:Hooks |Manual:Hooks}}{{#ifeq:Manual:Hooks| | }}</tvar> for values (but omit introductory '/').</translate> <translate> For custom hooks defined by extensions:
<translate> For multiple hooks, assign the first hook to <tvar name=1>hook1</tvar>, the second to <tvar name=2>hook2</tvar> and so on.</translate> |
| newhook1 newhook2 newhook3 newhook4 ... newhook90 |
<translate> name of each hook provided by the extension </translate> <translate> You might also want to add the hooks to <tvar name=exthooks>Extension hook registry</tvar>.</translate> |
| username | <translate> The author's username on MediaWiki.org (if they have one).</translate> <translate> May be omitted, but if present it will be used to link to the author's user & user_talk page.</translate> <translate> It should be provided without namespace and without <tvar name=1>[[]]</tvar>s.</translate> |
| Template:Visible anchor | <translate> The skin author's name, if different from their MediaWiki.org username.</translate> <translate> Free text.</translate> <translate> If omitted then the '<tvar name=1>username</tvar>' field will be used (if present).</translate> |
| description | <translate> short description</translate> |
| Template:Visible anchor | <translate> screenshot or logo of skin.</translate> <translate> It should be provided without namespace and without <tvar name=1>[[]]</tvar>s.</translate> |
| Template:Visible anchor | <translate> facultative, size of the image (default size is 220px)</translate> |
| Template:Visible anchor | <translate> last version</translate> |
| Template:Visible anchor | <translate> date of the last update</translate> |
| compatibility policy | {{#ifeq:Compatibility|
| }}{{#if:<translate> compatibility policy</translate> |<translate> compatibility policy</translate> |<translate> compatibility policy</translate>}}{{#ifeq:Compatibility| | }} (<translate> accepted values are <tvar name="1">master</tvar>, <tvar name="2">rel</tvar> and <tvar name="3">ltsrel</tvar></translate>). ({{#ifeq:Category:Skins without a compatibility policy| | }}{{#if:backlog |backlog |backlog}}{{#ifeq:Category:Skins without a compatibility policy| |}}) |
| Template:Visible anchor | <translate> required version of MediaWiki</translate> |
| Template:Visible anchor | <translate> required version of PHP</translate> |
| Template:Visible anchor | <translate> license(s) governing use of this skin, e.g. GPL</translate> |
| download | <translate> link to the download</translate>: Use {{WikimediaDownloadSkin}} or {{GithubDownload}}. |
| Template:Visible anchor | <translate> external link to the readme file</translate> |
| Template:Visible anchor | <translate> external link to the changelog file</translate> |
| Template:Visible anchor | <translate> available parameters for <tvar name="1">LocalSettings.php</tvar></translate> |
| Template:Visible anchor | <translate> example, website or screenshot of working skin</translate> |
| Template:Visible anchor | <translate> compatibility chart</translate> |
| Template:Visible anchor | <translate> Bugzilla MediaWiki skin component name</translate> |
<translate>
Control parameters
</translate>
| <translate> Parameter</translate> | <translate> Description</translate> |
|---|---|
| templatemode | <translate> Controls auto-categorisation of host page.</translate>
<translate> Normally left blank.</translate> <translate> Alternate values are:</translate>
<translate> If this is left blank, this template will add the host page to <tvar name=1>{{#ifeq:Category:All skins| | }}[[Special:MyLanguage/Category:All skins|{{#if: |{{{2}}} |{{#ifexist:Translations:{{#if:Category|Category:}}All skins/Page display title/en |{{#if:
|{{#if:
|
|{{ Template:TNTN | nsp = 0 }}
}}
|{{ Template:TNTN }}
}}
|{{#if:
|{{#if:All skins
|All skins
|Category:All skins
}}
|Category:All skins
}}
}}}}]]{{#ifeq:Category:All skins| | }}</tvar> and to one or more additional categories, depending on the values assigned to the [[<tvar name=2>#Content parameters</tvar>|Content parameters]].</translate> <translate> subpage; it is not in the Skin: namespace; or if suppressed by '<tvar name=1>templatemode=nocats</tvar>'</translate> |
<translate>
Categories added
This template will automatically add the pages it is used on to the <tvar name=1>Category:All skins</tvar> category.
In addition, it will categorise the page based on the value of the status parameter:</translate>
- unstable: Category:Unstable skins
- experimental: Category:Experimental skins
- stable: Category:Stable skins
- beta: Category:Beta status skins
- unmaintained: Category:Unmaintained skins
- otherwise: Category:Skins with unknown status
<translate>
Using the infobox
Existing skin pages
If you want to add the infobox to an existing page, copy and paste the code at the [[<tvar name=1>#CutAndPaste</tvar>|top of this page]].
Create a new skin page
</translate> <translate> If you want to create a new skin page, enter the name below and click the button.</translate> <translate> A new page will be created with the infobox template already in place.</translate>
Template:Skin/CreateSkinInputBox
<translate>
Enhancing this template
If you would like to improve on this template, thanks!</translate> <translate> This is a complicated template so here is some help along the way:</translate>
<translate> In addition, <tvar name=1>{{#ifeq:Template:Skin/Sample|
|
}}[[Special:MyLanguage/Template:Skin/Sample|{{#if: |{{{2}}} |{{#ifexist:Translations:{{#if:Template|Template:}}Skin/Sample/Page display title/en
|{{#if:
|{{#if:
|
|{{ Template:TNTN | nsp = 0 }}
}}
|{{ Template:TNTN }}
}}
|{{#if:
|{{#if:Skin/Sample
|Skin/Sample
|Template:Skin/Sample
}}
|Template:Skin/Sample
}}
}}}}]]{{#ifeq:Template:Skin/Sample|
|
}}</tvar> stores the boiler plate that is preloaded into newly created pages and contains some basic documentation on how to fill in the template parameters.</translate> <translate> It needs to be kept in sync with the documentation.
The Create skin button
To improve the create skin button behavior:</translate>
- Template:Skin/Sample — <translate> The boilerplate skin that is preloaded into newly-created pages.</translate>
- {{#ifeq:Template:Skin/CreateSkinInputBox|
|
}}[[Special:MyLanguage/Template:Skin/CreateSkinInputBox|{{#if: |{{{2}}} |{{#ifexist:Translations:{{#if:Template|Template:}}Skin/CreateSkinInputBox/Page display title/en
|{{#if:
|{{#if:
|
|{{ Template:TNTN | nsp = 0 }}
}}
|{{ Template:TNTN }}
}}
|{{#if:
|{{#if:Skin/CreateSkinInputBox
|Skin/CreateSkinInputBox
|Template:Skin/CreateSkinInputBox
}}
|Template:Skin/CreateSkinInputBox
}}
}}}}]]{{#ifeq:Template:Skin/CreateSkinInputBox|
|
}} — <translate> An input box that can be inserted wherever you want users to easily create skins.</translate> <translate> For documentation on the <tvar name=1>{{#switch:open
|c|close =
|e|empty|s|single|v|void
|o|open
|p|pair = <{{#if:|inputbox|inputbox}}{{#if:| {{{attribs}}}}}
}}{{#switch:open
|c|close =
|e|empty|s|single|v|void = />
|o|open = >
|p|pair = {{#ifeq:inputbox|!--||>}}...
}}{{#switch:open
|e|empty|s|single|v|void
|o|open =
|c|close
|p|pair = {{#ifeq:inputbox|!--|-->|</inputbox>}}
}}</tvar> tag, please see <tvar name=2>{{#ifeq:Extension:InputBox|
|
}}[[Special:MyLanguage/Extension:InputBox|{{#if: |{{{2}}} |{{#ifexist:Translations:{{#if:|:}}Extension:InputBox/Page display title/en
|{{#if:
|{{#if:
|
|{{ Template:TNTN | nsp = 0 }}
}}
|{{ Template:TNTN }}
}}
|{{#if:
|{{#if:Extension:InputBox
|Extension:InputBox
|Extension:InputBox
}}
|Extension:InputBox
}}
}}}}]]{{#ifeq:Extension:InputBox|
|
}}</tvar>.</translate>
- Skin:TheSkin: — <translate> Defines a placeholder, in case a user accidentally hits the create button without changing the skin name.</translate>
<translate>
Infobox parameters
In general:</translate>
- <translate> To make this template easy to use, each label in the infobox is linked to documentation on the template parameter(s) it displays.</translate> <translate> If you add a parameter, please be sure to also add it to the content parameter documentation and link its label to that documentation.</translate>
<translate>
Test cases
See if the following pages are still ok, after editing this template.</translate>
- {{#ifeq:Skin:Vector|
|
}}[[Special:MyLanguage/Skin:Vector|{{#if: |{{{2}}} |{{#ifexist:Translations:{{#if:|:}}Skin:Vector/Page display title/en
|{{#if:
|{{#if:
|
|{{ Template:TNTN | nsp = 0 }}
}}
|{{ Template:TNTN }}
}}
|{{#if:
|{{#if:Skin:Vector
|Skin:Vector
|Skin:Vector
}}
|Skin:Vector
}}
}}}}]]{{#ifeq:Skin:Vector|
|
}}
- {{#ifeq:Template:Skin|
|
}}[[Special:MyLanguage/Template:Skin|{{#if: |{{{2}}} |{{#ifexist:Translations:{{#if:Template|Template:}}Skin/Page display title/en
|{{#if:
|{{#if:
|
|{{ Template:TNTN | nsp = 0 }}
}}
|{{ Template:TNTN }}
}}
|{{#if:
|{{#if:Skin
|Skin
|Template:Skin
}}
|Template:Skin
}}
}}}}]]{{#ifeq:Template:Skin|
|
}}| [[Category:Template documentation pages{{#translation:}}]] }} [[Category:Infobox templates{{#translation:}}|Skin]] [[Category:Extension creation{{#translation:}}]] [[Category:Categorizing templates{{#translation:}}|Skin]] [[Category:Extension templates{{#translation:}}]] [[Category:Skin templates{{#translation:}}]]
