Skip to content

威妥瑪拼音是台灣護照、地名、老招牌上的那套羅馬拼音 —— 高雄是 Kaohsiung 不是 Gaoxiong。 規則在 1859 年就定了,但幾乎沒有現成的程式庫做這件事。

打開 urlSafe 會得到純 ASCII、沒有聲調的輸出,可以直接當網址。 這個站的文章 slug 就是這樣產生的。

要把中文姓名轉成護照用的拼法,用 中文姓名轉威妥瑪拼音,那頁多處理了姓名斷詞與破音姓氏,並且跟漢語拼音並排比對。

// 輸入中文
$
t'ai²-wan¹
// toneFormat
// 其他選項
// result.segments
台tai2t'ai聲調 2
灣wan1wan聲調 1
// the call above
import { toWadeGiles } from "use-wg";

toWadeGiles("台灣", {
  toneFormat: "superscript",
  urlSafe: false,
  capitalize: false,
  polyphoneMode: "auto",
}).text;
// → "t'ai²-wan¹"