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

提供: ArchWiki
ナビゲーションに移動 検索に移動
 
(同じ利用者による、間の7版が非表示)
4行目: 4行目:
 
[[es:Help:Template]]
 
[[es:Help:Template]]
 
[[fa:راهنما:الگو]]
 
[[fa:راهنما:الگو]]
  +
[[fi:Help:Template]]
 
[[pt:Help:Template]]
 
[[pt:Help:Template]]
 
[[ru:Help:Template]]
 
[[ru:Help:Template]]
13行目: 14行目:
 
{{Related|ヘルプ:スタイル}}
 
{{Related|ヘルプ:スタイル}}
 
{{Related articles end}}
 
{{Related articles end}}
 
 
テンプレートは、記事に挿入することが出来る定義済みの [[Wikipedia:Wikitext|wikitext]] です。テンプレートは主としてコンテンツを整形するために使われます。
 
テンプレートは、記事に挿入することが出来る定義済みの [[Wikipedia:Wikitext|wikitext]] です。テンプレートは主としてコンテンツを整形するために使われます。
   
60行目: 60行目:
 
問題が "=" 記号だけの場合、テンプレートのパラメータの名前やポジション番号を使うことで解決するのがおすすめです。
 
問題が "=" 記号だけの場合、テンプレートのパラメータの名前やポジション番号を使うことで解決するのがおすすめです。
   
例: {{ic|<nowiki>{{Tip|1=https://www.archlinux.org/?foo=bar}}</nowiki>}}
+
例: {{ic|<nowiki>{{Tip|1=https://archlinux.org/?foo=bar}}</nowiki>}}
   
表示: {{Tip|1=https://www.archlinux.org/?foo=bar}}
+
表示: {{Tip|1=https://archlinux.org/?foo=bar}}
   
 
これは以下のような場合にとても便利です。
 
これは以下のような場合にとても便利です。
70行目: 70行目:
 
* シェルの文字列やコマンド
 
* シェルの文字列やコマンド
 
* コードの行
 
* コードの行
  +
  +
名前付きパラメータの値の先頭・末尾にある空白文字 (例えば改行) は 自動で除去されます。空白文字を残すには、パラメータの値を {{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
  +
}}
   
 
===== 複数のパラメータ =====
 
===== 複数のパラメータ =====
89行目: 107行目:
 
"}" など "=" 以外の文字列で問題を抱えている場合、パラメータ全体を {{ic|<nowiki><nowiki></nowiki>}} タグで囲ってしまう方法が推奨されます。この方法ではあらゆる文字列を表示しますが、リンクや他のテンプレートなどのテキストマークアップも wiki エンジンによって処理されなくなります。例:
 
"}" など "=" 以外の文字列で問題を抱えている場合、パラメータ全体を {{ic|<nowiki><nowiki></nowiki>}} タグで囲ってしまう方法が推奨されます。この方法ではあらゆる文字列を表示しますが、リンクや他のテンプレートなどのテキストマークアップも wiki エンジンによって処理されなくなります。例:
   
<nowiki>{{Tip|&lt;nowiki>= | }} https://www.archlinux.org/ {{ic|foo}}&lt;/nowiki>}}</nowiki>
+
<nowiki>{{Tip|&lt;nowiki>= | }} https://archlinux.org/ {{ic|foo}}&lt;/nowiki>}}</nowiki>
   
{{Tip|<nowiki>= | }} https://www.archlinux.org/ {{ic|foo}}</nowiki>}}
+
{{Tip|<nowiki>= | }} https://archlinux.org/ {{ic|foo}}</nowiki>}}
   
 
特定の部分だけ (あるいは一文字だけ) を {{ic|<nowiki><nowiki></nowiki>}} タグで囲うことも可能ですが、可読性を高めるために、リンクや他のテンプレートを通常通りに表示したいときだけに使うようにしてください。例:
 
特定の部分だけ (あるいは一文字だけ) を {{ic|<nowiki><nowiki></nowiki>}} タグで囲うことも可能ですが、可読性を高めるために、リンクや他のテンプレートを通常通りに表示したいときだけに使うようにしてください。例:
   
<nowiki>{{Tip|&lt;nowiki>= | }}&lt;/nowiki> https://www.archlinux.org/ {{ic|foo}}}}</nowiki>
+
<nowiki>{{Tip|&lt;nowiki>= | }}&lt;/nowiki> https://archlinux.org/ {{ic|foo}}}}</nowiki>
   
{{Tip|<nowiki>= | }}</nowiki> https://www.archlinux.org/ {{ic|foo}}}}
+
{{Tip|<nowiki>= | }}</nowiki> https://archlinux.org/ {{ic|foo}}}}
   
 
==== HTML エンティティ ====
 
==== HTML エンティティ ====
110行目: 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.
 
* テンプレートを作成する前に、[[ヘルプ・トーク:テンプレート]]で議論してください。
 
* テンプレートを作成する前に、[[ヘルプ・トーク:テンプレート]]で議論してください。
 
* 作成するテンプレートは意味のあるものにしてください。特定の記事でしか使うことができないような、特殊なテンプレートを作成するのは止めて下さい。
 
* 作成するテンプレートは意味のあるものにしてください。特定の記事でしか使うことができないような、特殊なテンプレートを作成するのは止めて下さい。
167行目: 186行目:
 
| [[Template:Archive]] || もう使われていない内容。
 
| [[Template:Archive]] || もう使われていない内容。
 
|-
 
|-
| [[Template:Laptop style]] || 他のページと重複する [[ノートパソコン]] のページ。
+
| [[Template:Laptop style]] || [[:en:Help:Laptop page guidelines|Laptop page guidelines]] に従っていない [[ノートパソコン]] のページ。
 
|-
 
|-
 
| [[Template:Translateme]] || 不完全な翻訳。
 
| [[Template:Translateme]] || 不完全な翻訳。
183行目: 202行目:
 
| [[Template:Redirect]] || 他のページへのリダイレクト。
 
| [[Template:Redirect]] || 他のページへのリダイレクト。
 
|-
 
|-
| [[:en:Template:Unsupported]] || Arch Linux によりサポートされないユーザーページ。 || {{ic|1}} — ページの作者により最後に確認された日
+
| [[Template:Unsupported]] || Arch Linux によりサポートされないユーザーページ。 || {{ic|1}} — ページの作者により最後に確認された日
 
|}
 
|}
   
206行目: 225行目:
   
 
以下のテンプレートは議論ページでの下書きでのみ使用できます。
 
以下のテンプレートは議論ページでの下書きでのみ使用できます。
* [[:en:Template:Comment]]
+
* [[Template:Comment]]
   
 
=== 雑多なテンプレート ===
 
=== 雑多なテンプレート ===
212行目: 231行目:
 
* [[Template:App]]
 
* [[Template:App]]
 
* [[Template:Broken package link]]
 
* [[Template:Broken package link]]
  +
* [[Template:Broken section link]]
 
* [[Template:Bug]]
 
* [[Template:Bug]]
* [[:en:Template:Committed identity]]
+
* [[Template:Committed identity]]
 
* [[Template:Dead link]]
 
* [[Template:Dead link]]
 
* [[Template:Lowercase title]]
 
* [[Template:Lowercase title]]
284行目: 304行目:
 
* [[Template:Template]]
 
* [[Template:Template]]
 
* http://meta.wikimedia.org/wiki/Help:Template/ja
 
* 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.}}

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

ノート: 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}}

表示:

ヒント: https://archlinux.org/?foo=bar

これは以下のような場合にとても便利です。

  • 変数の定義
  • URL にクエリ文字列を含む外部リンク
  • シェルの文字列やコマンド
  • コードの行

名前付きパラメータの値の先頭・末尾にある空白文字 (例えば改行) は 自動で除去されます。空白文字を残すには、パラメータの値を <nowiki/> タグで開始してください。

例:

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

表示:

ヒント:
複数のパラメータ
  • ポジション番号付きパラメータ 12 を使う
{{hc|1=$ echo "="|2==}}

表示:

$ echo "="
=
  • 名前付きパラメータ headoutput を使う
{{hc|head=$ echo "="|output==}}

表示:

$ echo "="
=

nowiki タグ

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

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

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

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

HTML エンティティ

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

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

作成

ノート:

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

<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 — ページの作者により最後に確認された日

関連記事のテンプレート

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

ノートテンプレート

以下のテンプレートは議論ページでの下書きでのみ使用できます。

雑多なテンプレート

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

テーブルテンプレート

テキストの配置:

名前 配置 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}}

カテゴリテンプレート

参照

翻訳ステータス: このページは en:Help:Template の翻訳バージョンです。最後の翻訳日は 2021-12-31 です。もし英語版に 変更 があれば、翻訳の同期を手伝うことができます。