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

提供: ArchWiki
ナビゲーションに移動 検索に移動
(→‎記事の状態テンプレート: 訳出(版 16082 での同期部分))
(→‎テーブルテンプレート: 訳出(版 16084 での同期部分))
205行目: 205行目:
 
=== テーブルテンプレート ===
  
=== テーブルテンプレート ===
   
  +
テキストの配置:
−
Text align:
  
   
 
{| class="wikitable"
  
{| class="wikitable"
 
|-
  
|-
−
! width=100px | Name !! width=100px | Align !! width=100px | Wiki markup !! width=100px | Result
 +
! width=100px | 名前 !! width=100px | 配置 !! width=100px | Wiki マークアップ !! width=100px | 表示
 
|-
  
|-
 
| [[Template:C]] || center || {{ic|<nowiki>{{C|text}}</nowiki>}} || {{C|text}}
  
| [[Template:C]] || center || {{ic|<nowiki>{{C|text}}</nowiki>}} || {{C|text}}
 
|}
  
|}
   
  +
セルの背景:
−
Cell background:
  
   
 
{| class="wikitable"
  
{| class="wikitable"
−
! width=100px | Name !! width=100px | Color !! width=100px | Wiki markup !! width=100px | Result
 +
! width=100px | 名前 !! width=100px | 色 !! width=100px | Wiki マークアップ !! width=100px | 表示
 
|-
  
|-
 
| [[Template:R]] || red || {{ic|<nowiki>{{R|text}}</nowiki>}} || {{R|text}}
  
| [[Template:R]] || red || {{ic|<nowiki>{{R|text}}</nowiki>}} || {{R|text}}
230行目: 230行目:
 
|}
  
|}
   
  +
一般的なテキスト:
−
Common text:
  
   
 
{| class="wikitable"
  
{| class="wikitable"
−
! width=100px | Name !! Wiki markup !! width=100px | Result
 +
! width=100px | 名前 !! Wiki マークアップ !! width=100px | 表示
 
|-
  
|-
 
| rowspan=2 | [[Template:Yes]] || {{ic|<nowiki>{{Yes}}</nowiki>}} || {{Yes}}
  
| rowspan=2 | [[Template:Yes]] || {{ic|<nowiki>{{Yes}}</nowiki>}} || {{Yes}}
246行目: 246行目:
 
|}
  
|}
   
−
{{Tip|You can use attributes with table cell templates by prefixing them, e.g: {{ic|<nowiki>| colspan=2 {{Yes}}</nowiki>}}.}}
 +
{{Tip|属性は、セルのテンプレートの前に配置することで使うことができます。例: {{ic|<nowiki>| colspan=2 {{Yes}}</nowiki>}} }}
   
 
=== カテゴリテンプレート ===
  
=== カテゴリテンプレート ===

2020年4月25日 (土) 14:36時点における版

関連記事

テンプレートは、記事に挿入することが出来る定義済みの 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://www.archlinux.org/?foo=bar}}

表示:

ヒント: 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>}}
ヒント: = | }} 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; &#123;&#123; &#125;&#125;}}
ヒント: = | {{ }}

作成

ノート:
  • テンプレートを作成する前に、ヘルプ・トーク:テンプレートで議論してください。
  • 作成するテンプレートは意味のあるものにしてください。特定の記事でしか使うことができないような、特殊なテンプレートを作成するのは止めて下さい。
  • テンプレートは簡潔にしてください。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 の記事で直接使うことができるテンプレートは以下の通りです。詳しくはそれぞれのリンクをクリックしてください。ローカリゼーションやメタテンプレートのリストは特別:ページ一覧/テンプレート:、特別:前方一致ページ一覧/テンプレート:、特別:使用箇所の多いテンプレートを見てください。

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

テスト

記事の状態テンプレート

全ての言語のページで使用:

英語以外のページでのみ使用:

アーカイブされるページで使用:

ノート: 記事の状態テンプレートが付けられたページは、対応する en:メンテナンスカテゴリ と en:ArchWiki:統計#Maintenance statistics で追跡されます。

関連記事のテンプレート

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

ノートテンプレート

雑多なテンプレート

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

テーブルテンプレート

テキストの配置:

名前 配置 Wiki マークアップ 表示
Template:C center {{C|text}} text

セルの背景:

名前 色 Wiki マークアップ 表示
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

一般的なテキスト:

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

カテゴリテンプレート

参照

「https://wiki.archlinux.jp/index.php?title=ヘルプ:テンプレート&oldid=16094」から取得