進行文字轉換
/convert¶
總結
此端點用於將文字做轉換。
備註
此頁面的內容未必會在新增移除轉換器或是模組時更新。 若要取得最新可用的轉換器與模組， 請參考 查看繁化姬設定 。
請求方法¶
- GET, POST
請求參數¶
必填¶
| 屬性 | 說明 | 型別 |
|---|---|---|
| text | 將要被轉換的文字。 | string |
| converter | 所要使用的轉換器。有 Simplified （簡體化）、 Traditional （繁體化）、 China （中國化）、 Hongkong （香港化）、 Taiwan （台灣化）、 Pinyin （拼音化） Bopomofo （注音化）、 Mars （火星化）、 WikiSimplified （維基簡體化）、 WikiTraditional （維基繁體化）。 | string |
字幕樣式¶
| 屬性 | 說明 | 型別 | 預設值 |
|---|---|---|---|
| ignoreTextStyles | 由那些不希望被繁化姬處理的 "樣式" 以逗號分隔所組成的字串。通常用於保護特效字幕不被轉換，例如字幕組的特效字幕若是以 OPJP 與 OPCN 作為樣式名。可以設定 "OPJP,OPCN" 來作保護。 | string | "" |
| jpTextStyles | 告訴繁化姬哪些樣式要當作日文處理（預設為伺服器端自動猜測）。若要自行設定，則必須另外再加入 *noAutoJpTextStyles 這個樣式。所有樣式以逗號分隔組成字串，例如： "OPJP,EDJP,*noAutoJpTextStyles" 表示不讓伺服器自動猜測，並指定 OPJP 與 EDJP 為日文樣式。 | string | "" |
日文的處理策略¶
| 屬性 | 說明 | 型別 | 預設值 |
|---|---|---|---|
| jpStyleConversionStrategy | 對於日文樣式該如何處理。 "none" 表示 無（當成中文處理） 、 "protect" 表示 保護 、 "protectOnlySameOrigin" 表示 僅保護原文與日文相同的字 、 "fix" 表示 修正 。 | string | "protectOnlySameOrigin" |
| jpTextConversionStrategy | 對於繁化姬自己發現的日文區域該如何處理。 "none" 表示 無（當成中文處理） 、 "protect" 表示 保護 、 "protectOnlySameOrigin" 表示 僅保護原文與日文相同的字 、 "fix" 表示 修正 。 | string | "protectOnlySameOrigin" |
自訂取代¶
| 屬性 | 說明 | 型別 | 預設值 |
|---|---|---|---|
| modules | 強制設定模組啟用／停用 。 -1 / 0 / 1 分別表示 自動 / 停用 / 啟用 。字串使用 JSON 格式編碼。使用 * 可以先設定所有模組的狀態。例如：{"*":0,"Naruto":1,"Typo":1} 表示停用所有模組，但啟用 火影忍者 與 錯別字修正 模組。 | JSON string | "{}" |
| userPostReplace | 轉換後再進行的額外取代。格式為 "搜尋1=取代1\n搜尋2=取代2\n..." 。 搜尋1 會在轉換後再被取代為 取代1 。 | string | "" |
| userPreReplace | 轉換前先進行的額外取代。格式為 "搜尋1=取代1\n搜尋2=取代2\n..." 。 搜尋1 會在轉換前先被取代為 取代1 。 | string | "" |
| userProtectReplace | 保護字詞不被繁化姬修改。格式為 "保護1\n保護2\n..." 。 保護1 、 保護2 等字詞將不會被繁化姬修改。 | string | "" |
差異比較¶
| 屬性 | 說明 | 型別 | 預設值 |
|---|---|---|---|
| diffCharLevel | 是否使用字元級別的差異比較（否則為行級別），這將會使回應時間變長。 | bool | false |
| diffContextLines | 所輸出的結果要包含多少行上下文。可以是 0~4 之間的整數。 | int | 1 |
| diffEnable | 是否要啟用差異比較。 | bool | false |
| diffIgnoreCase | 是否要忽略英文大小寫的差異。 | bool | false |
| diffIgnoreWhiteSpaces | 是否要忽略空格的差異。 | bool | false |
| diffTemplate | 所要使用的輸出模板。可選的值有： Inline 、 SideBySide 、 Unified 、 Context 以及 Json 。 | string | "Inline" |
文本整理¶
| 屬性 | 說明 | 型別 | 預設值 |
|---|---|---|---|
| cleanUpText | 根據所偵測到的文本格式做出對應的文本清理。例如 ASS 字幕 的編輯器訊息、空白的對話等等，將會被移除。 | bool | false |
| ensureNewlineAtEof | 確保輸出的文本結尾處有一個且只有一個換行符。 | bool | false |
| translateTabsToSpaces | 轉換每行開頭的 Tab 為數個空格。此值可以是 -1~8 之間的整數。 -1 表示不轉換； 0 表示移除開頭 Tab 。 1~8 表示轉換為數個空白。 | int | -1 |
| trimTrailingWhiteSpaces | 移除每行結尾的多餘空格。 | bool | false |
| unifyLeadingHyphen | 將區分說話人用的連字號統一為半形減號。 | bool | false |
回應參數¶
| 屬性 | 說明 | 型別 |
|---|---|---|
| converter | 此次轉換所使用的轉換器。 | string |
| text | 經過轉換後的文本。 | string |
| diff | 轉換前後的文本差異比較。若轉換時沒有啟用差異比較，則傳回 null 。 | string | null |
| usedModules | 此次轉換使用了哪些模組。 | string[] |
| jpTextStyles | 此次轉換將哪些樣式視為日文樣式。 | string[] |
| textFormat | 輸入的文本被繁化姬判定為何種格式。 | string |
回應範例¶
提示
對 内存不足！没法在视频聊天时播放视频。 做 台灣化 。 您可以點擊 此處 來查看真實的回傳結果。
{
// ...
"data": {
"converter": "Taiwan",
"text": "記憶體不足！沒辦法在視訊聊天時播放影片。",
"diff": null,
"jpTextStyles": [],
"usedModules": [
"Unit",
"Typo",
"Smooth",
"GanToZuo",
"Repeat",
"ProperNoun",
"Punctuation"
],
"textFormat": "PlainText"
},
// ...
}
最後更新: 2019年2月7日