我的 KDE 翻譯流程

直接用 SVN 讓我能夠只 clone 部分的資料夾。git-svn 好像也支援這類功能，但是它實在是太慢了。

svn update --set-depth empty 路徑 # 路徑/ 是空資料夾
svn update --set-depth files 路徑 # 路徑/檔案1 ...
# 路徑/檔案1 ... 和 路徑/資料夾1/ ...，後者是空資料夾
svn update --set-depth immediates 路徑
svn update --set-depth infinity 路徑 # 所有子資料夾和檔案，深度無限

KDE 的 SVN 版本庫長這樣：

/branches/
/branches/<一堆我沒興趣的資料夾>
/branches/stable/
/branches/stable/<一堆我沒興趣的資料夾>
/branches/stable/l10n-kf5/ # 其中有 templates、zh_TW 和別的語言
/branches/stable/l10n-kf6/ # 其中有 templates、zh_TW 和別的語言
/tags/<一堆我沒興趣的資料夾>
/trunk/
/trunk/<一堆我沒興趣的資料夾>
/trunk/l10n-kf5/ # 其中有 templates、zh_TW 和別的語言
/trunk/l10n-kf6/ # 其中有 templates、zh_TW 和別的語言

我的目的是要讓我的工作複本長這樣：

/branches/stable/l10n-kf5/ # 其中有 templates、zh_TW 和參考用的 ja
/branches/stable/l10n-kf6/ # 其中有 templates、zh_TW 和參考用的 ja
/trunk/l10n-kf5/ # 其中有 templates、zh_TW 和參考用的 ja
/trunk/l10n-kf6/ # 其中有 templates、zh_TW 和參考用的 ja
/trunk/l10n-kf6/zh_TW/messages/konsole/konsole.po # 完整路徑範例

首先我先簽出工作複本，確保不要不小心簽出整個版本庫：

svn checkout --depth immediates svn://anonsvn.kde.org/home/kde/ ~/kde-svn
cd ~/kde-svn

接下來，我的目的是要這樣做：

svn update --set-depth infinity branches/stable/l10n-kf{5,6}/{templates,ja,zh_TW} trunk/l10n-kf{5,6}/{ja,zh_TW,templates}

# "kf{5,6}" 代表 "kf5 kf6"，是 shell 的 brace expansion

但是 SVN 會抱怨：

svn: E155007: None of the targets are working copies

現在的問題是， /trunk 的深度是 empty ，而要再製它底下的東西的話它本身不能是 empty 。我們只剩三個選項： infinity 下載太多東西， immediates 會給我們一大堆空的資料夾（不過這樣會很明顯有哪些能用的資料夾）； files 會給我們它底下的檔案，雖然我還是不想要那些檔案，但是這是最不糟的選項。

這樣，我們需要把目標資料夾的親資料夾個別設為深度 = files 。我的做法是，就…

svn update --set-depth files branches
svn update --set-depth files branches/stable
svn update --set-depth files branches/stable/l10n-kf{5,6}
# 親資料夾都沒有 empty depth 了，所以可以設定目標的 depth = infinity 了
svn update --set-depth infinity branches/stable/l10n-kf{5,6}/{templates,ja,zh_TW}

svn update --set-depth files trunk
svn update --set-depth files trunk/l10n-kf{5,6}
# 同樣，親資料夾都沒有 empty depth 了，所以可以設定目標的 depth
svn update --set-depth infinity trunk/l10n-kf{5,6}/{ja,zh_TW,templates}

我的路徑長這樣：

~/kde-svn/branches/stable/l10n-kf5/zh_TW
~/kde-svn/branches/stable/l10n-kf5/ja
~/kde-svn/branches/stable/l10n-kf5/templates

~/kde-svn/branches/stable/l10n-kf6/zh_TW
~/kde-svn/branches/stable/l10n-kf6/ja
~/kde-svn/branches/stable/l10n-kf6/templates

~/kde-svn/trunk/l10n-kf5/zh_TW
~/kde-svn/trunk/l10n-kf5/ja
~/kde-svn/trunk/l10n-kf5/templates

~/kde-svn/trunk/l10n-kf6/zh_TW
~/kde-svn/trunk/l10n-kf6/ja
~/kde-svn/trunk/l10n-kf6/templates

Lokalize 可以設定專案，而屬於專案的 PO 檔是在專案檔 (.lokalize) 同一個資料夾底下的所有 PO 檔。

我希望同一個 Lokalize 專案裡可以同時看到 kf5 和 kf6 的檔案。問題是，現有的路徑裡如果同時看到 kf5 和 kf6 也就代表會同時看到 templates 和 zh_TW ，而這會導致我沒有辦法利用 Lokalize 的 PO 樣本的功能。

我的解決方法是用 symlink 把我需要的資料夾格式做出來。

(在 ~/kde-translations/ 裡面)
# {lang} 是 ja, zh_TW 或 templates
{lang}/kf{5,6} -> ~/kde-svn/trunk/l10n-kf{5,6}/{lang}
# 讓 stable 和 trunk 的 Lokalize 專案共用 Glossary
zh_TW/terms.tbx -> ../terms.tbx
# trunk 的 Lokalize 專案設定
zh_TW/index.lokalize

stable.{lang}/kf{5,6} -> ~/kde-svn/branches/stable/l10n-kf{5,6}/{lang}
# 讓 stable 和 trunk 的 Lokalize 專案共用 Glossary
stable.zh_TW/terms.tbx -> ../terms.tbx
# stable 的 Lokalize 專案設定
stable.zh_TW/index.lokalize

zh_TW/index.lokalize 的內容：

[General]
AltDir=../ja
BranchDir=../stable.zh_TW
PotBaseDir=../templates ; 這是預設值，實際上會忽略
PotBranchDir=../stable.templates
LangCode=zh_TW
LanguageSource=Project
MailingList=zh-l10n@lists.slat.org
ProjLangTeam=Traditional Chinese <zh-l10n@lists.slat.org>
ProjectID=kde-translations-zh_TW ; 讓 stable 和 trunk 用同樣的翻譯記憶體
TargetLangCode=zh_TW

stable.zh_TW/index.lokalize 的內容：

[General]
AltDir=../stable.ja
BranchDir=../zh_TW
PotBaseDir=../stable.templates
PotBranchDir=../templates
LangCode=zh_TW
LanguageSource=Project
MailingList=zh-l10n@lists.slat.org
ProjLangTeam=Traditional Chinese <zh-l10n@lists.slat.org>
ProjectID=kde-translations-zh_TW ; 讓 stable 和 trunk 用同樣的翻譯記憶體
TargetLangCode=zh_TW

這樣我就有一個 Lokalize 專案可以一次翻譯正體中文的所有軟體（應該已經不需要回去看 KDE4 還有什麼了…），並且透過 Lokalize 的自動同步功能，在設定好 BranchDir 之後也會自動在我修改 trunk 的時候自動幫我修改可以直接套用的 stable 的翻譯。

我現在的翻譯流程是：

• 在開始翻譯之前用 svn update 抓最新的變更，因為讓 SVN 自動合併 PO 檔會很麻煩（尤其是 Scripty 自動更新的來源原始碼行號的註解）

• 然後 我會在 ~/kde-svn 開一個新的 Git 版本庫 。這完全只是用來 diff 變更前和變更後的差異用的而已，但我個人覺得這比 svn diff 還要好用，尤其我在翻譯完之後還可以用 Magit 來回顧做檢查。

  git init
  git add ./trunk ./branches
  git commit -m "before"

• 然後打開 Lokalize 開始翻譯。

• 翻譯完之後先檢查我有沒有漏掉 %1 之類的格式字串。

  fd -e po -x msgfmt -o /dev/null --check-format
  # 當然也可以用 find，但我通常覺得 fd 比較直覺
  # https://github.com/sharkdp/fd

• 打開 Magit，檢查各個變更的區塊，然後寫提交訊息
• 把寫到 Git 裡的提交訊息複製起來
• 用 svn status 確認有沒有新檔案需要加入版控 —— SVN 沒有一個 staging area，但是新檔案還是需要先明確的 svn add 過才會在 commit 時包含。
• 確認我沒有把 .git 標成加入版控 。有提交權限就有檢查自己有沒有提交垃圾的責任；with great power comes great responsibility.
• 用 svn add 把新檔案加入版控
• svn commit, 讓它開編輯器來編輯提交訊息，然後把剛剛複製的提交訊息貼上
• 存檔提交