trtool

$ npm install -g trtool

Usage no npm install needed!

<script type="module">
  import trtool from 'https://cdn.skypack.dev/trtool';
</script>

README

全域安裝

$ npm install -g trtool

tr [options]

參數 描述
from 來源語系:預設:auto
toLang 目標語系:預設:en (英文) 參閱註1及註2
backup 是否備份已存在檔案:預設:true; backup=false (覆蓋)
sourceFile 來源檔案: 依當前資料夾指定相對路徑檔案或資料夾
targetPath 目標資料夾: 依當前資料夾指定相對路徑資料夾做為儲存檔案資料夾,不設定會依照toLang入參做為資料夾名稱,與當下資料夾相同階層
showRequestError 顯示翻譯請求錯誤: 預設:false; showRequestError=true (顯示)
allowFileType 自訂要讀取的來源檔案類型,目前只有json及txt可選;預設json及txt檔皆選取
-h 列出參數說明文檔

Usage

於當前所在資料夾下,執行 $ tr

會選取資料夾下所有json及txt檔做為翻譯來源檔案,目標語系為en(英文)

於當前所在資料夾下,執行 $ tr toLang=cn sourceFile=basic.json

會讀取basic.json,目標語系為cn(簡體中文),於zh_CN資料夾下產生簡體basic.json, 如果資料下已存在basic.json,則原始檔名改為basic_bak.json備份

於當前所在資料夾下,執行 $ tr toLang=cn backup=false sourceFile=basic.json

會讀取basic.json,目標語系為cn(簡體中文),覆蓋zh_CN資料夾下已存在的basic.json

常見錯誤處理

錯誤訊息 處理方式
Request Entity Too Large 單筆請求字元上限5000字,請拆分翻譯內容
Too Many Requests 每小時100次請求上限已滿,請約過一小時後再啟用本工具
JSON.parse error 讀取json文件錯誤,依照描述訊息,檢查來源內容是否有特殊字元或json格式不正確造成錯誤
Not Supported Language 非標準語系入參,請參閱註2

解除安裝

$ npm uninstall -g trtool

註1:toLang常用入參及產生的資料夾名稱

{
    'en': 'en_US',
    'zh-CN': 'zh_CN',
    'zh-TW': 'zh_TW',
}

註2:toLang入參對應要翻譯的目標語系

{
    'auto': 'Automatic',
    'af': 'Afrikaans',
    'sq': 'Albanian',
    'am': 'Amharic',
    'ar': 'Arabic',
    'hy': 'Armenian',
    'az': 'Azerbaijani',
    'eu': 'Basque',
    'be': 'Belarusian',
    'bn': 'Bengali',
    'bs': 'Bosnian',
    'bg': 'Bulgarian',
    'ca': 'Catalan',
    'ceb': 'Cebuano',
    'ny': 'Chichewa',
    'zh-CN': 'Chinese Simplified',
    'zh-TW': 'Chinese Traditional',
    'co': 'Corsican',
    'hr': 'Croatian',
    'cs': 'Czech',
    'da': 'Danish',
    'nl': 'Dutch',
    'en': 'English',
    'eo': 'Esperanto',
    'et': 'Estonian',
    'tl': 'Filipino',
    'fi': 'Finnish',
    'fr': 'French',
    'fy': 'Frisian',
    'gl': 'Galician',
    'ka': 'Georgian',
    'de': 'German',
    'el': 'Greek',
    'gu': 'Gujarati',
    'ht': 'Haitian Creole',
    'ha': 'Hausa',
    'haw': 'Hawaiian',
    'iw': 'Hebrew',
    'hi': 'Hindi',
    'hmn': 'Hmong',
    'hu': 'Hungarian',
    'is': 'Icelandic',
    'ig': 'Igbo',
    'id': 'Indonesian',
    'ga': 'Irish',
    'it': 'Italian',
    'ja': 'Japanese',
    'jw': 'Javanese',
    'kn': 'Kannada',
    'kk': 'Kazakh',
    'km': 'Khmer',
    'ko': 'Korean',
    'ku': 'Kurdish (Kurmanji)',
    'ky': 'Kyrgyz',
    'lo': 'Lao',
    'la': 'Latin',
    'lv': 'Latvian',
    'lt': 'Lithuanian',
    'lb': 'Luxembourgish',
    'mk': 'Macedonian',
    'mg': 'Malagasy',
    'ms': 'Malay',
    'ml': 'Malayalam',
    'mt': 'Maltese',
    'mi': 'Maori',
    'mr': 'Marathi',
    'mn': 'Mongolian',
    'my': 'Myanmar (Burmese)',
    'ne': 'Nepali',
    'no': 'Norwegian',
    'ps': 'Pashto',
    'fa': 'Persian',
    'pl': 'Polish',
    'pt': 'Portuguese',
    'ma': 'Punjabi',
    'ro': 'Romanian',
    'ru': 'Russian',
    'sm': 'Samoan',
    'gd': 'Scots Gaelic',
    'sr': 'Serbian',
    'st': 'Sesotho',
    'sn': 'Shona',
    'sd': 'Sindhi',
    'si': 'Sinhala',
    'sk': 'Slovak',
    'sl': 'Slovenian',
    'so': 'Somali',
    'es': 'Spanish',
    'su': 'Sundanese',
    'sw': 'Swahili',
    'sv': 'Swedish',
    'tg': 'Tajik',
    'ta': 'Tamil',
    'te': 'Telugu',
    'th': 'Thai',
    'tr': 'Turkish',
    'uk': 'Ukrainian',
    'ur': 'Urdu',
    'uz': 'Uzbek',
    'vi': 'Vietnamese',
    'cy': 'Welsh',
    'xh': 'Xhosa',
    'yi': 'Yiddish',
    'yo': 'Yoruba',
    'zu': 'Zulu'
};