ヘルプ:テンプレート
テンプレートは、記事に挿入することが出来る定義済みの 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://www.archlinux.org/?foo=bar}}
表示:
これは以下のような場合にとても便利です。
- 変数の定義
- URL にクエリ文字列を含む 外部リンク
- シェルの文字列やコマンド
- コードの行
複数のパラメータ
- ポジション番号付きパラメータ
1
と2
を使う
{{hc|1=$ echo "="|2==}}
表示:
$ echo "="
=
- 名前付きパラメータ
head
とoutput
を使う
{{hc|head=$ echo "="|output==}}
表示:
$ echo "="
=
nowiki タグ
"}" など "=" 以外の文字列で問題を抱えている場合、パラメータ全体を <nowiki>
タグで囲ってしまう方法が推奨されます。この方法ではあらゆる文字列を表示しますが、リンクや他のテンプレートなどのテキストマークアップも wiki エンジンによって処理されなくなります。例:
{{Tip|<nowiki>= | }} https://www.archlinux.org/ {{ic|foo}}</nowiki>}}
特定の部分だけ (あるいは一文字だけ) を <nowiki>
タグで囲うことも可能ですが、可読性を高めるために、リンクや他のテンプレートを通常通りに表示したいときだけに使うようにしてください。例:
{{Tip|<nowiki>= | }}</nowiki> https://www.archlinux.org/ {{ic|foo}}}}
HTML エンティティ
問題の文字列を、対応する HTML エンティティで置き換える方法もありますが、ソーステキストの可読性が失われるため、上記の方法が使えない場合にのみ利用してください。例:
{{Tip|= | {{ }}}}
作成
以下のテンプレートを使うことで新しいテンプレートを作成して利用・編集できます:
<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 の記事で直接使うことができるテンプレートは以下の通りです。詳しくはそれぞれのリンクをクリックしてください。ローカリゼーションやメタテンプレートのリストは特別:ページ一覧/テンプレート:、特別:前方一致ページ一覧/テンプレート:、特別:使用箇所の多いテンプレートを見てください。
テスト
記事の状態テンプレート
For use on articles in all languages:
- Template:Accuracy
- Template:Expansion
- Template:Merge
- Template:Move
- Template:Laptop style
- Template:Out of date
- Template:Redirect
- Template:Remove
- Template:Style
For use on non-English articles:
For articles to be archived:
関連記事のテンプレート
コード整形のテンプレート
ノートテンプレート
雑多なテンプレート
- Template:App
- Template:Broken package link
- Template:Bug
- Template:Dead link
- Template:Lowercase title
- Template:man
- Template:Unsigned
パッケージのテンプレート
テーブルテンプレート
Text align:
Name | Align | Wiki markup | Result |
---|---|---|---|
Template:C | center | {{C|text}} |
text |
Cell background:
Name | Color | Wiki markup | Result |
---|---|---|---|
Template:R | red | {{R|text}} |
text |
Template:Y | yellow | {{Y|text}} |
text |
Template:G | green | {{G|text}} |
text |
Template:B | blue | {{B|text}} |
text |
Template:Grey | grey | {{Grey|text}} |
text |
Common text:
Name | Wiki markup | Result |
---|---|---|
Template:Yes | {{Yes}} |
Yes |
{{Yes|https://wiki.archlinux.org/}} |
Yes | |
Template:No | {{No}} |
No |
{{No|https://wiki.archlinux.org/}} |
No | |
Template:- | {{-}} |
– |