「ヘルプ:テンプレート」の版間の差分
en:Help:Templateへの転送ページ |
|||
| (3人の利用者による、間の41版が非表示) | |||
| 1行目: | 1行目: | ||
[[Category:ヘルプ]] |
|||
#redirect[[en:Help:Template]] |
|||
[[el:Help:Template]] |
|||
[[en:Help:Template]] |
|||
[[es:Help:Template]] |
|||
[[fa:راهنما:الگو]] |
|||
[[fi:Help:Template]] |
|||
[[pt:Help:Template]] |
|||
[[ru:Help:Template]] |
|||
[[zh-hans:Help:Template]] |
|||
[[zh-hant: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|{{Pkg|...}} や {{ic|{{ic|...}} は正しく、{{ic|{{pkg|...}} や {{ic|{{Ic|...}} は誤り。 |
|||
* テンプレートの名前の前後に空白を挟んではいけません: {{ic|{{Template name|...}} は正しく、{{ic|{{ Template name |...}} は誤りです。 |
|||
* テンプレートはカテゴリに入れてはいけません。 |
|||
=== テンプレートを破壊する文字列のエスケープ === |
|||
テンプレートの中で使用すると、出力が破壊される文字列が存在します: その中で最も頻繁に使われるのが "=" (イコール記号) と "|" (パイプ記号) です。以下の方法でエスケープしてください。 |
|||
{{Tip|パイプ記号 "{{!}}" は {{ic|<nowiki>{{!}}</nowiki>}} [[MW:ja:Help:マジックワード#その他の変数|マジックワード]]でエスケープできます。}} |
|||
==== 名前・番号付きパラメータ ==== |
|||
問題が "=" 記号だけの場合、テンプレートのパラメータの名前やポジション番号を使うことで解決するのがおすすめです。 |
|||
例: {{ic|<nowiki>{{Tip|1=https://archlinux.org/?foo=bar}}</nowiki>}} |
|||
表示: {{Tip|1=https://archlinux.org/?foo=bar}} |
|||
これは以下のような場合にとても便利です。 |
|||
* 変数の定義 |
|||
* URL にクエリ文字列を含む[[ヘルプ:編集#外部リンク|外部リンク]] |
|||
* シェルの文字列やコマンド |
|||
* コードの行 |
|||
名前付きパラメータの値の先頭・末尾にある空白文字 (例えば改行) は 自動で除去されます。空白文字を残すには、パラメータの値を {{ic|<nowiki><nowiki/></nowiki>}} タグで開始してください。 |
|||
例: |
|||
{{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> |
|||
表示: {{hc|1=$ echo "="|2==}} |
|||
* 名前付きパラメータ {{ic|head}} と {{ic|output}} を使う |
|||
<nowiki>{{hc|head=$ echo "="|output==}}</nowiki> |
|||
表示: {{hc|head=$ echo "="|output==}} |
|||
==== nowiki タグ ==== |
|||
"}" など "=" 以外の文字列で問題を抱えている場合、パラメータ全体を {{ic|<nowiki><nowiki></nowiki>}} タグで囲ってしまう方法が推奨されます。この方法ではあらゆる文字列を表示しますが、リンクや他のテンプレートなどのテキストマークアップも wiki エンジンによって処理されなくなります。例: |
|||
<nowiki>{{Tip|<nowiki>= | }} https://archlinux.org/ {{ic|foo}}</nowiki>}}</nowiki> |
|||
{{Tip|<nowiki>= | }} https://archlinux.org/ {{ic|foo}}</nowiki>}} |
|||
特定の部分だけ (あるいは一文字だけ) を {{ic|<nowiki><nowiki></nowiki>}} タグで囲うことも可能ですが、可読性を高めるために、リンクや他のテンプレートを通常通りに表示したいときだけに使うようにしてください。例: |
|||
<nowiki>{{Tip|<nowiki>= | }}</nowiki> https://archlinux.org/ {{ic|foo}}}}</nowiki> |
|||
{{Tip|<nowiki>= | }}</nowiki> https://archlinux.org/ {{ic|foo}}}} |
|||
==== HTML エンティティ ==== |
|||
問題の文字列を、対応する HTML エンティティで置き換える方法もありますが、ソーステキストの可読性が失われるため、上記の方法が使えない場合にのみ利用してください。例: |
|||
<nowiki>{{Tip|&#61; &#124; &#123;&#123; &#125;&#125;}}</nowiki> |
|||
{{Tip|= | {{ }}}} |
|||
== 作成 == |
|||
{{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. |
|||
* テンプレートを作成する前に、[[ヘルプ・トーク:テンプレート]]で議論してください。 |
|||
* 作成するテンプレートは意味のあるものにしてください。特定の記事でしか使うことができないような、特殊なテンプレートを作成するのは止めて下さい。 |
|||
* テンプレートは簡潔にしてください。[[The Arch Way]] を思い出しましょう: Keep It Simple, Stupid! |
|||
}} |
|||
以下のテンプレートを使うことで新しいテンプレートを作成して利用・編集できます: |
|||
<nowiki><noinclude> |
|||
{{Template}} |
|||
テンプレートの簡単な説明 |
|||
== 使用方法 == |
|||
<nowiki>{{Template name|param1|param2|...|paramN}}</nowiki> |
|||
== サンプル == |
|||
{{Template name|param1|param2|...|paramN}}</noinclude><includeonly>ここにテンプレートのコードが来ます</includeonly></nowiki> |
|||
テンプレートを作成するには、[[:Template:Template name]] ({{ic|Template name}} は作成したいテンプレートの名前に置き換えて下さい) を開いて [[ヘルプ:編集|wikitext を編集・追加]]してください。 |
|||
== テンプレート一覧 == |
|||
ArchWiki の記事で直接使うことができるテンプレートは以下の通りです。詳しくはそれぞれのリンクをクリックしてください。ローカリゼーションやメタテンプレートのリストは[[特別:ページ一覧/テンプレート:]]、[[特別:前方一致ページ一覧/テンプレート:]]、[[特別:使用箇所の多いテンプレート]]を見てください。 |
|||
{{Warning|既存のテンプレートで実験をしてはいけません。保護されていないテンプレートを編集したいときは、テキストを[[テンプレート:サンドボックス]]にコピーして、編集・テストしてから、元のテンプレートにコピーし直して下さい。まずは議論ページで変更を提案することを強く推奨します (テンプレートが保護されている場合は必須)。}} |
|||
=== テスト === |
|||
* [[Template:サンドボックス]] |
|||
* [[Template:Lorem Ipsum]] |
|||
=== 記事の状態テンプレート === |
|||
以下のテンプレートは、影響するページかセクションの一番上に追加する必要があります。[[ヘルプ:スタイル#記事の状態テンプレート]] も参照してください。 |
|||
翻訳者は [[ArchWiki 翻訳チーム]] のテンプレートガイドラインも確認する必要があります。 |
|||
記事の状態テンプレートが付けられたページは、対応する [[:カテゴリ:メンテナンス|メンテナンスカテゴリ]] と [[ArchWiki:統計#メンテナンス統計]] で追跡されます。 |
|||
{| class="wikitable" |
|||
! 名前 !! 推奨される使用方法 !! 引数 |
|||
|- |
|||
| [[Template:Style]] || 言葉遣い・wiki 構文・スタイルの問題のある内容。 |
|||
| rowspan=9 | {{ic|1}} — 理由、{{ic|2}} — 任意の議論ページ、{{ic|section}} — デフォルトの議論ページでの任意のセクション |
|||
|- |
|||
| [[Template:Accuracy]] || 正しくない・誤解させる・混乱させる内容。 |
|||
|- |
|||
| [[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}} — ページの作者により最後に確認された日 |
|||
|} |
|||
=== 関連記事のテンプレート === |
|||
* [[Template:Related articles start]] |
|||
* [[Template:Related]] |
|||
* [[Template:Related articles end]] |
|||
=== コード整形のテンプレート === |
|||
* [[Template:ic]] |
|||
* [[Template:bc]] |
|||
* [[Template:hc]] |
|||
* [[Template:Text art]] |
|||
=== ノートテンプレート === |
|||
* [[Template:Note]] |
|||
* [[Template:Tip]] |
|||
* [[Template:Warning]] |
|||
以下のテンプレートは議論ページでの下書きでのみ使用できます。 |
|||
* [[Template:Comment]] |
|||
=== 雑多なテンプレート === |
|||
* [[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]] |
|||
=== パッケージのテンプレート === |
|||
* [[Template:Pkg]] |
|||
* [[Template:Grp]] |
|||
* [[Template:AUR]] |
|||
=== テーブルテンプレート === |
|||
テキストの配置: |
|||
{| class="wikitable" |
|||
|- |
|||
! width=100px | 名前 !! width=100px | 配置 !! width=100px | Wiki マークアップ !! width=100px | 表示 |
|||
|- |
|||
| [[Template:C]] || center || {{ic|<nowiki>{{C|text}}</nowiki>}} || {{C|text}} |
|||
|- |
|||
| [[Template:L]] || left || {{ic|<nowiki>{{L|text}}</nowiki>}} || {{L|text}} |
|||
|} |
|||
セルの背景: |
|||
{| class="wikitable" |
|||
! width=100px | 名前 !! width=100px | 色 !! width=100px | Wiki マークアップ !! width=100px | 表示 |
|||
|- |
|||
| [[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:G]] || green || {{ic|<nowiki>{{G|text}}</nowiki>}} || {{G|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}} |
|||
|} |
|||
一般的なテキスト: |
|||
{| class="wikitable" |
|||
! width=100px | 名前 !! Wiki マークアップ !! width=100px | 表示 |
|||
|- |
|||
| rowspan=2 | [[Template:Yes]] || {{ic|<nowiki>{{Yes}}</nowiki>}} || {{Yes}} |
|||
|- |
|||
| {{ic|<nowiki>{{Yes|https://wiki.archlinux.org/}}</nowiki>}} || {{Yes|https://wiki.archlinux.org/}} |
|||
|- |
|||
| rowspan=2 | [[Template:No]] || {{ic|<nowiki>{{No}}</nowiki>}} || {{No}} |
|||
|- |
|||
| {{ic|<nowiki>{{No|https://wiki.archlinux.org/}}</nowiki>}} || {{No|https://wiki.archlinux.org/}} |
|||
|- |
|||
| [[Template:-]] || {{ic|<nowiki>{{-}}</nowiki>}} || {{-}} |
|||
|} |
|||
{{Tip|属性は、セルのテンプレートの前に配置することで使うことができます。例: {{ic|<nowiki>| colspan=2 {{Yes}}</nowiki>}} }} |
|||
=== カテゴリテンプレート === |
|||
* [[Template:Cat main]] |
|||
== 参照 == |
|||
* [[Template: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}}}}
fooHTML エンティティ
問題の文字列を、対応する HTML エンティティで置き換える方法もありますが、ソーステキストの可読性が失われるため、上記の方法が使えない場合にのみ利用してください。例:
{{Tip|= | {{ }}}}
作成
- The Template namespace is semi-protected. Only autoconfirmed users can create or edit templates.
- テンプレートを作成する前に、ヘルプ・トーク:テンプレートで議論してください。
- 作成するテンプレートは意味のあるものにしてください。特定の記事でしか使うことができないような、特殊なテンプレートを作成するのは止めて下さい。
- テンプレートは簡潔にしてください。The Arch Way を思い出しましょう: Keep It Simple, Stupid!
以下のテンプレートを使うことで新しいテンプレートを作成して利用・編集できます:
<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:- | {{-}} |
– |
| colspan=2 {{Yes}}