Template:Skin

テンプレートの解説

This template should be added to all skin pages on this wiki (but only the main page) to display an information box and categorize the skin.

使用法

以下をコピー & ペーストします: {{Skin|templatemode = |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 = }} 引数の値のヘルプは下記を参照してください。

MediaWiki 外装マニュアル - カテゴリ {{{name}}} リリースの状態: 不明 説明 {{{description}}} 作者 SomeAuthor 最新バージョン {{{version}}} ({{{update}}}) 最新プレビュー バージョン {{{version preview}}} ({{{update preview}}}) 互換性ポリシー MediaWiki {{{mediawiki}}} PHP {{{php}}} Composer {{{composer}}} ライセンス {{{license}}} ダウンロード {{{download}}} {{{readme}}} {{{changelog}}} 例 {{{example}}} パラメーター {{{parameters}}} 使用するフック hook1 hook2 提供するフック newhook1 newhook2 {{{compatibility}}} translatewiki.net で翻訳を利用できる場合は、Skin 外装の翻訳にご協力ください Vagrant role {{{vagrant-role}}} 問題点 : [[phab:tag/{{{phabricator}}}|未解決のタスク]] · バグを報告

コンテンツのパラメーター

この節では情報ボックスの内容を制御する引数を解説します。

templatemodeその他の制御パラメーターに関するヘルプは制御のパラメーターを参照してください。

Content parameters

Parameter	Description
name	name of the skin
status	current release status One of: unstable (broken - do not use this skin) experimental (early stages of development, may change drastically) beta (stable but not fully tested) stable (stable version) proprietary (code not available to download/contribute to) unmaintained (unmaintained - previously claimed to be stable, now unmaintained) unknown (default) 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. release status colour scheme
hook1 hook2 hook3 hook4 ... hook90	拡張機能が使用する各フックの名前 Entering values in this field is a good way to get exposure for your extension and help other developers. Each documented hook will automatically add the extension to a category listing extensions that use that hook. This category is autolinked to each hook page so that programmers can easily find examples of extensions that use a particular hook. For built-in hooks: use the hook name alone. Please see Manual:Hooks for values (but omit introductory '/'). For custom hooks defined by extensions: use extensionName/hookName. For a partial list of custom hooks, see Extension hook registry. For multiple hooks, assign the first hook to hook1, the second to hook2 and so on.
newhook1 newhook2 newhook3 newhook4 ... newhook90	拡張機能が提供する各フックの名前 You might also want to add the hooks to Extension hook registry.
username	The author's username on MediaWiki.org (if they have one). May be omitted, but if present it will be used to link to the author's user & user_talk page. It should be provided without namespace and without [[]]s.
author	The skin author's name, if different from their MediaWiki.org username. Free text. If omitted then the 'username' field will be used (if present).
description	short description
image	screenshot or logo of skin. It should be provided without namespace and without [[]]s.
imagesize	facultative, size of the image (default size is 220px)
version	last version
update	date of the last update
compatibility policy	compatibility policy (accepted values are master, rel and ltsrel). (backlog )
mediawiki	required version of MediaWiki
php	required version of PHP
license	license(s) governing use of this skin, e.g. GPL
download	link to the download: Use {{WikimediaDownloadSkin}} or {{GithubDownload}}.
readme	external link to the readme file
changelog	external link to the changelog file
parameters	available parameters for LocalSettings.php
example	example, website or screenshot of working skin
compatibility	compatibility chart, e.g. Template:Extension Testing
bugzilla	Bugzilla MediaWiki skin component name

制御のパラメーター

Control parameters

Parameter

Description

templatemode

Controls auto-categorization of host page. Normally left blank. Alternate values are: nocats - suppresses categorization. Use this value if you are adding this template to subpages of a skin or to how-to documentation of skins. For example, the usage image above sets templatemode=nocats because this isn't an actual skin page and we don't want to add this page to any categories on account of it. If this is left blank, this template will add the host page to カテゴリ:すべての外装 and to one or more additional categories, depending on the values assigned to the Content parameters. subpage; it is not in the Skin: namespace; or if suppressed by 'templatemode=nocats'

Categories added

This template will automatically add the pages it is used on to the Category:All skins category.

In addition, it will categorize the page based on the value of the status parameter:

• unstable: Category:Unstable skins
• experimental: Category:Experimental skins
• stable: Category:Stable skins
• beta: Category:Beta status skins
• unmaintained: Category:Unmaintained skins
• proprietary: Category:Skins which have not released their source code
• otherwise: Category:Skins with unknown status

基礎情報ボックスの使用

既存の外装ページ

既存のページに情報ボックスを追加するには、このページ冒頭のコードをコピー&ペーストします。

外装ページの新規作成

外装のページを新規作成するには、下記の欄にページ名を記入してボタンをクリックします。 すると基礎情報ボックスを備えたページが新規作成されます。

Please replace "TheSkin" with your skin's name:

MediaWiki is an open-source project and users are encouraged to make any MediaWiki skins under an Open Source Initiative (OSI) approved GPLv2 compatible license (including MIT, BSD, PD). For skins that have a compatible license, you can request commit access to the MediaWiki source repository for skins.

A developer sharing their code in the code repository should expect:

フィードバック / 批評 / コード レビュー

Review and comments by other developers on things like framework use, security, efficiency and usability.

Developer tweaking

Other developers modifying your submission to improve or clean-up your code to meet new framework classes and methods, coding conventions and translations.

他の開発者による将来のバージョン

New branches of your code being created by other developers as new versions of MediaWiki are released.

帰属

Credit for your work being preserved in future versions

Similarly, you should credit the developers of any skins whose code you borrow from.

Any developer who is uncomfortable with any of these actions occurring should not host their code in the code repository. You are still encouraged to create a summary page for your skin on the wiki to let people know about the skin, and where to download it.

Enhancing this template

If you would like to improve on this template, thanks! This is a complicated template so here is some help along the way:

In addition, Template:Skin/Sample stores the boiler plate that is preloaded into newly created pages and contains some basic documentation on how to fill in the template parameters. It needs to be kept in sync with Template:Skin/doc.

The Create skin button

To improve the create skin button behavior:

• Template:Skin/Sample: The boilerplate skin that is preloaded into newly-created pages.
• Template:Skin/CreateSkinInputBox: An input box that can be inserted wherever you want users to easily create skins. For documentation on the <inputbox> tag, please see Extension:InputBox.
• Skin:TheSkin: - Defines a placeholder, in case a user accidentally hits the create button without changing the skin name.

Infobox parameters

In general:

• To make this template easy to use, each label in the infobox is linked to documentation on the template parameter(s) it displays. If you add a parameter, please be sure to also add it to the content parameter documentation and link its label to that documentation.

Test case

See if the following pages are still ok, after edited this template.

• Skin:Vector
• Template:Skin

編集者はこのテンプレートのサンドボックス (作成 | ミラー) およびテストケース (作成) のページで実験できます。
このテンプレートの下位ページ