コンテンツにスキップ

「ヘルプ:テンプレート」の版間の差分

提供: ArchWiki
削除された内容 追加された内容
en:Help:Templateへの転送ページ
 
編集の要約なし
1行目: 1行目:
[[Category:ヘルプ]]
#redirect[[en:Help:Template]]
[[en:Help:Template]]
[[es:Help:Template]]
[[ru:Help:Template]]
[[zh-CN:Help:Template]]
[[zh-TW:Help:Template]]
{{Related articles start}}
{{Related|ヘルプ:編集}}
{{Related|ヘルプ:読み方}}
{{Related|ヘルプ:スタイル}}
{{Related articles end}}

テンプレートは、記事に挿入することが出来る定義済みの [[Wikipedia:Wikitext|wikitext]] です。テンプレートは主としてコンテンツを整形するために使われます。

== 使用方法 ==

以下のマークアップを記事に追加することでテンプレートを使えます:

<nowiki>{{Template name}}</nowiki>

ほとんどのテンプレートは引数を指定します。例えば [[Template:Note]] の場合:

<nowiki>{{Note|This text should be noted.}}</nowiki>

以下のように表示されます:

{{Note|This text should be noted.}}

テンプレートによっては名前付きのパラメータを使うことがあります。[[Template:hc]] の場合:

<nowiki>{{hc|head=/etc/rc.local|output=exit 0}}</nowiki>

以下のように表示されます:

{{hc|head=/etc/rc.local|output=exit 0}}

一般的なフォーマットは:

<nowiki>{{Template name|param1|param2|...|paramN}}</nowiki>

使用方法についてはそれぞれのテンプレートのページを見て下さい。

=== スタイル ===

* テンプレートの名前の先頭は大文字にしてください。例えば {{ic|&#123;{Pkg&#124;...}} や {{ic|&#123;{ic&#124;...}} は正しく、{{ic|&#123;{pkg&#124;...}} や {{ic|&#123;{Ic&#124;...}} は誤り。
* テンプレートの名前に空白を挟んではいけません: {{ic|&#123;{Template name&#124;...}} は正しく、{{ic|&#123;{ Template name &#124;...}} は誤りです。
* テンプレートはカテゴリに入れてはいけません。

=== テンプレートを破壊する文字列のエスケープ ===

テンプレートの中で使用すると、出力が破壊される文字列が存在します: その中で最も頻繁に使われるのが "=" (イコール記号) と "|" (パイプ記号) です。以下の方法でエスケープしてください。

==== 名前付きパラメータ ====

問題が "=" 記号だけの場合、テンプレートのパラメータの名前やポジション番号を使うことで解決するのがおすすめです。URL にクエリ文字列を含む[[ヘルプ:編集#外部リンク|外部リンク]]や変数の定義で有用ですが、"|" など他の問題がある文字列には通用しません。例:

<nowiki>{{Tip|1=https://www.archlinux.org/?foo=bar}}</nowiki>

{{Tip|1=https://www.archlinux.org/?foo=bar}}

もしくは、複数のパラメータを使って:

<nowiki>{{hc|1=$ echo "="|2==}}</nowiki>

<nowiki>{{hc|head=$ echo "="|output==}}</nowiki>

{{hc|1=$ echo "="|2==}}

==== nowiki タグ ====


"|" など "=" 以外の文字列で問題を抱えている場合、パラメータ全体を {{ic|<nowiki><nowiki></nowiki>}} タグで囲ってしまう方法が推奨されます。この方法ではあらゆる文字列を表示しますが、リンクや他のテンプレートなどのテキストマークアップも wiki エンジンによって処理されなくなります。例:

<nowiki>{{Tip|&lt;nowiki>= | }} https://www.archlinux.org/ {{ic|foo}}&lt;/nowiki>}}</nowiki>

{{Tip|<nowiki>= | }} https://www.archlinux.org/ {{ic|foo}}</nowiki>}}

特定の部分だけ (あるいは一文字だけ) を {{ic|<nowiki><nowiki></nowiki>}} タグで囲うことも可能ですが、可読性を高めるために、リンクや他のテンプレートを通常通りに表示したいときだけに使うようにしてください。例:

<nowiki>{{Tip|&lt;nowiki>= | }}&lt;/nowiki> https://www.archlinux.org/ {{ic|foo}}}}</nowiki>

{{Tip|<nowiki>= | }}</nowiki> https://www.archlinux.org/ {{ic|foo}}}}

==== HTML エンティティ ====

問題の文字列を、対応する HTML エンティティで置き換える方法もありますが、ソーステキストの可読性が失われるため、上記の方法が使えない場合にのみ利用してください。例:

<nowiki>{{Tip|&amp;#61; &amp;#124; &amp;#125;&amp;#125;}}</nowiki>

{{Tip|&#61; &#124; &#125;&#125;}}

== 作成 ==

{{Note|
* テンプレートを作成する前に、[[ヘルプ・トーク:テンプレート]]で議論してください。
* 作成するテンプレートは意味のあるものにしてください。特定の記事でしか使うことができないような、特殊なテンプレートを作成するのは止めて下さい。
* テンプレートは簡潔にしてください。[[The Arch Way]] を思い出しましょう: Keep It Simple, Stupid!
}}

以下のテンプレートを使うことで新しいテンプレートを作成して利用・編集できます:

<nowiki><noinclude>
{{Template}}

A brief description of the template

== 使用方法 ==

&lt;nowiki&gt;{{Template name|param1|param2|...|paramN}}&lt;/nowiki&gt;

== サンプル ==

{{Template name|param1|param2|...|paramN}}</noinclude><includeonly>Template code goes here...</includeonly></nowiki>

テンプレートを作成するには、[[:Template:Template name]] ({{ic|Template name}} は作成したいテンプレートの名前に置き換えて下さい) を開いて [[ヘルプ:編集|wikitext を編集・追加]]してください。

== テンプレート一覧 ==

ArchWiki の記事で直接使うことができるテンプレートは以下の通りです。詳しくはそれぞれのリンクをクリックしてください。ローカリゼーションやメタテンプレートのリストは [[Special:AllPages/Template:]], [[Special:PrefixIndex/Template:]], [[Special:MostLinkedTemplates]] を見て下さい。

{{Warning|既存のテンプレートで実験をしてはいけません。保護されていないテンプレートを編集したいときは、テキストを[[テンプレート:サンドボックス]]にコピーして、編集・テストしてから、元のテンプレートにコピーし直して下さい。まずは議論ページで変更を提案することを強く推奨します (テンプレートが保護されている場合は必須)。}}

=== テスト ===

* [[en2:Template:Sandbox]]
* [[en2:Template:Lorem Ipsum]]

=== 記事の状態テンプレート ===

* [[Template:Accuracy]]
* [[en2:Template:Bad translation]]
* [[Template:Deletion]]
* [[Template:Expansion]]
* [[en2:Template:Laptop style]]
* [[en2:Template:Merge]]
* [[en2:Template:Move]]
* [[Template:Out of date]]
* [[Template:Stub]]
* [[en2:Template:Style]]
* [[en2:Template:Translateme]]

=== 関連記事のテンプレート ===

* [[Template:Related articles start]]
* [[Template:Related]]
* [[Template:Related articles end]]

=== コード整形のテンプレート ===

* [[Template:ic]]
* [[Template:bc]]
* [[Template:hc]]

=== ノートテンプレート ===

* [[Template:Note]]
* [[Template:Tip]]
* [[Template:Warning]]

=== 雑多なテンプレート ===

* [[Template:App]]
* [[Template:Bug]]
* [[Template:Dead link]]
* [[Template:Broken package link]]
* [[en2:Template:Unsigned]]

=== パッケージのテンプレート ===

* [[Template:Pkg]]
* [[Template:Grp]]
* [[Template:AUR]]

=== テーブルテンプレート ===

* [[Template:R]]
* [[Template:G]]
* [[Template:B]]
* [[en2:Template:C]]
* [[en2:Template:M]]
* [[Template:Y]]
* [[Template:Yes]]
* [[Template:No]]

== 参照 ==

* [[Template:Template]]
* http://meta.wikimedia.org/wiki/Help:Template

2015年11月30日 (月) 19:44時点における版

テンプレートは、記事に挿入することが出来る定義済みの wikitext です。テンプレートは主としてコンテンツを整形するために使われます。

使用方法

以下のマークアップを記事に追加することでテンプレートを使えます:

{{Template name}}

ほとんどのテンプレートは引数を指定します。例えば Template:Note の場合:

{{Note|This text should be noted.}}

以下のように表示されます:

ノート 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 |... は誤りです。
  • テンプレートはカテゴリに入れてはいけません。

テンプレートを破壊する文字列のエスケープ

テンプレートの中で使用すると、出力が破壊される文字列が存在します: その中で最も頻繁に使われるのが "=" (イコール記号) と "|" (パイプ記号) です。以下の方法でエスケープしてください。

名前付きパラメータ

問題が "=" 記号だけの場合、テンプレートのパラメータの名前やポジション番号を使うことで解決するのがおすすめです。URL にクエリ文字列を含む外部リンクや変数の定義で有用ですが、"|" など他の問題がある文字列には通用しません。例:

{{Tip|1=https://www.archlinux.org/?foo=bar}}

もしくは、複数のパラメータを使って:

{{hc|1=$ echo "="|2==}}
{{hc|head=$ echo "="|output==}}
$ echo "="
=

nowiki タグ

"|" など "=" 以外の文字列で問題を抱えている場合、パラメータ全体を <nowiki> タグで囲ってしまう方法が推奨されます。この方法ではあらゆる文字列を表示しますが、リンクや他のテンプレートなどのテキストマークアップも wiki エンジンによって処理されなくなります。例:

{{Tip|<nowiki>= | }} https://www.archlinux.org/ {{ic|foo}}</nowiki>}}
ヒント = | }} https://www.archlinux.org/ {{ic|foo}}

特定の部分だけ (あるいは一文字だけ) を <nowiki> タグで囲うことも可能ですが、可読性を高めるために、リンクや他のテンプレートを通常通りに表示したいときだけに使うようにしてください。例:

{{Tip|<nowiki>= | }}</nowiki> https://www.archlinux.org/ {{ic|foo}}}}
ヒント = | }} https://www.archlinux.org/ foo

HTML エンティティ

問題の文字列を、対応する HTML エンティティで置き換える方法もありますが、ソーステキストの可読性が失われるため、上記の方法が使えない場合にのみ利用してください。例:

{{Tip|&#61; &#124; &#125;&#125;}}
ヒント = | }}

作成

ノート
  • テンプレートを作成する前に、ヘルプ・トーク:テンプレートで議論してください。
  • 作成するテンプレートは意味のあるものにしてください。特定の記事でしか使うことができないような、特殊なテンプレートを作成するのは止めて下さい。
  • テンプレートは簡潔にしてください。The Arch Way を思い出しましょう: Keep It Simple, Stupid!

以下のテンプレートを使うことで新しいテンプレートを作成して利用・編集できます:

<noinclude>
{{Template}}

A brief description of the template

== 使用方法 ==

<nowiki>{{Template name|param1|param2|...|paramN}}</nowiki>

== サンプル ==

{{Template name|param1|param2|...|paramN}}</noinclude><includeonly>Template code goes here...</includeonly>

テンプレートを作成するには、Template:Template name (Template name は作成したいテンプレートの名前に置き換えて下さい) を開いて wikitext を編集・追加してください。

テンプレート一覧

ArchWiki の記事で直接使うことができるテンプレートは以下の通りです。詳しくはそれぞれのリンクをクリックしてください。ローカリゼーションやメタテンプレートのリストは Special:AllPages/Template:, Special:PrefixIndex/Template:, Special:MostLinkedTemplates を見て下さい。

警告 既存のテンプレートで実験をしてはいけません。保護されていないテンプレートを編集したいときは、テキストをテンプレート:サンドボックスにコピーして、編集・テストしてから、元のテンプレートにコピーし直して下さい。まずは議論ページで変更を提案することを強く推奨します (テンプレートが保護されている場合は必須)。

テスト

記事の状態テンプレート

関連記事のテンプレート

コード整形のテンプレート

ノートテンプレート

雑多なテンプレート

パッケージのテンプレート

テーブルテンプレート

参照