跳至內容

語言

語言可能會成為理解的障礙。我哋希望確保盡可能多的人都能使用 Tuist。如果你講嘅語言 Tuist 尚未支援,你可以透過改善英文原文同 Glossia 用於翻譯的本地化上下文,幫助 Tuist 支援該語言。

由於語言支援係一項持續進行嘅工作,我哋會喺見到有貢獻者願意協助維護時,先至加入新語言。目前支援以下語言:

  • 英文
  • 阿拉伯文
  • 西班牙文
  • 日文
  • 格魯吉亞文
  • 韓文
  • 俄文
  • 粵語
  • 簡體中文
  • 繁體中文
請求新增語言

如果你認為 Tuist 支援新語言會有幫助,請建立一個新的 社區論壇主題 同社區討論。

如何提供幫助#

Tuist 的語言支援由儲存庫驅動。貢獻者更新英文原文同翻譯上下文,而 Glossia 會自動生成本地化文件。

工作流程如下:

  1. 更新英文原文內容。
  2. 如果譯者需要更多指引,請更新相關的 L10N.md 上下文。
  3. 提交包含這些來源更改的拉取請求。
  4. 當更改合併到 main 後,Glossia 會翻譯更改部分,並保持一個包含更新本地化文件的翻譯拉取請求處於開啟狀態。
切勿修改生成的本地化內容

請勿直接編輯生成的本地化內容。應改為更新英文原文同語言上下文。

L10N.md 結構#

L10N.md 文件定義了 Glossia 翻譯時使用的上下文。最簡單的理解方式係將它們視為可以存在於不同目錄層級的範圍化語言指令。

例如:

plaintext
.
|-- L10N.md
|-- server
| |-- L10N.md
| |-- L10N
| | `-- es.md
| `-- priv
| `-- gettext
| `-- marketing.pot

目錄上下文#

Glossia 會從儲存庫根目錄向下遍歷至正在翻譯的目錄,並組合該路徑上找到的每個 L10N.md 文件。

在上述例子中:

  • L10N.md 全局適用。
  • server/L10N.md 添加伺服器特定的上下文。
  • server/L10N/es.md 為同一區域添加僅限西班牙文的覆蓋設定。

這意味著你可以將上下文放置於適當的位置:

  • 位於根目錄的全儲存庫指引
  • 位於子目錄的區域特定指引
  • 位於 L10N/<locale>.md 的語言特定指引