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

第1行：

'''{{Template:Biaoyin}}'''（標音）是一個用於在文字~~'''~~正上方'''~~標註拼~~音、注音~~、國際~~音~~標（IPA~~）~~或日文假名的模板~~。~~本模板~~採用 ~~HTML5 的 <code><ruby></code> 標籤~~，確保在不同瀏覽器~~與裝置上都能精確~~對齊。~~模板文檔ai生成的~~

by：[[Xiaoyu_moon]]~~<br>啊~~，~~那個讀音上層其實就是我剛剛去複製粘貼了一下第一層的代碼然~~後微調~~了一下~~，~~讀音上層~~模~~塊用了~~會~~是這樣：{{Biaoyin|文字=和曦民國|讀音=hé xī mín guó|讀音上層=ㄏㄜˊ ㄒㄧㄇㄧㄣˊ ㄍㄨㄛˊ}}~~

'''{{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||

@@ 第1行： / 第1行： @@
 {{Documentation subpage}}
-'''{{Template:Biaoyin}}'''（標音）是一個用於在文字'''正上方'''標註拼音、注音、國際音標（IPA）或日文假名的模板。本模板採用 HTML5 的 <code><ruby></code> 標籤，確保在不同瀏覽器與裝置上都能精確對齊。模板文檔ai生成的
-by：[[Xiaoyu_moon]]<br>啊，那個讀音上層其實就是我剛剛去複製粘貼了一下第一層的代碼然後微調了一下，讀音上層模塊用了會是這樣：{{Biaoyin|文字=和曦民國|讀音=hé  xī mín guó|讀音上層=ㄏㄜˊ ㄒㄧ ㄇㄧㄣˊ ㄍㄨㄛˊ}}
+'''{{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||