テンプレート:Convert/doc

テンプレート:Convertを使用している記事一覧

テンプレートの目的

単位付きの数字を、別の単位に変換して併記するためのテンプレートです。たとえば重さの単位グラム(g)をグレーン(gr)という単位に置き換えるには、{{convert|10|g|gr}}と書けば、10グラム (150 gr)と、2つを並べて書いてくれます。

当初、英語版の記事をコピーした時、赤文字で「Template:Convert/DWton」のように出てくる場合は、その内部テンプレートがまだ日本語版に移植されていないことを意味していて、表示させるには、自分で移植するか、誰かが移植するのを待つ場合がありました。さらに場合によっては、見かけ上1つのテンプレートであっても、複数のテンプレートを移植する必要がありました。

しかし、ウィキペディア英語版ではLuaモジュール使用に移行し、内部テンプレートは使用されなくなっているので{{convert2}}に書き換えた方が良い状態になっています。

使用箇所が1つであれば、このテンプレートを使わずに表示後の値をコピーした方が簡単かもしれません。

このテンプレートは、英語版では比較的高頻度で使われています。新しい変換式を作る場合には、必ず英語版に類似のテンプレートが無いか確認してください。特に、英語版と同じタイトルで別の意味のテンプレートを作らないで下さい。

使用例

変換	記法	表示
キロメートルからマイルへ	{{convert|18.75|km|mi}}	18.75キロメートル (11.65 mi)
キログラムからポンドへ	{{convert|3.215|kg|lb}}	3.215キログラム (7.09 lb)
単位を略号にする場合	{{convert|3.215|kg|lb|abbr=on}}	3.215 kg (7.09 lb)
さらに単位の記事への内部リンクを作成	{{convert|3.215|kg|lb|lk=on|abbr=on}}	3.215 kg (7.09 lb)
表示を"/"区切りで並べる場合	{{convert|3.215|kg|lb|disp=s}}	3.215キログラム / 7.09ポンド
単位の前に"-"を付ける場合	{{convert|3.215|kg|lb|adj=on}}	3.215キログラム (7.09 lb)
小数点以下1桁となるよう四捨五入する場合	{{convert|3.215|kg|lb|1}}	3.215キログラム (7.1 lb)
(変換後の単位を省略すると、最も一般的な単位に変換する)	{{Convert|7|lb}}	7ポンド (3.2 kg)
誤差を併記する場合	{{convert|60|+/-|10|m|ft}}	60 ± 10メートル (200 ± 33 ft)
複数単位への変換 (スペースで区切って並べる)	{{convert|1|R|C F K}}	1 °R (−{{rnd/b||()| }} °C; −{{rnd/b||()| }} °F; 0.56 K)

注意

• 上記のスイッチ（abbr=onとか）は、その組み合わせ毎にテンプレートを作っています。そのため、スイッチのon、offの組み合わせによっては新たにテンプレートを作成または移植する必要があります。
• 複数単位への変換の場合もその組み合わせに対応するテンプレートを新たに作成する必要がある場合があります。

変換精度

変換後の精度は入力の精度に依存します。

入力の精度	記述例	表示
1	{{convert|1|R|K}}	1 °R (0.56 K)
1.0000	{{convert|1.0000|R|K}}	1.0000 °R (0.5556 K)
1.00000000	{{convert|1.00000000|R|K}}	|()| }} K)

英語版から移植する場合の注意

• 通常の移植と同様に、Wikipedia:FAQ 翻訳、Wikipedia:翻訳のガイドラインをよくお読みのうえ、要約欄に必要事項を記載してください。以下はそれに付け加えての注意です。

• en:Template:Convert/ft(21:37, 29 March 2008の版)を例にとると、ソースは

{{convert/{{#ifeq:{{{4}}}|in|and/in|{{{d}}}}}|{{{1}}}|{{{2|}}}|{{{3|}}}|{{{4|}}}|{{{5|}}}|{{{6|}}}|s={{{s|}}}|r={{{r}}}|d={{{d}}}

|u=ft

|n=foot

|l=feet

|t=Foot (length)

|o=m

|b=0.3048

|j=-0.515985037-0}}<noinclude>{{pp-template|small=yes}}

[[Category:Subtemplates of Template Convert]]

</noinclude>

となっています。そのままコピーしても一応動作しますが、

• {{pp-template}}または{{pp-template|small=yes}}は、英語版で「影響が大きいため保護されているテンプレート」を意味しますので、日本語版では削除してください。（現在のところ、日本語版の{{pp-template}}は「何もしない」設定になっています。）
• tで始まる引数（上の例では「t=Foot (length)」）は、単位の説明記事への内部リンクの記事名ですので、これは日本語版の相当する記事名（上の例では「フィート」）に変更する必要があります。引数tがない場合には引数nの文字で代用されます。
• nで始まる引数とlで始まる引数（上の例では「n=foot」と「l=feet」）は、省略せずに（abbr=offで）書いた場合の表示単位です。引数nは結果が1（単数）の場合、引数lは結果が1以外の場合に表示されます。引数lを省略した場合で、結果が1以外の場合には、単位の末尾に複数形の「s」が付きます。そのため、引数nを日本語に訳す場合には、必ず引数lも定義してください(通常は引数nと同じ文字でよい)。
• <noinclude></noinclude>の間に、英語版への言語間リンクを記載してください。
• 上記の例の場合、例えば

{{convert/{{#ifeq:{{{4}}}|in|and/in|{{{d}}}}}|{{{1}}}|{{{2|}}}|{{{3|}}}|{{{4|}}}|{{{5|}}}|{{{6|}}}|s={{{s|}}}|r={{{r}}}|d={{{d}}}

|u=ft

|n=フィート

|l=フィート

|t=フィート

|o=m

|b=0.3048

|j=-0.515985037-0}}<noinclude>

[[Category:Subtemplates of Template Convert]]

[[en:Template:Convert/ft]]

</noinclude>

とするとよいでしょう。