跳至內容

語言

語言可能會成為理解的障礙。我們希望盡可能讓更多人能夠使用 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 中放置特定語言的指引