跳至內容

語言

語言可能造成理解上的障礙。我們希望盡可能讓更多人能夠使用 Tuist。如果你使用的語言尚未受 Tuist 支援，你可以協助 Tuist 支援該語言，方法是改進英文原始內容，以及 Glossia 用來進行翻譯的本地化上下文。

由於語言支援是一項持續的工作，當我們看到有貢獻者願意協助維護時，就會新增語言。目前支援的語言包括：

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

如果你認為 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 中放置特定語言的指引