ヘルプ:テンプレート
テンプレートは、記事に挿入することが出来る定義済みの 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:- | {{-}} |
– |