Index: trunk/l10n-support/zh_TW/sync_po_file.py =================================================================== --- trunk/l10n-support/zh_TW/sync_po_file.py (revision 1543921) +++ trunk/l10n-support/zh_TW/sync_po_file.py (nonexistent) @@ -1,216 +0,0 @@ -#!/usr/bin/python3 -''' -可以同步您語言目錄和範本的應用程式。 - -[注意] - - 確保 template 與語言目錄是最新的 - - 確保已經安裝 gettext-tools - - 確保您系統有安裝 python3.7 或更新版本 -''' - -import sys, shutil, os -import argparse -import subprocess -import shlex # for subprocess - -argp = argparse.ArgumentParser( - description="同步 KDE SVN 檔案庫中範本與語言中的翻譯檔案", - epilog="請將問題回報至 ", - formatter_class=argparse.RawTextHelpFormatter -) - -argp.add_argument( - "template_path", - action="store", - type=str, - help="""\ -範本檔存放位置。 - -以 KDE 5 的應用程式翻譯檔範本為例，它通常會像這樣： -https://websvn.kde.org/trunk/l10n-kf5/templates/messages/ -""" -) -argp.add_argument( - "translation_path", - action="store", - type=str, - help="""\ -翻譯檔存放位置。 - -以 KDE 5 的應用程式翻譯檔 (zh_TW) 為例，它通常會像這樣： -https://websvn.kde.org/trunk/l10n-kf5/zh_TW/messages/ -""" -) -argp.add_argument( - "--merge", - action="store_true", - help="是否完整合併所有翻譯檔（使用範本檔作來源）？\n除非翻譯檔存放位置與範本脫節非常嚴重，否則不建議使用此功能。", - dest="mergeSwitch" -) - -argv = argp.parse_args() - -def merge_translations(template, old): - ''' - 使用 msgmerge 工具合併翻譯。 - - template: 範本檔 - old: 原翻譯檔 - 回傳值: msgmerge 執行的回傳值，預設為 0 - ''' - # -q 必須，否則會導致進度列無法正常運作。 - merge = subprocess.Popen(shlex.split(f"msgmerge -U --backup=none --previous -q {old} {template}")) - merge.wait() - - return merge.returncode - -def copy(source, target): - ''' - 將 source 複製到 target。 - - source: 來源檔案 - target: 目標位置 - 回傳值: 一律為 None。 - ''' - shutil.copyfile(source, target) - return None - -def recursive(path): - ''' - 遞迴目錄，並回傳檔案列表。 - - 傳入： - path: 要遞迴的目錄 - - 回傳：檔案列表與所有目錄列表。 - ''' - filelist = [] - dirlist = [] - # 要排除的檔案 / 目錄名稱 - excludes = [".git", ".svn"] - for dirbase, dirnames, filenames in os.walk(path): - for dirname in dirnames: - # 這迴圈將遞迴檢查以下項目： - # - 曾未出現在 dirlist 中。 - # - # 並將「dirbase/dirname」加入 dirlist 中。 - if dirlist.count(dirname) == 0: - dirlist.append(os.path.join(dirbase, dirname)) - - for filename in filenames: - # 此迴圈將遞迴檢查以下項目： - # - 曾未出現在 filelist 中。 - # - 檔名結尾必須是 ".po" 或 ".pot" - # - # 並將「dirbase/filename」加入 filelist 中。 - if ".po" in filename or ".pot" in filename and filelist.count(filename) == 0: - filelist.append(os.path.join(dirbase, filename)) - - for filename in filelist: - for exclude in excludes: - if exclude in filename: - filelist.remove(filename) - continue - - for dirname in dirlist: - for exclude in excludes: - if exclude in dirname: - dirlist.remove(dirname) - continue - - return filelist, dirlist - -symbol = "^" # 一開始的動畫 -def symbolChanger(symbol): - ''' - 毫無意義的概念www - - symbol: 傳入 "." "-" "=" "^" 任一個，將會不斷重複這幾個動畫 - ''' - - if symbol == "^": - return "." - elif symbol == ".": - return "-" - elif symbol == "-": - return "=" - elif symbol == "=": - return "^" - else: - raise Exception("動畫好像未初始成功……") - -def determine_translationfile(templatedir, translationdir): - ''' - 檢查目前的翻譯檔案是要合併還是要複製範本檔 - - templatedir: 範本目錄 - translationdir: 翻譯檔目錄 - ''' - global symbol # 把這裡的 symbol 提升到全域。 - - templateFileList, templateFolderList = recursive(templatedir) - # 處理最後一個檔案時，「剩餘 xx 數：[y]」的 [y] 我希望是 0，所以皆 -1。 - templateFileCount, templateFolderCount = len(templateFileList)-1, len(templateFolderList)-1 - - translationFileList, translationFolderList = recursive(translationdir) - - print("""\ -[->] 開始檢查範本資料夾數是否與翻譯檔的資料夾數相同…… - - 假如有一個資料夾範本有，但翻譯檔資料夾沒有，則會在翻譯檔資料夾建立同名資料夾。 - 假如有一個資料夾範本沒有，但翻譯檔資料夾有，則不進行任何動作。 -""") - - # 開始檢查範本資料夾數是否與翻譯檔的資料夾數相同…… - for templateFolder in templateFolderList: - symbol = symbolChanger(symbol) - print("\r{0} 剩餘 {1} 個未複製目錄…… ".format(symbol, templateFolderCount), end="", flush=True) - copyToDir = templateFolder.replace(templatedir, translationdir) - - if os.path.exists(copyToDir) == False: - os.mkdir(copyToDir) - print(f"\n[!] 已建立資料夾：{copyToDir}") - - templateFolderCount -= 1 - - print("""\ -\n[->] 開始更新翻譯檔資料夾中的翻譯檔案…… - - 假如有一個 PO 檔，翻譯檔資料夾沒有但範本資料夾卻有，則會使用 - msginit 來初始化範本檔中的 POT 檔，並複製到 - 翻譯檔資料夾。 - 假如有一個 PO 檔，範本和翻譯檔資料夾都有，且有傳入 --merge - 參數，則會使用 msgmerge 合併。 -""") - - - # 開始更新翻譯檔資料夾中的翻譯檔案…… - for templateFile in templateFileList: - symbol = symbolChanger(symbol) - print("\r{0} 剩餘 {1} 個未處理檔案…… ".format(symbol, templateFileCount), end="", flush=True) - - toProcessFile = templateFile.replace(templatedir, translationdir).replace(".pot", ".po") - - if os.path.exists(toProcessFile): - if argv.mergeSwitch == True: - merge_translations(templateFile, toProcessFile) - else: - copyPot = subprocess.Popen( - shlex.split(f"msginit --no-translator -o {toProcessFile} -i {templateFile}"), - stdout=subprocess.DEVNULL, - stderr=subprocess.DEVNULL - ) - copyPot.wait() - - if copyPot.returncode != 0: - print(f"\n[*] 警告：初始化 {templateFile} 至 {toProcessFile} 時發生錯誤……") - else: - print(f"\n[!] 已初始化 PO 檔：{toProcessFile}") - - templateFileCount -= 1 - - # 空白得保留。 - print("\r處理完成。請再次檢查結果，以確保合併沒有任何錯誤！ ") - return - -determine_translationfile(argv.template_path, argv.translation_path) Index: trunk/l10n-support/zh_TW/README.txt =================================================================== --- trunk/l10n-support/zh_TW/README.txt (revision 1543921) +++ trunk/l10n-support/zh_TW/README.txt (revision 1543922) @@ -1,94 +1,4 @@ -zh_TW 翻譯相關準則與建議： +關於怎麼翻譯 KDE，以及相關的翻譯守則及工具，已遷移至 +更易管理的 GitHub 檔案庫： -(1) 請盡量遵循該指引翻譯： - https://docs.google.com/document/d/1Zs4CS_ZjN-imnImq4aEsiVYih8zkIkVZTSQim13_kYg - -(2) 您可使用放置於此處的 sync_po_file.py 以保證範本的 PO 檔案數與字串與 zh_TW 語言相同。 - （使用方法請參閱 == PO Sync 工具使用 == ） - -(3) 若有時間，可使用上層目錄中的 pology 工具標準化翻譯檔。 - （使用方法請參閱 == POLOGY 使用 == ） - -(4) 你能參考 == 同步 trunk 與 stable 翻譯檔案 == - 了解如何在翻譯 trunk 的字串時就能同步 stable 的字串。 - -(5) 有任何問題請參閱「== 聯絡團隊 ==」與團隊聯絡。 - -== PO Sync 工具使用 == -1. 確保你已經安裝 Python 3.7 以上。 - -2. 第一項為你想翻譯分支的範本資料夾。 - 第二項為你想翻譯分支的要翻譯資料夾。 (ex. zh_TW zh_CN) - -3. 可輸入 --help 得知此工具的其他使用資訊。 - -== POLOGY 使用 == -最新的 Pology 存放在：https://websvn.kde.org/trunk/l10n-support/pology/ -請使用 svn 或 git-svn 將 svn://anonsvn.kde.org/home/kde/trunk/l10n-support/pology -clone 下來，未來如果 pology 有更新只需 checkout (svn) rebase (git-svn) 即可。 - -在使用前，請確保您已經安裝 Python 2。 - -請進入翻譯檔目錄，輸入 `python2 (pology 存放目錄)/scripts/posieve.py [動作] [-s 參數]` 來對 PO 檔案做 -指定動作。 - -接下來講建議做的一些動作。 - - - 動作列表 - - - [動作] remove-obsolete - [用意] 移除已經過時的字串。除非過時字串真的太多，否則沒什麼必要執行。 - [參數] 無 - - [動作] remove-previous - [用意] 移除無 fuzzy 標記之先前訊息。 - [參數] - all: 移除包括 fuzzy 標記的先前訊息。 - - [動作] normalize-header - [用意] 標準化每個 PO 檔案的檔頭，讓 PO 的檔頭一致化。 - [參數] 無 - [動作] check-kde4 - [用意] 檢查每個 PO 檔案的字串，看 HTML Tag 是否對稱、內容是否有效等等。 - [參數] - strict: 嚴格檢查模式。建議不加。 - lokalize: 使用 lokalize 開啟有問題的 PO 檔，讓你比較好修正。 - 注意：lokalize 必須要是開著的。 - 建議傳入。 - - [動作] unfuzzy-context-only - [用意] 將只更改翻譯備註 (context) 的被標 fuzzy 翻譯取消 fuzzy 標記。 - [參數] 無 - - [動作] unfuzzy-inplace-only - [用意] 修正 HTML 標籤，並將因標籤問題而標為 fuzzy 的字串取消 fuzzy 標記。 - [參數] 無 - -== 同步 trunk 與 stable 翻譯檔案 == -這可以解決要重複翻譯 trunk 和 stable 中同一個軟體 po 檔的問題。 -此使用 Lokalize 18.12.0 示範，若未來方法有所變更，請幫忙提交修改。 - -I. 建立專案 -打開 Lokalize -> 專案(P) -> 建立軟體翻譯專案 - -接著把 index.lokalize 取名為你想取的名字，並放在你能找得到的地方。 - -II. 設定專案 -接著會跳出一堆東西，你只需要改以下幾個： - -- 一般 - - ID: 把他改成你能識別的名字，例如「KDEtrunk」「KDEstable」 - - 郵件論壇: 把他改成「l10n-tw@linux.org.tw」或其他郵件論壇，保留原本的亦可。 - - 根目錄: 改成你想翻譯的分支，例如 trunk 或 stable 分支。 -- 進階 - - 分支目錄: 改成你想要同步的 PO 翻譯檔分支，例如 stable 或 trunk 分支。 - - 其他翻譯目錄: 改成你目前的翻譯分支，例如 trunk 或 stable 分支。 - -未來只需開啟該專案檔，即可同步兩側的 PO 檔案。 - -== 聯絡團隊 == -#l10n-tw - -IRC: #l10n-tw -Telegram: @l10n-tw -郵件論壇: zh-l10n@linux.org.tw +https://github.com/l10n-tw/KSVNTManage/blob/master/README.md Index: trunk/l10n-support/zh_TW/README.txt.old =================================================================== --- trunk/l10n-support/zh_TW/README.txt.old (nonexistent) +++ trunk/l10n-support/zh_TW/README.txt.old (revision 1543922) @@ -0,0 +1,94 @@ +zh_TW 翻譯相關準則與建議： + +(1) 請盡量遵循該指引翻譯： + https://docs.google.com/document/d/1Zs4CS_ZjN-imnImq4aEsiVYih8zkIkVZTSQim13_kYg + +(2) 您可使用放置於此處的 sync_po_file.py 以保證範本的 PO 檔案數與字串與 zh_TW 語言相同。 + （使用方法請參閱 == PO Sync 工具使用 == ） + +(3) 若有時間，可使用上層目錄中的 pology 工具標準化翻譯檔。 + （使用方法請參閱 == POLOGY 使用 == ） + +(4) 你能參考 == 同步 trunk 與 stable 翻譯檔案 == + 了解如何在翻譯 trunk 的字串時就能同步 stable 的字串。 + +(5) 有任何問題請參閱「== 聯絡團隊 ==」與團隊聯絡。 + +== PO Sync 工具使用 == +1. 確保你已經安裝 Python 3.7 以上。 + +2. 第一項為你想翻譯分支的範本資料夾。 + 第二項為你想翻譯分支的要翻譯資料夾。 (ex. zh_TW zh_CN) + +3. 可輸入 --help 得知此工具的其他使用資訊。 + +== POLOGY 使用 == +最新的 Pology 存放在：https://websvn.kde.org/trunk/l10n-support/pology/ +請使用 svn 或 git-svn 將 svn://anonsvn.kde.org/home/kde/trunk/l10n-support/pology +clone 下來，未來如果 pology 有更新只需 checkout (svn) rebase (git-svn) 即可。 + +在使用前，請確保您已經安裝 Python 2。 + +請進入翻譯檔目錄，輸入 `python2 (pology 存放目錄)/scripts/posieve.py [動作] [-s 參數]` 來對 PO 檔案做 +指定動作。 + +接下來講建議做的一些動作。 + + - 動作列表 - + + [動作] remove-obsolete + [用意] 移除已經過時的字串。除非過時字串真的太多，否則沒什麼必要執行。 + [參數] 無 + + [動作] remove-previous + [用意] 移除無 fuzzy 標記之先前訊息。 + [參數] + all: 移除包括 fuzzy 標記的先前訊息。 + + [動作] normalize-header + [用意] 標準化每個 PO 檔案的檔頭，讓 PO 的檔頭一致化。 + [參數] 無 + [動作] check-kde4 + [用意] 檢查每個 PO 檔案的字串，看 HTML Tag 是否對稱、內容是否有效等等。 + [參數] + strict: 嚴格檢查模式。建議不加。 + lokalize: 使用 lokalize 開啟有問題的 PO 檔，讓你比較好修正。 + 注意：lokalize 必須要是開著的。 + 建議傳入。 + + [動作] unfuzzy-context-only + [用意] 將只更改翻譯備註 (context) 的被標 fuzzy 翻譯取消 fuzzy 標記。 + [參數] 無 + + [動作] unfuzzy-inplace-only + [用意] 修正 HTML 標籤，並將因標籤問題而標為 fuzzy 的字串取消 fuzzy 標記。 + [參數] 無 + +== 同步 trunk 與 stable 翻譯檔案 == +這可以解決要重複翻譯 trunk 和 stable 中同一個軟體 po 檔的問題。 +此使用 Lokalize 18.12.0 示範，若未來方法有所變更，請幫忙提交修改。 + +I. 建立專案 +打開 Lokalize -> 專案(P) -> 建立軟體翻譯專案 + +接著把 index.lokalize 取名為你想取的名字，並放在你能找得到的地方。 + +II. 設定專案 +接著會跳出一堆東西，你只需要改以下幾個： + +- 一般 + - ID: 把他改成你能識別的名字，例如「KDEtrunk」「KDEstable」 + - 郵件論壇: 把他改成「l10n-tw@linux.org.tw」或其他郵件論壇，保留原本的亦可。 + - 根目錄: 改成你想翻譯的分支，例如 trunk 或 stable 分支。 +- 進階 + - 分支目錄: 改成你想要同步的 PO 翻譯檔分支，例如 stable 或 trunk 分支。 + - 其他翻譯目錄: 改成你目前的翻譯分支，例如 trunk 或 stable 分支。 + +未來只需開啟該專案檔，即可同步兩側的 PO 檔案。 + +== 聯絡團隊 == +#l10n-tw + +IRC: #l10n-tw +Telegram: @l10n-tw +郵件論壇: zh-l10n@linux.org.tw