威妥瑪拼音是台灣護照、地名、老招牌上的那套羅馬拼音 —— 高雄是 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¹"