「模板:Biaoyin/doc」：修訂間差異

於 2026年6月7日 (日) 13:44 的最新修訂

此頁面是模板:Biaoyin的Templatedocumentation。
此頁面可能包含了模板的使用說明、分類和其他内容。

{{{讀音}}}
{{{文字}}}

（標音）是一個專為和曦民國官網暨微國家百科設計的高級雙層標音模板。

本模板突破了傳統維基內建 Ruby 模板只能標註一層讀音的技術限制，支援在文字正上方同時完美疊加兩層讀音（例如：下層注音 + 上層拼音）。內部採用隱形微型網格技術，徹底解決了舊版嵌套代碼在移動端或部分瀏覽器下「讀音全部向左對齊歪斜」的 Bug，實現像素級的絕對置中。

by：Xiaoyu_moon

註：本模板之文檔（Documentation）初版由 AI 生成，後由作者手工微調修正。（騙你的，模板文檔純AI,模板文檔這種東西我是絕對不會親自寫的wwwwwwwwwwwwwwww)

語法

本模板支援「具名參數」與「匿名快捷」兩種模式。

具名完整語法

匿名快捷語法（推薦）

參數說明

參數名稱	匿名順序	是否必填	說明
文字或 1	第 1 個參數	必填	需要被標注讀音的漢字本體。
讀音或 2	第 2 個參數	必填	緊貼在漢字上方的第一層讀音（通常放注音符號或日文假名）。
讀音上層或 3	第 3 個參數	選填	疊加在最上方的第二層讀音（通常放漢語拼音或羅馬字）。

範例

1. 雙層讀音滿載（注音 + 拼音）

當同時需要注音與拼音時，直接啟用 `讀音上層`（或第三參數）。

匿名寫法： {{Biaoyin|和曦民國|ㄏㄜˊ ㄒㄧㄇㄧㄣˊ ㄍㄨㄛˊ|hé xī mín guó}}
效果：
hé xī mín guó
ㄏㄜˊ ㄒㄧㄇㄧㄣˊ ㄍㄨㄛˊ
和曦民國
具名寫法： {{Biaoyin|文字=和曦民國|讀音=ㄏㄜˊ ㄒㄧㄇㄧㄣˊ ㄍㄨㄛˊ|讀音上層=hé xī mín guó}}
效果：
hé xī mín guó
ㄏㄜˊ ㄒㄧㄇㄧㄣˊ ㄍㄨㄛˊ
和曦民國

2. 單層應用：標註漢語拼音

不填寫第三參數時，自動退化為普通的單層標音。

輸入： {{Biaoyin|維基百科|wéi jī bǎi kē}}
效果：
wéi jī bǎi kē
維基百科

3. 單層應用：標註注音符號

輸入： {{Biaoyin|臺灣|ㄊㄞˊ ㄨㄢ}}
效果：
ㄊㄞˊ ㄨㄢ
臺灣

💡 核心排版技巧（一字一音）

雖然本模板支援多字連寫，但由於各字拼音長度不一（例如「國」guó 有三個字母，而「曦」xī 只有兩個），直接整串連寫可能會讓字母與漢字的中心點產生些微的視覺不對齊。

為了達成最高規格的印刷美感，強烈建議在國家核心條目中，使用一字一音的串聯寫法：

極致排版輸入：

{{Biaoyin|和|ㄏㄜˊ|hé}}{{Biaoyin|曦|ㄒㄧ|xī}}{{Biaoyin|民|ㄇㄧㄣˊ|mín}}{{Biaoyin|國|ㄍㄨˊ|guó}}

極致排版效果：
hé
ㄏㄜˊ
和
xī
ㄒㄧ
曦
mín
ㄇㄧㄣˊ
民
guó
ㄍㄨㄛˊ
國

注意事項

防錯位與斷行： 本模板內部已封裝 `white-space: nowrap` 屬性，在任何窄螢幕或手機版介面下，標音字組都絕對不會發生中途斷行、字音分離的慘劇。
免 CSS 依賴： 由於完全基於 HTML 原生表格網格邏輯重構，此模板不需要在 `Common.css` 寫入額外樣式即可完美運作。

參見

Template:Ruby（維基百科內建的單層標音模板）

@@ 第1行： / 第1行： @@
 {{Documentation subpage}}
-'''{{Template:Biaoyin}}'''（標音）是一個用於在文字'''正上方'''標註拼音、注音、國際音標（IPA）或日文假名的模板。本模板採用 HTML5 的 <code><ruby></code> 標籤，確保在不同瀏覽器與裝置上都能精確對齊。模板文檔ai生成的
+'''{{Template:Biaoyin}}'''（標音）是一個專為'''和曦民國官網'''暨微國家百科設計的高級雙層標音模板。
+本模板突破了傳統維基內建 Ruby 模板只能標註一層讀音的技術限制，支援在文字正上方'''同時完美疊加兩層讀音'''（例如：下層注音 + 上層拼音）。內部採用隱形微型網格技術，徹底解決了舊版嵌套代碼在移動端或部分瀏覽器下「讀音全部向左對齊歪斜」的 Bug，實現像素級的絕對置中。
 by：[[Xiaoyu_moon]]
+* ''註：本模板之文檔（Documentation）初版由 AI 生成，後由作者手工微調修正。（騙你的，模板文檔純AI,模板文檔這種東西我是絕對不會親自寫的wwwwwwwwwwwwwwww)''
 == 語法 ==
-可以使用具名參數，直覺且不易出錯：
+本模板支援「具名參數」與「匿名快捷」兩種模式。
-<pre>{{Biaoyin |文字= |讀音= }}</pre>
+=== 具名完整語法 ===
+<nowiki>{{Biaoyin |文字= |讀音= |讀音上層= }}</nowiki>
+=== 匿名快捷語法（推薦） ===
+<nowiki>{{Biaoyin | 漢字 | 下層讀音 | 上層讀音 }}</nowiki>
+== 參數說明 ==
+{| class="wikitable" style="width:100%;"
+! 參數名稱 !! 匿名順序 !! 是否必填 !! 說明
+|-
+| '''文字''' 或 '''1''' || 第 1 個參數 || {{Yes|必填}} || 需要被標注讀音的漢字本體。
+|-
+| '''讀音''' 或 '''2''' || 第 2 個參數 || {{Yes|必填}} || 緊貼在漢字上方的第一層讀音（通常放注音符號或日文假名）。
+|-
+| '''讀音上層''' 或 '''3''' || 第 3 個參數 || {{No|選填}} || 疊加在最上方的第二層讀音（通常放漢語拼音或羅馬字）。
+|}
 == 範例 ==
-=== 1. 標註漢語拼音 ===
+=== 1. 雙層讀音滿載（注音 + 拼音） ===
-* '''輸入：''' <code><nowiki>{{Biaoyin|文字=維基百科|讀音=wéi jī bǎi kē}}</nowiki></code>
+當同時需要注音與拼音時，直接啟用 `讀音上層`（或第三參數）。
-* '''效果：''' {{Biaoyin|文字=維基百科|讀音=wéi jī bǎi kē}}
+* '''匿名寫法：''' <code><nowiki>{{Biaoyin|和曦民國|ㄏㄜˊ ㄒㄧ ㄇㄧㄣˊ ㄍㄨㄛˊ|hé xī mín guó}}</nowiki></code>
+* '''效果：''' {{Biaoyin|和曦民國|ㄏㄜˊ ㄒㄧ ㄇㄧㄣˊ ㄍㄨㄛˊ|hé xī mín guó}}
+* '''具名寫法：''' <code><nowiki>{{Biaoyin|文字=和曦民國|讀音=ㄏㄜˊ ㄒㄧ ㄇㄧㄣˊ ㄍㄨㄛˊ|讀音上層=hé xī mín guó}}</nowiki></code>
+* '''效果：''' {{Biaoyin|文字=和曦民國|讀音=ㄏㄜˊ ㄒㄧ ㄇㄧㄣˊ ㄍㄨㄛˊ|讀音上層=hé xī mín guó}}
+=== 2. 單層應用：標註漢語拼音 ===
+不填寫第三參數時，自動退化為普通的單層標音。
+* '''輸入：''' <code><nowiki>{{Biaoyin|維基百科|wéi jī bǎi kē}}</nowiki></code>
+* '''效果：''' {{Biaoyin|維基百科|wéi jī bǎi kē}}
+=== 3. 單層應用：標註注音符號 ===
+* '''輸入：''' <code><nowiki>{{Biaoyin|臺灣|ㄊㄞˊ ㄨㄢ}}</nowiki></code>
+* '''效果：''' {{Biaoyin|臺灣|ㄊㄞˊ ㄨㄢ}}
-=== 2. 標註注音符號 ===
+== 💡 核心排版技巧（一字一音） ==
-* '''輸入：''' <code><nowiki>{{Biaoyin|文字=臺灣|讀音=ㄊㄞˊ ㄨㄢ}}</nowiki></code>
+雖然本模板支援多字連寫，但由於各字拼音長度不一（例如「國」guó 有三個字母，而「曦」xī 只有兩個），直接整串連寫可能會讓字母與漢字的中心點產生些微的視覺不對齊。
-* '''效果：''' {{Biaoyin|文字=臺灣|讀音=ㄊㄞˊ ㄨㄢ}}
-=== 3. 標註日文假名 ===
+為了達成最高規格的印刷美感，強烈建議在國家核心條目中，使用'''一字一音'''的串聯寫法：
-* '''輸入：''' <code><nowiki>{{Biaoyin|文字=富士山|讀音=ふじさん}}</nowiki></code>
+* '''極致排版輸入：'''
-* '''效果：'''  {{Biaoyin|文字=富士山|讀音=ふじさん}}
+: <code><nowiki>{{Biaoyin|和|ㄏㄜˊ|hé}}{{Biaoyin|曦|ㄒㄧ|xī}}{{Biaoyin|民|ㄇㄧㄣˊ|mín}}{{Biaoyin|國|ㄍㄨˊ|guó}}</nowiki></code>
+* '''極致排版效果：''' {{Biaoyin|和|ㄏㄜˊ|hé}}{{Biaoyin|曦|ㄒㄧ|xī}}{{Biaoyin|民|ㄇㄧㄣˊ|mín}}{{Biaoyin|國|ㄍㄨㄛˊ|guó}}
 == 注意事項 ==
-* 如果使用者的瀏覽器較舊（不支援 Ruby 標籤），系統會自動將排版降級顯示為「文字（讀音）」的括號形式，不會造成文字重疊或斷行。
+* '''防錯位與斷行：''' 本模板內部已封裝 `white-space: nowrap` 屬性，在任何窄螢幕或手機版介面下，標音字組都絕對不會發生中途斷行、字音分離的慘劇。
-* 為維持條目的整體閱讀流暢度，上方的讀音字級已預設縮小至 70%，並自動居中對齊。
+* '''免 CSS 依賴：''' 由於完全基於 HTML 原生表格網格邏輯重構，此模板不需要在 `Common.css` 寫入額外樣式即可完美運作。
 == 參見 ==
-* [[Template:Ruby]]（維基百科內建的通用標音模板）
+* [[Template:Ruby]]（維基百科內建的單層標音模板）
 <includeonly>{{Sandbox other||