「ヘルプ:テンプレート」の版間の差分
(→Category templates: セクションを en:Help:Template en:ID: 593542 の版の状態に同期) |
|||
(2人の利用者による、間の27版が非表示) | |||
4行目: | 4行目: | ||
[[es:Help:Template]] |
[[es:Help:Template]] |
||
[[fa:راهنما:الگو]] |
[[fa:راهنما:الگو]] |
||
+ | [[fi:Help:Template]] |
||
+ | [[pt:Help:Template]] |
||
[[ru:Help:Template]] |
[[ru:Help:Template]] |
||
[[zh-hans:Help:Template]] |
[[zh-hans:Help:Template]] |
||
12行目: | 14行目: | ||
{{Related|ヘルプ:スタイル}} |
{{Related|ヘルプ:スタイル}} |
||
{{Related articles end}} |
{{Related articles end}} |
||
− | |||
テンプレートは、記事に挿入することが出来る定義済みの [[Wikipedia:Wikitext|wikitext]] です。テンプレートは主としてコンテンツを整形するために使われます。 |
テンプレートは、記事に挿入することが出来る定義済みの [[Wikipedia:Wikitext|wikitext]] です。テンプレートは主としてコンテンツを整形するために使われます。 |
||
55行目: | 56行目: | ||
{{Tip|パイプ記号 "{{!}}" は {{ic|<nowiki>{{!}}</nowiki>}} [[MW:ja:Help:マジックワード#その他の変数|マジックワード]]でエスケープできます。}} |
{{Tip|パイプ記号 "{{!}}" は {{ic|<nowiki>{{!}}</nowiki>}} [[MW:ja:Help:マジックワード#その他の変数|マジックワード]]でエスケープできます。}} |
||
− | ==== 名前付き |
+ | ==== 名前・番号付きパラメータ ==== |
問題が "=" 記号だけの場合、テンプレートのパラメータの名前やポジション番号を使うことで解決するのがおすすめです。 |
問題が "=" 記号だけの場合、テンプレートのパラメータの名前やポジション番号を使うことで解決するのがおすすめです。 |
||
− | + | 例: {{ic|<nowiki>{{Tip|1=https://archlinux.org/?foo=bar}}</nowiki>}} |
|
− | + | 表示: {{Tip|1=https://archlinux.org/?foo=bar}} |
|
+ | これは以下のような場合にとても便利です。 |
||
− | This is very useful for: |
||
* 変数の定義 |
* 変数の定義 |
||
* URL にクエリ文字列を含む[[ヘルプ:編集#外部リンク|外部リンク]] |
* URL にクエリ文字列を含む[[ヘルプ:編集#外部リンク|外部リンク]] |
||
+ | * シェルの文字列やコマンド |
||
− | * Shell strings and commands. |
||
+ | * コードの行 |
||
− | * Lines of code. |
||
+ | 名前付きパラメータの値の先頭・末尾にある空白文字 (例えば改行) は 自動で除去されます。空白文字を残すには、パラメータの値を {{ic|<nowiki><nowiki/></nowiki>}} タグで開始してください。 |
||
− | ===== Multiple parameters ===== |
||
+ | 例: |
||
− | * Using positional parameters {{ic|1}} and {{ic|2}} |
||
+ | |||
+ | {{bc|<nowiki> |
||
+ | {{Tip|1=<nowiki/> |
||
+ | * https://archlinux.org/?foo=bar |
||
+ | * https://archlinux.org/?foo=baz |
||
+ | }} |
||
+ | </nowiki>}} |
||
+ | |||
+ | 表示: |
||
+ | |||
+ | {{Tip|1=<nowiki/> |
||
+ | * https://archlinux.org/?foo=bar |
||
+ | * https://archlinux.org/?foo=baz |
||
+ | }} |
||
+ | |||
+ | ===== 複数のパラメータ ===== |
||
+ | |||
+ | * ポジション番号付きパラメータ {{ic|1}} と {{ic|2}} を使う |
||
<nowiki>{{hc|1=$ echo "="|2==}}</nowiki> |
<nowiki>{{hc|1=$ echo "="|2==}}</nowiki> |
||
− | + | 表示: {{hc|1=$ echo "="|2==}} |
|
− | * |
+ | * 名前付きパラメータ {{ic|head}} と {{ic|output}} を使う |
<nowiki>{{hc|head=$ echo "="|output==}}</nowiki> |
<nowiki>{{hc|head=$ echo "="|output==}}</nowiki> |
||
− | + | 表示: {{hc|head=$ echo "="|output==}} |
|
==== nowiki タグ ==== |
==== nowiki タグ ==== |
||
88行目: | 107行目: | ||
"}" など "=" 以外の文字列で問題を抱えている場合、パラメータ全体を {{ic|<nowiki><nowiki></nowiki>}} タグで囲ってしまう方法が推奨されます。この方法ではあらゆる文字列を表示しますが、リンクや他のテンプレートなどのテキストマークアップも wiki エンジンによって処理されなくなります。例: |
"}" など "=" 以外の文字列で問題を抱えている場合、パラメータ全体を {{ic|<nowiki><nowiki></nowiki>}} タグで囲ってしまう方法が推奨されます。この方法ではあらゆる文字列を表示しますが、リンクや他のテンプレートなどのテキストマークアップも wiki エンジンによって処理されなくなります。例: |
||
− | <nowiki>{{Tip|<nowiki>= | }} https:// |
+ | <nowiki>{{Tip|<nowiki>= | }} https://archlinux.org/ {{ic|foo}}</nowiki>}}</nowiki> |
− | {{Tip|<nowiki>= | }} https:// |
+ | {{Tip|<nowiki>= | }} https://archlinux.org/ {{ic|foo}}</nowiki>}} |
特定の部分だけ (あるいは一文字だけ) を {{ic|<nowiki><nowiki></nowiki>}} タグで囲うことも可能ですが、可読性を高めるために、リンクや他のテンプレートを通常通りに表示したいときだけに使うようにしてください。例: |
特定の部分だけ (あるいは一文字だけ) を {{ic|<nowiki><nowiki></nowiki>}} タグで囲うことも可能ですが、可読性を高めるために、リンクや他のテンプレートを通常通りに表示したいときだけに使うようにしてください。例: |
||
− | <nowiki>{{Tip|<nowiki>= | }}</nowiki> https:// |
+ | <nowiki>{{Tip|<nowiki>= | }}</nowiki> https://archlinux.org/ {{ic|foo}}}}</nowiki> |
− | {{Tip|<nowiki>= | }}</nowiki> https:// |
+ | {{Tip|<nowiki>= | }}</nowiki> https://archlinux.org/ {{ic|foo}}}} |
==== HTML エンティティ ==== |
==== HTML エンティティ ==== |
||
109行目: | 128行目: | ||
{{Note| |
{{Note| |
||
+ | * [[Special:ListGroupRights#Namespace restrictions|The Template namespace is semi-protected]]. Only [[ArchWiki:Access levels and roles#Access levels|autoconfirmed users]] can create or edit templates. |
||
* テンプレートを作成する前に、[[ヘルプ・トーク:テンプレート]]で議論してください。 |
* テンプレートを作成する前に、[[ヘルプ・トーク:テンプレート]]で議論してください。 |
||
* 作成するテンプレートは意味のあるものにしてください。特定の記事でしか使うことができないような、特殊なテンプレートを作成するのは止めて下さい。 |
* 作成するテンプレートは意味のあるものにしてください。特定の記事でしか使うことができないような、特殊なテンプレートを作成するのは止めて下さい。 |
||
119行目: | 139行目: | ||
{{Template}} |
{{Template}} |
||
+ | テンプレートの簡単な説明 |
||
− | A brief description of the template |
||
== 使用方法 == |
== 使用方法 == |
||
127行目: | 147行目: | ||
== サンプル == |
== サンプル == |
||
− | {{Template name|param1|param2|...|paramN}}</noinclude><includeonly> |
+ | {{Template name|param1|param2|...|paramN}}</noinclude><includeonly>ここにテンプレートのコードが来ます</includeonly></nowiki> |
テンプレートを作成するには、[[:Template:Template name]] ({{ic|Template name}} は作成したいテンプレートの名前に置き換えて下さい) を開いて [[ヘルプ:編集|wikitext を編集・追加]]してください。 |
テンプレートを作成するには、[[:Template:Template name]] ({{ic|Template name}} は作成したいテンプレートの名前に置き換えて下さい) を開いて [[ヘルプ:編集|wikitext を編集・追加]]してください。 |
||
144行目: | 164行目: | ||
=== 記事の状態テンプレート === |
=== 記事の状態テンプレート === |
||
+ | 以下のテンプレートは、影響するページかセクションの一番上に追加する必要があります。[[ヘルプ:スタイル#記事の状態テンプレート]] も参照してください。 |
||
− | For use on articles in all languages: |
||
+ | 翻訳者は [[ArchWiki 翻訳チーム]] のテンプレートガイドラインも確認する必要があります。 |
||
− | * [[Template:Accuracy]] |
||
− | * [[Template:Expansion]] |
||
− | * [[Template:Merge]] |
||
− | * [[Template:Move]] |
||
− | * [[Template:Laptop style]] |
||
− | * [[Template:Out of date]] |
||
− | * [[Template:Redirect]] |
||
− | * [[Template:Remove]] |
||
− | * [[Template:Style]] |
||
+ | 記事の状態テンプレートが付けられたページは、対応する [[:カテゴリ:メンテナンス|メンテナンスカテゴリ]] と [[ArchWiki:統計#メンテナンス統計]] で追跡されます。 |
||
− | For use on non-English articles: |
||
+ | {| class="wikitable" |
||
− | * [[Template:Bad translation]] |
||
+ | ! 名前 !! 推奨される使用方法 !! 引数 |
||
− | * [[Template:Translateme]] |
||
+ | |- |
||
− | |||
+ | | [[Template:Style]] || 言葉遣い・wiki 構文・スタイルの問題のある内容。 |
||
− | For articles to be archived: |
||
+ | | rowspan=9 | {{ic|1}} — 理由、{{ic|2}} — 任意の議論ページ、{{ic|section}} — デフォルトの議論ページでの任意のセクション |
||
− | |||
+ | |- |
||
− | * [[Template:Archive]] |
||
+ | | [[Template:Accuracy]] || 正しくない・誤解させる・混乱させる内容。 |
||
− | |||
+ | |- |
||
− | {{Note|The pages flagged with the article status templates are tracked in the corresponding [[:en:Category:Maintenance|maintenance category]] and in [[:en:ArchWiki:Statistics#Maintenance statistics]].}} |
||
+ | | [[Template:Expansion]] || 不完全な内容。 |
||
+ | |- |
||
+ | | [[Template:Out of date]] || 古くなった内容。 |
||
+ | |- |
||
+ | | [[Template:Remove]] || 関係のない・役に立たない内容。 |
||
+ | |- |
||
+ | | [[Template:Archive]] || もう使われていない内容。 |
||
+ | |- |
||
+ | | [[Template:Laptop style]] || [[:en:Help:Laptop page guidelines|Laptop page guidelines]] に従っていない [[ノートパソコン]] のページ。 |
||
+ | |- |
||
+ | | [[Template:Translateme]] || 不完全な翻訳。 |
||
+ | |- |
||
+ | | [[Template:Bad translation]] || 問題のある翻訳。 |
||
+ | |- |
||
+ | | [[Template:TranslationStatus]] || 翻訳の状態。 |
||
+ | | {{ic|1}} — 英語版のタイトル、{{ic|2}} — 翻訳した日、{{ic|3}} — 版の番号 |
||
+ | |- |
||
+ | | [[Template:Merge]] || 他のページと重複する内容。 |
||
+ | | rowspan=3 | {{ic|1}} — 対象のページ、{{ic|2}} — 理由、{{ic|3}} — 任意の議論ページ、{{ic|section}} — デフォルトの議論ページでの任意のセクション |
||
+ | |- |
||
+ | | [[Template:Move]] || ページ名の変更・セクションの他のページへの移動。 |
||
+ | |- |
||
+ | | [[Template:Redirect]] || 他のページへのリダイレクト。 |
||
+ | |- |
||
+ | | [[Template:Unsupported]] || Arch Linux によりサポートされないユーザーページ。 || {{ic|1}} — ページの作者により最後に確認された日 |
||
+ | |} |
||
=== 関連記事のテンプレート === |
=== 関連記事のテンプレート === |
||
185行目: | 223行目: | ||
* [[Template:Tip]] |
* [[Template:Tip]] |
||
* [[Template:Warning]] |
* [[Template:Warning]] |
||
+ | |||
+ | 以下のテンプレートは議論ページでの下書きでのみ使用できます。 |
||
+ | * [[Template:Comment]] |
||
=== 雑多なテンプレート === |
=== 雑多なテンプレート === |
||
190行目: | 231行目: | ||
* [[Template:App]] |
* [[Template:App]] |
||
* [[Template:Broken package link]] |
* [[Template:Broken package link]] |
||
+ | * [[Template:Broken section link]] |
||
* [[Template:Bug]] |
* [[Template:Bug]] |
||
+ | * [[Template:Committed identity]] |
||
* [[Template:Dead link]] |
* [[Template:Dead link]] |
||
* [[Template:Lowercase title]] |
* [[Template:Lowercase title]] |
||
204行目: | 247行目: | ||
=== テーブルテンプレート === |
=== テーブルテンプレート === |
||
+ | テキストの配置: |
||
− | Text align: |
||
{| class="wikitable" |
{| class="wikitable" |
||
|- |
|- |
||
− | ! width=100px | |
+ | ! width=100px | 名前 !! width=100px | 配置 !! width=100px | Wiki マークアップ !! width=100px | 表示 |
|- |
|- |
||
| [[Template:C]] || center || {{ic|<nowiki>{{C|text}}</nowiki>}} || {{C|text}} |
| [[Template:C]] || center || {{ic|<nowiki>{{C|text}}</nowiki>}} || {{C|text}} |
||
+ | |- |
||
+ | | [[Template:L]] || left || {{ic|<nowiki>{{L|text}}</nowiki>}} || {{L|text}} |
||
|} |
|} |
||
+ | セルの背景: |
||
− | Cell background: |
||
{| class="wikitable" |
{| class="wikitable" |
||
− | ! width=100px | |
+ | ! width=100px | 名前 !! width=100px | 色 !! width=100px | Wiki マークアップ !! width=100px | 表示 |
|- |
|- |
||
| [[Template:R]] || red || {{ic|<nowiki>{{R|text}}</nowiki>}} || {{R|text}} |
| [[Template:R]] || red || {{ic|<nowiki>{{R|text}}</nowiki>}} || {{R|text}} |
||
+ | |- |
||
+ | | [[Template:O]] || orange || {{ic|<nowiki>{{O|text}}</nowiki>}} || {{O|text}} |
||
|- |
|- |
||
| [[Template:Y]] || yellow || {{ic|<nowiki>{{Y|text}}</nowiki>}} || {{Y|text}} |
| [[Template:Y]] || yellow || {{ic|<nowiki>{{Y|text}}</nowiki>}} || {{Y|text}} |
||
225行目: | 272行目: | ||
|- |
|- |
||
| [[Template:B]] || blue || {{ic|<nowiki>{{B|text}}</nowiki>}} || {{B|text}} |
| [[Template:B]] || blue || {{ic|<nowiki>{{B|text}}</nowiki>}} || {{B|text}} |
||
+ | |- |
||
+ | | [[Template:V]] || violet || {{ic|<nowiki>{{V|text}}</nowiki>}} || {{V|text}} |
||
|- |
|- |
||
| [[Template:Grey]] || grey || {{ic|<nowiki>{{Grey|text}}</nowiki>}} || {{Grey|text}} |
| [[Template:Grey]] || grey || {{ic|<nowiki>{{Grey|text}}</nowiki>}} || {{Grey|text}} |
||
|} |
|} |
||
+ | 一般的なテキスト: |
||
− | Common text: |
||
{| class="wikitable" |
{| class="wikitable" |
||
− | ! width=100px | |
+ | ! width=100px | 名前 !! Wiki マークアップ !! width=100px | 表示 |
|- |
|- |
||
| rowspan=2 | [[Template:Yes]] || {{ic|<nowiki>{{Yes}}</nowiki>}} || {{Yes}} |
| rowspan=2 | [[Template:Yes]] || {{ic|<nowiki>{{Yes}}</nowiki>}} || {{Yes}} |
||
245行目: | 294行目: | ||
|} |
|} |
||
− | {{Tip| |
+ | {{Tip|属性は、セルのテンプレートの前に配置することで使うことができます。例: {{ic|<nowiki>| colspan=2 {{Yes}}</nowiki>}} }} |
− | === |
+ | === カテゴリテンプレート === |
* [[Template:Cat main]] |
* [[Template:Cat main]] |
||
254行目: | 303行目: | ||
* [[Template:Template]] |
* [[Template:Template]] |
||
− | * http://meta.wikimedia.org/wiki/Help:Template |
+ | * http://meta.wikimedia.org/wiki/Help:Template/ja |
+ | |||
+ | {{TranslationStatus|Help:Template|2021-12-31|707589}} |
2021年12月31日 (金) 09:20時点における最新版
テンプレートは、記事に挿入することが出来る定義済みの wikitext です。テンプレートは主としてコンテンツを整形するために使われます。
目次
使用方法
以下のマークアップを記事に追加することでテンプレートを使えます:
{{Template name}}
ほとんどのテンプレートは引数を指定します。例えば Template:Note の場合:
{{Note|This text should be noted.}}
以下のように表示されます:
テンプレートによっては名前付きのパラメータを使うことがあります。Template:hc の場合:
{{hc|head=/etc/rc.local|output=exit 0}}
以下のように表示されます:
/etc/rc.local
exit 0
一般的なフォーマットは:
{{Template name|param1|param2|...|paramN}}
使用方法についてはそれぞれのテンプレートのページを見て下さい。
スタイル
- テンプレートの名前の先頭の大文字・小文字はサンプルに合わせてください。例えば
{{Pkg|...
や{{ic|...
は正しく、{{pkg|...
や{{Ic|...
は誤り。 - テンプレートの名前の前後に空白を挟んではいけません:
{{Template name|...
は正しく、{{ Template name |...
は誤りです。 - テンプレートはカテゴリに入れてはいけません。
テンプレートを破壊する文字列のエスケープ
テンプレートの中で使用すると、出力が破壊される文字列が存在します: その中で最も頻繁に使われるのが "=" (イコール記号) と "|" (パイプ記号) です。以下の方法でエスケープしてください。
名前・番号付きパラメータ
問題が "=" 記号だけの場合、テンプレートのパラメータの名前やポジション番号を使うことで解決するのがおすすめです。
例: {{Tip|1=https://archlinux.org/?foo=bar}}
表示:
これは以下のような場合にとても便利です。
- 変数の定義
- URL にクエリ文字列を含む外部リンク
- シェルの文字列やコマンド
- コードの行
名前付きパラメータの値の先頭・末尾にある空白文字 (例えば改行) は 自動で除去されます。空白文字を残すには、パラメータの値を <nowiki/>
タグで開始してください。
例:
{{Tip|1=<nowiki/> * https://archlinux.org/?foo=bar * https://archlinux.org/?foo=baz }}
表示:
複数のパラメータ
- ポジション番号付きパラメータ
1
と2
を使う
{{hc|1=$ echo "="|2==}}
表示:
$ echo "="
=
- 名前付きパラメータ
head
とoutput
を使う
{{hc|head=$ echo "="|output==}}
表示:
$ echo "="
=
nowiki タグ
"}" など "=" 以外の文字列で問題を抱えている場合、パラメータ全体を <nowiki>
タグで囲ってしまう方法が推奨されます。この方法ではあらゆる文字列を表示しますが、リンクや他のテンプレートなどのテキストマークアップも wiki エンジンによって処理されなくなります。例:
{{Tip|<nowiki>= | }} https://archlinux.org/ {{ic|foo}}</nowiki>}}
特定の部分だけ (あるいは一文字だけ) を <nowiki>
タグで囲うことも可能ですが、可読性を高めるために、リンクや他のテンプレートを通常通りに表示したいときだけに使うようにしてください。例:
{{Tip|<nowiki>= | }}</nowiki> https://archlinux.org/ {{ic|foo}}}}
HTML エンティティ
問題の文字列を、対応する HTML エンティティで置き換える方法もありますが、ソーステキストの可読性が失われるため、上記の方法が使えない場合にのみ利用してください。例:
{{Tip|= | {{ }}}}
作成
以下のテンプレートを使うことで新しいテンプレートを作成して利用・編集できます:
<noinclude> {{Template}} テンプレートの簡単な説明 == 使用方法 == <nowiki>{{Template name|param1|param2|...|paramN}}</nowiki> == サンプル == {{Template name|param1|param2|...|paramN}}</noinclude><includeonly>ここにテンプレートのコードが来ます</includeonly>
テンプレートを作成するには、Template:Template name (Template name
は作成したいテンプレートの名前に置き換えて下さい) を開いて wikitext を編集・追加してください。
テンプレート一覧
ArchWiki の記事で直接使うことができるテンプレートは以下の通りです。詳しくはそれぞれのリンクをクリックしてください。ローカリゼーションやメタテンプレートのリストは特別:ページ一覧/テンプレート:、特別:前方一致ページ一覧/テンプレート:、特別:使用箇所の多いテンプレートを見てください。
テスト
記事の状態テンプレート
以下のテンプレートは、影響するページかセクションの一番上に追加する必要があります。ヘルプ:スタイル#記事の状態テンプレート も参照してください。
翻訳者は ArchWiki 翻訳チーム のテンプレートガイドラインも確認する必要があります。
記事の状態テンプレートが付けられたページは、対応する メンテナンスカテゴリ と ArchWiki:統計#メンテナンス統計 で追跡されます。
名前 | 推奨される使用方法 | 引数 |
---|---|---|
Template:Style | 言葉遣い・wiki 構文・スタイルの問題のある内容。 | 1 — 理由、2 — 任意の議論ページ、section — デフォルトの議論ページでの任意のセクション
|
Template:Accuracy | 正しくない・誤解させる・混乱させる内容。 | |
Template:Expansion | 不完全な内容。 | |
Template:Out of date | 古くなった内容。 | |
Template:Remove | 関係のない・役に立たない内容。 | |
Template:Archive | もう使われていない内容。 | |
Template:Laptop style | Laptop page guidelines に従っていない ノートパソコン のページ。 | |
Template:Translateme | 不完全な翻訳。 | |
Template:Bad translation | 問題のある翻訳。 | |
Template:TranslationStatus | 翻訳の状態。 | 1 — 英語版のタイトル、2 — 翻訳した日、3 — 版の番号
|
Template:Merge | 他のページと重複する内容。 | 1 — 対象のページ、2 — 理由、3 — 任意の議論ページ、section — デフォルトの議論ページでの任意のセクション
|
Template:Move | ページ名の変更・セクションの他のページへの移動。 | |
Template:Redirect | 他のページへのリダイレクト。 | |
Template:Unsupported | Arch Linux によりサポートされないユーザーページ。 | 1 — ページの作者により最後に確認された日
|
関連記事のテンプレート
コード整形のテンプレート
ノートテンプレート
以下のテンプレートは議論ページでの下書きでのみ使用できます。
雑多なテンプレート
- Template:App
- Template:Broken package link
- Template:Broken section link
- Template:Bug
- Template:Committed identity
- Template:Dead link
- Template:Lowercase title
- Template:man
- Template:Unsigned
パッケージのテンプレート
テーブルテンプレート
テキストの配置:
名前 | 配置 | Wiki マークアップ | 表示 |
---|---|---|---|
Template:C | center | {{C|text}} |
text |
Template:L | left | {{L|text}} |
text |
セルの背景:
名前 | 色 | Wiki マークアップ | 表示 |
---|---|---|---|
Template:R | red | {{R|text}} |
text |
Template:O | orange | {{O|text}} |
text |
Template:Y | yellow | {{Y|text}} |
text |
Template:G | green | {{G|text}} |
text |
Template:B | blue | {{B|text}} |
text |
Template:V | violet | {{V|text}} |
text |
Template:Grey | grey | {{Grey|text}} |
text |
一般的なテキスト:
名前 | Wiki マークアップ | 表示 |
---|---|---|
Template:Yes | {{Yes}} |
Yes |
{{Yes|https://wiki.archlinux.org/}} |
Yes | |
Template:No | {{No}} |
No |
{{No|https://wiki.archlinux.org/}} |
No | |
Template:- | {{-}} |
– |