使用 Weblate 進行翻譯¶

感謝你有興趣使用 Weblate 參與翻譯！如果你是第一次使用，請依照開始你的第一筆翻譯的指引完成首次貢獻。

總體而言，有兩種最常用的翻譯模式：

該專案接受直接翻譯
專案接受使用者的建議。

匿名建議有時也被接受。

更多翻譯流程詳情見翻譯工作流程。

專案或其中的組件要麼對所有人可見，要麼只對某些翻譯者可見。

也參考

翻譯專案¶

翻譯專案包含相關組件；同一軟體、書籍或專案的資源。

翻譯連結¶

導覽到一個組件後，一組連結會指向它的實際翻譯。翻譯進一步分為單獨的檢查，如未翻譯的字串或未提交的字串。如果整個專案已被翻譯，且沒有任何錯誤，所有字串仍然可用。或者，您可以使用搜尋功能來查詢特定的字串或術語。

建議¶

備註

實際權限可能因 Weblate 設定而異。

匿名使用者預設只能提交建議。登入的使用者若對某翻譯有疑慮，也可提交建議，請其他譯者進行審閱。任何使用者都可將現有建議（包括複數形式）複製到翻譯欄位，作為新的建議或翻譯基礎。

會每天掃描所有建議，以刪除重複建議以及與目前翻譯相符的建議。

如果您擁有接受建議權限，可按下某位使用者建議旁的帳號核取圖示，批次接受該使用者的所有建議。此功能適合用來快速處理來自可信任貢獻者的建議。未通過品質檢查的建議會被略過，並留待人工審閱。Weblate 會顯示相符建議的數量以供確認，並在背景執行接受作業。如果您可審閱翻譯，也可在同一步驟中接受並核准這些建議。

批次接受功能只會選取該使用者在目前組件、目前語言中的建議。即使屬於同一專案，也不會選取其他語言或其他組件的建議。例如，將組件翻譯成法文時，批次接受只會選取該使用者在該組件中的法文建議。

評論¶

可以發表三類評論：

對於翻譯
對於來源字串
報告來源字串的錯誤，前提是透過啟用來源檢閱開啟了此功能。

請為您想討論的主題選擇合適類型。不論任何情況，來源字串註解都很適合用來提供來源字串的意見，例如建議改寫，或對內容提問。

所有留言都可以使用 Markdown 語法，也可以使用 @username 提及其他使用者。發表前，請使用留言欄位上方的預覽分頁，檢查 Markdown 與提及的顯示方式。若需要維護者或其他譯者查看後續問題，請提及對方；他們可以在同一個留言分頁回覆。

若要再次尋找註解，請開啟您的使用者設定檔；註解數會連結至您的註解活動。若要尋找特定使用者留下註解的字串，請使用搜尋。例如，comment_author:USERNAME 會找出該使用者留下註解的字串，而 source_comment_author:USERNAME 會找出該使用者留下來源字串註解的字串。登入後，搜尋過濾選單也會提供您的註解及您的來源註解捷徑。

也參考

變體¶

變體用於對字串的不同長度變體進行分組。專案的前端可以根據螢幕或視窗大小使用不同的字串。

也參考

標籤¶

標籤用於對專案中的字串進行分類，以進一步自訂在地化工作流程（例如定義字串的類別）。

Weblate 使用以下標籤：

已自動翻譯: 字串是使用自動翻譯翻譯的。
來源需要檢閱: 使用來源字串檢閱將字串標記為需要稽核。

也參考

字串標籤

翻譯¶

在翻譯頁面上，將顯示來源字串及其譯文的編輯區域。如果譯文是複數的，則會顯示多個來源字串和編輯區域，每個來源字串和編輯區域都以翻譯語言具有的複數形式的數量進行描述和標記。

所有特殊空白字元都會新增紅色下劃線，並用灰色符號表示。多個接續的空格也會新增紅色下劃線，以提醒譯者潛在的格式問題。

此頁面上可以顯示各種額外資訊，其中大部分來自專案原始碼（如情境、註解或訊息的使用位置）。譯者在偏好設定選擇的任何第二語言的翻譯欄位都將顯示在來源字串上方（參閱第二語言）。

在譯文下方，譯者會看到他人的建議，可進行的操作有接受（✓）、接受但進行修改（✏️）、批次接受特定使用者的建議（👤✓）、複製到翻譯框內（📑）或刪除（🗑）。

安全地翻譯特殊文字¶

部分來源字串包含應用程式會在執行階段解讀的文字。請翻譯一般使用者可閱讀的部分，但除非專案說明另有說明，否則應完整保留技術標記。

預留位置及格式字串: 請在翻譯中保留 %s、%1$d、%(name)s、{count}、{{ value }} 等變數或類似標記。具名預留位置會說明插入的值，但名稱本身不應翻譯。通常可以重新排列編號或具名預留位置，使其符合目標語言。請使用可置入項目的複製捷徑插入，以免輸入錯誤。
標記: 請保持 HTML 及 XML 標籤、標籤名稱及屬性名稱不變。請翻譯標籤之間可見的文字，以及翻譯字串中供使用者閱讀的屬性值，例如替代文字或工具提示。重新排列句子後，請確認開始與結束標籤仍然相符。
程式語法: 除非專案明確記載在地化形式，否則函式名稱、指令、環境變數、試算表函式、SQL 關鍵字及類似程式語法應保持不翻譯。
標點符號與空格: 請保留會影響介面的標點及空格，例如結尾冒號、省略符號、開頭或結尾空格，以及預留位置旁的標點。目標語言的排版與來源不同時，請遵循目標語言排版；若來源標點看似有誤，請使用註解反映。
加速器: 選單標籤可使用 &、_ 或 ~ 等字元標示鍵盤快速鍵。來源含有快速鍵時，翻譯也應保留 1 個。請在翻譯後的標籤中選取容易辨識的按鍵，並避免與鄰近選單項目或按鈕發生明顯衝突。
複數形式: 請翻譯 Weblate 顯示的每個複數欄位。除非這種寫法符合目標語言及專案規範，否則請勿將各形式合併為 file(s) 之類的單一寫法。若來源字串使用語意不明的複數形式，請透過來源字串註解或審閱加以回報。

Weblate 品質檢查可以找出許多預留位置、標記、標點、空白及複數形式的技術錯誤，但不能取代翻譯者的判斷。因此，來源文字需要釐清時，請使用翻譯情境、詞彙表及評論。

也參考

檢查與修復
複數
翻譯情境
評論

編輯來源字串與索引鍵¶

啟用管理字串且你有權限編輯來源字串時，請在翻譯編輯器中選擇工具 → 編輯來源字串。你可以從任何語言開啟此對話方塊。變更會套用至該組件中的來源字串及其現有翻譯。

你可以在對話方塊中變更來源文字、支援的索引鍵或上下文，以及來源說明。現有翻譯、歷程、留言、標籤及建議都會保留。變更來源文字會將現有翻譯標記為待編輯；只變更索引鍵、上下文或說明則會保留翻譯狀態。重新命名索引鍵時，可能也需要變更應用程式程式碼。

變更會透過一般的待處理變更佇列寫入翻譯檔案，並遵循專案的提交政策。待處理編輯所使用的索引鍵會保留，直到編輯寫入檔案為止。Weblate 遇到索引鍵衝突時會拒絕變更，不會合併字串。若你開啟對話方塊後，其他使用者已變更來源，請重新載入編輯器。

來源編輯支援 PO、TBX、純文字 XLIFF 1.2、XLIFF 2.0 和 Apple XLIFF。索引鍵編輯支援 JSON（一般、巢狀、ARB、WebExtension 和 i18next）、YAML、Ruby YAML、TOML、Go-i18n TOML、Java properties、GWT、PHP、DTD、Android、RESX，以及簡單的 Fluent 訊息。這些單語格式也支援編輯來源文字。PO 上下文與 TBX 索引鍵可以編輯；複合 XLIFF 索引鍵則無法編輯。

YAML 和 TOML 索引鍵可以在既有對應結構中重新命名，但不能移至其他對應結構，也不能在陣列中重新命名。若來源文字含有不支援的行內標記、要變更複數形式或術語替代項目的數量，或組件使用中介語言檔案，都不支援編輯。

也參考

複數¶

為了表示數量而改變形態的字詞稱為複數，每種語言的定義都不相同。例如英文支援一種複數形式：範例「car」的單數形式隱含指一輛車；複數形式「cars」則指兩輛以上的車（或作為名詞的車輛概念）。捷克文或阿拉伯文等語言擁有更多複數形式，複數規則也不相同。

Weblate 完整支援各語言的每種形式。每種文法數都會根據翻譯語言特定的預設基數集合，在個別欄位中翻譯。欄位數量及它們在翻譯後的應用程式或專案中如何使用，取決於設定的複數公式。Weblate 會顯示基本資訊；Unicode 聯盟的 Language Plural Rules 則提供更詳細的說明。

也參考

複數定義

替代翻譯¶

在 4.13 版被加入.

備註

目前只有多數值 CSV 檔案支援。

對於某些格式，單條字串可以有多種翻譯。您可以使用工具選單新增更多替代翻譯。儲存後將自動刪除任何空白的替代翻譯。

鍵盤快速鍵¶

在翻譯期間可以使用以下鍵盤快速鍵：

鍵盤快速鍵	描述
`?`	開啟可用的鍵盤快速鍵。
`Alt`+`Home`	導覽至目前搜尋中的第一個翻譯。
`Alt`+`End`	導覽至目前搜尋中的最後一個翻譯。
`Alt`+`PageUp` 或 `Ctrl`+`↑` 或 `Alt`+`↑` 或 `Cmd`+`↑`	導覽至目前搜尋中的上一個翻譯。
`Alt`+`PageDown` 或 `Ctrl`+`↓` 或 `Alt`+`↓` 或 `Cmd`+`↓`	導覽至目前搜尋中的下一個翻譯。
`Ctrl`+`Enter` 或 `Cmd`+`Enter`	提交目前的表單；這與在編輯翻譯時按下儲存並繼續是一樣的。
`Ctrl`+`Shift`+`Enter` 或 `Cmd`+`Shift`+`Enter`	將翻譯標記為「無需編輯」並提交。
`Ctrl`+`Alt`+`Enter` 或 `Cmd`+`Alt`+`Enter`	核准翻譯並儲存後繼續。僅供審核者使用。
`Alt`+`Enter` 或 `Option`+`Enter`	將字串提交為建議；這等同於在編輯譯文時按下建議。
`Ctrl`+`E` 或 `Cmd`+`E`	聚焦翻譯編輯器。
`Ctrl`+`U` 或 `Cmd`+`U`	聚焦評論編輯器。
`Ctrl`+`M` 或 `Cmd`+`M`	顯示自動建議分頁，請參閱自動建議。
`Ctrl`+`1` 到 `Ctrl`+`9` 或 `Cmd`+`1` 到 `Cmd`+`9`	從來源字串複製指定數量個可置換元素。
`Ctrl`+`M` 後接 `1` 到 `9` 或 `Cmd`+`M` 後接 `1` 到 `9`	將指定數量的機器翻譯複製到目前的翻譯。
`Ctrl`+`I` 後接 `1` 到 `9` 或 `Cmd`+`I` 後接 `1` 到 `9`	忽略清單中的其中一個失敗檢查專案。
`Ctrl`+`J` 或 `Cmd`+`J`	顯示相鄰字串分頁。
`Ctrl`+`S` 或 `Cmd`+`S`	聚焦搜尋欄位。
`Ctrl`+`O` 或 `Cmd`+`O`	複製來源字串。
`Ctrl`+`Y` 或 `Cmd`+`Y`	勾選/取消勾選需要編輯核取方塊。
`→`	瀏覽下一個翻譯字串。
`←`	瀏覽上一個翻譯字串。

虛擬鍵盤¶

在翻譯輸入框的上方，會顯示一行小型的視覺化鍵盤。這行鍵盤的內容因語言而異，可用於輸入在地化的標點符號或手動輸入較為困難的字元。

顯示的符號分為三類：

使用者設定特殊字元在使用者設定檔
Weblate 為每種語言提供的字元（例如引號或 RTL 特定字元）
使用 SPECIAL_CHARS 設定的字元

翻譯情境¶

此情境描述提供有關目前字串的相關資訊。

字串屬性: 例如訊息 ID、情境（msgctxt）或原始碼中的位置。
解釋: 透過解釋可提供進一步的解釋性資訊。
螢幕擷圖: 你可以使用上傳螢幕擷圖，直接從此面板上傳螢幕擷圖；也可以使用加入現有螢幕擷圖，連結已上傳的圖片，指出字串的用途與使用位置。來源語言螢幕擷圖會顯示在該字串的所有翻譯中；專屬於某份翻譯的螢幕擷圖則只會顯示在該翻譯中。請參閱螢幕擷圖和視覺化情境。
相鄰字串: 顯示來自翻譯檔案的相鄰字串。這些資訊通常是類似的情境，並保證翻譯的一致性。
其他出現位置: 如果一條資訊出現在多個地方（例如多個組件），若發現它們不一致，這個標籤會顯示所有的資訊（參閱不一致）。您可以選擇使用其中之一。
翻譯記憶: 查詢過去翻譯過的相似字串，參閱翻譯記憶。
詞彙表: 顯示目前資訊中使用的專案詞彙表的術語。
歷史紀錄: 顯示最近透過 Weblate 變更了此資訊的人員清單。
專案: 專案資訊，如翻譯人員的說明，或專案使用的版本控制系統儲存庫中字串的目錄或連結。

如果您想要直接連結，翻譯格式必須支援。

加入現有螢幕擷圖¶

若要連結已上傳的螢幕擷圖，請在翻譯編輯器中開啟該字串：

在螢幕擷圖面板中選擇加入現有螢幕擷圖。
瀏覽縮圖，或在搜尋螢幕擷圖輸入查詢，再選擇搜尋。使用上一個和下一個瀏覽其他結果。
按一下螢幕擷圖卡片即可選取。卡片會反白顯示並標示為已選取。若要使用鍵盤選取，請按 Tab 移至卡片，再用方向鍵移動，並按 Space 選取卡片。
選擇新增螢幕擷圖。編輯器會在同一個字串重新載入，並在螢幕擷圖面板中顯示連結的螢幕擷圖。

選取器會顯示目前組件中，以來源語言或目前翻譯語言拍攝的螢幕擷圖。來源語言螢幕擷圖會連結至來源字串，並顯示在所有翻譯中；翻譯語言螢幕擷圖則只會顯示在該語言中。已連結至該字串的螢幕擷圖不會出現在選取器中。

此操作需要編輯螢幕擷圖權限。若要上傳新圖片，請改用上傳螢幕擷圖。若要使用完整的螢幕擷圖管理介面，請選擇管理螢幕擷圖。

翻譯歷史紀錄¶

預設情況下，每個變更（除非在組件設定中關閉）都儲存在資料庫中，並且可以復原。此外，也可以在底層版本控制系統中復原翻譯。

在變更瀏覽器中，使用較舊和較新瀏覽歷程，或選擇最新返回最新的相符變更。跳至日期會從所選日期當天或之前的最新變更開始。之後你可以保留搜尋篩選條件，往任一方向瀏覽。使用日期範圍將結果限制在特定期間。

CSV 下載和 RSS 訂閱會使用搜尋篩選條件，不會採用瀏覽位置或跳轉日期。CSV 下載最多包含 2,000 筆相符變更；RSS 訂閱則包含最新的 10 筆。舊的頁碼連結會開啟最新的相符變更。

已翻譯的字串長度¶

Weblate 可以透過多種方式限制翻譯的長度，以確保翻譯後的字串不會太長：

翻譯的預設限制是來源字串的十倍。這可以透過 LIMIT_TRANSLATION_LENGTH_BY_SOURCE_LENGTH 進行修改。如果您遇到這種情況，也可能是由於單語翻譯被錯誤地設定為雙語翻譯，導致 Weblate 將翻譯鍵誤認為是實際的來源字串。更多資訊參閱雙語言和單語言格式。
依照翻譯最大長度，由翻譯檔案或標誌定義的字元的最大長度。
由標誌定義的以畫素為單位的最大渲染大小，請參閱翻譯的最大長度。

自動建議¶

根據設定和您的翻譯語言，Weblate 提供來自多個機器翻譯工具和翻譯記憶的建議。所有機器翻譯都在每個翻譯頁面的一個分頁中提供。

您也可以在翻譯記憶執行詞語索引搜尋。

也參考

您可以在自動建議中找到支援的工具清單。

自動翻譯¶

您可以使用自動翻譯，根據外部來源建立初始翻譯。選取組件及語言後，可從作業選單開啟名為自動翻譯的工具：

如果您選取了專案語言、組件或類別，也可使用類似的批次自動翻譯作業。

有兩種操作模式是可能的：

使用其他 Weblate 組件作為翻譯來源。
使用所選機器翻譯服務，轉換高於一定的品質閾值。

使用其他組件作為來源時，Weblate 會先比對來源文字與上下文是否完全一致，包括空白上下文。若找不到，就會使用只符合來源文字的翻譯。上下文相符的結果優先於來源組件順序；相符程度相同時，才依組件順序決定。

只有在複數形式相容時，Weblate 才會套用翻譯。若來源組件使用不同的複數規則，Weblate 會略過複數字串並顯示警告，但仍會翻譯只有一種形式的字串。

您還可以選擇要自動翻譯的字串。

警告

請注意，如果使用諸如所有字串之類的寬過濾器，這將覆蓋現有的翻譯。

在幾種情況下有用，如在不同組件（例如應用程式及其網站）之間的統一轉換（例如應用程式及其網站）或使用現有翻譯（翻譯記憶）引導用於新組件的翻譯時。

自動翻譯的字串會被打上自動翻譯標籤。

也參考

跨組件保持翻譯一致

速率限制¶

為了避免濫用介面，速率限制適用於多個操作，如搜尋、傳送聯絡表單或翻譯。如果受其影響，您將被阻止一段時間，直到您可以再次執行該操作。

預設限制和微調在管理手冊中有描述，參閱速率限制。

搜尋並取代¶

使用操作選單中的搜尋並替換有效地變更術語或執行字串的批次修復。

提示

不用擔心會弄亂字串。此過程分為兩步：先顯示要編輯字串的預覽，再確認實際改動。可以從預覽調整搜尋引數並在應用替換前更新它。

批次編輯¶

批次編輯允許對多條字串執行一個操作。您可以透過搜尋字串來定義字串，併為相符字串設定要執行的操作。支援以下操作：

變更字串狀態（例如，批准所有未稽核的字串）。
調整適用於所有語言或特定語言的翻譯旗標（請參閱使用旗標自訂行為）
調整字串標籤（請參閱字串標籤）

來源旗標與標籤操作會影響所有語言中符合條件的字串。翻譯旗標操作只會影響符合條件的翻譯，並略過來源字串。移除翻譯旗標只會移除本機值；繼承而來的旗標仍然有效。若要將符合條件的翻譯設為唯讀，請在要新增的翻譯旗標—符合的翻譯中加入 read-only。

提示

這個工具叫做批次編輯，可以在每個專案、組件或翻譯的操作選單中存取。

也參考

批次編輯附加元件

矩陣檢視¶

使用此檢視，您可以高效比較不同語言。您可以在操作選單下的每個組件頁面上找到它。首先選擇您要比較的所有語言，並確認您的選擇，然後點選任何翻譯來開啟和編輯它。

矩陣檢視也是一個非常好的起點，可以找到不同語言中缺少的翻譯，並從一個檢視快速新增它們。

禪譯模式¶

此模式會簡化版面，並移除附近字串或詞彙表之類的額外使用者介面元素。您可在一般編輯器（字串翻譯頁面）右上角按下 Zen 按鈕開啟。

您可以使用使用者設定檔上的偏好設定分頁選擇禪編輯器作為預設編輯器。您還可以在此根據您的個人喜好選擇到底是從上到下還是並排列出翻譯。