Template:Extension/ja
![]() | This template employs intricate features of template syntax.
You are encouraged to familiarize yourself with its setup and parser functions before editing the template. If your edit causes unexpected problems, please undo it quickly, as this template may appear on a large number of pages. Remember that you can conduct experiments, and should test all improvements, in either the general sandbox or your user space before changing anything here. |
![]() | Uses Lua: |
![]() | This template uses TemplateStyles: |
このテンプレートは表示しているwikiのすべての拡張機能ページ (各メインページに限る) に追加する必要があります。 すると便利な基礎情報ボックスを付け加え (下記参照)、拡張機能を自動的に Category:All extensions に追加すると同時に、適切な状態 および実装の種類 のカテゴリに分類します。
使用法
以下をコピー & ペーストします: {{Extension |templatemode = |name = |status = |type1 = |type2 = |hook1 = |hook2 = |newhook1 = |newhook2 = |username = |author = |description = |image = |imagesize = |version = |update = |version preview = |update preview = |compatibility policy = |mediawiki = |php = |needs-updatephp = |composer = |table1 = |table2 = |license = |download = |repo = |readme = |changelog = |help = |example = |namespace = |parameters = |tags = |rights = |compatibility = |phabricator = |translate = |vagrant-role = }}引数の値のヘルプは下記を参照してください。 |
|
コンテンツのパラメーター
この節では情報ボックスの内容を制御する引数を解説します。
templatemodeその他の制御パラメーターに関するヘルプは制御のパラメーターを参照してください。
パラメーター | 説明 |
---|---|
name | 拡張機能の名前 |
status |
現在のリリースの状態 以下のいずれか:
上記以外のステータスの場合は無視され、代わりに既定値である「Unknown」がテンプレートに表示されます。 値が省略された場合は、unknownに分類されます。 値が無効な場合は、エラーを発見して修正できるようにするため特殊なカテゴリに配置されます。 |
type1 type2 type3 type4 type5 type6 | 実装の種類
この拡張機能を構築するために採用した実装戦略。 このパラメーターはカテゴリを作成し、プログラマが MediaWiki 固有の実装戦略またはパターンを探しやすくします。 ときにはこのパラメーターの値が特定の拡張機能の使用ケースや目的と衝突することもありますが、このパラメーターの目的はそこにはありません。 このパラメーターに選んだ値が適切に目的あるいは可能性のあるユースケースと適合しない場合は、必要に応じてカテゴリ リンクを追加するようお勧めしています。 Allowed values for the type1, type2, ... parameters are:
Any other value for 'type' is invalid, and will cause the extension to be placed in Category:Extensions with invalid or missing type/ja. Note: Many extensions have more than one type, if this applies to yours, replace|type= with |type1=|type2=|type3=... . You may define up to six types for an extension. |
hook1 hook2 hook3 hook4 ... |
拡張機能が使用する各フックの名前
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:
For custom hooks defined by extensions:
For multiple hooks, assign the first hook to hook1, the second to hook2 and so on. |
newhook1 newhook2 newhook3 newhook4 ... newhook90 |
name of each hook provided by the extension You might also want to add the hooks to Extension hook registry. |
username | MediaWiki.orgでの作者の利用者名 (登録済の場合)。 省略可能ですが、登録してある場合は作者の利用者ぺージならびにそのトークページにリンクするため使用します。 名前空間名と[[]]を除去して記入します。 |
MediaWiki.org登録名と異なる場合、拡張機能の作者名。 フリーテキスト。 省略すると'username'欄を使用 (登録済みの場合)。 | |
description | 短い説明 |
image | 拡張機能の画面キャプチャもしくはロゴ 名前空間名と[[]]を除去して記入します。 |
imagesize | 文字通り画像サイズ (既定値は220px) |
version | 最終バージョン |
update | 最終更新の日付 |
version preview | preview version |
update preview | date of the last update to the preview version |
compatibility policy | 互換性の方針 (認められる値は master、rel、ltsrel)。 (製品バックログ ) |
mediawiki | 必要とする MediaWiki のバージョン Most extensions should not need to use this — it defaults to the value of the 'requires' property of extension.json. See also Category:Extensions without MediaWiki version and Category:Extensions with manual MediaWiki version. |
php | 必要な PHP のバージョン |
needs-updatephp |
Extensions which conform to MediaWiki extension standards come with a schema change script which you need to start manually (once) before starting and accessing the MediaWiki through your browser, and after you copied all the extension files to
1>$IP </> stands for the Installation Path (or "directory") of your MediaWiki installation, the same directory that holds <tvar |
composer | The extension's Composer package name, in the standard format. It will be automatically included if set in an extension's "composer.json" file (i.e. this parameter is not required in that case). It will be linked to the extension's page on Packagist. |
table1 table2 table3 table4 ... table30 | name of each non-core table used by the extension Links to a subpage of your extension page. For instance, "table1 = cu_changes" at Extension:CheckUser will link to Extension:CheckUser/cu_changes table . Don't list core tables such as page or revision ; only list tables that are added by extensions. |
license | license governing use of this extension, as one of the codes found in https://spdx.org/licenses/, e.g. GPL-2.0-or-later , GPL-2.0-only or GPL-3.0-or-later , etc. |
download | link to the download : Git, {{WikimediaDownload/ja}}. |
repo | Name of the Gerrit repository the extension's code is stored in, if different from the page name. Setting this automatically sets |download= , and allows the template to automatically load data from the appropriate extension.json file. |
readme | external link to the readme file, e.g. https://phabricator.wikimedia.org/r/browse/mediawiki/extensions/Flow;master;README |
changelog | external link to the changelog file, e.g. Extension:XGlossary/Changelog |
help | Link to user-help for the extension. If not provided, will look for Help:Extension:ExtensionName . If provided, full wikitext link should be given (because you may want to link to e.g. an external page). |
example | example, website or screenshot of working extension |
namespace | namespace in which this extension is used |
parameters | available parameters for LocalSettings.php |
any tags your extension uses (e.g. <tag1>, <tag2>). | |
rights | rights added by the extension. Not to be confused with the license! Rights are such as makebot or desysop , not such as GFDL or LGPL or GPL - those are licenses! |
compatibility | Additional compatibility information, for instance compatibility charts. It's encouraged to add any client-side compatibility information here too, especially when diverging from expectations of full support for a browser. |
bugzilla | Bugzilla MediaWiki extension component name |
phabricator | Phabricator プロジェクト名 |
translate |
Optional parameter to link the exact page where (message group id with which) the extension will be translatable on translatewiki.net if enabled. If the default link is incorrect, manually set it to:
|
vagrant-role | MediaWiki-Vagrant role |
CheckUsageNameOverride | override the page name used for the check usage link. |
制御のパラメーター
パラメーター | 説明 |
---|---|
templatemode |
Controls auto-categorization of host page. Normally left blank. Alternate values are:
|
基礎情報ボックスの使用
既存の拡張機能ページ
既存のページに情報ボックスを追加するには、このページ冒頭のコードをコピー&ペーストします。
拡張機能の記事の新規作成
拡張機能の新規ページを作成するには、下記の欄にページ名を記入してボタンをクリックします。 すると基礎情報ボックスを備えた新規ページが作成されます。
type=create width=40 placeholder=<translate nowrap> Enter your extension's name here</translate> prefix=Extension: preload=Template:Extension/Sample buttonlabel=作成
</inputbox><translate> A developer sharing their code in the MediaWiki code repository should expect:</translate>
- <translate> Feedback / Criticism / Code reviews</translate>
- <translate> Review and comments by other developers on things like [<tvar
テンプレートの強化
テンプレート改善に取り組もうと考えていますか、よろしくお願いします! テンプレートが複雑なため、いくつか手順のヘルプを提供します。
拡張機能作成ボタン
拡張機能作成ボタンの挙動を改善する方法:
- Template:Extension/Sample : The boilerplate extension that is preloaded into newly-created pages.
- Template:Extension/CreateExtensionInputBox : An input box that can be inserted wherever you want users to easily create extensions. For documentation on the
<inputbox>
tag, please see Extension:InputBox .
基礎情報ボックスのパラメーター
一般的には:
- 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.
To change/correct/add to the implementation type parameters:
- Check the talk page - there have been some extensive discussions about this field.
- The valid types and what they link to are defined at Module:Extension
フックパラメータの挙動を変更するには:
- Template:Extension/HookInUse: Adds links and categories for a hook in use. Multiple hooks in use are implemented by calling this template with Template:Foreach.
- Template:Extension/HookInUseNoCats: Used instead of Template:Extension/HookInUse when this template is used in
templatemode=nocats
. Templates used with Template:Foreach can only take one parameter so we need to wrap the call to Template:Extension/HookInUse with another template that sets the mode.
テストケース
このテンプレートを編集したあとで、以下のページが正しく表示されるか試してみます。
TemplateData
TemplateData | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
· <span style="" title="<translate nowrap> Edit this template</translate>"><translate> edit</translate>]
これは、ビジュアルエディターまたは他のツールで使用される、このテンプレート向けのテンプレートデータ説明文です。 Extension An infobox for a MediaWiki extension.
|
Maintenance: vulnerabilities, archived
- Pages with script errors
- Pages using duplicate arguments in template calls
- Lua-based templates
- Templates using TemplateStyles/ja
- Extensions with manual MediaWiki version
- Extensions supporting Composer/ja
- Templates using TemplateData/ja
- Info templates/ja
- Extension creation/ja
- Categorizing templates/ja
- Extension templates/ja
- Template documentation pages/ja
- Infobox templates/ja