Template:音声ルビ/doc
 | これはTemplate:音声ルビの解説サブページです。 使用方法、カテゴリ、およびその他テンプレート自体に含まれない情報を収容しています。 |
音声ルビテンプレートは、人名や専門用語やスラングなどといった、正しく読み上げられない文字列の読み方を指定するものです。
これは、{{ルビ}} テンプレートとは第3無名引数の既定値が異なるだけの等価なテンプレートです。
使い方 編集
基本の使い方は発音できない文字列とその読み方を指定するものです。既定では読み方は出力されません。
| 記述 | HTML |
|---|---|
{{音声ルビ|発音できない文字列|読み方}}
|
<span class="ruby"><span class="rb" style="speak:none">発音できない文字列</span><span class="rp" style="speak:none;display:none">（</span><span class="rt" style="display:none">読み方</span><span class="rp" style="speak:none;display:none">）</span></span>
|
ただし、第3無名引数を「表示」にすれば、読み方が出力されます。これは {{ルビ}} テンプレートの既定の動作と同じです。
| 記述 | HTML |
|---|---|
{{音声ルビ|発音できない文字列|読み方|表示}}
|
<span class="ruby"><span class="rb" style="speak:none">発音できない文字列</span><span class="rp" style="speak:none">（</span><span class="rt">読み方</span><span class="rp" style="speak:none">）</span></span>
|
また、音声ルビテンプレートの目的には沿いませんが、第3無名引数を「補助表示」にすれば、補助として読み仮名を表示します。
| 記述 | HTML |
|---|---|
{{音声ルビ|文字列|読み方|補助表示}}
|
<span class="ruby"><span class="rb">文字列</span><span class="rp" style="speak:none">（</span><span class="rt" style="speak:none">読み方</span><span class="rp" style="speak:none">）</span></span>
|
また、読み方の言語コードは「lang=言語コード」パラメーターで指定できますので、ハングルなどの表音文字も使用可能です。さらに、本文の言語コードは「rblang=言語コード」パラメーターで指定できます。読み方の言語と本文の言語が同じ場合は、lang 属性の指定は ruby クラスを持つ span 要素に集約されます。
| 記述 | HTML |
|---|---|
{{音声ルビ|本文|読み方|lang=読み方の言語}}
|
<span class="ruby"><span class="rb" style="speak:none">本文</span><span class="rp" style="speak:none;display:none">（</span><span class="rt" style="display:none" lang="読み方の言語" xml:lang="読み方の言語">読み方</span><span class="rp" style="speak:none;display:none">）</span></span>
|
{{音声ルビ|本文|読み方|rblang=本文の言語}}
|
<span class="ruby"><span class="rb" style="speak:none" lang="本文の言語" xml:lang="本文の言語">本文</span><span class="rp" style="speak:none;display:none">（</span><span class="rt" style="display:none">読み方</span><span class="rp" style="speak:none;display:none">）</span></span>
|
{{音声ルビ|本文|読み方|lang=読み方の言語|rblang=本文の言語}}
|
<span class="ruby"><span class="rb" style="speak:none" lang="本文の言語" xml:lang="本文の言語">本文</span><span class="rp" style="speak:none;display:none">（</span><span class="rt" style="display:none" lang="読み方の言語" xml:lang="読み方の言語">読み方</span><span class="rp" style="speak:none;display:none">）</span></span>
|
{{音声ルビ|本文|読み方|lang=同じ言語|rblang=同じ言語}}
|
<span class="ruby" lang="同じ言語" xml:lang="同じ言語"><span class="rb" style="speak:none">本文</span><span class="rp" style="speak:none;display:none">（</span><span class="rt" style="display:none">読み方</span><span class="rp" style="speak:none;display:none">）</span></span>
|
使用例 編集
難読な人名 編集
奇抜な当て字の名前など、読み方が一般的でないもの。ただし「長万部町」「中城村」などの地名は、難読ではあっても辞書（ユーザーエージェント内のデータベース）に含まれている可能性が高いため、このテンプレートは不要かもしれません。
| 記述 | 結果 | HTML |
|---|---|---|
{{音声ルビ|希星|きらら}}
|
|
<span class="ruby"><span class="rb" style="speak:none">希星</span><span class="rp" style="speak:none;display:none">（</span><span class="rt" style="display:none">きらら</span><span class="rp" style="speak:none;display:none">）</span></span>
|
{{音声ルビ|希星|きらら|表示}}
|
|
<span class="ruby"><span class="rb" style="speak:none">希星</span><span class="rp" style="speak:none">（</span><span class="rt">きらら</span><span class="rp" style="speak:none">）</span></span>
|
文字の本来の読み方とは異なる読み方のもの 編集
流行り廃りの速い流行語、固有名詞あるいは特定の業界の専門用語であるなどの理由で、読み方が一般的でないもの。
| 記述 | 結果 | HTML |
|---|---|---|
{{音声ルビ|関ジャニ∞|かんジャニエイト}}
|
|
<span class="ruby"><span class="rb" style="speak:none">関ジャニ∞</span><span class="rp" style="speak:none;display:none">（</span><span class="rt" style="display:none">かんジャニエイト</span><span class="rp" style="speak:none;display:none">）</span></span>
|
{{音声ルビ|℃-ute|Cute|lang=en}}
|
℃-ute（Cute） |
<span class="ruby"><span class="rb" style="speak:none">℃-ute</span><span class="rp" style="speak:none;display:none">（</span><span class="rt" style="display:none" lang="en" xml:lang="en">Cute</span><span class="rp" style="speak:none;display:none">）</span></span>
|
{{音声ルビ|IEEE|アイトリプルイー}}
|
|
<span class="ruby"><span class="rb" style="speak:none">IEEE</span><span class="rp" style="speak:none;display:none">（</span><span class="rt" style="display:none">アイトリプルイー</span><span class="rp" style="speak:none;display:none">）</span></span>
|
{{音声ルビ|SCSI|スカジー}}
|
|
<span class="ruby"><span class="rb" style="speak:none">SCSI</span><span class="rp" style="speak:none;display:none">（</span><span class="rt" style="display:none">スカジー</span><span class="rp" style="speak:none;display:none">）</span></span>
|
{{音声ルビ|DQN|ドキュン}}
|
|
<span class="ruby"><span class="rb" style="speak:none">DQN</span><span class="rp" style="speak:none;display:none">（</span><span class="rt" style="display:none">ドキュン</span><span class="rp" style="speak:none;display:none">）</span></span>
|
外語発音するもの 編集
下記の例では記号「♥」を「love」、「NY」を「New York」と読ませます。
| 記述 | 結果 | HTML |
|---|---|---|
{{音声ルビ|I♥NY|I Love New York|lang=en}}
|
I♥NY（I Love New York） |
<span class="ruby"><span class="rb" style="speak:none">I♥NY</span><span class="rp" style="speak:none;display:none">（</span><span class="rt" style="display:none" lang="en" xml:lang="en">I Love New York</span><span class="rp" style="speak:none;display:none">）</span></span>
|
{{音声ルビ|I♥NY|I Love New York|lang=en|rblang=en}}
|
|
<span class="ruby" lang="en" xml:lang="en"><span class="rb" style="speak:none">I♥NY</span><span class="rp" style="speak:none;display:none">（</span><span class="rt">I Love New York</span><span class="rp" style="speak:none;display:none">）</span></span>
|
{{音声ルビ|I♥NY|I Love New York|lang=en|表示}}
|
I♥NY（I Love New York） |
<span class="ruby"><span class="rb" style="speak:none">I♥NY</span><span class="rp" style="speak:none">（</span><span class="rt" lang="en" xml:lang="en">I Love New York</span><span class="rp" style="speak:none">）</span></span>
|
{{音声ルビ|I♥NY|I Love New York|lang=en|rblang=en|表示}}
|
|
<span class="ruby" lang="en" xml:lang="en"><span class="rb" style="speak:none">I♥NY</span><span class="rp" style="speak:none">（</span><span class="rt">I Love New York</span><span class="rp" style="speak:none">）</span></span>
|
同じ漢字で違う読み方があるもの 編集
| 記述 | 結果 | HTML |
|---|---|---|
{{音声ルビ|健|たけし}}
|
|
<span class="ruby"><span class="rb" style="speak:none">健</span><span class="rp" style="speak:none;display:none">（</span><span class="rt" style="display:none">たけし</span><span class="rp" style="speak:none;display:none">）</span></span>
|
{{音声ルビ|健|たける}}
|
|
<span class="ruby"><span class="rb" style="speak:none">健</span><span class="rp" style="speak:none;display:none">（</span><span class="rt" style="display:none">たける</span><span class="rp" style="speak:none;display:none">）</span></span>
|
{{音声ルビ|健|けん}}
|
|
<span class="ruby"><span class="rb" style="speak:none">健</span><span class="rp" style="speak:none;display:none">（</span><span class="rt" style="display:none">けん</span><span class="rp" style="speak:none;display:none">）</span></span>
|
{{音声ルビ|健|つよし}}
|
|
<span class="ruby"><span class="rb" style="speak:none">健</span><span class="rp" style="speak:none;display:none">（</span><span class="rt" style="display:none">つよし</span><span class="rp" style="speak:none;display:none">）</span></span>
|
外語の文字列を発音は正確にさせたいが、視覚的には補助として読み仮名を付ける場合 編集
| 記述 | 結果 | HTML |
|---|---|---|
|
Let it go（レリゴー） |
{{ルビ|Let it go|レリゴー|補助表示|rblang=en}}
|
<span class="ruby"><span class="rb" xml:lang="en" lang="en">Let it go</span><span class="rp" style="speak:none">（</span><span class="rt" style="speak:none">レリゴー</span><span class="rp" style="speak:none">）</span></span>
|
考慮すべき点 編集
同じ語が複数ある場合 編集
難読な語・複数の読み方がある同じ語が本文中で繰り返し出てくる場合、音声読み上げ式ユーザーエージェントでの発音矯正のために読み仮名の指定はすべての単語で繰り返すべきです。
外語 編集
外語の文字列で、その言語の辞書にあるような一般的な語については音声ルビテンプレートではなく lang テンプレートが適切です。
| 音声ルビテンプレートを使う記述 | 代替え案 |
|---|---|
{{音声ルビ|bldg.|building|lang=en}}
|
{{lang|en|bldg.}}
|
しかし、少数派の言語や音声読み上げユーザーエージェントが対応していないと思われる言語であれば、このテンプレートを使って読み方を明示する方が良いかもしれません。ただしその場合でも、rblang=言語コード パラメーターで本文の言語を指定すれば視覚式ユーザーエージェントで言語に合ったフォントで表示されることが期待できます。例えば、漢字に関しては日本語の文字集合にない文字がある場合などはそのようにすると良いでしょう。以下は、画面上の本文だけを言語指定しつつ、読み方の部分については言語指定せず、文脈の言語（日本語）で読ませています。
| 音声ルビテンプレートを使う記述 | 結果 | HTML |
|---|---|---|
{{音声ルビ|יהוה|ヤハウェ|rblang=he}}
|
יהוה（ヤハウェ） |
<span class="ruby"><span class="rb" style="speak:none" lang="he" xml:lang="he">יהוה</span><span class="rp" style="speak:none;display:none">（</span><span class="rt" style="display:none">ヤハウェ</span><span class="rp" style="speak:none;display:none">）</span></span>
|
{{音声ルビ|पारमिता|パーラミター|rblang=sa}}
|
पारमिता（パーラミター） |
<span class="ruby"><span class="rb" style="speak:none" lang="sa" xml:lang="sa">पारमिता</span><span class="rp" style="speak:none;display:none">（</span><span class="rt" style="display:none">パーラミター</span><span class="rp" style="speak:none;display:none">）</span></span>
|
{{音声ルビ|內田百閒|うちだひゃっけん|rblang=zh-TW}}
|
內田百閒（うちだひゃっけん） |
<span class="ruby"><span class="rb" style="speak:none" lang="zh-TW" xml:lang="zh-TW">內田百閒</span><span class="rp" style="speak:none;display:none">（</span><span class="rt" style="display:none">うちだひゃっけん</span><span class="rp" style="speak:none;display:none">）</span></span>
|
略語 編集
音声ルビテンプレートはあくまでも音声読み上げを補佐するものであるので、略語の元となった語を示すものではありません。略語の元となった語を示すには {{abbr}} テンプレートを使うか、あるいは、<ref>解説文</ref> を使って脚注で示してください。
| 音声ルビテンプレートを使う記述 | 代替え案 |
|---|---|
{{音声ルビ|CERN|Conseil Européen pour la Recherche Nucléaire|表示|lang=fr|rblang=fr}}
|
|
また、長い名称の省略形を示すのに音声ルビテンプレートを使うべきではありません。
| 音声ルビテンプレートを使う記述 | 代替え案 |
|---|---|
{{音声ルビ|睡眠時無呼吸症候群|SAS|表示}}
|
睡眠時無呼吸症候群 (SAS)
|
傍点 編集
音声ルビテンプレートは読み方を示すためのものであり、レイアウトのためのものではありません。ですから傍点を付ける目的で音声ルビテンプレートを使うべきではありません。
| ルビテンプレートを使う記述 | 代替え案 |
|---|---|
その事故は想定{{ルビ|外|・|表示}}でした。
|
その事故は想定<strong>外</strong>でした。
|
関連項目 編集