Weblate is libre software web-based continuous localization system, used by over 2500 libre projects and companies in more than 165 countries.

安裝它，或使用 weblate.org 上的 Hosted Weblate 服務。

https://img.shields.io/pypi/v/weblate.svg

https://readthedocs.org/projects/weblate/badge/

支援#

Weblate is libre software with optional professional support and cloud hosting offerings. Check out https://weblate.org/hosting/ for more information.

文件#

可以在原始碼的 docs 目錄中找到，或在 https://docs.weblate.org/ 線上查看

安裝#

設置說明：

https://docs.weblate.org/en/latest/admin/install.html

缺陷#

請將功能請求和問題報告給：

https://github.com/WeblateOrg/weblate/issues

線上聊聊#

Weblate 線上聊天可在 Libera.Chat IRC 頻道。頻道名稱為 #weblate 。可透過例如 https://web.libera.chat/#weblate 或在您電腦中已安裝的 IRC 使用者端程式連線。

授權#

本程序是自由軟件：您可以在自由軟件基金會發佈的 GNU 一般公共許可的第三版許可，或（您選擇的）更新版本的條款之下，將其重新發佈並且/或者修改。

發佈本程序希望它有用，但不具有任何質保；甚至沒有應用可銷售性或適於特定目的的質保。更多細節請參見 GNU General Public License 。

Weblate 基礎知識#

Project and component structure#

在 Weblate 中，翻譯組織成為項目和組件。每個項目可以包含幾個組件，並且組件包含各個語言的翻譯。組件相應於一個翻譯文件（例如 GNU gettext 或 Android字串資源）。項目幫助您將組件組織為邏輯的組（例如，將一個應用中使用的所有翻譯分組）。

預設情況下，每個項目內都有對跨組件傳播的公共字串的翻譯。這減輕了重複和多版本翻譯的負擔。但假如翻譯應當有所不同，可以使用允許翻譯再用通過組件配置禁用翻譯傳播。

也參考

與 Weblate 集成

註冊和使用者資料#

註冊#

預設情況下，每個人都可以瀏覽項目，查看翻譯或建議翻譯。只允許註冊使用者實際保存更改，並為每種翻譯歸功於所做的。

您可以透過以下幾個簡單的步驟註冊：

使用憑據填寫註冊表格。
透過您收到的電子郵件中的連結啟用註冊。
（可選）調整您的個人資料以選擇您知道的語言。

控制面板#

登錄時，您將看到項目和組件的概述，以及各自的翻譯進展。

預設顯示您正在觀看的項目組件，並通過您的首選語言交叉引用。

提示

您可以使用導覽列中的分頁切換到不同的檢視方式。

菜單有這些選項：

：圭冊：“項目”>：“圭冊：”瀏覽所有項目`“主菜單中顯示了WebLate實例上的每個項目的轉換狀態。
在主菜單中選擇一種語言：Guilabel：“語言”（語言）將顯示所有項目的翻譯狀態，由您的主要語言之一過濾。
：圭冊：“觀看翻譯”儀表板中的翻譯將顯示只有您正在觀看的項目的翻譯狀態，由您的主要語言過濾。

此外，DROP-DOWN還可以顯示Web2管理員預先配置的任何數量的*組件列表*，請參閱:ref:“ComponentLists`”。

您可以在“使用者配置文件”設置的“使用者配置文件”設置中配置“個人預設儀表板”視圖：“首選項”部分。

備註

當使用以下項目配置 Weblate 時 SINGLE_PROJECT 在 settings.py 文件（請參閱配置），儀表板將不會顯示，當使用者將被重定向到單個專案或組件。

使用者個人檔案#

單擊頂部菜單的右上角的“使用者”圖標可以訪問使用者配置文件，然後單擊“：Guilabel：”設置“菜單。

使用者配置文件包含您的首選項。VCS提交中使用的名稱和電子郵件地址，因此請保持此信息準確。

備註

所有語言選擇僅提供目前翻譯的語言。

提示

請求或添加要通過單擊按鈕來翻譯的其他語言，以使其成為可用。

語言#

介面語言#

選擇您想要顯示用户界面的語言。

想翻譯成哪些語言#

選擇您更喜歡翻譯的語言，它們將在觀看項目的主頁上提供，因此您可以更容易地訪問每個語言中的所有翻譯。

第二語言#

您可以在翻譯時將哪些輔助語言作為指南顯示為指南。在以下圖像中可以看到一個示例，其中希伯來語如下所示：

偏好設定#

預設控制面板檢視#

在：Guilabel：“首選項”選項卡，您可以預設選擇要呈現的可用儀表板視圖。如果選擇：Guilabel：“組件列表”，則必須從以下內容中選擇哪些組件列表：Guilabel：“預設組件列表”下拉列表。

也參考

組件列表

編輯器連結#

原始碼鏈接顯示在:ref:“組件”中配置的Web瀏覽器中，預設情況下。

提示

通過設置：Guilabel：“編輯器”鏈接“，您可以使用本地編輯器打開翻譯字串的VCS原始碼文件。您可以使用:ref:“標記”。

通常是“編輯器：//打開/？文件= {{filename}}＆line = {{line}}``是一個很好的選擇。

也參考

您可以在 Nette 文件中找到更多關於註冊編輯器自訂 URL 協議的資訊。

特殊字元#

Additional special characters to include in the 模擬鍵盤.

通知#

訂閱來自：Guilabel：“通知”選項卡的各種通知。觀看或管理項目的所選事件的通知將每次發送電子郵件發送給您。

其中一些通知僅用於語言中的事件（例如，關於要轉換的新字串），而組件級別的某些觸發（例如合併錯誤）。這兩種通知在設置中可視化。

您可以切換監視項目和管理項目的通知，每個項目和組件都可以進一步調整（或靜音）。訪問“組件概述”頁面，然後選擇以下選項：Guilabel：“觀看”菜單。

以防：圭冊：“自動觀看貢獻的項目即可啟用，您將在翻譯字串時自動開始觀看項目。預設值取決於：設置：default_auto_watch。

備註

您不會收到您自己的行為的通知。

提示

Sending out notifications is limited, you will not receive more than 1000 e-mails per day. Any further notifications for you will be discarded.

帳號#

Account 標籤頁讓您設定基本的帳戶資訊細節、連結其他登入帳戶服務並可透過它們來登入 Weblate、完整的移除您的帳戶或打包下載您的使用者資訊 (詳情請參考 Weblate user data export)。

備註

服務列表取決於您的WebBlate配置，但可以包括包括Gitlab，Github，Google，Facebook或Bitbucket或其他OAuth 2.0提供程序等流行網站。

個人檔案#

此頁面上的所有欄位皆為選填，且可隨時刪除。一旦填入這些資訊，即表示您同意我們在您的個人檔案出現時分享這些資料。

The private commit e-mail will be used instead of your account e-mail in version control commits. Use this to avoid leaking your real e-mail there. Be aware that using different e-mail can disconnect your contributions on other servers (for example your contributions will no longer link to your profile on GitHub). The private e-mail can be turned on site-wide using PRIVATE_COMMIT_EMAIL_OPT_IN.

可以為每個使用者顯示化身（取決於：設置：enable_avatars）。這些圖像是使用https://gravatar.com/獲得的。

授權方式#

API 存取#

您可以在此處獲取或重置API訪問令牌。

稽核記錄#

審核日誌會跟踪您的帳戶執行的操作。它為您的帳戶註銷每個重要操作的IP地址和瀏覽器。關鍵操作還觸發了主電子郵件地址的通知。

也參考

在反向代理後面運行

使用 Weblate 進行翻譯#

感謝您使用Weberate翻譯的興趣。項目可以設置為直接翻譯，也可以通過不接受沒有賬戶的使用者提出的建議。

總的來說，有兩種翻譯方式：

該項目接受直接翻譯
該項目僅接受建議，一旦達到了已定數量的投票，就會自動驗證

有關翻譯工作流的更多信息，請見翻譯工作流。

翻譯項目可見性選項：

Publicly visible
僅對某一組翻譯人員來看見

也參考

存取控制, 翻譯工作流

翻譯專案數#

翻譯項目持有相關組件;用於同一軟件，書籍或項目的資源。

Translation links#

Having navigated to a component, a set of links lead to its actual translation. The translation is further divided into individual checks, like Untranslated strings or Unfinished strings. If the whole project is translated, without error, All strings is still available. Alternatively you can use the search field to find a specific string or term.

建議#

備註

實際權限可能會有所不同，具體取決於您的WebLate配置。

匿名使用者只能（預設情況下）前向建議。在簽署的使用者中仍然可以使用，因為在出現過翻譯的不確定性，提示其他翻譯人員審查它。

每天掃描建議，以刪除與當前翻譯的重複和建議。

評註#

可以發佈三種類型的註釋：用於翻譯，來源字串或在使用以下功能時報告來源字串錯誤:ref:Project-Source_Review。選擇您要討論的適合主題的那個。來源字串註釋在任何事件中都適用於在原始字串上提供反饋，例如應該被重建或提出關於它的問題。

You can use Markdown syntax in all comments and mention other users using @mention.

也參考

Receiving source string feedback, 源字串複查, 啟用來源檢閱

變體#

變體用於分組串的不同長度變體。然後，項目前端可以使用不同的字串，具體取決於屏幕或窗口大小。

也參考

字串變量, 變體

標籤#

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

Following labels are used by Weblate:

自動翻譯: String was translated using 自動翻譯.
來源需要檢閱: String was marked for review using 源字串複查.

也參考

字串標籤

Translating#

在翻譯頁面上，顯示了其翻譯的來源字串和編輯區域。如果翻譯是複數，則顯示多個來源字串和編輯區域，每個來源字串和編輯區域都描述並標記為翻譯語言的複數。

所有特殊的空白字符都以紅色強調，並用灰色符號表示。在紅色中也強調了多個後續空間以提醒轉換器到潛在的格式問題。

變型的字元或額外的資訊會被呈現在這頁，它們大部分來自專案本身的原始碼（如：上下文的情境、評論註解或是此字串也在哪個位置被使用過）。翻譯欄位也將會將次要語言（如有設定）內容顯示在來源字串上方（參閱第二語言）。

Below the translation, translators will find suggestion made by others, to be accepted (✓), accepted with changes (✏️), or deleted (🗑).

複數#

單詞更改表單以說明其數字名稱稱為複數。每種語言都有自己的複數定義。例如，英語支持一個。在例如“汽車”的奇異定義中，在多個定義中被引用了一輛車，“汽車”兩個或更多輛車被引用（或汽車的概念作為名詞）。例如，捷克或阿拉伯語喜歡的語言有更多的複數，並且他們的複數規則是不同的。

Weberate在每個相應的語言中都對每個表格中的每一種完全支持（通過單獨翻譯每個複數）。在翻譯的應用程序或項目中使用的字段數以及輪流如何取決於配置的多個公式。Weberate顯示基本信息，並且Unicode Consortium的“語言複數規則”是一個更詳細的描述。

也參考

複數公式

Alternative translations#

在 4.13 版本新加入.

備註

This is currently only supported with Multivalue CSV file.

With some formats, it is possible to have more translations for a single string. You can add more alternative translations using the Tools menu. Any blank alternative translations will be automatically removed upon saving.

鍵盤快捷鍵#

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

鍵盤快捷鍵	描述
`Alt+Home`	引導到第一個翻譯字串在此搜尋中。
`Alt+End`	引導到最後一個翻譯字串在此搜尋中。
`Alt+PageUp` 或 `Ctrl+↑` 或 `Alt+↑` 或 `Cmd+↑`	引導到前一個翻譯字串在此搜尋中。
`Alt+PageDown` 或 `Ctrl+↓` 或 `Alt+↓` 或 `Cmd+↓`	引導到下一個翻譯字串在此搜尋中。
`Ctrl+Enter` 或 `Cmd+Enter`	送出目前的表單。這與在編輯翻譯時按下 :guilabel:`Save and continue`是一樣的。
`Ctrl+Shift+Enter` 或 `Cmd+Shift+Enter`	無翻譯標記視為需要編輯與送出。
`Alt+Enter` 或 `Option+Enter`	送出此字串視為建議。這與在編輯翻譯時按下 :guilabel:`Suggest`是一樣的。
`Ctrl+E` 或 `Cmd+E`	焦點移到翻譯輸入框。
`Ctrl+U` 或 `Cmd+U`	焦點移到評註輸入框。
`Ctrl+M` 或 `Cmd+M`	顯示 Automatic suggestions 標籤，請參見自動建議。
`Ctrl+1` 到 `Ctrl+9` 或 `Cmd+1` 到 `Cmd+9`	從源字串中放置給定數字的副本。
`Ctrl+M` followed by `1` to `9` or `Cmd+M` followed by `1` to `9`	將給定號的機器翻譯複製到當前翻譯。
`Ctrl+I` followed by `1` to `9` or `Cmd+I` followed by `1` to `9`	忽略一個項目於未通過的查核列表。
`Ctrl+J` 或 `Cmd+J`	顯示 Nearby strings 標籤頁。
`Ctrl+S` 或 `Cmd+S`	焦點移到搜尋欄位。
`Ctrl+O` 或 `Cmd+O`	複製來源字串。
`Ctrl+Y` 或 `Cmd+Y`	切換 Needs editing 複選框。

模擬鍵盤#

小視覺鍵盤行在翻譯字段之上顯示。這對局部標點符號非常有用（因為行是每種語言的本地），或者有難以鍵入方便的字符。

顯示的符號分為三類：

使用者設定特殊字元在使用者個人檔案
Web20提供的每語言字符（例如引號或RTL特定字符）
字母設定使用 SPECIAL_CHARS

翻譯上下文#

此上下文描述提供有關當前字串的相關信息。

字串屬性: 像消息ID，上下文（`````）或原始碼中的位置。
螢幕擷圖: 屏幕截圖可以上傳到WebLate，以更好地通知譯者的位置以及如何如何使用字串，參見:ref:“屏幕截圖”。
相鄰字串: 顯示翻譯文件中相鄰信息。這些信息通常是類似的上下文，並保證翻譯的一致性。
其他出現位置: 如果一條信息出現在多個地方（例如多個組件），若發現它們不一致，這個標籤會顯示所有的信息（參見不一致）。您可以選擇使用其中之一。
翻譯記憶: 查找過去曾經翻譯的相識字串，參見:ref:memory。
詞彙表: 顯示當前信息中使用的項目詞彙表的術語。
最近更動: 顯示最近通過Weblate更改了此信息的人員列表。
專案: Project Info，如翻譯人員的說明，或版本控制系統存儲庫中的字串的目錄或鏈接項目使用。

如果要直接鏈接，轉換格式必須支持它。

Translation history#

預設情況下，每個更改都是（除非在資料庫中保存的組件設置中關閉），否則可以恢復。可選地，人們還可以還原在底層版本控制系統中的任何內容。

Translated string length#

Weberate可以在幾種方法中限制翻譯的長度，以確保翻譯的字串不是太長：

翻譯的預設限制比來源字串長十倍。這可以通過以下方式關閉：設置：limit_translation_length_by_source_length。如果您正在觸及此情況，則可能也是由單格式轉換錯誤地設置為雙語的語言，使WebLate誤認為是實際源串的翻譯鍵。請參閱:ref:“雙隅猴”以獲取更多信息。
由翻譯文件或標誌定義的字符中的最大長度，請參閱:ref:check-max-length。
最大渲染大小以標誌定義，請參閱：Ref：“Check-Max-Size`”。

自動建議#

基於配置和翻譯語言，Webleate提供了來自多種機器翻譯工具的建議和:ref:“翻譯 - 記憶庫”。所有機器翻譯都可以在每個翻譯頁面的單個選項卡中使用。

也參考

您可以找到支持的工具列表:ref:“計算機翻譯設置”。

自動翻譯#

您可以使用自動轉換基於外部源的引導轉換。該工具被稱為：圭冊：“自動翻譯”可訪問：Guilabel：“工具”菜單，選擇組件和一種語言後：

兩種操作模式是可能的：

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

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

警告

注意這將覆蓋具有廣泛過濾器（如：Guilabel：`所有字串）覆蓋現有翻譯。

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

The automatically translated strings are labelled Automatically translated.

也參考

跨組件保持翻譯一致

頻次限制#

為避免濫用界面，速率限制應用於若干操作，如搜索，發送聯繫表單或翻譯。如果受其影響，則在某個時期被阻止，直到您可以再次執行操作。

預設限制和微調在管理手冊中介紹，請參閱:ref:“速率限制”。

搜尋並取代#

使用：Guilabel有效地改變術語或執行批量固定字串：“搜索和替換”：Guilabel：“工具”菜單。

提示

不用擔心會弄亂字串。這分成兩個步驟：先預覽編輯字串，才會確認實際更動。

大量編輯#

批量編輯允許在字串數量上執行一個操作。您可以通過搜索它們來定義字串並設置用於匹配的東西。支持以下操作：

更改字串狀態（例如批准所有未升義的字串）。
調整翻譯標誌（參見:ref:“定制檢查”）
調整字串標籤（參見:ref:“標籤”）

提示

此工具被稱為：Guilabel：“批量編輯”可訪問：Guilabel：“工具”菜單，每個項目，組件或翻譯。

也參考

批量編輯插件

矩陣視圖#

要有效地比較不同的語言，您可以使用矩陣視圖。它在工具菜單下的每個組件頁面上都可用。首先選擇您要比較的所有語言並確認您的選擇，然後您可以單擊任何翻譯以快速打開和編輯它。

矩陣視圖也是一個很好的起點，可以找到不同語言的缺失翻譯並從一個視圖快速添加它們。

禪模式#

Zen 編輯器可以通過在翻譯組件時單擊右上角的 Zen 按鈕來啟用。它簡化了佈局並移除了額外的 UI 元素，例如 Nearby strings 或 Glossary。

You can select the Zen editor as your default editor using the 偏好設定 tab on your 使用者個人檔案. Here you can also choose between having translations listed Top to bottom or Side by side depending on your personal preference.

下載和上傳翻譯#

您可以從轉換中導出文件，進行更改，並再次導入它們。這允許脫機工作，然後將更改合併回現有翻譯。這也有效，即使它在此期間已更改。

備註

可用選項可能受到訪問控制設置的限制。

下載翻譯#

從項目或組件儀表板中，可在以下方式下載可翻譯文件：Guilabel：`files`菜單。

第一個選項是以原始格式下載文件，因為它存儲在存儲庫中。在這種情況下，翻譯中的任何掛起更改都會被提交，最新文件是不帶任何轉換的產量。

您還可以下載轉換為廣泛使用的本地化格式之一的翻譯。轉換後的文件將富裕地富裕在WebLate中提供的數據;例如其他上下文，評論或標誌。通過以下內容提供了多種文件格式：Guilabel：`文件`↓：圭冊：`自定義下載`菜單：

gettext PO (po)
XLIFF with gettext extensions (xliff)
XLIFF 1.1 (xliff11)
TermBase eXchange (tbx)
Translation Memory eXchange (tmx)
gettext MO (only available when translation is using gettext PO) (mo)
CSV (csv)
Excel Open XML (xlsx)
JSON (only available for monolingual translations) (json)
Android String Resource (only available for monolingual translations) (aresource)
iOS strings (only available for monolingual translations) (strings)

提示

轉換文件中可用的內容基於文件格式功能而不同，您可以查找概述:ref:FMT_CAPABS。

也參考

GET /api/translations/(string:project)/(string:component)/(string:language)/file/, WEBLATE_EXPORTERS

上傳翻譯#

當您進行更改時，使用：Guilabel：“上傳翻譯”：Guilabel：`Files`菜單。

支持的文件格式#

可以上載支持的文件格式中的任何文件，但仍然建議使用與用於翻譯的文件格式相同的文件格式，否則可能無法正確翻譯一些功能。

也參考

支持的文件格式, 下載和上傳翻譯

導入方法#

這些是上傳翻譯文件時提供的選項：

新增為翻譯 (translate)

導入的字串作為現有字串的翻譯添加。這是最常見的用例，也是預設行為。

只能從上傳的文件中使用翻譯，而且沒有其他內容。

新增為建議 (suggest)

字串作為建議來匯入，當您希望審核已上傳的字串時執行此操作。

只能從上傳的文件中使用翻譯，而且沒有其他內容。

新增為需要編輯的翻譯 (fuzzy)

字串作為需要編輯的翻譯匯入。當您希望使用翻譯但也需要審核時，這可能很有用。

只能從上傳的文件中使用翻譯，而且沒有其他內容。

取代既有翻譯檔 (replace)

現有文件替換為新內容。這可能導致現有翻譯丟失，謹慎使用。

更新來源字串 (source)

更新雙語翻譯文件中的源字串。這類似於什麼 addon-webblate.gettext.msgmerge 。

僅某些檔案格式支援此選項。

新增字串 (add)

將新字串添加到翻譯中。它跳過已經存在的那個。

如果您想要添加新字串並更新現有翻譯，請使用以下時間將文件上載添加作為翻譯。

此選項僅在打開管理字串時可用。

上傳檔中僅使用源、翻譯和金鑰（情境）。

也參考

POST /api/translations/(string:project)/(string:component)/(string:language)/file/

衝突處理#

定義如何處理已翻譯的上傳字串。

需要編輯的字串#

還有一個選擇如何處理需要在導入的文件中編輯的字串。這種字串可以以以下三種方式之一句柄：“不要導入”，“導入作為字串需要編輯”，或“轉換為”導入“。

覆蓋作者身份#

使用管理員權限，您還可以指定上傳文件的作者身份。如果您以其他方式收到文件並希望將其合併到現有翻譯中，同時正確註明實際作者，這可能會很有用。

詞彙表#

每個項目可以包括一個或多個詞彙表作為存儲術語的速記。術語表可以實現維持翻譯的一致性。

可以自己管理每種語言的詞彙表，但它們作為一個單個組件一起存儲，可幫助項目管理員和多語言翻譯人員來維持一些跨語言一致性。從包含當前翻譯的字串的詞彙表中的詞彙表中的術語顯示在翻譯編輯器的側欄中。

提示

The glossary terms are not used in quality checks unless you enable that, see 與詞彙表不同 for more information.

管理詞彙表#

在 4.5 版本變更: 詞彙表現在是常規的翻譯組件，您可以使用它們上的所有WebLate功能 - 評論，存儲在遠程存儲庫中，或添加說明。

使用任何組件作為詞彙表，方法是開啟當作詞彙表。您可以為一個項目創建多個詞彙表。

使用該項目自動創建給定項目的空詞彙表。詞彙表在同一項目的所有組件中共享，並且可選地使用其他項目:ref:“組件 - 鏈接”來自各個詞彙表組件。

詞彙表組件看起來像Weberate中的任何其他組件，其中添加彩色標籤：

您可以瀏覽所有詞彙表術語：

或將它們編輯為任何翻譯。

詞彙表術語#

詞彙表術語翻譯相同的常規字串。您可以使用以下內容切換其他功能：Guilabel：“工具”菜單，每個術語。

不可翻譯的術語#

在 4.5 版本新加入.

Flagging certain glossary term translations read-only by bulk-editing, typing in the flag, or by using Tools ↓ Mark as untranslatable means they can not be translated. Use this for brand names or other terms that should not be changed in other languages. Such terms are visually highlighted in the glossary sidebar.

也參考

使用標誌自定義行為

禁止的翻譯#

在 4.5 版本新加入.

標記某些詞彙表術語翻譯為“禁止的”，通過批量編輯，鍵入標誌，或者使用：Guilabel：“工具”↓：圭冊：“標記為禁止翻譯”意味著它們是**不是**使用。當有些詞曖昧或可能有意外含義時，用這可以澄清翻譯。

也參考

使用標誌自定義行為

專有名詞#

在 4.5 版本新加入.

將某些詞彙表術語標記為“術語”（批量編輯），或者使用旗幟，或使用工具`↓ :guilabel:`標記為術語添加“所有語言”中為“詞彙表”中的條目增加了所有語言。使用此項來說是應該得到深思熟慮的重要術語，並在所有語言中保留一致的含義。

也參考

使用標誌自定義行為

變體#

變體是將字串組合在一起的通用方式。在翻譯時，所有術語變體都列在詞彙表側欄中。

提示

您可以使用它來添加縮寫或縮短表達式。

也參考

字串變量

檢查和修復#

質量檢查有助於發現常見的翻譯錯誤，確保翻譯質量良好。如果出現誤報，則可以忽略這些檢查。

提交未通過檢查的翻譯後，將立即向使用者顯示：

自動修正#

除了質量檢查外，Weblate 還可以自動修復翻譯字串中的一些常見錯誤。謹慎使用它，不要使其增加翻譯錯誤。

也參考

AUTOFIX_LIST

Trailing ellipsis replacer#

Replace trailing dots (...) with an ellipsis (…) to make it consistent with the source string.

Zero-width space removal#

Zero width space is typically not desired in the translation. This fix will remove it unless it is present in the source string as well.

Control characters removal#

Removes any control characters from the translation.

Devanagari danda#

Replaces wrong full stop in Devanagari by Devanagari danda (।).

Unsafe HTML cleanup#

When turned on using a safe-html flag it sanitizes HTML markup.

也參考

不安全的 HTML

Trailing and leading whitespace fixer#

Makes leading and trailing whitespace consistent with the source string. The behavior can be fine-tuned using ignore-begin-space and ignore-end-space flags to skip processing parts of the string.

質量檢查#

Weblate 對字串進行了廣泛的質量檢查。以下部分將對它們進行更詳細的描述。還有針對特定語言的檢查。如果有錯誤報告，請將缺陷提交。

也參考

CHECK_LIST, 使用標誌自定義行為

翻譯檢查#

在每次翻譯更改時執行，幫助翻譯人員保持高質量的翻譯。

BBCode 標記#

概要:: 翻譯中的 BBCode 與來源不符
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.markup.BBCodeCheck
檢查標識符:: bbcode
忽略的標誌:: ignore-bbcode

BBCode 表示簡單的標記，例如以粗體或斜體突出顯示消息的重要部分。

此檢查確保在翻譯中也找到它們。

備註

當前檢測 BBCode 的方法非常簡單，因此此檢查可能會產生誤報。

連續重複單字#

在 4.1 版本新加入.

概要:: 文字在同一行中有兩個相同的單字：
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.duplicate.DuplicateCheck
檢查標識符:: duplicate
忽略的標誌:: ignore-duplicate

檢查翻譯中是否沒有連續重複的單詞。這通常表示翻譯錯誤。

提示

此檢查包括特定於語言的規則，以避免誤報。如果在您的情況下錯誤觸發，請告訴我們。請參閱在 Weblate 中匯報問題。

與詞彙表不同#

在 4.5 版本新加入.

概要:: 翻譯未遵循詞彙表定義的字詞。
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.glossary.GlossaryCheck
檢查標識符:: check_glossary
Flag to enable:: check-glossary
忽略的標誌:: ignore-check-glossary

此檢查必須使用“檢查詞彙表”標誌（參見:ref:“定制檢查”）。在啟用它之前請考慮以下操作：

它確實是精確的字串匹配，預計詞彙表將包含所有變體中的術語。
檢查每個字串針對詞彙表昂貴，它將減慢Weberate中的任何操作，涉及運行等待導入字串或翻譯。
It also utilizes untranslatable glossary terms in 未更動的翻譯.

也參考

詞彙表, 使用標誌自定義行為, 翻譯旗標

兩個空白#

概要:: 翻譯含有兩個空白
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.chars.DoubleSpaceCheck
檢查標識符:: double_space
忽略的標誌:: ignore-double-space

檢查翻譯中是否存在雙空格，以避免其他與空格相關的檢查出現誤報。

當在源中找到雙空格時，檢查為假，這意味著故意使用雙空格。

格式化字串#

檢查字串格式是否在源和翻譯之間複製。在翻譯中省略格式字串通常會導致嚴重的問題，因此字串中的格式通常應與源匹配。

Weblate 支持檢查幾種語言的格式字串。僅當適當地標記了字串時（例如，C 格式為 c-format），才會自動啟用該檢查。 Gettext 會自動添加它，但是對於其他文件格式，或者如果您的 PO 文件不是由 xgettext 生成的，您可能必須手動添加它。

可以按每單位（請參閱源字串另外的信息）或在組件配置中完成此操作。為每個組件定義它比較簡單，但是如果該字串未解釋為格式化字串，而碰巧使用了格式化字串語法，則可能導致誤報。

提示

如果 Weblate 中不提供特定格式的檢查，則可以使用通用佔位符。

除了檢查，這也將高亮格式化字串，方便將它們插入到已翻譯字串:

AngularJS 插值字串#

概要:: AngularJS 插值字串與來源不符
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.angularjs.AngularJSInterpolationCheck
檢查標識符:: angularjs_format
Flag to enable:: angularjs-format
忽略的標誌:: ignore-angularjs-format
Named format string example:: 您的餘額是{{ulity}} {{currency}}

也參考

格式化字串，`angularjs text插值<https://angular.io/guide/interpolation>`_

C 格式#

概要:: C 格式字串與來源不符
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.format.CFormatCheck
檢查標識符:: c_format
Flag to enable:: c-format
忽略的標誌:: ignore-c-format
Simple format string example:: 這裡有 %d 顆蘋果
Position format string example:: 您的餘額是％1 $ d％2 $ s

也參考

格式化字串,: `c格式字串<https://www.gnu.org/software/gettext/manual/html_node/c_002dformat.html>`_，`c printf格式<https://en.wikipedia.org/wiki/printf_format_string>`_

C# 格式#

概要:: C# 格式字串與來源不符
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.format.CSharpFormatCheck
檢查標識符:: c_sharp_format
Flag to enable:: c-sharp-format
忽略的標誌:: ignore-c-sharp-format
Position format string example:: 這裡有 {0} 顆蘋果

也參考

格式化字串, C# String Format

ECMAScript 模板字面值#

概要:: ECMAScript 模板字面值與來源不相符
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.format.ESTemplateLiteralsCheck
檢查標識符:: es_format
Flag to enable:: es-format
忽略的標誌:: ignore-es-format
Interpolation example:: 這裡有 ${number} 顆蘋果

也參考

格式化字串, Template literals

i18next 插補#

在 4.0 版本新加入.

概要:: i18next 插補與來源不符
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.format.I18NextInterpolationCheck
檢查標識符:: i18next_interpolation
Flag to enable:: i18next-interpolation
忽略的標誌:: ignore-i18next-interpolation
Interpolation example:: 這裡有 {{number}} 顆蘋果
Nesting example:: 這裡有 $t(number) 顆蘋果

也參考

格式化字串, i18next interpolation

ICU MessageFormat#

在 4.9 版本新加入.

概要:: ICU MessageFormat 字串有語法錯誤或是佔位符不相符。
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.icu.ICUMessageFormatCheck
檢查標識符:: icu_message_format
Flag to enable:: icu-message-format
忽略的標誌:: ignore-icu-message-format
Interpolation example:: 這裡有 {數量, 複數, 一 {一顆蘋果} 其他 {# 顆蘋果}}。

This check has support for both pure ICU MessageFormat messages as well as ICU with simple XML tags. You can configure the behavior of this check by using icu-flags:*, either by opting into XML support or by disabling certain sub-checks. For example, the following flag enables XML support while disabling validation of plural sub-messages:

icu-message-format, icu-flags:xml:-plural_selectors

`xml`	Enable support for simple XML tags. By default, XML tags are parsed loosely. Stray `<` characters are ignored if they are not reasonably part of a tag.
`strict-xml`	Enable support for strict XML tags. All `<` characters must be escaped if they are not part of a tag.
`-highlight`	Disable highlighting placeholders in the editor.
`-require_other`	Disable requiring sub-messages to have an `other` selector.
`-submessage_selectors`	Skip checking that sub-message selectors match the source.
`-types`	Skip checking that placeholder types match the source.
`-extra`	Skip checking that no placeholders are present that were not present in the source string.
`-missing`	Skip checking that no placeholders are missing that were present in the source string.

Additionally, when strict-xml is not enabled but xml is enabled, you can use the icu-tag-prefix:PREFIX flag to require that all XML tags start with a specific string. For example, the following flag will only allow XML tags to be matched if they start with <x::

icu-message-format, icu-flags:xml, icu-tag-prefix:"x:"

This would match <x:link>click here</x:link> but not <strong>this</strong>.

也參考

ICU MessageFormat 語法, 格式化字串, ICU: Formatting Messages, Format.JS: Message Syntax

Java 格式#

概要:: Java 格式字串與來源不符
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.format.JavaFormatCheck
檢查標識符:: java_printf_format
Flag to enable:: java-printf-format
忽略的標誌:: ignore-java-printf-format
Simple format string example:: 這裡有 %d 顆蘋果
Position format string example:: 您的餘額是％1 $ d％2 $ s

在 4.14 版本變更: This used to be toggled by java-format flag, it was changed for consistency with GNU gettext.

也參考

格式化字串，`java格式字串<https://docs.oracle.com/javase/7/docs/api/java/util/formatter.html>`_

Java MessageFormat#

概要:: Java MessageFormat 字串與來源不符
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.format.JavaMessageFormatCheck
檢查標識符:: java_format
Flag to enable unconditionally:: java-format
Flag to enable autodetection:: auto-java-messageformat enables check only if there is a format string in the source
忽略的標誌:: ignore-java-format
Position format string example:: 這裡有 {0} 顆蘋果

在 4.14 版本變更: This used to be toggled by java-messageformat flag, it was changed for consistency with GNU gettext.

This check validates that format string is valid for the Java MessageFormat class. Besides matching format strings in the curly braces, it also verifies single quotes as they have a special meaning. Whenever writing single quote, it should be written as ''. When not paired, it is treated as beginning of quoting and will not be shown when rendering the string.

也參考

格式化字串, Java MessageFormat

JavaScript 格式#

概要:: JavaScript 格式字串與來源不符
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.format.JavaScriptFormatCheck
檢查標識符:: javascript_format
Flag to enable:: javascript-format
忽略的標誌:: ignore-javascript-format
Simple format string example:: 這裡有 %d 顆蘋果

也參考

格式化字串, `JavaScript 格式字串<https://www.gnu.org/software/gettext/manual/html_node/javascript_002dformat.html>`_

Lua 格式#

概要:: Lua 格式字串與來源不符
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.format.LuaFormatCheck
檢查標識符:: lua_format
Flag to enable:: lua-format
忽略的標誌:: ignore-lua-format
Simple format string example:: 這裡有 %d 顆蘋果

也參考

格式化字串, `Lua 格式字串<https://www.gnu.org/software/gettext/manual/html_node/lua_002dformat.html#lua_002dformat>`_

Object Pascal 格式#

概要:: Object Pascal 格式字串與來源不符
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.format.ObjectPascalFormatCheck
檢查標識符:: object_pascal_format
Flag to enable:: object-pascal-format
忽略的標誌:: ignore-object-pascal-format
Simple format string example:: 這裡有 %d 顆蘋果

也參考

格式化字串, Object Pascal formatting strings, Free Pascal formatting strings Delphi formatting strings

百分比佔位符#

在 4.0 版本新加入.

概要:: 百分比佔位符與來源不符
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.format.PercentPlaceholdersCheck
檢查標識符:: percent_placeholders
Flag to enable:: percent-placeholders
忽略的標誌:: ignore-percent-placeholders
Simple format string example:: 這裡有 %number% 顆蘋果

也參考

格式化字串,

Perl 格式#

概要:: Perl 格式字串與來源不符
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.format.PerlFormatCheck
檢查標識符:: perl_format
Flag to enable:: perl-format
忽略的標誌:: ignore-perl-format
Simple format string example:: 這裡有 %d 顆蘋果
Position format string example:: 您的餘額是％1 $ d％2 $ s

也參考

格式化字串, Perl sprintf, `Perl 格式字串<https://www.gnu.org/software/gettext/ manual/html_node/perl_002dformat.html>`_

PHP 格式#

概要:: PHP 格式字串與來源不符
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.format.PHPFormatCheck
檢查標識符:: php_format
Flag to enable:: php-format
忽略的標誌:: ignore-php-format
Simple format string example:: 這裡有 %d 顆蘋果
Position format string example:: 您的餘額是％1 $ d％2 $ s

也參考

:ref:“檢查格式”，“PHP Sprintf文件<https://www.php.net/manual/en/function.sprintf.php>`_，`php格式字串<https：//www.gnu。組織/軟件/ GetText /手動/ html_node / php_002dformat.html>`_

Python 大括號格式#

概要:: Python 大括號格式字串與來源不符
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.format.PythonBraceFormatCheck
檢查標識符:: python_brace_format
Flag to enable:: python-brace-format
忽略的標誌:: ignore-python-brace-format
Simple format string:: 這裡有 {} 顆蘋果
Named format string example:: 您的餘額是{COALE} {COMPORY}

也參考

格式化字串, Python brace 格式, `Python 格式字串<https://www.gnu.org/software/gettext/manual/html_node/python_002dformat.html >`_

Python 格式#

概要:: Python 格式字串與來源不符
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.format.PythonFormatCheck
檢查標識符:: python_format
Flag to enable:: python-format
忽略的標誌:: ignore-python-format
Simple format string:: 這裡有 %d 顆蘋果
Named format string example:: Your balance is %(amount)d %(currency)s

也參考

格式化字串, Python string formatting, `Python 格式字串<https://www.gnu.org/software/gettext/manual/html_node /python_002dformat.html>`_

Qt 格式#

概要:: Qt 格式字串與來源不符
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.qt.QtFormatCheck
檢查標識符:: qt_format
Flag to enable:: qt-format
忽略的標誌:: ignore-qt-format
Position format string example:: 這裡有 %1 顆蘋果

也參考

格式化字串, Qt QString::arg()

Qt 複數格式#

概要:: Qt 複數格式字串與來源不符
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.qt.QtPluralCheck
檢查標識符:: qt_plural_format
Flag to enable:: qt-plural-format
忽略的標誌:: ignore-qt-plural-format
Plural format string example:: ``There are %Ln apple(s)``（譯註：無中文使用情境，因為蘋果我們不用加 s）

也參考

格式化字串，`qt i18n指南<https://doc.qt.io/qt-5/i18n-source-translation.html#andling-purals>`_

Ruby 格式#

概要:: Ruby 格式字串與來源不符
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.ruby.RubyFormatCheck
檢查標識符:: ruby_format
Flag to enable:: ruby-format
忽略的標誌:: ignore-ruby-format
Simple format string example:: 這裡有 %d 顆蘋果
Position format string example:: 您的餘額是％1 $ f％2 $ s
Named format string example:: ``您的餘額是％+。2 <COMPELL> S``的2 <金額>
Named template string:: 您的餘額是％{ulity}％{currency}

也參考

格式化字串, Ruby Kernel#sprintf

Scheme 格式#

概要:: Scheme 格式字串與來源不符
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.format.SchemeFormatCheck
檢查標識符:: scheme_format
Flag to enable:: scheme-format
忽略的標誌:: ignore-scheme-format
Simple format string example:: 這裡有 ~d 顆蘋果

也參考

:ref:“檢查格式”，“SRFI 28 <https://srfi.schemers.org/srfi-28/srfi-28.html>`_，`chicken scheme格式<https：//wiki.call-cc.org / eggref / 5 /格式>`_，`軸套方案格式化輸出<https://www.gnu.org/software/guile/manual/html_node/formatted-output.html>`_

Vue I18n 格式#

概要:: Vue I18n 格式與來源不符
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.format.VueFormattingCheck
檢查標識符:: vue_format
Flag to enable:: vue-format
忽略的標誌:: ignore-vue-format
Named formatting:: 這裡有 {count} 顆蘋果
Rails i18n formatting:: 這裡有 %{count} 顆蘋果
Linked locale messages:: @:message.dio @:message.the_world!

也參考

格式化字串，』查看i18n格式<https://kazupon.github.io/vue-i18n/guide/formatting.html>`_，查看i18n鏈接本地消息<https：// kazupon。github .io / vue-i18n / guide / messages.html＃linked-locale-messages>`_

已經翻譯過#

概要:: 字串之前已經有翻譯過
範圍:: all strings
檢查類:: weblate.checks.consistency.TranslatedCheck
檢查標識符:: translated
忽略的標誌:: ignore-translated

表示已經翻譯了一個字串。當翻譯在VCS中或否則丟失時，可能會發生這種情況。

不一致#

概要:: 此專案中的這個字串有一種以上的翻譯，或是在某些組件未翻譯。
範圍:: all strings
檢查類:: weblate.checks.consistency.ConsistencyCheck
檢查標識符:: inconsistent
忽略的標誌:: ignore-inconsistent

Weberate檢查項目中所有翻譯中相同字串的翻譯，以幫助您保持一致的翻譯。

檢查失敗了項目中的一個字串的不同轉換。這也可能導致顯示檢查中的不一致。您可以在以下網站上找到此字串的其他翻譯：Guilabel：“其他出現”選項卡。

This check applies to all components in a project that have 允許翻譯再用 turned on.

提示

For performance reasons, the check might not find all inconsistencies, it limits number of matches.

備註

This check also fires in case the string is translated in one component and not in another. It can be used as a quick way to manually handle strings which are untranslated in some components just by clicking on the Use this translation button displayed on each line in the Other occurrences tab.

您可以使用自動翻譯附加元件來自動翻譯從另一個組件中已翻譯字串到新添加而未翻譯的字串。

也參考

跨組件保持翻譯一致

使用 Kashida letter#

在 3.5 版本新加入.

概要:: 不應該使用裝飾性的卡希達對齊字母
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.chars.KashidaCheck
檢查標識符:: kashida
忽略的標誌:: ignore-kashida

裝飾kashida字母不應該在翻譯中使用。這些也稱為TatWeel。

也參考

Kashida on Wikipedia

Markdown 連結#

在 3.5 版本新加入.

概要:: Markdown 連結與來源不符
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.markup.MarkdownLinkCheck
檢查標識符:: md-link
Flag to enable:: md-text
忽略的標誌:: ignore-md-link

Markdown鏈接不匹配源。

也參考

Markdown links

Markdown 參照#

在 3.5 版本新加入.

概要:: Markdown 連結參照與來源不符
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.markup.MarkdownRefLinkCheck
檢查標識符:: md-reflink
Flag to enable:: md-text
忽略的標誌:: ignore-md-reflink

Markdown鏈接引用不匹配源。

也參考

Markdown links

Markdown 語法#

在 3.5 版本新加入.

概要:: Markdown 語法與來源不符
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.markup.MarkdownSyntaxCheck
檢查標識符:: md-syntax
Flag to enable:: md-text
忽略的標誌:: ignore-md-syntax

Markdown 語法與來源不符

也參考

Markdown span elements

翻譯最大長度#

概要:: 翻譯不該超過指定長度
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.chars.MaxLengthCheck
檢查標識符:: max-length
Flag to enable:: max-length
忽略的標誌:: ignore-max-length

檢查翻譯的長度是否可匹配可用的空間。這只檢查翻譯字符的長度。

與其他檢查不同，標誌應該被設置為“鍵：價值”（價值）對，如“Max-Length：100`”。

提示

此檢查查看字符數，使用比例字體呈現文本時可能不是最佳度量。：Ref：“Check-Max-size`檢查確實檢查了文本的實際渲染。

“替換：```````標誌可能也很有用，在檢查字串之前展開PLATEABLE。

When xml-text flag is also used, the length calculation ignores XML tags.

翻譯的最大長度#

概要:: 翻譯的呈現文字不該超過指定長度
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.render.MaxSizeCheck
檢查標識符:: max-size
Flag to enable:: max-size
忽略的標誌:: ignore-max-size

在 3.7 版本新加入.

翻譯渲染文本不應超過給定的大小。它呈現出線包裝的文本，並檢查它是否適合給定邊界。

此檢查需要一個或兩個參數 - 最大寬度和最大行數。如果未提供行數，則考慮一行文本。

您還可以通過``font- *``指令配置已使用的字體（請參閱:ref:``custom-check`），例如隨圖的翻譯標誌說，使用ubuntu字體大小22呈現的文本應該適合兩行和500像素：

max-size:500:2, font-family:ubuntu, font-size:22

提示

您可能希望設置“字體 - *”`指令:ref:“組件”（Component）以具有為組件中的所有字串配置的相同字體。您可以每字串覆蓋每個字串的值，以防每個字串自定義它。

“替換：```````標誌可能也很有用，在檢查字串之前展開PLATEABLE。

When xml-text flag is also used, the length calculation ignores XML tags.

也參考

管理字型, 使用標誌自定義行為, 翻譯最大長度

Mismatched \n#

概要:: 譯文中的換行數 \n 和源文不符
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.chars.EscapedNewlineCountingCheck
檢查標識符:: escaped_newline
忽略的標誌:: ignore-escaped-newline

Usually escaped newlines are important for formatting program output. Check fails if the number of \n literals in translation does not match the source.

冒號不相符#

概要:: 翻譯沒有和來源一致以冒號結尾
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.chars.EndColonCheck
檢查標識符:: end_colon
忽略的標誌:: ignore-end-colon

檢查冒號在源和翻譯之間複製冒號。還檢查了冒號的存在，以便他們不屬於哪種語言（中文或日語）。

也參考

Colon on Wikipedia

刪節號不相符#

概要:: 翻譯沒有和來源一致以刪節號結尾
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.chars.EndEllipsisCheck
檢查標識符:: end_ellipsis
忽略的標誌:: ignore-end-ellipsis

檢查尾部橢圓在源和轉換之間複製尾部橢圓。這只檢查真正的省略號（...）不適用於三個小點（...）。

省略號通常比打印中的三個點更好，並且文本到語音更好地聽起來更好。

也參考

Ellipsis on Wikipedia

驚嘆號不相符#

概要:: 翻譯沒有和來源一致以驚嘆號結尾
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.chars.EndExclamationCheck
檢查標識符:: end_exclamation
忽略的標誌:: ignore-end-exclamation

檢查源和翻譯之間複製的感嘆號。還檢查了感嘆號的存在，他們不屬於哪種語言（中國，日語，韓國，亞美尼亞，林欄，緬甸或NKO）。

也參考

Wikipedia的感嘆號<https://en.wikipedia.org/wiki/exclamation_mark>`_

句號不相符#

概要:: 翻譯沒有和來源一致以句號結尾
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.chars.EndStopCheck
檢查標識符:: end_stop
忽略的標誌:: ignore-end-stop

檢查在源和翻譯之間複製完整停止。檢查全部停止的存在，以便他們不屬於哪種語言（中文，日語，Devanagari或Urdu）。

也參考

wikipedia

問號不相符#

概要:: 翻譯沒有和來源一致以問號結尾
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.chars.EndQuestionCheck
檢查標識符:: end_question
忽略的標誌:: ignore-end-question

檢查源和翻譯之間複製的問號。還檢查了問號的存在，以便他們不屬於哪些語言（亞美尼亞，阿拉伯語，中國，韓國，日語，埃塞俄比亞，vai或coptic）。

也參考

`wikipedia上的問號<https://en.wikipedia.org/wiki/question_mark>`_

分號不相符#

概要:: 翻譯沒有和來源一致以分號結尾
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.chars.EndSemicolonCheck
檢查標識符:: end_semicolon
忽略的標誌:: ignore-end-semicolon

Checks that semicolons at the end of sentences are replicated between both source and translation.

也參考

Semicolon on Wikipedia

斷列符不相配#

概要:: 譯文中的換行數和源文不符
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.chars.NewLineCountCheck
檢查標識符:: newline-count
忽略的標誌:: ignore-newline-count

Usually newlines are important for formatting program output. Check fails if the number of new lines in translation does not match the source.

缺少複數形#

概要:: 有些複數形未翻譯
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.consistency.PluralsCheck
檢查標識符:: plurals
忽略的標誌:: ignore-plurals

檢查已翻譯所有復數形式的源字串。可以在字串定義中找到每個複數表單的具體細節。

在某些情況下，未能填寫複數表格將導致多種形式使用時顯示任何內容。

佔位符#

在 3.9 版本新加入.

概要:: 翻譯缺少一些佔位符
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.placeholders.PlaceholderCheck
檢查標識符:: placeholders
Flag to enable:: placeholders
忽略的標誌:: ignore-placeholders

在 4.3 版本變更: You can use regular expression as placeholder.

在 4.13 版本變更: With the case-insensitive flag, the placeholders are not case-sensitive.

翻譯缺少一些佔位符。這些是從翻譯文件中提取的，或者使用````````手動定義，更多可以用冒號分開，可以引用帶空間的字串：

placeholders:$URL$:$TARGET$:"some long text"

如果您對占位符有一些語法，則可以使用正則表達式：

placeholders:r"%[^% ]%"

You can also have case insensitive placeholders:

placeholders:$URL$:$TARGET$,case-insensitive

也參考

使用標誌自定義行為

標點符號間距#

在 3.9 版本新加入.

概要:: 兩個標點符號前沒有不斷行空格
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.chars.PunctuationSpacingCheck
檢查標識符:: punctuation_spacing
忽略的標誌:: ignore-punctuation-spacing

檢查雙標點符號（驚嘆號，問號，分號和冒號）之前存在不可破壞的空間。此規則僅以少數選定的語言使用法語或BRETON，其中PARD標註符號前的空間是印刷規則。

也參考

`wikipedia的法語和英語間距<https://en.wikipedia.org/wiki/history_of_sentence_spacing#french_and_english_spacing>`_

正則表達式#

在 3.9 版本新加入.

概要:: 翻譯不符正則表達式
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.placeholders.RegexCheck
檢查標識符:: regex
Flag to enable:: regex
忽略的標誌:: ignore-regex

翻譯與正則表達式不匹配。表達式要么從翻譯文件中提取，也可以使用`````````）來定義：

regex:^foo|bar$

相同複數形#

概要:: 有些複數形沒有以相同方式翻譯
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.consistency.SamePluralsCheck
檢查標識符:: same-plurals
忽略的標誌:: ignore-same-plurals

如果在翻譯中復制了一些複數，請檢查失敗。在大多數語言中他們必須不同。

開頭換列#

概要:: 翻譯沒有和來源一致以換列符開頭
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.chars.BeginNewlineCheck
檢查標識符:: begin_newline
忽略的標誌:: ignore-begin-newline

紐丁通常出現在源字串中，有效原因，遺漏或添加可以導致翻譯文本使用時的格式化問題。

也參考

換列結尾

開頭空格#

概要:: 翻譯沒有和來源一致以相同數目的空格開頭
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.chars.BeginSpaceCheck
檢查標識符:: begin_space
忽略的標誌:: ignore-begin-space

字串開頭的空間通常用於界面中的縮進，因此重要地保持。

換列結尾#

概要:: 翻譯沒有和來源一致以換列結尾
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.chars.EndNewlineCheck
檢查標識符:: end_newline
忽略的標誌:: ignore-end-newline

紐丁通常出現在源字串中，有效原因，遺漏或添加可以導致翻譯文本使用時的格式化問題。

也參考

開頭換列

空格結尾#

概要:: 翻譯沒有和來源一致以相同數目的空格結尾
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.chars.EndSpaceCheck
檢查標識符:: end_space
忽略的標誌:: ignore-end-space

檢查尾隨空格是否在源和轉換之間複製。

尾隨空間通常用於空閒鄰居元素，因此刪除它可能會破壞佈局。

未更動的翻譯#

概要:: 翻譯與來源文字相同
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.same.SameCheck
檢查標識符:: same
忽略的標誌:: ignore-same

如果源和相應的轉換字串相同，則會發生到至少一個形式中。忽略所有語言中常見的一些字串，並剝離各種標記。這減少了誤報的數量。

此檢查可以幫助查找錯誤誤解的字串。

此檢查的預設行為是從檢查中從內置黑名單中排除單詞。這些是經常未被翻譯的單詞。這對於避免短串上的誤報是有用的，該虛假陽性僅由單個單詞組成，該單詞具有多種語言中的相同。通過添加“嚴格的”“標記至字串或組件，可以禁用此黑名單。

在 4.17 版本變更: With check-glossary flag (see 與詞彙表不同), the untranslatable glossary terms are excluded from the checking.

也參考

與詞彙表不同, 組件配置, 使用標誌自定義行為

不安全的 HTML#

在 3.9 版本新加入.

概要:: 翻譯使用了不安全的 HTML 標示
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.markup.SafeHTMLCheck
檢查標識符:: safe-html
Flag to enable:: safe-html
忽略的標誌:: ignore-safe-html

翻譯使用不安全的HTML標記。必須使用“安全 - HTML”標誌（參見:ref:“定制檢查”）啟用此檢查。還有伴隨的AutoFixer，可以自動消毒標記。

提示

When md-text flag is also used, the Markdown style links are also allowed.

也參考

The HTML check is performed by the Ammonia library.

網址#

在 3.5 版本新加入.

概要:: 此譯文未包含網址
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.markup.URLCheck
檢查標識符:: url
Flag to enable:: url
忽略的標誌:: ignore-url

翻譯不包含URL。僅在單位標記為包含URL時才會觸發這一點。在這種情況下，翻譯必須是有效的URL。

XML 標記#

概要:: 翻譯中的 XML 標籤與來源不符
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.markup.XMLTagsCheck
檢查標識符:: xml-tags
忽略的標誌:: ignore-xml-tags

這通常意味著產生的輸出看起來不同。在大多數情況下，這不是改變翻譯的所需結果，但偶爾就是。

檢查源和翻譯之間是否複製XML標記。

The check is automatically enabled for XML like strings. You might need to add xml-text flag in some cases to force turning it on.

備註

This check is disabled by the safe-html flag as the HTML cleanup done by it can produce HTML markup which is not valid XML.

XML 語法#

概要:: 翻譯標記為無效 XML
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.markup.XMLValidityCheck
檢查標識符:: xml-invalid
忽略的標誌:: ignore-xml-invalid

XML標記無效。

The check is automatically enabled for XML like strings. You might need to add xml-text flag in some cases to force turning it on.

備註

This check is disabled by the safe-html flag as the HTML cleanup done by it can produce HTML markup which is not valid XML.

零寬度空格#

概要:: 翻譯中包含有額外的零寬度的空白字元
範圍:: 已翻譯好的字串
檢查類:: weblate.checks.chars.ZeroWidthSpaceCheck
檢查標識符:: zero-width-space
忽略的標誌:: ignore-zero-width-space

零寬度空間（<u + 200b>）字符用於打破單詞中的消息（Word包裝）。

由於它們通常被錯誤插入，因此在翻譯中存在後觸發此檢查。使用此字符時，某些程序可能會出現問題。

也參考

wikipedia

Source checks#

源檢查可以幫助開發人員提高源字串的質量。

刪節號#

概要:: 該字串使用三個點（…）而非刪節號（…）
範圍:: 來源字串
檢查類:: weblate.checks.source.EllipsisCheck
檢查標識符:: ellipsis
忽略的標誌:: ignore-ellipsis

當字串使用三個點時，這會失敗（...）時，它應該使用省略號字符（````）。

在大多數情況下，使用Unicode字符更好的方法，看起來更好，並且文本到語音可能會更好地聽起來更好。

也參考

Ellipsis on Wikipedia

ICU MessageFormat 語法#

在 4.9 版本新加入.

概要:: ICU MessageFormat 字串有語法錯誤。
範圍:: 來源字串
檢查類:: weblate.checks.icu.ICUSourceCheck
檢查標識符:: icu_message_format_syntax
Flag to enable:: icu-message-format
忽略的標誌:: ignore-icu-message-format

也參考

ICU MessageFormat

長期未翻譯#

在 4.1 版本新加入.

概要:: 字串很久都沒有翻譯
範圍:: 來源字串
檢查類:: weblate.checks.source.LongUntranslatedCheck
檢查標識符:: long_untranslated
忽略的標誌:: ignore-long-untranslated

When the string has not been translated for a long time, it can indicate a problem in a source string making it hard to translate.

多項未通過查核#

概要:: 多個語言的翻譯有未通過查核的項目
範圍:: 來源字串
檢查類:: weblate.checks.source.MultipleFailingCheck
檢查標識符:: multiple_failures
忽略的標誌:: ignore-multiple-failures

此字串的許多翻譯都沒有質量檢查。這通常是可以進行某些東西來改進源字串的指示。

此檢查失敗通常可以在句子末尾的缺失完整停止丟失或類似的次要問題傾向於在翻譯中解決，而在源字串中將其更好。

多個未命名變數#

在 4.1 版本新加入.

概要:: 字串中有多個未命名變數，翻譯者將難以重新排序
範圍:: 來源字串
檢查類:: weblate.checks.format.MultipleUnnamedFormatsCheck
檢查標識符:: unnamed_format
忽略的標誌:: ignore-unnamed-format

字串中有多個未命名的變量，使翻譯是不可能重新排序的轉換器。

考慮使用命名變量，而不是允許翻譯器重新排序。

未複數化#

概要:: 該字串為複數，但沒有使用複數形
範圍:: 來源字串
檢查類:: weblate.checks.source.OptionalPluralCheck—
檢查標識符:: optional_plural
忽略的標誌:: ignore-optional-plural

該字串用作複數，但不使用複數形式。如果您的翻譯系統支持此情況，您應該使用它的複數感知變體。

例如，在Python中用GetText可能是：

from gettext import ngettext

print(ngettext("Selected %d file", "Selected %d files", files) % files)

搜索#

在 3.9 版本新加入.

使用布爾操作，括號或字段特定查找的高級查詢可用於查找所需的字串。

When no field is defined, the lookup happens on source, target, and context strings.

Simple search#

鍵入搜索框中的任何短語都分成單詞。顯示包含任何一個的字串。要查找一個確切的短語，將“SearchPhrase”放入引號（單個（』）和雙（“）引號將工作）：”這是一個引用的字串“``或’另一個引用的字串』``。

Fields#

source:TEXT: Source string case-insensitive search.
target:TEXT: Target string case-insensitive search.
context:TEXT: Context string case-insensitive search.
key:TEXT: Key string case-insensitive search.
note:TEXT: Source string description case-insensitive search.
location:TEXT: Location string case-insensitive search.
priority:NUMBER: String priority.
id:NUMBER: String unique identifier.
position:NUMBER: String position in the translation file.
added:DATETIME: 將字串添加到Webleate時的時間戳。
state:TEXT: Search for string states (approved, translated, needs-editing, empty, read-only), supports Field operators.
pending:BOOLEAN: 掛在彎曲以沖洗到VCS。
has:TEXT: Search for string having attributes - plural, context, suggestion, comment, check, dismissed-check, translation, variant, screenshot, flags, explanation, glossary, note, label.
is:TEXT: 搜尋擱置中的翻譯 (pending)。也可搜尋其他狀態的翻譯字串 (approved, translated, untranslated, needs-editing, read-only)。
language:TEXT: String target language.
component:TEXT: Component slug or name case-insensitive search, see 組件標識串 and 組件名稱.
project:TEXT: Project slug, see URL slug.
changed_by:TEXT: 作者使用給定使用者名更改字串。
changed:DATETIME: 字串內容在日期內更改，支持:ref:“搜索操作員”。
change_time:DATETIME: 字串已在日期更改，支持:ref:“搜索操作員”，與“已更改”（更改）提供此包含不會更改內容的事件，並且您可以使用“Change_Action”“”應用“使用”自定義操作過濾“。
change_action:TEXT: 在更改動作上的過濾器，與``change_time``一起有用。接受更改操作的英語名稱，引用以及帶有連字符替換的空格或小寫和空格。請參閱:ref:“搜索 - 更改”以獲取示例。
check:TEXT: String has failing check, see 檢查和修復 for check identifiers.
dismissed_check:TEXT: String has dismissed check, see 檢查和修復 for check identifiers.
comment:TEXT: Search in user comments.
resolved_comment:TEXT: Search in resolved comments.
comment_author:TEXT: Filter by comment author.
suggestion:TEXT: Search in suggestions.
suggestion_author:TEXT: Filter by suggestion author.
explanation:TEXT: Search in explanations.
label:TEXT: Search in labels.
screenshot:TEXT: Search in screenshots.

Boolean operators#

您可以合併使用以下方式來搜尋 AND, OR, NOT 或是在搜尋字串中混合使用。例如： state:translated AND (source:hello OR source:bar)

Field operators#

您可以為日期或數字搜索指定運算符，範圍或部分查找：

state:>=translated: 國家是“翻譯”或更好的（“批准”（“批准”）。
changed:2019: Changed in year 2019.
changed:[2019-03-01 to 2019-04-01]: 在兩個給定的日期之間發生了變化。
position:[10 to 100]: Strings with position between 10 and 100 (inclusive).

Exact operators#

您可以使用``=``運算符在不同的字串字段上進行完全匹配查詢。例如，搜索完全匹配的源字串匹配“您好世界”，使用：“來源：=”Hello World“。用於搜索單詞表達式，您可以跳過引號。例如，搜索匹配``hello``的所有源字串：``source：= hello。

Searching for changes#

在 4.4 版本新加入.

搜索歷史事件可以使用“Change_Action”和“Change_Time`”操作員完成。

例如，可以將標記為2018年編輯的字串輸入為“Change_time：2018和Change_Action：標記為編輯”“”或“Change_Time：2018和Change_Action：”標記為編輯“```。

正規表示法#

任何已接受的內文，您也可以指定使用正規表示法如 r"regexp" 。

例如，要搜索包含 2 和 5 之間的任何數字的所有來源字串，請使用 source:r"[2-5]" 。

Predefined queries#

您可以在搜索頁面上選擇預定義查詢，這允許您快速訪問最常見的搜索：

Ordering the results#

根據您的需要，有許多選擇字串：

翻譯工作流#

使用Weberate是一個流程，使您的使用者更接近您，通過讓您更接近您的翻譯。由您決定您想要使用的功能數量。

以下不是配置 Weblate 的方法的完整列表。您可以將其他工作流基於此處列出的最常見的示例。

翻譯訪問#

:ref:`access control <access-control>`並沒有作為一個整體在工作流程中被詳細討論，因它的大多數選項都可以應用於任何工作流。請參考有關如何管理對翻譯的訪問的相關文件。

在以下各章中，任何使用者 都是指有權訪問翻譯的使用者。如果項目是公共項目，則可以是任何經過身份驗證的使用者，也可以是具有項目 Translate 權限的使用者。

翻譯狀態#

每個翻譯的字串可以處於以下狀態之一：

未翻譯

翻譯是空的，取決於文件格式，翻譯是否可能存儲在文件中。

需要編輯

翻譯需要編輯，這通常是來源字串更改、模糊匹配或譯員操作的結果。翻譯存儲在文件中，具體取決於文件格式，它可能被標誌為需要編輯（例如，當它在 Gettext 文件中獲得一個 fuzzy 標記）。

等候檢閱

翻譯已完成，但未進行審核。它作為有效翻譯存儲在文件中。

已核可

翻譯已在審核中得到批准。翻譯者不能再更改它，只能由審閱者更改。譯者只能向其中添加建議。

This state is only available when reviews are enabled.

建議

建議僅存儲在 Weblate 中，而不存儲在翻譯文件中。

The states are represented in the translation files when possible.

提示

In case file format you use does not support storing states, you might want to use 將未變動的翻譯標記為「需要編輯」 add-on to flag unchanged strings as needing editing.

也參考

翻譯類型功能, 翻譯工作流

直接翻譯#

這是小型團隊最常用的設置，任何人都可以直接翻譯。這也是 Weblate 中的預設設置。

任何使用者 都可以編輯翻譯。
當翻譯者不確定更改時，建議是建議更改的可選方法。

Setting	Value	備註
啟用檢閱	關閉	Configured at project level.
啟用建議	開啟	使用者可以在不確定時提出建議，這很有用。
建議投票	關閉
自動接受建議	0
翻譯組	使用者	或使用 per-project access control 的翻譯權限。
審核者組	N/A	不曾用過。

同行評審#

使用此工作流程，任何人都可以添加建議，並且需要其他成員的同意才能被接受為翻譯。

任何使用者 都可以添加建議。
任何使用者 都可以對建議投票。
當給定預定數量的投票時，建議就變成翻譯。

Setting	Value	備註
啟用檢閱	關閉	Configured at project level.
啟用建議	開啟
建議投票	關閉
自動接受建議	1	您可以設置更高的值，以要求更多的同行評審。
翻譯組	使用者	或使用 per-project access control 的翻譯權限。
審核者組	N/A	未使用，所有翻譯員都審閱。

專門的審核者#

使用專門的審核者，您有兩組使用者，一組可以提交翻譯，而另一組可以審核它們以確保翻譯一致且質量良好。

任何使用者 都可以編輯未批准的翻譯。
審核者 能核可或不核可翻譯字串。
審核者 可以編輯所有翻譯（包括批准的翻譯）。
建議還可以用於建議更改已批准的字串。

Setting	Value	備註
啟用檢閱	開啟	Configured at project level.
啟用建議	關閉	使用者可以在不確定時提出建議，這很有用。
建議投票	關閉
自動接受建議	0
翻譯組	使用者	或使用 per-project access control 的翻譯權限。
審核者組	審核員	或使用 per-project access control 的權限進行審查。

打開審核#

可以在項目設置的 Workflow 子頁面中的項目配置中打開審核（位於 Manage → Settings 菜單中）：

源字串的質量網關#

在許多情況下，原始源語言字串來自開發人員，因為它們編寫代碼並提供初始字串。然而，開發人員通常不是源語言中的母語者，並且不提供所需的源字串質量。中間轉換可以幫助您解決此問題 - 開發人員和翻譯人員和使用者之間的字串存在額外的質量網關。

通過設置:ref:“組件中間”，此文件將用作字串的源，但它將被編輯為源語言以波動它。一旦字串在源語言中準備就緒，它也可以用於翻譯成轉換為其他語言。

也參考

中間語言檔案, 單語的基底語言檔, 雙語和單語格式

源字串複查#

通過允許啟用來源檢閱，複查過程可以應用到源字串上。一旦允許，使用者可以匯報源字串種的情況。實際過程依賴於使用雙語言還是單語言格式。

對於單語言格式，源字串複查的行為與專門的審核者相似——一旦源字串匯報了情況，就會被標記為 Needs editing。

雙語言格式不允許直接編輯源字串（他們典型地是從原始碼中直接提取的）。在這種情況下， Source needs review 標籤會貼到翻譯者回到的字串上。可以復查這樣的字串，並在源中編輯或刪除標籤。

也參考

雙語和單語格式, 專門的審核者, 字串標籤, 評註

常見問題#

配置#

如何創建自動化工作流？#

Weblate 可以為您半自動處理所有翻譯工作。如果授予它對倉儲的推送訪問權限，則翻譯可以在沒有交互的情況下進行，除非發生某些合併衝突。

新建您的 Git 倉儲，來告知 Weblate 何時有任何更改，請參閱通知掛勾以獲取有關如何執行此操作的信息。
在 Weblate 中的組件配置配置中設置推送 URL，這使 Weblate 可以將更改推送到倉儲。
在 Weblate 中打開 compoent`上的 :ref:`component-push_on_commit，這將使 Weblate 在 Weblate 發生更改時將更改推送到倉儲。

也參考

持續本地化, 避免發生合併衝突

如何通過 SSH 訪問倉儲？#

設置 SSH 密鑰的信息請參閱訪問存儲庫。

如何修復翻譯中的合併衝突？#

在翻譯文件在 Weblate 和上游倉儲同時更改時，合併衝突不時發生。通常可以通過在對翻譯文件進行更改前（例如在運行 msgmerge 前）合併倉儲來避免發生這個情況。只要告訴 Weblate 執行掛起所有的翻譯（可以在 Manage 菜單中的 Repository maintenance 中去做），並合併倉儲即可（如果自動推送沒有打開的話）。

If you’ve already encountered a merge conflict, the easiest way to solve all conflicts locally on your machine, is to add Weblate as a remote repository, merge it into upstream and fix any conflicts. Once you push changes back, Weblate will be able to use the merged version without any other special actions.

備註

取決於您的設置，訪問 Weblate 代碼庫可能需要身份驗證。使用 Weblate 中內建的 :ref:`git-exporter`時，您使用使用者名和 API 密鑰進行身份驗證。

# Commit all pending changes in Weblate, you can do this in the UI as well:
wlc commit
# Lock the translation in Weblate, again this can be done in the UI as well:
wlc lock
# Add Weblate as remote:
git remote add weblate https://hosted.weblate.org/git/project/component/
# You might need to include credentials in some cases:
git remote add weblate https://username:APIKEY@hosted.weblate.org/git/project/component/

# Update weblate remote:
git remote update weblate

# Merge Weblate changes:
git merge weblate/main

# Resolve conflicts:
edit …
git add …
…
git commit

# Rebase changes (if Weblate is configured to do rebases)
git rebase origin/main

# Push changes to upstream repository, Weblate will fetch merge from there:
git push

# Open Weblate for translation:
wlc unlock

如果在 Weblate 中使用多個分支，那麼可以對所有的分支做相同的事：

# Add and update Weblate remotes
git remote add weblate-one https://hosted.weblate.org/git/project/one/
git remote add weblate-second https://hosted.weblate.org/git/project/second/
git remote update weblate-one weblate-second

# Merge QA_4_7 branch:
git checkout QA_4_7
git merge weblate-one/QA_4_7
... # Resolve conflicts
git commit

# Merge main branch:
git checkout main
git merge weblates-second/main
... # Resolve conflicts
git commit

# Push changes to the upstream repository, Weblate will fetch the merge from there:
git push

在 gettext PO 文件的情況下，有一種方式以半自動方式來合併衝突：

取回並保存 Weblate Git 倉儲的本地克隆。還要得到上游 Git 倉儲的第二個新的本地克隆（也就是需要上游 Git 倉儲的兩份複件：完整的複件和工作複件）：

# Add remote:
git remote add weblate /path/to/weblate/snapshot/

# Update Weblate remote:
git remote update weblate

# Merge Weblate changes:
git merge weblate/main

# Resolve conflicts in the PO files:
for PO in `find . -name '*.po'` ; do
    msgcat --use-first /path/to/weblate/snapshot/$PO\
               /path/to/upstream/snapshot/$PO -o $PO.merge
    msgmerge --previous --lang=${PO%.po} $PO.merge domain.pot -o $PO
    rm $PO.merge
    git add $PO
done
git commit

# Push changes to the upstream repository, Weblate will fetch merge from there:
git push

也參考

如何導出 Weblate 使用的 Git 倉儲？, 持續本地化, 避免發生合併衝突, Weblate 客戶端

如何立刻翻譯幾個分支？#

Weblate 支持在一個項目配置內推送翻譯更改。對於每個將其打開的組件配置（預設行為），所作的更改自動傳遞給其它組件。即使分支本身已經非常多樣化了，也能以這種方式保持同步，並且不能在他們之間簡單地合併翻譯更改。

一旦從 Weblate 合併了更改，就會不得不合併這些分支（依賴於您的開發工作流程），而丟棄差異：

git merge -s ours origin/maintenance

也參考

跨組件保持翻譯一致

如何翻譯多平台項目？#

Weblate 支持大範圍的文件格式（請參見支持的文件格式），而最容易的方式時對每個平台使用本地格式。

一旦在一個項目中將所有平台的翻譯文件作為組件添加（請參見:ref:adding-projects），就可以立刻使用翻譯傳播特性（預設打開，並且可以在:ref:component 中關閉），來翻譯所有平台的字串了。

也參考

跨組件保持翻譯一致

如何導出 Weblate 使用的 Git 倉儲？#

倉儲沒有什麼特殊的，它存在於 DATA_DIR 目錄下面，並被命名為 vcs/<project>/<component>/。如果有 SSH 範文這台機器，那麼可以直接使用倉儲。

對於匿名訪問，您會想要運行 Git 服務器，並讓它為外部世界提供倉儲服務。

此外，可以在 Weblate 內替代使用 Git 導出器而使其自動化。

將更改推送回上游的選項是什麼？#

這嚴重依賴於您的設置，Weblate 在這個領域是非常靈活的。這裡是使用 Weblate 的一些工作流程的例子：

Weblate 自動推送並合併更改（請參見如何創建自動化工作流？）。
您需要手動告訴 Weblate 去推送（推送需要訪問上游倉儲）。
一些人將 Weblate git 倉儲的更改手動合併到上游倉儲中。
一些人重寫由 Weblate 生成的歷史（例如通過刪除合併提交），合併更改，並告訴 Weblate 重置上游倉儲中的內容。

當然您可以按您的意願自由混用所有這些方法。

如何限制 Weblate 只訪問翻譯，而不向它揭露原始碼？#

可以使用 git submodule 將翻譯從原始碼中分離出來，而仍將它們至於版本控制之下。

以您的文藝文件創建倉儲。

將其作為子模塊添加到您的代碼中：

git submodule add git@example.com:project-translations.git path/to/translations

將 Weblate 連接到這個倉儲上，它不再需要訪問包含您原始碼的倉儲。
可以從 Weblate 更新帶有翻譯的主倉儲，通過：
```
git submodule update --remote path/to/translations
```

更多細節請諮詢 git submodule 文件。

如何檢查 Weblate 是否被正確地設置？#

Weblate 包括一組配置檢查，可以在管理面板中看到，只需按照管理面板中的 Performance report 連接，或直接打開 /manage/performance/ URL 即可。

也參考

監測 Weblate, 觀察 Celery 狀態

為什麼所有提價由 Weblate <noreply@weblate.org> 執行？#

This is the default committer name, configured by DEFAULT_COMMITER_EMAIL and DEFAULT_COMMITER_NAME.

（如果下層的版本管理系統 VCS 支持它的話），每個提交的作者仍會被正確地記錄為進行翻譯的使用者。

For commits where no authorship is known (for example anonymous suggestions or machine translation results), the authorship is credited to the anonymous user (see ANONYMOUS_USER_NAME). You can change the name and e-mail in the management interface.

也參考

組件配置

How to move files in the repository without losing history in Weblate?#

To keep the history, comments, or screenshots linked to strings after changing the files location you need to ensure that these strings are never deleted in Weblate. These removals can happen in case the Weblate repository is updated, but the component configuration still points to the old files. This makes Weblate assume that it should delete all the translations.

The solution to this is to perform the operation in sync with Weblate:

Lock the affected component in Weblate.
Commit any pending changes and merge them into the upstream repository.
Disable receiving webhooks the 項目配置; this prevents Weblate from immediately seeing changes in the repository.
Do any needed changes in the repo (for example using git mv), push them to the upstream repository.
Change the 組件配置 to match the new setup; upon changing configuration, Weblate will fetch the updated repository and notice the changed locations while keeping existing strings.
Unlock the component and re-enable hooks in the project configuration.

Usage#

如何復查其他人的翻譯？#

在 Weblate 中，基於工作流程有幾種複查方式，請參見翻譯工作流。
可以訂閱通知中做出的任何更改，然後檢查當它們通過電子郵件進入時檢查其他人的貢獻。
在翻譯視圖底部有個複查工具，可以在那裡選擇瀏覽給定時間以來其他人進行的翻譯。

也參考

翻譯工作流

如何提供源字串的反饋？#

在翻譯下面的文本標籤上，可以使用 Comments 標籤來提供源字串的反饋，或者與其他翻譯者討論。

也參考

Receiving source string feedback, 評註

翻譯時如何使用現有的翻譯？#

All translations within Weblate can be used thanks to shared translation memory.
You can import existing translation memory files into Weblate.
使用導入功能將概要導入作為翻譯、建議或需要復查的翻譯。這是使用概要或相似的翻譯資料庫一次性翻譯的最好方法。
You can set up tmserver with all databases you have and let Weblate use it. This is good when you want to use it several times during translation.
另一個選項是在單一 Weblate 事件中翻譯所有相關項目，這樣同樣可以從其它項目中自動地拾取翻譯。

也參考

配置自動建議, 自動建議, 翻譯記憶

Weblate 除了更新翻譯，還更新翻譯文件嗎？#

Weblate 嘗試將翻譯文件中的更改限制為最小。對於有些文件格式，很不幸會導致將文件重新格式化。如果想要將文件保持為自己的格式化方式，請為其使用預提交鉤子。

也參考

Updating target language files

語言定義來自何處以及如何添加自己的語言定義？#

語言定義的基本組包括在 Weblate 和 Translate-toolkit 中。這覆蓋了超過 150 種語言，並且包括了複數形式和文本方向的信息。

您可以在管理界面自由定義自己的語言，只需要提供與之相關的信息。

也參考

語言定義

Weblate 能將模糊字串中的更改高亮嗎？#

Weblate 支持這個功能，然而它需要數據來顯示差異。

對於 Gettext PO 文件，更新 PO 文件時，必須將參數 --previous 傳遞給 msgmerge，例如：

msgmerge --previous -U po/cs.po po/phpmyadmin.pot

對於單語言翻譯，Weblate 可以通過 ID 找到之前的字串，因此可以自動顯示差異。

當已經更新了模板時，為什麼 Weblate 仍然顯示舊的字串？#

Weblate 除了允許翻譯者翻譯之外，不會嘗試以任何方式操作翻譯文件。因此當模板或原始碼更改時，它也同樣不會更新翻譯文件。您必須簡單地手動去做，並將更改推送到倉儲，然後 Weblate 會自動拾取更改。

備註

在更新翻譯文件之前在 Weblate 中完成更改合併，這通常是個好主意，因為否則的話通常會以一些合併衝突來結束。

例如對於 gettext PO 文件，可以使用 msgmerge 工具來更新翻譯文件：

msgmerge -U locale/cs/LC_MESSAGES/django.mo locale/django.pot

In case you want to do the update automatically, you can install add-on 更新 PO 檔以符合 POT (msgmerge).

也參考

Updating target language files

How to handle renaming translation files?#

When renaming files in the repository, it can happen that Weblate sees this as removal and adding of the files. This can lead to losing strings history, comments and suggestions.

To avoid that, perform renaming in following steps:

Lock the translation component in 管理版本控制倉儲.
Commit pending changes in 管理版本控制倉儲.
Merge Weblate changes to the upstream repository.
Disable receiving updates via hooks using 啟用掛勾.
Perform the renaming of the files in the repository.
Update the component configuration to match new file names.
Enable update hooks and unlock the component.

Troubleshooting#

請求有時失敗，錯誤信息為“too many open files”（打開文件過多）#

有時當您的 Git 倉儲增長太多並您有太多倉儲時會發生。壓縮 Git 倉儲會改善這種情況。

這樣做的最容易方式是運行：

# Go to DATA_DIR directory
cd data/vcs
# Compress all Git repositories
for d in */* ; do
    pushd $d
    git gc
    popd
done

也參考

DATA_DIR

當訪問網站時，“Bad Request (400)”（錯誤的請求）錯誤信息#

這很可能因為 ALLOWED_HOSTS 配置不當而產生。需要包含在 Weblate 上訪問的所有主機名。例如：

ALLOWED_HOSTS = ["weblate.example.com", "weblate", "localhost"]

也參考

允許的網域設定

“There are more files for the single language (en)”（單一語言‘英語’有多個文件）是什麼意思？#

當源語言有翻譯時這會典型發生。 Weblate 跟踪源字串，並為此保留源字串。相同語言的附加字串不會被處理。

In case the translation to the source language is desired, please change the 來源語言 in the component settings. You might want to use English (Developer) as a source language, or utilize 源字串的質量網關.
如果是不需要用到來源語言的翻譯檔，請從倉儲中將它移除。
In case the translation file for the source language is needed, but should be ignored by Weblate, please adjust the 語言篩選 to exclude it.

提示

對於其它語言可能也會得到相似的錯誤信息。在這種情況下最可能的原因是在 Weblate 中幾個文件映射到單語言上。

這可能是由於將過時的語言編碼與新的一起使用（對於日語是``ja``和``jp``），或者包括了特定國家的和通用的語言編碼（fr``和` `fr_FR）。更多細節請參見解析語系碼。

功能#

Weblate 支持 Git 和 Mercurial 意外的 VCS 嗎？#

Weblate 當前不支持:ref:vcs-git （擴展支持:ref:vcs-github、Gerrit 和:ref:vcs-git-svn）和:ref:vcs -mercurial 以外的任何VCSes，但能夠對其它VCSes 寫後端。

還可以在 Git 中使用 Git remote helpers 來訪問其它 VCSes。

Weblate 還支持無 VCS 的操作，請參見 Local files。

備註

為了本地支持其它 VCSes，Weblate 需要使用分佈式 VCS，並可能能夠調整來與 Git 和 Mercurial 以外的其它任何 VCSes 工作，但必須有人應用這項支持。

也參考

版本控制整合

Weblate 如何記錄翻譯者？#

Weblate 中所做的每個更改都將以翻譯者的名稱提交到版本控制系統（VCS ）中。這樣，每個更改都具有適當的作者身份，您可以使用用於代碼的標準版本控制系統（VCS ）工具來進行跟踪。

此外，如果翻譯文件格式支持，則文件頭會更新為包含翻譯者的名稱。

也參考

list_translators, 翻譯進程匯報

為什麼 Weblate 強制在單一樹中顯示所有 PO 文件？#

Weblate 的設計方式是將每個 PO 文件表示為單個組件。這對翻譯人員來說是有好處的，這樣他們就知道他們實際上在翻譯什麼。

在 4.2 版本變更: Translators can translate all the components of a project into a specific language as a whole.

Weblate 為什麼使用 sr_Latn 或 zh_Hant 這樣的語言編碼？#

These are language codes defined by RFC 5646 to better indicate that they are really different languages instead previously wrongly used modifiers (for @latin variants) or country codes (for Chinese).

Weblate 仍然理解傳統的語言編碼並將它們映射到當前的便馬上——例如``sr@latin`` 將被處理為``sr_Latn`` 或者``zh@CN`` 處理為``zh_Hans``。

備註

Weblate defaults to POSIX style language codes with underscore, see 語言定義 for more details.

也參考

語言定義, 語言代碼類型, 添加新的翻譯

支持的文件格式#

Weblate supports a wide range of translation formats. Each format is slightly different and provides a different set of capabilities.

提示

為您的應用程序選擇文件格式時，最好在您使用的工具箱/平台中保留一些公認的格式。這樣，您的翻譯人員可以額外使用他們習慣使用的任何工具，並且更有可能為您的項目做出貢獻。

Android字串資源#

用於翻譯應用的Android特定文件格式。

Android string resources are monolingual, the 單語的基底語言檔 is stored in a different location from the other files – res/values/strings.xml.

備註

當前不支持Android的 string-array 架構。為了解決這個問題，可以將字串數組分開：

<string-array name="several_strings">
    <item>First string</item>
    <item>Second string</item>
</string-array>

變為：

<string-array name="several_strings">
    <item>@string/several_strings_0</item>
    <item>@string/several_strings_1</item>
</string-array>
<string name="several_strings_0">First string</string>
<string name="several_strings_1">Second string</string>

指向 string 元素的 string-array 應存儲在不同文件中，並且不為翻譯所用。

這個腳本可以幫助預處理現有的 strings.xml 文件和翻譯：https://gist.github.com/paour/11291062

提示

To avoid translating some strings, these can be marked as non-translatable. This can be especially useful for string references:

<string name="foobar" translatable="false">@string/foo</string>

也參考

Android字串資源文件, Android string resources

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`res/values-*/strings.xml`
單語的基底語言檔	`res/values/strings.xml`
新翻譯的模板	Empty
檔案格式	Android字串資源

蘋果 iOS 字串#

File format typically used for translating Apple iOS applications, but also standardized by PWG 5100.13 and used on NeXTSTEP/OpenSTEP.

Apple iOS strings are usually used as monolingual.

也參考

Stringsdict format, Apple 「strings files」 documentation, Message Catalog File Format in PWG 5100.13, Mac OSX strings

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`Resources/*.lproj/Localizable.strings`
單語的基底語言檔	`Resources/en.lproj/Localizable.strings` 或 `Resources/Base.lproj/Localizable.strings`
新翻譯的模板	Empty
檔案格式	iOS Strings (UTF-8)

App store 中介資料檔#

在 3.5 版本新加入.

可以翻譯用於在各種應用商店中發佈應用程序的應用程序的元數據。目前以下工具兼容：

元數據由多個TextFile組成，Web2將作為單獨的字串呈現要轉換。

提示

如果您不想翻譯某些字串（例如changelogs），則標記為只讀（請參閱:ref:“自定義檢查”）。這可以通過以下方式自動化:ref:“addon-webblate.flags.bulk`。

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`fastlane/android/metadata/*`
單語的基底語言檔	`fastlane/android/metadata/en-US`
新翻譯的模板	`fastlane/android/metadata/en-US`
檔案格式	App store metadata files

ARB File#

在 4.1 版本新加入.

ARB翻譯是單語，因此建議使用（最常見的）英語字串指定基本文件。

也參考

JSON, 應用程式中文包規格, 國際化 Flutter 應用程式, Updating target language files, 自訂 JSON 輸出, 清理翻譯檔

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`lib/l10n/intl_*.arb`
單語的基底語言檔	`lib/l10n/intl_en.arb`
新翻譯的模板	Empty
檔案格式	ARB file

CSV 文件#

CSV 文件可以包含源和翻譯的簡單列表。 Weblate 支持以下文件：

帶有標頭定義字段（location, source, target, ID, fuzzy, context, translator_comments, ` developer_comments`）的文件。這是推薦的方法，因為它最不容易出錯。挑選 CSV file 作為一種文件格式。
具有兩個字段的文件 —— 源和翻譯（按此順序），選擇 Simple CSV file 作為文件格式。
無標頭文件字段順序由`translate-toolkit`_: location、 source、target、 ID、 fuzzy、 context、 translator_comments、 developer_comments 所定義。選擇 CSV file 作為一種文件格式。
請記住定義:ref:“組件 - 模板”（參見:ref:`Bimono）。

提示

By default, the CSV format does autodetection of file encoding. This can be unreliable in some corner cases and causes performance penalty. Please choose file format variant with encoding to avoid this (for example CSV file (UTF-8)).

警告

CSV 格式當前會自動檢測 CSV 文件的方言。在某些情況下，自動檢測可能會失敗，並且您會得到不同的結果。對於值中包含換行符的 CSV 文件尤其如此。作為一種解決方法，推薦省略引用的字符。

也參考

CSV

Multivalue CSV file#

在 4.13 版本新加入.

This variant of the CSV files allows storing multiple translations per string.

Example files#

範例檔案：

Thank you for using Weblate.,Děkujeme za použití Weblate.

Weblate 設定組態#

雙語 CSV 文件的典型Weblate 組件配置
文件掩碼	`locale/*.csv`
單語的基底語言檔	Empty
新翻譯的模板	`locale/en.csv`
檔案格式	CSV 文件

單語 CSV 文件的典型 Weblate 組件配置
文件掩碼	`locale/*.csv`
單語的基底語言檔	`locale/en.csv`
新翻譯的模板	`locale/en.csv`
檔案格式	Simple CSV file

DTD files#

也參考

Mozilla DTD format

Example DTD file:

<!ENTITY hello "">
<!ENTITY orangutan "">
<!ENTITY try "">
<!ENTITY thanks "">

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`locale/*.dtd`
單語的基底語言檔	`locale/en.dtd`
新翻譯的模板	Empty
檔案格式	DTD file

Excel Open XML#

在 3.2 版本新加入.

Excel打開XML（.xlsx）文件可以導入和導出。

在上傳用於翻譯的XLSX文件時，請注意，只考慮活動工作表，並且必須至少包含一個名為“源字串”的列以及稱為“目標”（包含的列）譯文）。此外，應該有一個名為“context``的”列（其中包含翻譯字串的上下文路徑）。如果使用XLSX下載將翻譯導出到Excel工作簿中，則您已經獲得了具有正確文件格式的文件。

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`path/*.xlsx`
單語的基底語言檔	`path/en.xlsx`
新翻譯的模板	`path/en.xlsx`
檔案格式	Excel Open XML

Flat XML files#

在 3.9 版本新加入.

也參考

Flat XML

平面XML文件的示例：

<?xml version='1.0' encoding='UTF-8'?>
<root>
  <str key="hello_world">Hello World!</str>
  <str key="resource_key">Translated value.</str>
</root>

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`locale/*.xml`
單語的基底語言檔	`locale/en.xml`
新翻譯的模板	Empty
檔案格式	Flat XML file

Fluent format#

在 4.8 版本新加入.

備註

Support for this format is under development. Some features might not yet be available and the behavior can change between releases. Feedback from testing is welcome.

Fluent is a monolingual text format that focuses on asymmetric localization: a simple string in one language can map to a complex multi-variant translation in another language.

也參考

Project Fluent website

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`locales/*/messages.ftl`
單語的基底語言檔	`locales/en/messages.ftl`
新翻譯的模板	Empty
檔案格式	Fluent file

GNU gettext#

Most widely used format for translating libre software.

通過調整文件頭或鏈接到相應的源文件，可以支持存儲在文件中的語境信息。

也參考

使用GNU gettext 來翻譯軟件, 使用 Sphinx 翻譯文件, Gettext on Wikipedia, PO Files, 更新「configure」檔案中的 ALL_LINGUAS 變數, 自訂 gettext 輸出, 更新 LINGUAS 檔案, 生成 MO 檔, 更新 PO 檔以符合 POT (msgmerge)

單語 gettext#

一些項目決定使用 gettext 作為單語格式 —— 它們僅在原始碼中編碼 ID，然後將字串翻譯成所有語言，包括英語。支持此功能，儘管在將組件導入 Weblate 時必須明確選擇此文件格式。

Example files#

雙語 gettext PO 文件通常如下所示：

#: weblate/media/js/bootstrap-datepicker.js:1421
msgid "Monday"
msgstr "Pondělí"

#: weblate/media/js/bootstrap-datepicker.js:1421
msgid "Tuesday"
msgstr "Úterý"

#: weblate/accounts/avatar.py:163
msgctxt "No known user"
msgid "None"
msgstr "Žádný"

單語言的 gettext PO 文件通常如下所示：

#: weblate/media/js/bootstrap-datepicker.js:1421
msgid "day-monday"
msgstr "Pondělí"

#: weblate/media/js/bootstrap-datepicker.js:1421
msgid "day-tuesday"
msgstr "Úterý"

#: weblate/accounts/avatar.py:163
msgid "none-user"
msgstr "Žádný"

基本語言文件將是：

#: weblate/media/js/bootstrap-datepicker.js:1421
msgid "day-monday"
msgstr "Monday"

#: weblate/media/js/bootstrap-datepicker.js:1421
msgid "day-tuesday"
msgstr "Tuesday"

#: weblate/accounts/avatar.py:163
msgid "none-user"
msgstr "None"

Weblate 設定組態#

Typical Weblate 組件配置 for bilingual gettext
文件掩碼	`po/*.po`
單語的基底語言檔	Empty
新翻譯的模板	`po/messages.pot`
檔案格式	Gettext PO file

Typical Weblate 組件配置 for monolingual gettext
文件掩碼	`po/*.po`
單語的基底語言檔	`po/en.po`
新翻譯的模板	`po/messages.pot`
檔案格式	Gettext PO 文件（單語）

go-i18n JSON files#

在 4.1 版本新加入.

在 4.16 版本變更: Support for v2 variant of this format was added.

Go-i18n翻譯是單向的，因此建議使用（最常見的）英語字串指定基本文件。

備註

Weblate supports the go-i18n JSON v1 and v2 variants. Please choose correct file format matching your environment.

也參考

tt：格式/ json，go-i18n，更新 - 目標文件，addon-Web2.json.Customize，清理翻譯檔，

Weblate 設定組態#

Typical Weblate 組件配置 for v1
文件掩碼	`langs/*.json`
單語的基底語言檔	`langs/en.json`
新翻譯的模板	Empty
檔案格式	go-i18n v1 JSON file

Typical Weblate 組件配置 for v2
文件掩碼	`langs/*.json`
單語的基底語言檔	`langs/en.json`
新翻譯的模板	Empty
檔案格式	go-i18n v2 JSON file

gotext JSON files#

在 4.15.1 版本新加入.

gotext translations are monolingual, so it is recommended to specify a base file with (what is most often the) English strings.

也參考

JSON, I18n in Go: Managing Translations, Updating target language files, 自訂 JSON 輸出, 清理翻譯檔,

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`internal/translations/locales/*/messages.gotext.json`
單語的基底語言檔	`internal/translations/locales/en-GB/messages.gotext.json`
新翻譯的模板	Empty
檔案格式	gotext JSON file

GWT 屬性#

用於翻譯的本地 GWT 格式。

GWT 屬性通常用作單語言翻譯。

也參考

GWT localization guide, GWT Internationalization Tutorial, Mozilla and Java properties files, Updating target language files, 格式化 Java properties 檔案, 清理翻譯檔

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`src/app/Bundle_*.properties`
單語的基底語言檔	`src/app/Bundle.properties`
新翻譯的模板	Empty
檔案格式	GWT 屬性

HTML files#

在 4.1 版本新加入.

可翻譯內容從HTML文件中提取，並為翻譯提供。

也參考

HTML

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`path/*.html`
單語的基底語言檔	`path/en.html`
新翻譯的模板	`path/en.html`
檔案格式	HTML file

i18next JSON files#

在 4.15.1 版本變更: Support for v4 variant of this format was added.

提示

In case you use plurals, it is recommended to use v4 as that aligned plural handling with CLDR. Older versions have different plural rules for some languages which are not correct.

`i18next <https://www.i18next.com/>`_是編寫的框架和javascript的國際化框架。Webleate支持其本地化文件，其中包含多個功能。

i18ext翻譯是單語，因此建議使用（最常見的）英語字串指定基本文件。

備註

Weblate supports the i18next JSON v3 and v4 variants. Please choose correct file format matching your environment.

The v2 and v1 variants are mostly compatible with v3, with exception of how plurals are handled.

也參考

JSON, i18next JSON 格式, Updating target language files, 自訂 JSON 輸出, 清理翻譯檔

範例檔案：

{
  "hello": "Hello",
  "apple": "I have an apple",
  "apple_plural": "I have {{count}} apples",
  "apple_negative": "I have no apples"
}

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`langs/*.json`
單語的基底語言檔	`langs/en.json`
新翻譯的模板	Empty
檔案格式	i18next JSON file v3

IDML Format#

在 4.1 版本新加入.

從Adobe Indesign標記語言文件中提取可翻譯內容，並為翻譯提供。

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`path/*.idml`
單語的基底語言檔	`path/en.idml`
新翻譯的模板	`path/en.idml`
檔案格式	IDML file

INI 翻譯#

在 4.1 版本新加入.

INI file format for translations. Weblate currently supports several variants of JSON translations:

INI 翻譯通常用作單語言翻譯。

備註

Weblate 只從 INI 文件內的章節中提取鍵。在您的 INI 文件缺乏章節的情況下，會想要替代使用 Joomla 翻譯或 Java 屬性。

也參考

INI Files, Java 屬性, Joomla 翻譯, Inno Setup INI translations

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`language/*.ini`
單語的基底語言檔	`language/en.ini`
新翻譯的模板	Empty
檔案格式	INI File

Inno Setup INI translations#

在 4.1 版本新加入.

Inno Setup INI file format for translations.

Inno Setup INI translations are usually used as monolingual translations.

備註

唯一需要注意的差異是 INI 翻譯支持 %n 和 %t 佔位符用於換行和製表符。

備註

當前只支持 Unicode 文件（.islu），當前不支持 ANSI 變體（.isl）。

也參考

INI Files, Joomla 翻譯, INI 翻譯

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`language/*.islu`
單語的基底語言檔	`language/en.islu`
新翻譯的模板	Empty
檔案格式	Inno Setup INI File

Java 屬性#

用於翻譯的本地 Java 格式。

Java 屬性通常用作單語言翻譯。

Weblate 支持這個格式的 ISO-8859-1、UTF-8 和 UTF-16 變體。它們所有都支持存儲 Unicode 字符，只是編碼不同。在 ISO-8859-1 中，使用了 Unicode 轉義序列（例如 zkou\u0161ka），所有其它編碼字符直接或者在 UTF-8 中或者在 UTF-16 中。

備註

加載轉義序列也在 UTF-8 模式中工作，因此請小心選擇正確的編碼組，與您應用的需要匹配。

也參考

Java properties on Wikipedia, Mozilla and Java properties files, mi18n lang files, GWT 屬性, Updating target language files, 格式化 Java properties 檔案, 清理翻譯檔

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`src/app/Bundle_*.properties`
單語的基底語言檔	`src/app/Bundle.properties`
新翻譯的模板	Empty
檔案格式	Java Properties (ISO-8859-1)

Joomla 翻譯#

用於翻譯的本地 Joomla 格式。

Joomla 翻譯通常用作單語言翻譯。

也參考

Mozilla and Java properties files, INI 翻譯, Inno Setup INI translations

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`language/*/com_foobar.ini`
單語的基底語言檔	`language/en-GB/com_foobar.ini`
新翻譯的模板	Empty
檔案格式	Joomla 語言文件

JSON files#

在 4.3 版本變更: 即使對於在之前發佈版本中中斷的複雜情況，JSON 文件的結構也適當保留。

JSON 格式主要用於翻譯 Javascript 中實施的應用。

Weblate 當前支持 JSON 翻譯的幾個變體：

簡單的鍵/值文件，由例如 vue-i18n 或 react-intl 使用。
具有嵌套鍵的文件。
i18next JSON files
go-i18n JSON files
gotext JSON files
WebExtension JSON
ARB File

JSON 翻譯通常是單語言的，因此推薦指定帶有（最經常使用的）英語字串的翻譯模板文件。

提示

JSON file 和 JSON nested structure file 都可以處理相同類型的文件。翻譯時都保留現有的 JSON 架構。

它們之間的唯一區別是使用Weberate添加新字串時。嵌套結構格式會解析新添加的鍵並將新字串插入匹配結構。例如，“app.name`”鍵插入為：

{
   "app": {
      "name": "Weblate"
   }
}

也參考

JSON, Updating target language files, 自訂 JSON 輸出, 清理翻譯檔,

Example files#

範例檔案：

{
  "Hello, world!\n": "Ahoj světe!\n",
  "Orangutan has %d banana.\n": "",
  "Try Weblate at https://demo.weblate.org/!\n": "",
  "Thank you for using Weblate.": ""
}

也支持嵌套文件（要求請參見上面），這樣的文件看起來像：

{
  "weblate": {
    "hello": "Ahoj světe!\n",
    "orangutan": "",
    "try": "",
    "thanks": ""
  }
}

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`langs/translation-*.json`
單語的基底語言檔	`langs/translation-en.json`
新翻譯的模板	Empty
檔案格式	JSON nested structure file

Laravel PHP 字串#

在 4.1 版本變更.

Laravel PHP 本地化文件也支持複數：

<?php
return [
    'welcome' => 'Welcome to our application',
    'apples' => 'There is one apple|There are many apples',
];

也參考

PHP, 在 Laravel 中使用在地化

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`lang/*/texts.php`
單語的基底語言檔	`lang/en/texts.php`
新翻譯的模板	`lang/en/texts.php`
檔案格式	Laravel PHP strings

mi18n lang files#

在 4.7 版本新加入.

File format used for JavaScript localization by mi18n. Syntactically it matches Java 屬性.

也參考

mi18n, Mozilla and Java properties files, Java 屬性, Updating target language files, 格式化 Java properties 檔案, 清理翻譯檔

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`*.lang`
單語的基底語言檔	`en-US.lang`
新翻譯的模板	Empty
檔案格式	mi18n lang file

OpenDocument Format#

在 4.1 版本新加入.

可翻譯內容從OpenDocument文件中提取，並為翻譯提供。

也參考

OpenDocument Format

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`path/*.odt`
單語的基底語言檔	`path/en.odt`
新翻譯的模板	`path/en.odt`
檔案格式	OpenDocument file

PHP 字串#

PHP翻譯通常只包含一種語言，因此建議指定(最常見的)帶英語字串的模板文件。

Weblate currently supports several variants of PHP translations:

Monolingual PHP strings in various syntax
Laravel PHP 字串

範例檔案：

<?php
$LANG['foo'] = 'bar';
$LANG['foo1'] = 'foo bar';
$LANG['foo2'] = 'foo bar baz';
$LANG['foo3'] = 'foo bar baz bag';

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`lang/*/texts.php`
單語的基底語言檔	`lang/en/texts.php`
新翻譯的模板	`lang/en/texts.php`
檔案格式	PHP strings

Qt Linguist .ts#

基於 Qt 的應用中使用的翻譯格式。

Qt Linguist 文件既用作雙語翻譯，也用作單語翻譯。

也參考

Qt Linguist 手冊, Qt .ts, 雙語和單語格式

Weblate 設定組態#

用作雙語言時典型的 Weblate 組件配置
文件掩碼	`i18n/app.*.ts`
單語的基底語言檔	Empty
新翻譯的模板	`i18n/app.de.ts`
檔案格式	Qt Linguist 翻譯文件

用作單語言時典型的 Weblate 組件配置
文件掩碼	`i18n/app.*.ts`
單語的基底語言檔	`i18n/app.en.ts`
新翻譯的模板	`i18n/app.en.ts`
檔案格式	Qt Linguist 翻譯文件

ResourceDictionary files#

在 4.13 版本新加入.

ResourceDictionary is a monolingual XML file format used to package localizable string resources for Windows Presentation Foundation (WPF) applications.

也參考

Flat XML, Flat XML files, Updating target language files, 清理翻譯檔

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`Languages/*.xaml`
單語的基底語言檔	`Language/en.xaml`
新翻譯的模板	Empty
檔案格式	ResourceDictionary file

RESX .NET resource files#

一個.xml資源（.resx）文件使用Microsoft .NET應用程序中使用的單格式XML文件格式。它是“互換的.resw，在使用相同的語法到.resx <https://lingohub.com/developers/resource-files/resw-resx-localization>`_。

也參考

.NET Resource files (.resx), Updating target language files, 清理翻譯檔

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`Resources/Language.*.resx`
單語的基底語言檔	`Resources/Language.resx`
新翻譯的模板	Empty
檔案格式	.NET resource file

Ruby YAML files#

Ruby i18N Yaml文件用語言作為根節點。

也參考

YAML, YAML files

示例Ruby I18N Yaml文件：

cs:
  weblate:
    hello: ""
    orangutan: ""
    try: ""
    thanks: ""

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`translations/messages.*.yml`
單語的基底語言檔	`translations/messages.en.yml`
新翻譯的模板	Empty
檔案格式	Ruby YAML file

Stringsdict format#

在 4.8 版本新加入.

XML based format used by Apple which is able to store plural forms of a string.

也參考

蘋果 iOS 字串，Stringsdict 檔案格式

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`Resources/*.lproj/Localizable.stringsdict`
單語的基底語言檔	`Resources/en.lproj/Localizable.stringsdict` or `Resources/Base.lproj/Localizable.stringsdict`
新翻譯的模板	Empty
檔案格式	Stringsdict file

Subtitle files#

在 3.7 版本新加入.

Weblate 可翻譯許多的字幕檔：

SubRip 字幕檔 (*.srt)
MicroDVD 字幕檔 (*.sub)
高級變電站alpha字幕文件（* .ass）
變電站字母字幕文件（* .ssa）

也參考

Subtitles

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`path/*.srt`
單語的基底語言檔	`path/en.srt`
新翻譯的模板	`path/en.srt`
檔案格式	SubRip subtitle file

TermBase eXchange format#

在 4.5 版本新加入.

TBX是術語數據交換的XML格式。

也參考

`tbx在wikipedia上<https://en.wikipedia.org/wiki/termbase_exchange>`_ ,: doc：tt：格式/ tbx詞彙表

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`tbx/*.tbx`
單語的基底語言檔	Empty
新翻譯的模板	Empty
檔案格式	TermBase eXchange file

文字檔#

在 4.6 版本新加入.

可翻譯內容從純文本文件中提取，並為翻譯提供。每個段落都被翻譯為單獨的字串。

這格式有三種風格：

純文字檔案
DokuWiki 文本文件
MediaWiki 文本文件

也參考

Simple Text Documents

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`path/*.txt`
單語的基底語言檔	`path/en.txt`
新翻譯的模板	`path/en.txt`
檔案格式	Plain text file

WebExtension JSON#

在翻譯Mozilla Firefox或Google Chromium的擴展時使用的文件格式。

備註

雖然這種格式稱為JSON，但其規範允許包括註釋，這些註釋不是JSON規範的一部分。WebLate目前不支持註釋。

也參考

JSON, Google chrome.i18n, Mozilla Extensions Internationalization

範例檔案：

{
  "hello": {
    "message": "Ahoj světe!\n",
    "description": "Description",
    "placeholders": {
      "url": {
        "content": "$1",
        "example": "https://developer.mozilla.org"
      }
    }
  },
  "orangutan": {
    "message": "Orangutan has $coUnT$ bananas",
    "description": "Description",
    "placeholders": {
      "count": {
        "content": "$1",
        "example": "5"
      }
    }
  },
  "try": {
    "message": "",
    "description": "Description"
  },
  "thanks": {
    "message": "",
    "description": "Description"
  }
}

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`_locales/*/messages.json`
單語的基底語言檔	`_locales/en/messages.json`
新翻譯的模板	Empty
檔案格式	WebExtension JSON 檔

Windows RC files#

在 4.1 版本變更: 對Windows RC文件的支持已被重寫。

備註

Support for this format is under development. Some features might not yet be available and the behavior can change between releases. Feedback from testing is welcome.

RC files are language files used to localize translatable text, dialogs, menus, for Windows applications.

也參考

Windows RC files

Example files#

Example Windows RC file:

LANGUAGE LANG_CZECH, SUBLANG_DEFAULT

STRINGTABLE
BEGIN
    IDS_MSG1                "Hello, world!\n"
    IDS_MSG2                "Orangutan has %d banana.\n"
    IDS_MSG3                "Try Weblate at http://demo.weblate.org/!\n"
    IDS_MSG4                "Thank you for using Weblate."
END

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`狼/*.如此`
單語的基底語言檔	`lang/en-US.rc`
新翻譯的模板	`lang/en-US.rc`
檔案格式	RC file

XLIFF#

創建基於 XML 的格式來標準化翻譯文件，但最終它是該領域中許多標準之一。

XML Localization Interchange File Format (XLIFF) 通常用作雙語言格式，但 Weblate 也支持其作為單語言格式。

Weblate supports XLIFF in several variants:

XLIFF translation file: Simple XLIFF file where content of the elements is stored as plain text (all XML elements being escaped).
XLIFF with placeables support: Standard XLIFF supporting placeables and other XML elements.
XLIFF with gettext extensions: XLIFF enriched by XLIFF 1.2 Representation Guide for Gettext PO to support plurals.

也參考

XML Localization Interchange File Format (XLIFF) specification, XLIFF 1.2 Representation Guide for Gettext PO, XLIFF on Wikipedia, XLIFF,

翻譯狀態#

在 3.3 版本變更: 3.3 版本前的 Weblate 忽略 state 屬性。

文件中的``state`` 屬性在Weblate 中被部分處理並映射為」Needs edit」（需要編輯）的狀態（如果出現目標的話，後面的狀態用於將字串標記為需要編輯： new `` 、 ``needs-translation 、 needs-adaptation 、 needs-l10n ）。如果應該省略 state 屬性，只要 <target> 元素存在，那麼字串被認為需要翻譯。

如果翻譯字串具有``approved=」yes」``，那麼它還將被導入Weblate 作為」Approved」（同意的），任何其它內容被導入作為」Waiting for review」（等待复核，這與XLIFF 規範匹配）。

當存儲時，Weblate 如無必要不會添加其它屬性：

state 屬性只在字串標記為需要編輯的情況下添加。
approved 屬性只在字串已經被複查的情況下添加。
在其它情況下不添加屬性，但在它們出現的情況下更新。

這表示當使用 XLIFF 格式時，強烈推薦打開 Weblate 審查過程，從而能看到並更改字串的審核狀態。

相似地在導入這樣的文件時（在上傳表格中），應該選擇 Processing of strings needing edit 之下的 Import as translated。

也參考

專門的審核者

XLIFF 中的空白字符和新行符#

在 XML 格式中不區分通常類型或量的空白字符。如果想要保留，必須將 xml:space="preserve" 標記添加到字串中。

例如：

    <trans-unit id="10" approved="yes">
        <source xml:space="preserve">hello</source>
        <target xml:space="preserve">Hello, world!
</target>
    </trans-unit>

指定翻譯標記#

還可以通過使用 weblate-flags 屬性指定附加的翻譯標記（請參見使用標誌自定義行為）。 Weblate 還理解來自 XLIFF 規範的 maxwidth 和 font 屬性：

<trans-unit id="10" maxwidth="100" size-unit="pixel" font="ubuntu;22;bold">
   <source>Hello %s</source>
</trans-unit>
<trans-unit id="20" maxwidth="100" size-unit="char" weblate-flags="c-format">
   <source>Hello %s</source>
</trans-unit>

解析 font 屬性用於字體集、尺寸和粗細，上面的示例顯示了全部，儘管只需要字符集。字符集中的任何空白字符被轉換為下劃線，所以 Source Sans Pro 變成 Source_Sans_Pro，當命名字符集時請記住這些請參見管理字型）。

也參考

font attribute in XLIFF 1.2, maxwidth attribute in XLIFF 1.2

String keys#

Weblate 通過 resname 屬性在它出線的情況下識別 XLIFF 文件中的單元，並退回到 id （如果出現的話與 file 標籤一起）。

resname 屬性被認為是人類友好的單元識別符，對 Weblate 比 id 更適於顯示。在整個 XLIFF 文件中 resname 具有一致性。這是 Weblate 需要的，並且不被 XLIFF 標準覆蓋——它不在這個屬性上放入任何獨特性限制。

Weblate 設定組態#

用於雙語言 XLIFF 的典型 Weblate 組件配置
文件掩碼	`localizations/*.xliff`
單語的基底語言檔	Empty
新翻譯的模板	`localizations/en-US.xliff`
檔案格式	XLIFF 翻譯文件

用於單語言 XLIFF 的典型 Weblate 組件配置
文件掩碼	`localizations/*.xliff`
單語的基底語言檔	`localizations/en-US.xliff`
新翻譯的模板	`localizations/en-US.xliff`
檔案格式	XLIFF 翻譯文件

YAML files#

具有字串鍵和值的普通yaml文件。Webleate還從列表或詞典中提取字串。

Weblate currently supports several variants of YAML translations:

具有嵌套鍵的文件。
Ruby YAML files

也參考

YAML, Ruby YAML files

yaml文件的示例：

weblate:
  hello: ""
  orangutan": ""
  try": ""
  thanks": ""

Weblate 設定組態#

典型的 Weblate 組件配置
文件掩碼	`translations/messages.*.yml`
單語的基底語言檔	`translations/messages.en.yml`
新翻譯的模板	Empty
檔案格式	YAML file

也參考

Translation Related File Formats

自動偵測#

Weblate tries to detect file format during 添加翻譯項目和組件. The detection might be wrong for different variants of the same serialization format (JSON, YAML, properties) or file encoding, so please verify that 檔案格式 is correct before creating the component.

翻譯類型功能#

所有受支持格式的功能#
Format	語言能力 [1]	複數 [2]	Descriptions [3]	語境 [4]	位置 [5]	標記 [8]	附加狀態 [6]
GNU gettext	bilingual	yes	yes	yes	yes	是 [9]	需要編輯
單語 gettext	mono	yes	yes	yes	yes	是 [9]	需要編輯
XLIFF	both	yes	yes	yes	yes	yes	需要編輯，已同意
Java 屬性	both	no	yes	no	no	no
mi18n lang files	mono	no	yes	no	no	no
GWT 屬性	mono	yes	yes	no	no	no
Joomla 翻譯	mono	no	yes	no	yes	no
Qt Linguist .ts	both	yes	yes	no	yes	yes	需要編輯
Android字串資源	mono	yes	是 [7]	no	no	yes
蘋果 iOS 字串	both	no	yes	no	no	no
PHP 字串	mono	否 [10]	yes	no	no	no
JSON files	mono	no	no	no	no	no
i18next JSON files	mono	yes	no	no	no	no
go-i18n JSON files	mono	yes	yes	no	no	no
gotext JSON files	mono	yes	yes	no	yes	no
ARB File	mono	yes	yes	no	no	no
WebExtension JSON	mono	yes	yes	no	no	no
RESX .NET resource files	mono	no	yes	no	no	yes
ResourceDictionary files	mono	no	no	no	no	yes
CSV 文件	both	no	yes	yes	yes	no	需要編輯
YAML files	mono	no	no	no	no	no
Ruby YAML files	mono	yes	no	no	no	no
DTD files	mono	no	no	no	no	no
Flat XML files	mono	no	no	no	no	yes
Windows RC files	mono	no	yes	no	no	no
Excel Open XML	mono	no	yes	yes	yes	no	需要編輯
App store 中介資料檔	mono	no	no	no	no	no
Subtitle files	mono	no	no	no	yes	no
HTML files	mono	no	no	no	no	no
OpenDocument Format	mono	no	no	no	no	no
IDML Format	mono	no	no	no	no	no
INI 翻譯	mono	no	no	no	no	no
Inno Setup INI translations	mono	no	no	no	no	no
TermBase eXchange format	bilingual	no	yes	no	no	yes
文字檔	mono	no	no	no	no	no
Stringsdict format	mono	yes	yes	no	no	no
Fluent format	mono	no [11]	yes	no	no	no

雙語和單語格式#

支持 monolingual 和 bilingual 格式。雙語格式在單個文件中存儲兩種語言 —— 源和翻譯（典型示例是 GNU gettext，XLIFF 或蘋果 iOS 字串字串）。另一方面，單語格式通過 ID 識別字串，每個語言文件僅包含那些語言到任何給定語言（通常是 Android字串資源）的映射。兩種變體都使用某些文件格式，請參見下面的詳細說明。

為了正確使用單語文件，Weblate 要求訪問一個包含完整字串列表的文件，以與其源一起翻譯—— 該文件在Weblate 中稱為:ref:component-template，儘管命名方式可能會有所不同。

另外，可以利用中間語言檔案擴展此工作流程，以包括開發人員提供的字串，但不要在最終的字串中使用。

翻譯旗標#

Translation flags allow customizing Weblate behavior. Some formats support defining those in the translation file (you can always define them in the Weblate interface, see 使用標誌自定義行為).

This feature is modelled on flags in GNU gettext.

Additionally, for all XML based format, the flags are extracted from the non-standard attribute weblate-flags. Additionally max-length:N is supported through the maxwidth attribute as defined in the XLIFF standard, see 指定翻譯標記.

也參考

使用標誌自定義行為, PO files documentation

Pluralized strings#

Plurals are necessary to properly localize strings with variable count. The rules depend on a target language and many formats follow CLDR specification for that.

提示

Pluralizing strings need proper support from the application framework as well. Choose native format of your platform such as GNU gettext, Android字串資源 or Stringsdict format.

唯讀字串#

在 3.10 版本新加入.

將包含來自翻譯文件的只讀字串，但不能在 Webleate 中編輯。此功能本功能僅由少量格式支持（ xliff`和 :ref:`aresource），但可以通過添加一個 read-only 標記，參閱使用標誌自定義行為。

Supporting other formats#

支持序列化的大多數格式可以輕鬆支持支持序列化，但他們沒有（尚未）接收任何測試。在大多數情況下，Weberate需要一些薄層以隱藏不同`Translate-Toolkit`_ Storage的行為的差異。

要為新格式添加支持，首先要在“translate-toolkit`_中為其實現支持。

也參考

Translation Related File Formats

版本控制整合#

Weblate currently supports Git (with extended support for GitHub pull requests, GitLab 合併請求, Gitea pull requests, Gerrit, Subversion and Bitbucket Server pull requests) and Mercurial as version control back-ends.

訪問存儲庫#

WebLate必須訪問您要使用的VCS存儲庫。使用公開的存儲庫，您只需輸入正確的URL（例如 https://github.com/WeblateOrg/weblate.git ），但對於私人存儲庫或推送URL，設置更複雜並且需要驗證。

從託管的Weberate訪問存儲庫#

對於託管的Web2，有一個專用推送使用者在Github，Bitbucket，Codeberg和Gitlab上註冊（帶有Username：Guilabel：“Webleate”，電子郵件“”託管“@ WebLate.org``和，名稱：Guilabel：Bublate Push使用者）。您需要將此使用者添加為協作者，並為存儲庫提供適當的權限（只讀對於克隆也可以，按下寫入）。根據服務和組織設置，這會立即發生，或者需要在Webleate方面確認。

：圭冊：Github上的“Webleate”使用者在五分鐘內自動接受邀請函。在其他服務可能需要手動處理，所以請耐心等待。

曾經：圭冊：“WebBlate”使用者已添加，您可以配置:ref:“組件 - repo`和:ref:component-push`使用ssh協議（例如``git@github.com：weblateorg / weberate.git`）。

SSH 倉儲#

訪問私有倉儲的最常用方法是基於 SSH。授權公共 Weblate SSH 密鑰（請參閱 Weblate SSH 密鑰）以這種方式訪問上游倉儲。

警告

在 Github 上，每個密鑰只能用一次，見 GitHub repositories 和從託管的Weberate訪問存儲庫。

Weblate 還會在首次連接時存儲主機密鑰指紋，並且在以後進行更改時將無法連接到主機（請參閱驗證 SSH 主機密鑰）。

如需調整，請從 Weblate 管理介面進行：

Weblate SSH 密鑰#

在 4.17 版本變更: Weblate now generates both RSA and Ed25519 SSH keys. Using Ed25519 is recommended for new setups.

Weblate 公鑰對瀏覽 About 頁面的所有使用者可見。

管理員可以在管理界面登錄頁面的連接部分（從 SSH keys）生成或顯示 Weblate 當前使用的公共密鑰。

備註

相應的私有 SSH 密鑰當前無法使用密碼，因此請確保已受到良好的保護。

提示

對生成的私有 Weblate SSH 密鑰進行備份。

驗證 SSH 主機密鑰#

Weblate 在第一次訪問時自動存儲SSH主機密鑰，並記住它們以備將來使用。

如果要在連接到倉儲之前對密鑰指紋進行驗證，請從管理界面的同一部分 :guilabel: 『 add host key 『添加您要訪問的服務器的 SSH 主機密鑰。輸入您要訪問的主機名（例如 gitlab.com），然後按 Submit。驗證其指紋與您添加的服務器匹配。

帶指紋的添加鍵顯示在確認消息中：

GitHub repositories#

可以訪問通過SSH（參見:ref:`SSH-REPOS），但在需要訪問多個存儲庫的情況下，您將在允許的SSH密鑰使用情況下擊中GitHub限制（因為每個鍵只能使用一次）。

如果:ref:`component-push_branch`未設置，則項目被叉，並通過叉子推出的變化。如果設置，則將更改推送到上游存儲庫和所選分支。

對於較小的部署，請使用HTTPS身份驗證使用個人訪問令牌和GitHub帳戶，參見“創建用於命令行使用”的訪問令牌。

對於更大的設置，通常更好地為Web2RETE創建專用使用者，將其分配它在Webleate中生成的公共SSH密鑰（請參閱：Ref：“WebLate-Ssh-key`）並授予您訪問要轉換的所有存儲庫的訪問權限。這種方法也用於託管的Weberate，有專門的：圭冊：“WebLate”使用者為此。

也參考

從託管的Weberate訪問存儲庫

Weblate internal URLs#

通過引用其放置在不同組件之間共享一個存儲庫設置，作為其他（鏈接）組件的“Web2：// Project / Component``”這種方式鏈接組件使用Main（參考）組件的VCS存儲庫配置。

警告

刪除主組件也會刪除鏈接組件。

如果在創建組件時，WebBlate會自動調整存儲庫URL，如果它找到具有匹配的存儲庫設置的組件。您可以在組件配置的最後一步中覆蓋這一點。

Reasons to use this:

保存服務器上的磁盤空間，存儲庫僅存儲一次。
使更新更快，只更新一個存儲庫。
只有單一導出的存儲庫，具有WebLate翻譯（請參閱:ref:“Git-Exporter”）。
某些附加元件可以在共享一個存儲庫的多個組件上運行，例如匯併 Git 提交。

HTTPS repositories#

要訪問受保護的HTTPS存儲庫，請在URL中包含使用者名和密碼。別擔心，Webleate會在URL向使用者顯示URL時剝離此信息（如果允許查看存儲庫URL）。

例如，添加了具有身份驗證的GitHub URL可能看起來像：https：// user：your_access_token @ github.com / weblateorg / webbleate.git。

備註

如果您的使用者名或密碼包含特殊字符，那麼必須是URL編碼的，例如``https：//user%40example.com：％24password％23 @ bitbucket.org / …``。

Using proxy#

如果需要使用代理服務器訪問HTTP / HTTPS VCS存儲庫，請配置VCS以使用它。

這可以使用“http_proxy``”，“https_proxy``和```````````````````````````````或者通過在VCS配置中執行它，例如：

git config --global http.proxy http://user:password@proxy.example.com:80

備註

代理設定需要在使用者使用 Weblate 下完成設定。（參閱：文件系統權限）並設置 ``HOME=$DATA_DIR/home``（請參閱： DATA_DIR），否則 Weblate 將無法透過 Git 執行它。

也參考

curl manpage，`git配置文件<https://git-cm.com/docs/git-config>`_

Git#

提示

Weblate needs Git 2.12 or newer.

也參考

請參閱:ref:“VCS-REPOS”用於如何訪問不同類型的存儲庫的信息。

Git 使用強制推送#

這表現得比很像Git本身，唯一的區別是它總是強制推動。這僅在使用單獨的存儲庫進行翻譯的情況下。

警告

謹慎使用，因為這很容易導致上游存儲庫中的丟失。

Customizing Git configuration#

Web2Rate用“Home = $ Data_Dir / Home``”調用所有VCS命令（參見：設置：data_dir），因此需要在``data_dir / home / .git``中編輯使用者配置。

Git remote helpers#

您還可以使用Git`Reary Helpers`_另外支持其他版本控制系統，但準備好調試問題，這可能會導致。

此時，在Github上的單獨存儲庫中提供了Bazaar和Mercurial的助手：“Git-remote-Hg`_和`git-remote-bzr`_。手動下載並將其放在搜索路徑中（例如：文件：〜/ bin）。確保安裝了相應的版本控制系統。

安裝這些已安裝後，此類遙控器可用於在WebLate中指定存儲庫。

使用 Bazaar 來複製在 Launchpad 上的 gnuhello 專案

bzr::lp:gnuhello

為 hello 倉儲在 selenic.com 上使用 Mercurial

hg::http://selenic.com/repo/hello

警告

使用Git遠程幫助程序的不便例如使用Mercurial，遠程幫助器有時會在推送更改時創建新的提示。

GitHub pull requests#

這在：Ref：“GCS-Git”中添加了一個薄層：使用“github api`_”以允許將翻譯更改推換為拉請求，而不是直接推向存儲庫。

:ref:“VCS-GIT”將更改直接轉到存儲庫，而參考:ref:“VCS-GitHub”創建拉出請求。僅訪問Git存儲庫不需要後者。

You need to configure API credentials (GITHUB_CREDENTIALS) in the Weblate settings to make this work. Once configured, you will see a GitHub option when selecting 版本控制系統.

也參考

推送 Weblate 的更改, GITHUB_CREDENTIALS

GitLab 合併請求#

在 3.9 版本新加入.

這只需在:ref:“VCS-GIT”上使用“GITLAB API”_使用“GITLAB API”允許將翻譯更改為合併請求，而不是直接推送到存儲庫。

不需要將此用於訪問Git存儲庫，普通:ref:“VCS-GIT”運行相同，唯一的區別是如何處理推送存儲庫。使用:ref:“VCS-Git”更改直接推送到存儲庫，而ref：`vcs-gitlab`創建合併請求。

You need to configure API credentials (GITLAB_CREDENTIALS) in the Weblate settings to make this work. Once configured, you will see a GitLab option when selecting 版本控制系統.

也參考

推送 Weblate 的更改, GITLAB_CREDENTIALS

Gitea pull requests#

在 4.12 版本新加入.

This just adds a thin layer atop Git using the Gitea API to allow pushing translation changes as pull requests instead of pushing directly to the repository.

There is no need to use this to access Git repositories, ordinary Git works the same, the only difference is how pushing to a repository is handled. With Git changes are pushed directly to the repository, while Gitea pull requests creates pull requests.

You need to configure API credentials (GITEA_CREDENTIALS) in the Weblate settings to make this work. Once configured, you will see a Gitea option when selecting 版本控制系統.

也參考

推送 Weblate 的更改, GITEA_CREDENTIALS

Bitbucket Server pull requests#

在 4.16 版本新加入.

This just adds a thin layer atop Git using the Bitbucket Server API to allow pushing translation changes as pull requests instead of pushing directly to the repository.

警告

This does not support Bitbucket Cloud API.

You need to configure API credentials (BITBUCKETSERVER_CREDENTIALS) in the Weblate settings to make this work. Once configured, you will see a Bitbucket Server option when selecting 版本控制系統.

也參考

推送 Weblate 的更改, BITBUCKETSERVER_CREDENTIALS

Pagure 合併請求#

在 4.3.2 版本新加入.

這只是在：REF中添加了一個薄層:ref:`VCS-GIT`使用`PAGURE API`_允許將翻譯更改為合併請求，而不是直接推送到存儲庫。

不需要將此用於訪問Git存儲庫，普通:ref:“VCS-GIT”運行相同，唯一的區別是如何處理推送存儲庫。使用:ref:“VCS-Git”更改直接推向存儲庫，而參考:ref:“VCS-PAGURE”：“VCS-PAGURE”創建合併請求。

You need to configure API credentials (PAGURE_CREDENTIALS) in the Weblate settings to make this work. Once configured, you will see a Pagure option when selecting 版本控制系統.

也參考

推送 Weblate 的更改, PAGURE_CREDENTIALS

Gerrit#

使用 git-review 工具加入一層審查層 Git，如透過 Gerrit 審查所有推送來的翻譯變更，而不是將翻譯變更直接推送到專案倉儲。

GERRIT文件有關於設置此類存儲庫所需的配置的詳細信息。

Mercurial#

Mercurial是另一個您可以直接在Webleate中使用的VC。

備註

它應該與任何Mercurial版本合作，但有時對命令行界面有時不兼容，可打破WebBlate集成。

也參考

請參閱:ref:“VCS-REPOS”用於如何訪問不同類型的存儲庫的信息。

Subversion#

Weberate使用`git-svn`_與`subversion`_存儲庫進行交互。它是一個perl腳本，它允許git客戶端使用subversion，使使用者能夠維護內部存儲庫的完整克隆並在本地提交。

備註

WebLate嘗試自動檢測Subversion存儲庫佈局 - 它支持具有標準佈局的分支或存儲庫的直接URL（分支/，標記/和中繼/）。有關此內容的更多信息將在“git-svn文件<https://git-scm.com/docs/git-svn#documentation/git-svn.txt—-tdlayout>`_中找到。如果您的存儲庫沒有標準佈局並且您遇到錯誤，請嘗試在存儲庫URL中包含分支名稱並將分支為空。

Subversion credentials#

Weberate希望您在前面接受證書（如果需要，您的憑據）。它將查看將它們插入：設置：data_dir`目錄。使用“SVN”（使用“$ HOME”環境變量設置為：設置：`DATA_DIR：

# Use DATA_DIR as configured in Weblate settings.py, it is /app/data in the Docker
HOME=${DATA_DIR}/home svn co https://svn.example.com/example

也參考

DATA_DIR

Local files#

Git#

提示

Underneath, this uses Git. It requires Git installed and allows you to switch to using Git natively with full history of your translations.

在 3.8 版本新加入.

Webleate也可以在沒有遠程VCS的情況下運行。通過上傳它們導入初始翻譯。稍後您可以通過文件上載替換單個文件，或直接從Weberate添加轉換字串（目前僅適用於單語翻譯）。

在後台，WebBlate為您創建一個Git存儲庫，並跟踪所有更改。如果您稍後決定使用VCS存儲翻譯，則您已經在Webleate中擁有存儲庫可以基於您的集成。

Weblate 的 REST API#

API 可以在 /api/ URL上訪問，並且它基於 Django REST framework。您可以直接使用或參考 Weblate 客戶端。

身份驗證和通用參數#

公共項目 API 不需要身份驗證就可用，儘管沒有身份驗證的請求導致嚴重的瓶頸（預設每天 100 個請求），所以推薦使用身份驗證。身份驗證使用令牌，這可以在您的簡介中得到。在 Authorization 標頭中使用它：

ANY /#

對於 API的普通請求行為，標頭、狀態編碼和參數在這裡也應用於所有端點。

查詢參數:

format – 響應格式（覆蓋了 Accept）。可能的值依賴於 REST 框架設置，預設支持 json 和 api。後者為 API 提供了 web 瀏覽器接口。
page – Returns given page of paginated results (use next and previous fields in response to automate the navigation).

請求標頭:

Accept – 相應內容的類型依賴於 Accept 標頭
Authorization – optional token to authenticate as Authorization: Token YOUR-TOKEN

響應標頭:

Content-Type – 這依賴於請求的標頭 Accept
Allow – 對象允許的 HTTP 方法的列表

Response JSON Object:

detail (string) – 結果的詳細描述（對於 200 OK 以外的 HTTP 狀態編碼）
count (int) – 對象列表的總項目計數
next (string) – 對象列表的下一頁 URL
previous (string) – 對象列表的上一頁 URL
results (array) – 對象列表的結果
url (string) – 使用 API 訪問這個資源的 URL
web_url (string) – 使用瀏覽器訪問這個資源的 URL

狀態編碼:

200 OK – 當請求被正確地處理時
201 Created – 當成功創建新對象時
204 No Content – 當一個對象成功刪除時
400 Bad Request – 當缺少表格參數時
403 Forbidden – 當訪問被拒絕時
429 Too Many Requests – 當出現瓶頸時

Authentication tokens#

在 4.10 版本變更: Project scoped tokens were introduced in the 4.10 release.

Each user has his personal access token which can be obtained in the user profile. Newly generated user tokens have the wlu_ prefix.

It is possible to create project scoped tokens for API access to given project only. These tokens can be identified by the wlp_ prefix.

身份驗證的例子#

示例請求：

GET /api/ HTTP/1.1
Host: example.com
Accept: application/json, text/javascript
Authorization: Token YOUR-TOKEN

示例響應：

HTTP/1.0 200 OK
Date: Fri, 25 Mar 2016 09:46:12 GMT
Server: WSGIServer/0.1 Python/2.7.11+
Vary: Accept, Accept-Language, Cookie
X-Frame-Options: SAMEORIGIN
Content-Type: application/json
Content-Language: en
Allow: GET, HEAD, OPTIONS

{
    "projects":"http://example.com/api/projects/",
    "components":"http://example.com/api/components/",
    "translations":"http://example.com/api/translations/",
    "languages":"http://example.com/api/languages/"
}

CURL 示例：

curl \
    -H "Authorization: Token TOKEN" \
    https://example.com/api/

Passing Parameters Examples#

對於 POST 方法，參數可以指定為表格提交（application/x-www-form-urlencoded）或 JSON （application/json）。

Form request example:

POST /api/projects/hello/repository/ HTTP/1.1
Host: example.com
Accept: application/json
Content-Type: application/x-www-form-urlencoded
Authorization: Token TOKEN

operation=pull

JSON request example:

POST /api/projects/hello/repository/ HTTP/1.1
Host: example.com
Accept: application/json
Content-Type: application/json
Authorization: Token TOKEN
Content-Length: 20

{"operation":"pull"}

CURL 示例：

curl \
    -d operation=pull \
    -H "Authorization: Token TOKEN" \
    http://example.com/api/components/hello/weblate/repository/

CURL JSON example:

curl \
    --data-binary '{"operation":"pull"}' \
    -H "Content-Type: application/json" \
    -H "Authorization: Token TOKEN" \
    http://example.com/api/components/hello/weblate/repository/

API 頻次限制#

這個 API 請求限制了速率；對於匿名使用者預設配置限制為每天 100 個請求，對於身份驗證的使用者限制為每小時 5000 個請求。

速率限制可以在:file:settings.py 中調整；如何配置它的更多細節請參見`Throttling in Django REST framework documentation <https://www.django-rest-framework.org/api-guide/ throttling/>`_。

In the Docker container this can be configured using WEBLATE_API_RATELIMIT_ANON and WEBLATE_API_RATELIMIT_USER.

速率限制在後面的標頭中報告：

`X-RateLimit-Limit`	要執行的對速率限制進行限制的請求
`X-RateLimit-Remaining`	保持限制的請求
`X-RateLimit-Reset`	直到速率限制窗口重置時的秒數

在 4.1 版本變更: 添加速率限制狀態的標頭。

也參考

頻次限制, 頻次限制, WEBLATE_API_RATELIMIT_ANON, WEBLATE_API_RATELIMIT_USER

API Entry Point#

GET /api/#

API 根入口點。

示例請求：

GET /api/ HTTP/1.1
Host: example.com
Accept: application/json, text/javascript
Authorization: Token YOUR-TOKEN

示例響應：

HTTP/1.0 200 OK
Date: Fri, 25 Mar 2016 09:46:12 GMT
Server: WSGIServer/0.1 Python/2.7.11+
Vary: Accept, Accept-Language, Cookie
X-Frame-Options: SAMEORIGIN
Content-Type: application/json
Content-Language: en
Allow: GET, HEAD, OPTIONS

{
    "projects":"http://example.com/api/projects/",
    "components":"http://example.com/api/components/",
    "translations":"http://example.com/api/translations/",
    "languages":"http://example.com/api/languages/"
}

使用者#

在 4.0 版本新加入.

GET /api/users/#: 返回使用者列表，如果有權限查看管理使用者的話。如果沒有，那麼會只看到自己的具體信息。

也參考

使用者對象屬性被歸檔在 GET /api/users/(str:username)/。

POST /api/users/#

創建新使用者。

參數值:

username (string) – 使用者名稱
full_name (string) – User full name
email (string) – 使用者電子郵箱
is_superuser (boolean) – 使用者是超級使用者嗎？（可選的）
is_active (boolean) – 使用者是活動使用者嗎？（可選的）
is_bot (boolean) – Is user bot? (optional) (used for project scoped tokens)

GET /api/users/(str: username)/#

返回使用者的信息。

參數值:

username (string) – 使用者的使用者名

Response JSON Object:

username (string) – 使用者的使用者名
full_name (string) – 使用者的全名
email (string) – 使用者的電子郵箱
is_superuser (boolean) – 使用者是否是超級使用者
is_active (boolean) – 使用者是否是活動使用者
is_bot (boolean) – whether the user is bot (used for project scoped tokens)
date_joined (string) – 創建使用者的日期
groups (array) – 連接到關聯的組；請參見 GET /api/groups/(int:id)/

Example JSON data:

{
    "email": "user@example.com",
    "full_name": "Example User",
    "username": "exampleusername",
    "groups": [
        "http://example.com/api/groups/2/",
        "http://example.com/api/groups/3/"
    ],
    "is_superuser": true,
    "is_active": true,
    "is_bot": false,
    "date_joined": "2020-03-29T18:42:42.617681Z",
    "url": "http://example.com/api/users/exampleusername/",
    "statistics_url": "http://example.com/api/users/exampleusername/statistics/"
}

PUT /api/users/(str: username)/#

更改使用者參數。

參數值:

username (string) – 使用者的使用者名

Response JSON Object:

username (string) – 使用者的使用者名
full_name (string) – 使用者的全名
email (string) – 使用者的電子郵箱
is_superuser (boolean) – 使用者是否是超級使用者
is_active (boolean) – 使用者是否是活動使用者
is_bot (boolean) – whether the user is bot (used for project scoped tokens)
date_joined (string) – 創建使用者的日期

PATCH /api/users/(str: username)/#

更改使用者參數。

參數值:

username (string) – 使用者的使用者名

Response JSON Object:

username (string) – 使用者的使用者名
full_name (string) – 使用者的全名
email (string) – 使用者的電子郵箱
is_superuser (boolean) – 使用者是否是超級使用者
is_active (boolean) – 使用者是否是活動使用者
is_bot (boolean) – whether the user is bot (used for project scoped tokens)
date_joined (string) – 創建使用者的日期

DELETE /api/users/(str: username)/#

刪除所有的使用者信息並將使用者標記為不活動使用者。

參數值:

username (string) – 使用者的使用者名

POST /api/users/(str: username)/groups/#

將群組與使用者關聯。

參數值:

username (string) – 使用者的使用者名

表格參數:

string group_id – 唯一的群組 ID

DELETE /api/users/(str: username)/groups/#

在 4.13.1 版本新加入.

Remove user from a group.

參數值:

username (string) – 使用者的使用者名

表格參數:

string group_id – 唯一的群組 ID

GET /api/users/(str: username)/statistics/#

使用者的統計數據列表。

參數值:

username (string) – 使用者的使用者名

Response JSON Object:

translated (int) – Number of translations by user
suggested (int) – Number of suggestions by user
uploaded (int) – Number of uploads by user
commented (int) – Number of comments by user
languages (int) – Number of languages user can translate

GET /api/users/(str: username)/notifications/#

使用者的訂閱列表。

參數值:

username (string) – 使用者的使用者名

POST /api/users/(str: username)/notifications/#

將訂閱與使用者關聯。

參數值:

username (string) – 使用者的使用者名

Request JSON Object:

notification (string) – 註冊通知的名稱
scope (int) – 來自可用選擇的通知範圍
frequency (int) – 通知的頻率選擇

GET /api/users/(str: username)/notifications/(int: subscription_id)/#

獲得與使用者關聯的訂閱。

參數值:

username (string) – 使用者的使用者名
subscription_id (int) – ID of notification registered

PUT /api/users/(str: username)/notifications/(int: subscription_id)/#

編輯與使用者關聯的訂閱。

參數值:

username (string) – 使用者的使用者名
subscription_id (int) – ID of notification registered

Request JSON Object:

notification (string) – 註冊通知的名稱
scope (int) – 來自可用選擇的通知範圍
frequency (int) – 通知的頻率選擇

PATCH /api/users/(str: username)/notifications/(int: subscription_id)/#

編輯與使用者關聯的訂閱。

參數值:

username (string) – 使用者的使用者名
subscription_id (int) – ID of notification registered

Request JSON Object:

notification (string) – 註冊通知的名稱
scope (int) – 來自可用選擇的通知範圍
frequency (int) – 通知的頻率選擇

DELETE /api/users/(str: username)/notifications/(int: subscription_id)/#

刪除與使用者關聯的訂閱。

參數值:

username (string) – 使用者的使用者名
subscription_id – 註冊通知的名稱
subscription_id – int

群組#

在 4.0 版本新加入.

GET /api/groups/#: 返回群組列表，如果有權限看到管理群組的話，如果沒有，那麼會只看到使用者所在的群組。

也參考

群組對象屬性歸檔在 GET /api/groups/(int:id)/。

POST /api/groups/#

創建新的群組。

參數值:

name (string) – 群組名稱
project_selection (int) – 給定選項的項目選擇的群組
language_selection (int) – 給定選項的語言選擇的群組
defining_project (str) – link to the defining project, used for 管理單一專案的存取控制; see GET /api/projects/(string:project)/

GET /api/groups/(int: id)/#

返回群組的信息。

參數值:

id (int) – 群組的 ID

Response JSON Object:

name (string) – 群組的名稱
project_selection (int) – 相應於對象群組的整數
language_selection (int) – 相應於語言群組的整數
roles (array) – 相關聯角色的連接；請參見 GET /api/roles/(int:id)/
projects (array) – 相關聯項目的連接；請參見 GET /api/projects/(string:project)/
components (array) – 相關聯組件的連接；請參見 GET /api/components/(string:project)/(string:component)/
componentlists (array) – 相關聯組件列表的連接；請參見 GET /api/component-lists/(str:slug)/
defining_project (str) – link to the defining project, used for 管理單一專案的存取控制; see GET /api/projects/(string:project)/

Example JSON data:

{
    "name": "Guests",
    "defining_project": null,
    "project_selection": 3,
    "language_selection": 1,
    "url": "http://example.com/api/groups/1/",
    "roles": [
        "http://example.com/api/roles/1/",
        "http://example.com/api/roles/2/"
    ],
    "languages": [
        "http://example.com/api/languages/en/",
        "http://example.com/api/languages/cs/",
    ],
    "projects": [
        "http://example.com/api/projects/demo1/",
        "http://example.com/api/projects/demo/"
    ],
    "componentlist": "http://example.com/api/component-lists/new/",
    "components": [
        "http://example.com/api/components/demo/weblate/"
    ]
}

PUT /api/groups/(int: id)/#

更改群組參數。

參數值:

id (int) – 群組的 ID

Response JSON Object:

name (string) – 群組的名稱
project_selection (int) – 相應於對象群組的整數
language_selection (int) – 相應於語言群組的整數

PATCH /api/groups/(int: id)/#

更改群組參數。

參數值:

id (int) – 群組的 ID

Response JSON Object:

name (string) – 群組的名稱
project_selection (int) – 相應於對象群組的整數
language_selection (int) – 相應於語言群組的整數

DELETE /api/groups/(int: id)/#

Deletes the group.

參數值:

id (int) – 群組的 ID

POST /api/groups/(int: id)/roles/#

將角色與群組關聯。

參數值:

id (int) – 群組的 ID

表格參數:

string role_id – 唯一的角色 ID

POST /api/groups/(int: id)/components/#

將組件與群組關聯。

參數值:

id (int) – 群組的 ID

表格參數:

string component_id – 唯一的組件 ID

DELETE /api/groups/(int: id)/components/(int: component_id)#

從群組刪除組件。

參數值:

id (int) – 群組的 ID
component_id (int) – 唯一的組件 ID

POST /api/groups/(int: id)/projects/#

將項目與群組關聯。

參數值:

id (int) – 群組的 ID

表格參數:

string project_id – 唯一的項目 ID

DELETE /api/groups/(int: id)/projects/(int: project_id)#

從群組刪除項目。

參數值:

id (int) – 群組的 ID
project_id (int) – 唯一的項目 ID

POST /api/groups/(int: id)/languages/#

將語言與群組關聯。

參數值:

id (int) – 群組的 ID

表格參數:

string language_code – 唯一的語言代碼

DELETE /api/groups/(int: id)/languages/(string: language_code)#

從群組刪除語言。

參數值:

id (int) – 群組的 ID
language_code (string) – 唯一的語言代碼

POST /api/groups/(int: id)/componentlists/#

將組件列表與群組關聯。

參數值:

id (int) – 群組的 ID

表格參數:

string component_list_id – 唯一的組件列表 ID

DELETE /api/groups/(int: id)/componentlists/(int: component_list_id)#

從群組刪除組件列表。

參數值:

id (int) – 群組的 ID
component_list_id (int) – 唯一的組件列表 ID

角色#

GET /api/roles/#: 返回與使用者關聯的所有角色列表。如果使用者是超級使用者，那麼返回所有現有角色的列表。

也參考

角色對象屬性歸檔在 GET /api/roles/(int:id)/。

POST /api/roles/#

創建新角色。

參數值:

name (string) – 角色名稱
permissions (array) – 權限編碼名稱的列表

GET /api/roles/(int: id)/#

返回角色的信息。

參數值:

id (int) – 角色 ID

Response JSON Object:

name (string) – 角色名稱
permissions (array) – 權限編碼名稱的列表

Example JSON data:

{
    "name": "Access repository",
    "permissions": [
        "vcs.access",
        "vcs.view"
    ],
    "url": "http://example.com/api/roles/1/",
}

PUT /api/roles/(int: id)/#

更改角色參數。

參數值:

id (int) – 角色的ID

Response JSON Object:

name (string) – 角色名稱
permissions (array) – 權限編碼名稱的列表

PATCH /api/roles/(int: id)/#

更改角色參數。

參數值:

id (int) – 角色的ID

Response JSON Object:

name (string) – 角色名稱
permissions (array) – 權限編碼名稱的列表

DELETE /api/roles/(int: id)/#

Deletes the role.

參數值:

id (int) – 角色的ID

語言#

GET /api/languages/#: 返回所有語言的列表。

也參考

語言對象屬性存檔在 GET /api/languages/(string:language)/。

POST /api/languages/#

創建新的語言。

參數值:

code (string) – 語言名稱
name (string) – 語言名稱
direction (string) – 文字方向
population (int) – 語言使用者數量
plural (object) – 語言複數形式與數字

GET /api/languages/(string: language)/#

返回語言的信息。

參數值:

language (string) – 語言碼

Response JSON Object:

code (string) – 語言碼
direction (string) – 文字方向
plural (object) – 語言複數信息的對象
aliases (array) – 語言別名的數組

Request JSON Object:

population (int) – 語言使用者數量

Example JSON data:

{
    "code": "en",
    "direction": "ltr",
    "name": "English",
    "population": 159034349015,
    "plural": {
        "id": 75,
        "source": 0,
        "number": 2,
        "formula": "n != 1",
        "type": 1
    },
    "aliases": [
        "english",
        "en_en",
        "base",
        "source",
        "eng"
    ],
    "url": "http://example.com/api/languages/en/",
    "web_url": "http://example.com/languages/en/",
    "statistics_url": "http://example.com/api/languages/en/statistics/"
}

PUT /api/languages/(string: language)/#

更改語言參數。

參數值:

language (string) – 語言的編碼

Request JSON Object:

name (string) – 語言名稱
direction (string) – 文字方向
population (int) – 語言使用者數量
plural (object) – Language plural details

PATCH /api/languages/(string: language)/#

更改語言參數。

參數值:

language (string) – 語言的編碼

Request JSON Object:

name (string) – 語言名稱
direction (string) – 文字方向
population (int) – 語言使用者數量
plural (object) – Language plural details

DELETE /api/languages/(string: language)/#

Deletes the language.

參數值:

language (string) – 語言的編碼

GET /api/languages/(string: language)/statistics/#

返回語言的統計數據。

參數值:

language (string) – 語言碼

Response JSON Object:

total (int) – 字串的總數
total_words (int) – 詞的總數
last_change (timestamp) – 語言的上一次更改
recent_changes (int) – 更改的總數
translated (int) – 已翻譯的字串數量
translated_percent (float) – 已翻譯字串的百分比
translated_words (int) – 已翻譯詞的數量
translated_words_percent (int) – 已翻譯詞的百分比
translated_chars (int) – 已翻譯字符的數量
translated_chars_percent (int) – 已翻譯字符的百分比
total_chars (int) – 總字符的數量
fuzzy (int) – number of fuzzy (marked for edit) strings
fuzzy_percent (int) – 模糊字串（標記為需要編輯）的百分比
failing (int) – 失敗字串的數量
failing – 失敗字串的百分比

專案#

GET /api/projects/#: 返回所有項目的列表。

也參考

項目對象的屬性存檔在 GET /api/projects/(string:project)/。

POST /api/projects/#

在 3.9 版本新加入.

創建新項目。

參數值:

name (string) – 專案名稱
slug (string) – 項目標識串
web (string) – 專案網站

GET /api/projects/(string: project)/#

返回項目的信息。

參數值:

project (string) – 專案 URL slug

Response JSON Object:

name (string) – 專案名稱
slug (string) – 項目標識串
web (string) – 項目網站
components_list_url (string) – 組件列表的 URL；請參見 GET /api/projects/(string:project)/components/
repository_url (string) – 倉儲狀態的 URL；請參見 GET /api/projects/(string:project)/repository/
changes_list_url (string) – 更改列表的 URL；請參見 GET /api/projects/(string:project)/repository/
translation_review (boolean) – 啟用檢閱
source_review (boolean) – 啟用來源檢閱
set_language_team (boolean) – 設定「Language-Team」檔案標頭
enable_hooks (boolean) – 啟用掛勾
instructions (string) – 翻譯指示
language_aliases (string) – 語言別名

Example JSON data:

{
    "name": "Hello",
    "slug": "hello",
    "url": "http://example.com/api/projects/hello/",
    "web": "https://weblate.org/",
    "web_url": "http://example.com/projects/hello/"
}

PATCH /api/projects/(string: project)/#

在 4.3 版本新加入.

透過 PATCH 請求來編輯一個專案。

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug

PUT /api/projects/(string: project)/#

在 4.3 版本新加入.

透過 PUT 請求來編輯一個專案。

參數值:

project (string) – 專案 URL slug

DELETE /api/projects/(string: project)/#

在 3.9 版本新加入.

Deletes a project.

參數值:

project (string) – 專案 URL slug

GET /api/projects/(string: project)/changes/#

返回項目更改的列表。這本質上是仔細檢查的項目 GET /api/changes/ 接收相同的參數。

參數值:

project (string) – 專案 URL slug

Response JSON Object:

results (array) – 組件對象的矩陣；請參見 GET /api/changes/(int:id)/

GET /api/projects/(string: project)/repository/#

返回版本控制系統（VCS）倉儲狀態的信息。這個端點只包含項目所有倉儲的整體概況。為了得到更多細節，請使用 GET /api/components/(string:project)/(string:component)/repository/。

參數值:

project (string) – 專案 URL slug

Response JSON Object:

needs_commit (boolean) – 是否有待定的更改要提交
needs_merge (boolean) – 是否有上游更改要合併
needs_push (boolean) – 是否有本地更改要推送

Example JSON data:

{
    "needs_commit": true,
    "needs_merge": false,
    "needs_push": true
}

POST /api/projects/(string: project)/repository/#

在版本控制系統（VCS）倉儲上執行給定的操作。

參數值:

project (string) – 專案 URL slug

Request JSON Object:

operation (string) – 要執行的操作: one of push, pull, commit, reset, cleanup, file-sync

Response JSON Object:

result (boolean) – 操作的結果

CURL 示例：

curl \
    -d operation=pull \
    -H "Authorization: Token TOKEN" \
    http://example.com/api/projects/hello/repository/

JSON request example:

POST /api/projects/hello/repository/ HTTP/1.1
Host: example.com
Accept: application/json
Content-Type: application/json
Authorization: Token TOKEN
Content-Length: 20

{"operation":"pull"}

JSON response example:

HTTP/1.0 200 OK
Date: Tue, 12 Apr 2016 09:32:50 GMT
Server: WSGIServer/0.1 Python/2.7.11+
Vary: Accept, Accept-Language, Cookie
X-Frame-Options: SAMEORIGIN
Content-Type: application/json
Content-Language: en
Allow: GET, POST, HEAD, OPTIONS

{"result":true}

GET /api/projects/(string: project)/components/#

返回給定項目的翻譯組件列表。

參數值:

project (string) – 專案 URL slug

Response JSON Object:

results (array) – 組件對象的矩陣；請參見 GET /api/components/(string:project)/(string:component)/

POST /api/projects/(string: project)/components/#

在 3.9 版本新加入.

在 4.3 版本變更: zipfile 和 docfile 參數現在可被無 VCS 的組件所接受，見 Local files.

在 4.6 版本變更: 克隆的存儲庫現在使用:ref:“內部URL”，現在自動在項目中自動共享。使用``isable_autoshare``關閉。

在給定的項目中新建翻譯組件。

提示

使用:ref:從單個VCS存儲庫創建多個組件時的“內部URL”。

備註

多數組件的新建發生在後台。檢查新建組件的 task_url 屬性，並按照那裡的步驟進行。

參數值:

project (string) – 專案 URL slug

表格參數:

file zipfile – 上傳到 Weblate 用於翻譯初始化的 ZIP 文件
file docfile – 要翻譯的文件
boolean disable_autoshare – 禁用自動存儲庫共享:ref:“內部URL”。

Request JSON Object:

object – Component parameters, see GET /api/components/(string:project)/(string:component)/

Response JSON Object:

result (object) – 新建組件對象；請參見 GET /api/components/(string:project)/(string:component)/

使用“ZipFile``和````````````````````````）無法使用JSON。數據必須上傳為：MimeType：multipart / form-data。

CURL form request example:

curl \
    --form docfile=@strings.html \
    --form name=Weblate \
    --form slug=weblate \
    --form file_format=html \
    --form new_lang=add \
    -H "Authorization: Token TOKEN" \
    http://example.com/api/projects/hello/components/

CURL JSON request example:

curl \
    --data-binary '{
        "branch": "main",
        "file_format": "po",
        "filemask": "po/*.po",
        "name": "Weblate",
        "slug": "weblate",
        "repo": "https://github.com/WeblateOrg/hello.git",
        "template": "",
        "new_base": "po/hello.pot",
        "vcs": "git"
    }' \
    -H "Content-Type: application/json" \
    -H "Authorization: Token TOKEN" \
    http://example.com/api/projects/hello/components/

JSON request to create a new component from Git:

POST /api/projects/hello/components/ HTTP/1.1
Host: example.com
Accept: application/json
Content-Type: application/json
Authorization: Token TOKEN
Content-Length: 20

{
    "branch": "main",
    "file_format": "po",
    "filemask": "po/*.po",
    "name": "Weblate",
    "slug": "weblate",
    "repo": "https://github.com/WeblateOrg/hello.git",
    "template": "",
    "new_base": "po/hello.pot",
    "vcs": "git"
}

JSON request to create a new component from another one:

POST /api/projects/hello/components/ HTTP/1.1
Host: example.com
Accept: application/json
Content-Type: application/json
Authorization: Token TOKEN
Content-Length: 20

{
    "file_format": "po",
    "filemask": "po/*.po",
    "name": "Weblate",
    "slug": "weblate",
    "repo": "weblate://weblate/hello",
    "template": "",
    "new_base": "po/hello.pot",
    "vcs": "git"
}

JSON response example:

HTTP/1.0 200 OK
Date: Tue, 12 Apr 2016 09:32:50 GMT
Server: WSGIServer/0.1 Python/2.7.11+
Vary: Accept, Accept-Language, Cookie
X-Frame-Options: SAMEORIGIN
Content-Type: application/json
Content-Language: en
Allow: GET, POST, HEAD, OPTIONS

{
    "branch": "main",
    "file_format": "po",
    "filemask": "po/*.po",
    "git_export": "",
    "license": "",
    "license_url": "",
    "name": "Weblate",
    "slug": "weblate",
    "project": {
        "name": "Hello",
        "slug": "hello",
        "source_language": {
            "code": "en",
            "direction": "ltr",
             "population": 159034349015,
            "name": "English",
            "url": "http://example.com/api/languages/en/",
            "web_url": "http://example.com/languages/en/"
        },
        "url": "http://example.com/api/projects/hello/",
        "web": "https://weblate.org/",
        "web_url": "http://example.com/projects/hello/"
    },
    "repo": "file:///home/nijel/work/weblate-hello",
    "template": "",
    "new_base": "",
    "url": "http://example.com/api/components/hello/weblate/",
    "vcs": "git",
    "web_url": "http://example.com/projects/hello/weblate/"
}

GET /api/projects/(string: project)/languages/#

對項目內的所有語言返回編頁的統計數據。

在 3.8 版本新加入.

參數值:

project (string) – 專案 URL slug

Response JSON Object:

results (array) – 翻譯統計數據對象的矩陣
language (string) – 語言名稱
code (string) – 語言代碼
total (int) – 字串的總數
translated (int) – 已翻譯的字串數量
translated_percent (float) – 已翻譯字串的百分比
total_words (int) – 詞的總數
translated_words (int) – 已翻譯詞的數量
words_percent (float) – 已翻譯詞的百分比

GET /api/projects/(string: project)/statistics/#

返回項目的統計數據。

在 3.8 版本新加入.

參數值:

project (string) – 專案 URL slug

Response JSON Object:

total (int) – 字串的總數
translated (int) – 已翻譯的字串數量
translated_percent (float) – 已翻譯字串的百分比
total_words (int) – 詞的總數
translated_words (int) – 已翻譯詞的數量
words_percent (float) – 已翻譯詞的百分比

組件#

提示

Use POST /api/projects/(string:project)/components/ to create new components.

GET /api/components/#: 返回翻譯組件的列表。

也參考

組件對象屬性存檔在 GET /api/components/(string:project)/(string:component)/。

GET /api/components/(string: project)/(string: component)/#

返回翻譯組件的信息。

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug

Response JSON Object:

project (object) – 翻譯項目；請參見 GET /api/projects/(string:project)/
name (string) – 組件名稱
slug (string) – 組件標識串
vcs (string) – 版本控制系統
repo (string) – 源始碼倉儲
git_export (string) – 已匯出倉儲 URL
branch (string) – 倉儲分支
push_branch (string) – 推送分支
filemask (string) – 文件掩碼
template (string) – 單語的基底語言檔
edit_template (string) – 編輯基底檔
intermediate (string) – 中間語言檔案
new_base (string) – 新翻譯的模板
file_format (string) – 檔案格式
license (string) – 翻譯授權條款
agreement (string) – 貢獻者協議書
new_lang (string) – 加入新翻譯
language_code_style (string) – 語言代碼類型
source_language (object) – 源語言對象；請參見 GET /api/languages/(string:language)/
push (string) – 倉儲推送 URL
check_flags (string) – 翻譯旗標
priority (string) – 優先度
enforced_checks (string) – 強制查核
restricted (string) – 受限制的訪問
repoweb (string) – 倉儲瀏覽器
report_source_bugs (string) – 來源字串臭蟲回報位址
merge_style (string) – 合併類型
commit_message (string) – Commit, add, delete, merge, add-on, and merge request messages
add_message (string) – Commit, add, delete, merge, add-on, and merge request messages
delete_message (string) – Commit, add, delete, merge, add-on, and merge request messages
merge_message (string) – Commit, add, delete, merge, add-on, and merge request messages
addon_message (string) – Commit, add, delete, merge, add-on, and merge request messages
pull_message (string) – Commit, add, delete, merge, add-on, and merge request messages
allow_translation_propagation (string) – 允許翻譯再用
enable_suggestions (string) – 啟用建議
suggestion_voting (string) – 建議投票
suggestion_autoaccept (string) – 自動接受建議
push_on_commit (string) – 提交時一併推送
commit_pending_age (string) – 更動後提交的經過時間
auto_lock_error (string) – 有錯誤時鎖定
language_regex (string) – 語言篩選
variant_regex (string) – 變體的正則表達式
repository_url (string) – 倉儲狀態的 URL；請參見 GET /api/components/(string:project)/(string:component)/repository/
translations_url (string) – 翻譯列表的 URL；請參見 GET /api/components/(string:project)/(string:component)/translations/
lock_url (string) – 鎖定狀態的 URL；請參見 GET /api/components/(string:project)/(string:component)/lock/
changes_list_url (string) – 更改的列表的 URL；請參見 GET /api/components/(string:project)/(string:component)/changes/
task_url (string) – 後台任務 URL （如果有的話）；請參見 GET /api/tasks/(str:uuid)/

Example JSON data:

{
    "branch": "main",
    "file_format": "po",
    "filemask": "po/*.po",
    "git_export": "",
    "license": "",
    "license_url": "",
    "name": "Weblate",
    "slug": "weblate",
    "project": {
        "name": "Hello",
        "slug": "hello",
        "source_language": {
            "code": "en",
            "direction": "ltr",
             "population": 159034349015,
            "name": "English",
            "url": "http://example.com/api/languages/en/",
            "web_url": "http://example.com/languages/en/"
        },
        "url": "http://example.com/api/projects/hello/",
        "web": "https://weblate.org/",
        "web_url": "http://example.com/projects/hello/"
    },
    "source_language": {
        "code": "en",
        "direction": "ltr",
        "population": 159034349015,
        "name": "English",
        "url": "http://example.com/api/languages/en/",
        "web_url": "http://example.com/languages/en/"
    },
    "repo": "file:///home/nijel/work/weblate-hello",
    "template": "",
    "new_base": "",
    "url": "http://example.com/api/components/hello/weblate/",
    "vcs": "git",
    "web_url": "http://example.com/projects/hello/weblate/"
}

PATCH /api/components/(string: project)/(string: component)/#

透過 PATCH 請求來編輯一個組件。

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug
source_language (string) – 項目源語言代碼（可選）

Request JSON Object:

name (string) – name of component
slug (string) – slug of component
repo (string) – VCS repository URL

CURL 示例：

curl \
    --data-binary '{"name": "new name"}' \
    -H "Content-Type: application/json" \
    -H "Authorization: Token TOKEN" \
    PATCH http://example.com/api/projects/hello/components/

JSON request example:

PATCH /api/projects/hello/components/ HTTP/1.1
Host: example.com
Accept: application/json
Content-Type: application/json
Authorization: Token TOKEN
Content-Length: 20

{
    "name": "new name"
}

JSON response example:

HTTP/1.0 200 OK
Date: Tue, 12 Apr 2016 09:32:50 GMT
Server: WSGIServer/0.1 Python/2.7.11+
Vary: Accept, Accept-Language, Cookie
X-Frame-Options: SAMEORIGIN
Content-Type: application/json
Content-Language: en
Allow: GET, POST, HEAD, OPTIONS

{
    "branch": "main",
    "file_format": "po",
    "filemask": "po/*.po",
    "git_export": "",
    "license": "",
    "license_url": "",
    "name": "new name",
    "slug": "weblate",
    "project": {
        "name": "Hello",
        "slug": "hello",
        "source_language": {
            "code": "en",
            "direction": "ltr",
            "population": 159034349015,
            "name": "English",
            "url": "http://example.com/api/languages/en/",
            "web_url": "http://example.com/languages/en/"
        },
        "url": "http://example.com/api/projects/hello/",
        "web": "https://weblate.org/",
        "web_url": "http://example.com/projects/hello/"
    },
    "repo": "file:///home/nijel/work/weblate-hello",
    "template": "",
    "new_base": "",
    "url": "http://example.com/api/components/hello/weblate/",
    "vcs": "git",
    "web_url": "http://example.com/projects/hello/weblate/"
}

PUT /api/components/(string: project)/(string: component)/#

透過 PUT 請求來編輯一個組件。

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug

Request JSON Object:

branch (string) – VCS repository branch
file_format (string) – 翻譯的文件格式
filemask (string) – 倉儲中翻譯的文件掩碼
name (string) – name of component
slug (string) – slug of component
repo (string) – VCS repository URL
template (string) – 但語言翻譯的譯文模板文件
new_base (string) – 用於添加新翻譯的譯文模板文件
vcs (string) – version control system

DELETE /api/components/(string: project)/(string: component)/#

在 3.9 版本新加入.

Deletes a component.

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug

GET /api/components/(string: project)/(string: component)/changes/#

返回組件更改的列表。這本質上是仔細檢查的組件 :http:get:`/api/changes/`接相同參數。

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug

Response JSON Object:

results (array) – 組件對象的矩陣；請參見 GET /api/changes/(int:id)/

GET /api/components/(string: project)/(string: component)/file/#

在 4.9 版本新加入.

Downloads all available translations associated with the component as an archive file using the requested format.

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug

查詢參數:

format (string) – The archive format to use; If not specified, defaults to zip; Supported formats: zip

GET /api/components/(string: project)/(string: component)/screenshots/#

返回組件屏幕截圖的列表。

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug

Response JSON Object:

results (array) – 組件屏幕截圖的矩陣；請參見 GET /api/screenshots/(int:id)/

GET /api/components/(string: project)/(string: component)/lock/#

返回組件鎖定狀態。

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug

Response JSON Object:

locked (boolean) – 組件是否因更新而鎖定

Example JSON data:

{
    "locked": false
}

POST /api/components/(string: project)/(string: component)/lock/#

設置組件鎖定狀態。

響應時間與 :http:get:`/api/components/(string:project)/(string:component)/lock/`相同。

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug

Request JSON Object:

lock – 是否鎖定的布爾值。

CURL 示例：

curl \
    -d lock=true \
    -H "Authorization: Token TOKEN" \
    http://example.com/api/components/hello/weblate/repository/

JSON request example:

POST /api/components/hello/weblate/repository/ HTTP/1.1
Host: example.com
Accept: application/json
Content-Type: application/json
Authorization: Token TOKEN
Content-Length: 20

{"lock": true}

JSON response example:

HTTP/1.0 200 OK
Date: Tue, 12 Apr 2016 09:32:50 GMT
Server: WSGIServer/0.1 Python/2.7.11+
Vary: Accept, Accept-Language, Cookie
X-Frame-Options: SAMEORIGIN
Content-Type: application/json
Content-Language: en
Allow: GET, POST, HEAD, OPTIONS

{"locked":true}

GET /api/components/(string: project)/(string: component)/repository/#

返回版本控制系統（VCS）倉儲狀態的信息。

響應與 GET /api/projects/(string:project)/repository/ 的相同。

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug

Response JSON Object:

needs_commit (boolean) – 是否有待定的更改要提交
needs_merge (boolean) – 是否有上游更改要合併
needs_push (boolean) – 是否有本地更改要推送
remote_commit (string) – Remote commit information
status (string) – 由版本控制系統（VCS）報告的 VCS 狀態
merge_failure – 描述合併失敗的文本，沒有的話為空

POST /api/components/(string: project)/(string: component)/repository/#

在版本控制系統（VCS）倉儲執行給定的操作。

文件請參見 POST /api/projects/(string:project)/repository/。

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug

Request JSON Object:

operation (string) – 執行的操作： push, pull, commit, reset, ``cleanup``之一

Response JSON Object:

result (boolean) – 操作的結果

CURL 示例：

curl \
    -d operation=pull \
    -H "Authorization: Token TOKEN" \
    http://example.com/api/components/hello/weblate/repository/

JSON request example:

POST /api/components/hello/weblate/repository/ HTTP/1.1
Host: example.com
Accept: application/json
Content-Type: application/json
Authorization: Token TOKEN
Content-Length: 20

{"operation":"pull"}

JSON response example:

HTTP/1.0 200 OK
Date: Tue, 12 Apr 2016 09:32:50 GMT
Server: WSGIServer/0.1 Python/2.7.11+
Vary: Accept, Accept-Language, Cookie
X-Frame-Options: SAMEORIGIN
Content-Type: application/json
Content-Language: en
Allow: GET, POST, HEAD, OPTIONS

{"result":true}

GET /api/components/(string: project)/(string: component)/monolingual_base/#

為單語言翻譯下載譯文模板文件。

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug

GET /api/components/(string: project)/(string: component)/new_template/#

為新的翻譯下載模板文件。

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug

GET /api/components/(string: project)/(string: component)/translations/#

返回給定組件中翻譯對象的列表。

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug

Response JSON Object:

results (array) – 翻譯對象的矩陣；請參見 GET /api/translations/(string:project)/(string:component)/(string:language)/

POST /api/components/(string: project)/(string: component)/translations/#

在給定組件中新建新的翻譯。

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug

Request JSON Object:

language_code (string) – 翻譯語言代碼；請參見 GET /api/languages/(string:language)/

Response JSON Object:

result (object) – 新建的新翻譯對象

CURL 示例：

curl \
    -d language_code=cs \
    -H "Authorization: Token TOKEN" \
    http://example.com/api/projects/hello/components/

JSON request example:

POST /api/projects/hello/components/ HTTP/1.1
Host: example.com
Accept: application/json
Content-Type: application/json
Authorization: Token TOKEN
Content-Length: 20

{"language_code": "cs"}

JSON response example:

HTTP/1.0 200 OK
Date: Tue, 12 Apr 2016 09:32:50 GMT
Server: WSGIServer/0.1 Python/2.7.11+
Vary: Accept, Accept-Language, Cookie
X-Frame-Options: SAMEORIGIN
Content-Type: application/json
Content-Language: en
Allow: GET, POST, HEAD, OPTIONS

{
    "failing_checks": 0,
    "failing_checks_percent": 0,
    "failing_checks_words": 0,
    "filename": "po/cs.po",
    "fuzzy": 0,
    "fuzzy_percent": 0.0,
    "fuzzy_words": 0,
    "have_comment": 0,
    "have_suggestion": 0,
    "is_template": false,
    "is_source": false,
    "language": {
        "code": "cs",
        "direction": "ltr",
        "population": 1303174280
        "name": "Czech",
        "url": "http://example.com/api/languages/cs/",
        "web_url": "http://example.com/languages/cs/"
    },
    "language_code": "cs",
    "id": 125,
    "last_author": null,
    "last_change": null,
    "share_url": "http://example.com/engage/hello/cs/",
    "total": 4,
    "total_words": 15,
    "translate_url": "http://example.com/translate/hello/weblate/cs/",
    "translated": 0,
    "translated_percent": 0.0,
    "translated_words": 0,
    "url": "http://example.com/api/translations/hello/weblate/cs/",
    "web_url": "http://example.com/projects/hello/weblate/cs/"
}

GET /api/components/(string: project)/(string: component)/statistics/#

對組件內所有的翻譯返回分頁的統計數據。

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug

Response JSON Object:

results (array) – 翻譯統計數據對象的矩陣；請參見 GET /api/translations/(string:project)/(string:component)/(string:language)/statistics/

GET /api/components/(string: project)/(string: component)/links/#

Returns projects linked with a component.

在 4.5 版本新加入.

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug

Response JSON Object:

projects (array) – associated projects; see GET /api/projects/(string:project)/

POST /api/components/(string: project)/(string: component)/links/#

Associate project with a component.

在 4.5 版本新加入.

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug

表格參數:

string project_slug – 項目標識串

DELETE /api/components/(string: project)/(string: component)/links/(string: project_slug)/#

Remove association of a project with a component.

在 4.5 版本新加入.

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug
project_slug (string) – Slug of the project to remove

翻譯#

GET /api/translations/#: 返回翻譯的列表。

也參考

翻譯對象屬性存檔在 GET /api/translations/(string:project)/(string:component)/(string:language)/。

GET /api/translations/(string: project)/(string: component)/(string: language)/#

返回翻譯的信息。

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug
language (string) – Translation language code

Response JSON Object:

component (object) – 組件對象；請參見 GET /api/components/(string:project)/(string:component)/
failing_checks (int) – number of strings failing checks
failing_checks_percent (float) – percentage of strings failing checks
failing_checks_words (int) – number of words with failing checks
filename (string) – 翻譯文件名
fuzzy (int) – number of fuzzy (marked for edit) strings
fuzzy_percent (float) – 模糊字串（標記為需要編輯）的百分比
fuzzy_words (int) – 模糊（標記為編輯)）字串中的單詞數
have_comment (int) – 帶有註釋的字串數量
have_suggestion (int) – 帶有建議的字串數量
is_template (boolean) – whether the translation has a monolingual base
language (object) – 源語言對象；請參見 GET /api/languages/(string:language)/
language_code (string) – 倉儲中使用的語言代碼；這可以不同於語言對像中的語言代碼
last_author (string) – 最後一位作者的姓名
last_change (timestamp) – last change timestamp
revision (string) – 文件的修訂哈希值
share_url (string) – 用於分享導向約定頁面的 URL
total (int) – 字串的總數
total_words (int) – 詞的總數
translate_url (string) – URL for translating
translated (int) – 已翻譯的字串數量
translated_percent (float) – 已翻譯字串的百分比
translated_words (int) – 已翻譯詞的數量
repository_url (string) – 倉儲狀態的 URL；請參見 GET /api/translations/(string:project)/(string:component)/(string:language)/repository/
file_url (string) – 文件對象的 URL；請參見 GET /api/translations/(string:project)/(string:component)/(string:language)/file/
changes_list_url (string) – 更改的列表的 URL；請參見 GET /api/translations/(string:project)/(string:component)/(string:language)/changes/
units_list_url (string) – 字串列表的 URL；請參見 GET /api/translations/(string:project)/(string:component)/(string:language)/units/

Example JSON data:

{
    "component": {
        "branch": "main",
        "file_format": "po",
        "filemask": "po/*.po",
        "git_export": "",
        "license": "",
        "license_url": "",
        "name": "Weblate",
        "new_base": "",
        "project": {
            "name": "Hello",
            "slug": "hello",
            "source_language": {
                "code": "en",
                "direction": "ltr",
                "population": 159034349015,
                "name": "English",
                "url": "http://example.com/api/languages/en/",
                "web_url": "http://example.com/languages/en/"
            },
            "url": "http://example.com/api/projects/hello/",
            "web": "https://weblate.org/",
            "web_url": "http://example.com/projects/hello/"
        },
        "repo": "file:///home/nijel/work/weblate-hello",
        "slug": "weblate",
        "template": "",
        "url": "http://example.com/api/components/hello/weblate/",
        "vcs": "git",
        "web_url": "http://example.com/projects/hello/weblate/"
    },
    "failing_checks": 3,
    "failing_checks_percent": 75.0,
    "failing_checks_words": 11,
    "filename": "po/cs.po",
    "fuzzy": 0,
    "fuzzy_percent": 0.0,
    "fuzzy_words": 0,
    "have_comment": 0,
    "have_suggestion": 0,
    "is_template": false,
    "language": {
        "code": "cs",
        "direction": "ltr",
        "population": 1303174280
        "name": "Czech",
        "url": "http://example.com/api/languages/cs/",
        "web_url": "http://example.com/languages/cs/"
    },
    "language_code": "cs",
    "last_author": "Weblate Admin",
    "last_change": "2016-03-07T10:20:05.499",
    "revision": "7ddfafe6daaf57fc8654cc852ea6be212b015792",
    "share_url": "http://example.com/engage/hello/cs/",
    "total": 4,
    "total_words": 15,
    "translate_url": "http://example.com/translate/hello/weblate/cs/",
    "translated": 4,
    "translated_percent": 100.0,
    "translated_words": 15,
    "url": "http://example.com/api/translations/hello/weblate/cs/",
    "web_url": "http://example.com/projects/hello/weblate/cs/"
}

DELETE /api/translations/(string: project)/(string: component)/(string: language)/#

在 3.9 版本新加入.

Deletes a translation.

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug
language (string) – Translation language code

GET /api/translations/(string: project)/(string: component)/(string: language)/changes/#

返回翻譯更改的列表。這本質上是仔細檢查的翻譯 :http:get:`/api/changes/`接受相同參數。

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug
language (string) – Translation language code

Response JSON Object:

results (array) – 組件對象的矩陣；請參見 GET /api/changes/(int:id)/

GET /api/translations/(string: project)/(string: component)/(string: language)/units/#

返回翻譯單元的列表。

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug
language (string) – Translation language code
q (string) – 搜索查詢字串 :ref:`Searching`（可選）

Response JSON Object:

results (array) – 組件對象的矩陣；請參見 GET /api/units/(int:id)/

POST /api/translations/(string: project)/(string: component)/(string: language)/units/#

Add new unit.

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug
language (string) – Translation language code

Request JSON Object:

key (string) – 翻譯單元的名稱
value (array) – Source strings (use single string if not creating plural)
state (int) – String state; see GET /api/units/(int:id)/

Response JSON Object:

unit (object) – newly created unit; see GET /api/units/(int:id)/

也參考

管理字串, Adding new strings

POST /api/translations/(string: project)/(string: component)/(string: language)/autotranslate/#

觸發自動翻譯。

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug
language (string) – Translation language code

Request JSON Object:

mode (string) – 自動翻譯模式
filter_type (string) – 自動翻譯篩選類型
auto_source (string) – Automatic translation source - mt or others
component (string) – 開啟對專案的共享翻譯記憶作貢獻，以取得其他組件的存取權。
engines (array) – 機器翻譯引擎
threshold (string) – 分數閾值

GET /api/translations/(string: project)/(string: component)/(string: language)/file/#

下載存儲在 VCS 中的當前翻譯文件（不帶 ``format``參數）或將其轉換為另一格式（見下載翻譯）。

備註

這個 API 端點使用了不同於API其餘的邏輯來輸出，它在整個文件而不是在數據上操作。接受的``format``參數組不同，沒有這個參數會將翻譯文件存儲在版本控制系統（VCS）中。

查詢參數:

format – File format to use; if not specified no format conversion happens; see 下載翻譯 for supported formats
q (string) – Filter downloaded strings, see 搜尋頁面, only applicable when conversion is in place (format is specified).

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug
language (string) – Translation language code

POST /api/translations/(string: project)/(string: component)/(string: language)/file/#

上傳帶有翻譯的新文件。

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug
language (string) – Translation language code

表格參數:

string conflicts – 如何處理衝突（ignore, replace-translated or replace-approved）
file file – 上傳文件
string email – 作者郵件信箱
string author – 作者姓名
string method – 上傳方法(translate, approve, suggest, fuzzy, replace, source, add)，見:ref: upload-method
string fuzzy – 模糊（標記為需要編輯）的字串處理（empty, process, approve）

CURL 示例：

curl -X POST \
    -F file=@strings.xml \
    -H "Authorization: Token TOKEN" \
    http://example.com/api/translations/hello/android/cs/file/

GET /api/translations/(string: project)/(string: component)/(string: language)/repository/#

返回版本控制系統（VCS）倉儲狀態的信息。

響應與 :http:get:`/api/components/(string:project)/(string:component)/repository/`的相同。

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug
language (string) – Translation language code

POST /api/translations/(string: project)/(string: component)/(string: language)/repository/#

在版本控制系統（VCS）倉儲上執行給定的操作。

文件請參見 POST /api/projects/(string:project)/repository/。

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug
language (string) – Translation language code

Request JSON Object:

operation (string) – 執行的操作： push, pull, commit, reset, ``cleanup``之一

Response JSON Object:

result (boolean) – 操作的結果

GET /api/translations/(string: project)/(string: component)/(string: language)/statistics/#

返回具體的翻譯統計數據。

參數值:

project (string) – 專案 URL slug
component (string) – 組件 URL slug
language (string) – Translation language code

Response JSON Object:

code (string) – 語言代碼
failing (int) – 檢查失敗的數量
failing_percent (float) – 檢查失敗的百分比
fuzzy (int) – number of fuzzy (marked for edit) strings
fuzzy_percent (float) – 模糊字串（標記為需要編輯）的百分比
total_words (int) – 詞的總數
translated_words (int) – 已翻譯詞的數量
last_author (string) – 最後一位作者的姓名
last_change (timestamp) – 上次更改的日期
name (string) – 語言名稱
total (int) – 字串的總數
translated (int) – 已翻譯的字串數量
translated_percent (float) – 已翻譯字串的百分比
url (string) – 訪問翻譯的 URL （約定的 URL）
url_translate (string) – 訪問翻譯的 URL （真實翻譯的 URL）

記憶#

在 4.14 版本新加入.

GET /api/memory/#: Returns a list of memory results.

DELETE /api/memory/(int: memory_object_id)/#

Deletes a memory object

參數值:

memory_object_id – Memory Object ID

Units#

“單位”是一個翻譯的單曲，它對具有相應翻譯的字串對的來源字串，也包含一些相關元數據。該術語來自“翻譯工具包”<http://docs.translatehouse.org/projects/translate-toolkit/en/latest/api/storage.html#translate.storage.base.translationUnit>`_和xliff。

GET /api/units/#

返回翻譯單元的列表。

參數值:

q (string) – 搜索查詢字串 :ref:`Searching`（可選）

也參考

單元對象屬性存檔在 GET /api/units/(int:id)/。

GET /api/units/(int: id)/#

在 4.3 版本變更: target 和 source 現在是矩陣，來適當的處理多個字串。

返回翻譯單元的信息。

參數值:

id (int) – 單元 ID

Response JSON Object:

translation (string) – 相關翻譯對象的 URL
source (array) – 來源字串
previous_source (string) – 用於模糊匹配的之前的源字串
target (array) – 目標字串
id_hash (string) – 單元的唯一識別文字
content_hash (string) – 源字串的唯一識別文字
location (string) – 原始碼中單元的位置
context (string) – 翻譯單元的語境
note (string) – 翻譯單元的註解
flags (string) – 翻譯單元的標記
labels (array) – translation unit labels, available on source units
state (int) – unit state, 0 - untranslated, 10 - needs editing, 20 - translated, 30 - approved, 100 - read only
fuzzy (boolean) – 是否為 fuzzy 或標記為需檢閱
translated (boolean) – whether the unit is translated
approved (boolean) – whether the translation is approved
position (int) – 翻譯文件中的單元位置
has_suggestion (boolean) – whether the unit has suggestions
has_comment (boolean) – whether the unit has comments
has_failing_check (boolean) – whether the unit has failing checks
num_words (int) – 源詞彙的數量
priority (int) – 翻譯優先級；100為預設值
id (int) – 單元識別問題
explanation (string) – 字串的解釋，可在源單元獲得，請參見源字串另外的信息
extra_flags (string) – 另外的字串標記，可在源單元獲得，請參見使用標誌自定義行為
web_url (string) – 單元可以被編輯的 URL
source_unit (string) – 源單元鏈接；請參見 GET /api/units/(int:id)/
pending (boolean) – 是否為等候寫入
timestamp (timestamp) – string age

PATCH /api/units/(int: id)/#

在 4.3 版本新加入.

Performs partial update on translation unit.

參數值:

id (int) – 單元 ID

Request JSON Object:

state (int) – unit state, 0 - untranslated, 10 - needs editing, 20 - translated, 30 - approved (need review workflow enabled, see 專門的審核者)
target (array) – 目標字串
explanation (string) – 字串的解釋，可在源單元獲得，請參見源字串另外的信息
extra_flags (string) – 另外的字串標記，可在源單元獲得，請參見使用標誌自定義行為

Response JSON Object:

labels (array) – labels, available on source units

PUT /api/units/(int: id)/#

在 4.3 版本新加入.

Performs full update on translation unit.

參數值:

id (int) – 單元 ID

Request JSON Object:

state (int) – unit state, 0 - untranslated, 10 - needs editing, 20 - translated, 30 - approved (need review workflow enabled, see 專門的審核者)
target (array) – 目標字串
explanation (string) – 字串的解釋，可在源單元獲得，請參見源字串另外的信息
extra_flags (string) – 另外的字串標記，可在源單元獲得，請參見使用標誌自定義行為

Response JSON Object:

labels (array) – labels, available on source units

DELETE /api/units/(int: id)/#

在 4.3 版本新加入.

Deletes a translation unit.

參數值:

id (int) – 單元 ID

更動#

GET /api/changes/#

在 4.1 版本變更: 更改的篩選在 4.1 版本引入。

返回翻譯更改的列表。

也參考

更改對象的屬性存檔在 GET /api/changes/(int:id)/。

查詢參數:

user (string) – 篩選使用者的使用者名
action (int) – 篩選的動作，可以多次使用
timestamp_after (timestamp) – ISO 8601 格式的時間標籤，列出此時間之後的更改
timestamp_before (timestamp) – ISO 8601 格式的時間標籤，列出此時間之前的更改

GET /api/changes/(int: id)/#

返回有關翻譯更改的信息。

參數值:

id (int) – 更改的ID

Response JSON Object:

unit (string) – 相關單元對象的 URL
translation (string) – 相關翻譯對象的 URL
component (string) – 相關組件對象的 URL
user (string) – 相關使用者對象的 URL
author (string) – 相關作者對象的 URL
timestamp (timestamp) – 時間的時間標籤
action (int) – 動作的幾種識別
action_name (string) – 動作的文本描述
target (string) – 更改的事件的文本或細節
id (int) – 更改的識別文字

螢幕擷圖#

GET /api/screenshots/#: 返回屏幕截圖字串信息的列表。

也參考

屏幕截圖對象的屬性存檔在 GET /api/screenshots/(int:id)/。

GET /api/screenshots/(int: id)/#

返回與屏幕截圖信息有關的信息。

參數值:

id (int) – 屏幕截圖的 ID

Response JSON Object:

name (string) – 屏幕截圖的名稱
component (string) – 相關組件對象的 URL
file_url (string) – 下載文件的 URL；請參見 GET /api/screenshots/(int:id)/file/
units (array) – 與源字串信息相關的鏈接；請參見 GET /api/units/(int:id)/

GET /api/screenshots/(int: id)/file/#

下載屏幕截圖的圖片。

參數值:

id (int) – 屏幕截圖的 ID

POST /api/screenshots/(int: id)/file/#

替換屏幕截圖。

參數值:

id (int) – 屏幕截圖的 ID

表格參數:

file image – 上傳文件

CURL 示例：

curl -X POST \
    -F image=@image.png \
    -H "Authorization: Token TOKEN" \
    http://example.com/api/screenshots/1/file/

POST /api/screenshots/(int: id)/units/#

與屏幕截圖相關的源字串。

參數值:

id (int) – 屏幕截圖的 ID

表格參數:

string unit_id – 單元 ID

Response JSON Object:

name (string) – 屏幕截圖的名稱
translation (string) – 相關翻譯對象的 URL
file_url (string) – 下載文件的 URL；請參見 GET /api/screenshots/(int:id)/file/
units (array) – 與源字串信息相關的鏈接；請參見 GET /api/units/(int:id)/

DELETE /api/screenshots/(int: id)/units/(int: unit_id)#

Remove source string association with screenshot.

參數值:

id (int) – 屏幕截圖的 ID
unit_id – Source string unit ID

POST /api/screenshots/#

新建新的屏幕截圖。

表格參數:

file image – 上傳文件
string name – 畫面快照名稱
string project_slug – 項目標識串
string component_slug – 組件標識串
string language_code – 語言碼

Response JSON Object:

name (string) – 屏幕截圖的名稱
component (string) – 相關組件對象的 URL
file_url (string) – 下載文件的 URL；請參見 GET /api/screenshots/(int:id)/file/
units (array) – 與源字串信息相關的鏈接；請參見 GET /api/units/(int:id)/

PATCH /api/screenshots/(int: id)/#

Edit partial information about screenshot.

參數值:

id (int) – 屏幕截圖的 ID

Response JSON Object:

name (string) – 屏幕截圖的名稱
component (string) – 相關組件對象的 URL
file_url (string) – 下載文件的 URL；請參見 GET /api/screenshots/(int:id)/file/
units (array) – 與源字串信息相關的鏈接；請參見 GET /api/units/(int:id)/

PUT /api/screenshots/(int: id)/#

Edit full information about screenshot.

參數值:

id (int) – 屏幕截圖的 ID

Response JSON Object:

name (string) – 屏幕截圖的名稱
component (string) – 相關組件對象的 URL
file_url (string) – 下載文件的 URL；請參見 GET /api/screenshots/(int:id)/file/
units (array) – 與源字串信息相關的鏈接；請參見 GET /api/units/(int:id)/

DELETE /api/screenshots/(int: id)/#

Delete screenshot.

參數值:

id (int) – 屏幕截圖的 ID

附加元件#

在 4.4.1 版本新加入.

GET /api/addons/#: 返回附加元件列表。

也參考

附加組件對象屬性記錄在 GET /api/units/(int:id)/。

GET /api/addons/(int: id)/#

Returns information about add-on information.

參數值:

id (int) – Add-on ID

Response JSON Object:

name (string) – name of an add-on
component (string) – 相關組件對象的 URL
configuration (object) – Optional add-on configuration

也參考

附加元件

POST /api/components/(string: project)/(string: component)/addons/#

Creates a new add-on.

參數值:

project_slug (string) – 項目標識串
component_slug (string) – 組件標識串

Request JSON Object:

name (string) – name of an add-on
configuration (object) – Optional add-on configuration

PATCH /api/addons/(int: id)/#

Edit partial information about add-on.

參數值:

id (int) – Add-on ID

Response JSON Object:

configuration (object) – Optional add-on configuration

PUT /api/addons/(int: id)/#

Edit full information about add-on.

參數值:

id (int) – Add-on ID

Response JSON Object:

configuration (object) – Optional add-on configuration

DELETE /api/addons/(int: id)/#

Delete add-on.

參數值:

id (int) – Add-on ID

組件列表#

在 4.0 版本新加入.

GET /api/component-lists/#: 返回組件列表的列表。

也參考

組件列表對象屬性存檔在 GET /api/component-lists/(str:slug)/。

GET /api/component-lists/(str: slug)/#

返回組件列表的信息。

參數值:

slug (string) – 組件列表的標識串

Response JSON Object:

name (string) – 組件列表的名稱
slug (string) – 組件列表的表示串
show_dashboard (boolean) – 是否在控制台上顯示
components (array) – 相關聯組件的連接；請參見 GET /api/components/(string:project)/(string:component)/
auto_assign (array) – 自動分配規則

PUT /api/component-lists/(str: slug)/#

更改組件列表參數。

參數值:

slug (string) – 組件列表的標識串

Request JSON Object:

name (string) – 組件列表的名稱
slug (string) – 組件列表的表示串
show_dashboard (boolean) – 是否在控制台上顯示

PATCH /api/component-lists/(str: slug)/#

更改組件列表參數。

參數值:

slug (string) – 組件列表的標識串

Request JSON Object:

name (string) – 組件列表的名稱
slug (string) – 組件列表的表示串
show_dashboard (boolean) – 是否在控制台上顯示

DELETE /api/component-lists/(str: slug)/#

刪除組件列表。

參數值:

slug (string) – 組件列表的標識串

POST /api/component-lists/(str: slug)/components/#

使組件與組件列表相關。

參數值:

slug (string) – 組件列表的標識串

表格參數:

string component_id – 組件 ID

DELETE /api/component-lists/(str: slug)/components/(str: component_slug)#

將組件與組件列表接觸相關性。

參數值:

slug (string) – 組件列表的標識串
component_slug (string) – 組件標識串

詞彙表#

在 4.5 版本變更: 表格現在存儲為常規組件，翻譯和字串，請使用相應的API。

Tasks#

在 4.4 版本新加入.

GET /api/tasks/#: Listing of the tasks is currently not available.

GET /api/tasks/(str: uuid)/#

Returns information about a task

參數值:

uuid (string) – 任務 UUID

Response JSON Object:

completed (boolean) – Whether the task has completed
progress (int) – Task progress in percent
result (object) – 任務結果或過程細節
log (string) – Task log

Metrics#

GET /api/metrics/#

Returns server metrics.

Response JSON Object:

units (int) – Number of units
units_translated (int) – Number of translated units
users (int) – Number of users
changes (int) – 變更數
projects (int) – Number of projects
components (int) – 組件數目
translations (int) – Number of translations
languages (int) – Number of used languages
checks (int) – Number of triggered quality checks
configuration_errors (int) – Number of configuration errors
suggestions (int) – Number of pending suggestions
celery_queues (object) – Celery 排程序列的長度。參閱使用 Celery 的後台任務
name (string) – Configured server name

通知掛勾#

通知鉤子允許外部應用來通知 Weblate 版本控制系統（VCS）倉儲已經更新。

可以為項目、組件和翻譯使用倉儲端點來更新各自的倉儲；文件請參見 POST /api/projects/(string:project)/repository/。

GET /hooks/update/(string: project)/(string: component)/#: 在 2.6 版本開始棄用: 請使用 POST /api/components/(string:project)/(string:component)/repository/ 來替代，它使用 ACL 限制的身份驗證而工作正常。

觸發組件的更新（從版本控制系統 VCS 拉取並掃描翻譯的更改）。

GET /hooks/update/(string: project)/#: 在 2.6 版本開始棄用: 請使用 POST /api/projects/(string:project)/repository/ 來替代，它使用 ACL 限制的身份驗證而工作正常。

觸發項目中所有組件的更新（從版本控制系統 VCS 拉取並掃描翻譯的更改）。

POST /hooks/github/#

處理 Github 通知與自動更新匹配組件的特殊鉤子。

備註

Github 包括了對通知 Weblate 的直接支持：在倉儲設置中啟動 Weblate 服務鉤子，並將 URL 設置為您的 Weblate 安裝的 URL。

也參考

從 GitHub 自動接收更改: 關於設置 Github 集成的指令
https://docs.github.com/en/get-started/customizing-your-github-workflow/exploring-integrations/about-webhooks: GitHub Webhooks 的一般信息
ENABLE_HOOKS: 關於對整個 Weblate 啟動鉤子

POST /hooks/gitlab/#

處理 GitLab 通知並自動更新匹配組件的特殊鉤子。

也參考

從 GitLab 自動接收更改: 關於設置 GitLab 集成的指示
https://docs.gitlab.com/ee/user/project/integrations/webhooks.html: 關於 GitLab Webhooks 的一般信息
ENABLE_HOOKS: 關於對整個 Weblate 啟動鉤子

POST /hooks/bitbucket/#

處理 Bitbucket 通知並自動更新匹配的組件的特殊鉤子。

也參考

從 Bitbucket 自動接收更改: 關於設置 Bitbucket 集成的指示
https://support.atlassian.com/bitbucket-cloud/docs/manage-webhooks/: 關於 Bitbucket Webhooks 的一般信息
ENABLE_HOOKS: 關於對整個 Weblate 啟動鉤子

POST /hooks/pagure/#

在 3.3 版本新加入.

處理 Pagure 通知並自動更新匹配的組件的特殊鉤子。

也參考

從 Pagure 自動接受更改: 關於設置 Pagure 集成的指示
https://docs.pagure.org/pagure/usage/using_webhooks.html: 關於 Pagure Webhooks 的一般信息
ENABLE_HOOKS: 關於對整個 Weblate 啟動鉤子

POST /hooks/azure/#

在 3.8 版本新加入.

Special hook for handling Azure DevOps notifications and automatically updating matching components.

備註

Please make sure that Resource details to send is set to All, otherwise Weblate will not be able to match your Azure repository.

也參考

從 Azure Repos 自動接收更改: 關於設置 Azure 集成的指示
https://learn.microsoft.com/en-us/azure/devops/service-hooks/services/webhooks?view=azure-devops: Generic information about Azure DevOps Web Hooks
ENABLE_HOOKS: 關於對整個 Weblate 啟動鉤子

POST /hooks/gitea/#

在 3.9 版本新加入.

處理 Gitea Webhook 通知並自動更新匹配的組件的特殊鉤子。

也參考

從 Gitea Repos 自動接收更改: 關於設置 Gitea 集成的指示
https://docs.gitea.io/en-us/webhooks/: 關於 Gitea Webhooks 的一般信息
ENABLE_HOOKS: 關於對整個 Weblate 啟動鉤子

POST /hooks/gitee/#

在 3.9 版本新加入.

處理 Gitee Webhook 通知並自動更新匹配的組件的特殊鉤子。

也參考

從 Gitee Repos 自動接收更改: 關於設置 Gitee 集成的指示
https://gitee.com/help/categories/40: 關於 Gitee Webhooks 的一般信息
ENABLE_HOOKS: 關於對整個 Weblate 啟動鉤子

Exports#

Weblate 提供各種導出，允許進一步處理數據。

GET /exports/stats/(string: project)/(string: component)/#

查詢參數:

format (string) – 輸出格式： json 或 csv

在 2.6 版本開始棄用: 請替代使用:http:get:/api/components/(string:project)/(string:component)/statistics/ 和:http:get:/api/translations/(string:project)/(string: component)/(string:language)/statistics/；它也允許訪問ACL 控制的項目。

為給定的組件以給定的格式檢索統計數據。

示例請求：

GET /exports/stats/weblate/main/ HTTP/1.1
Host: example.com
Accept: application/json, text/javascript

示例響應：

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

[
    {
        "code": "cs",
        "failing": 0,
        "failing_percent": 0.0,
        "fuzzy": 0,
        "fuzzy_percent": 0.0,
        "last_author": "Michal Čihař",
        "last_change": "2012-03-28T15:07:38+00:00",
        "name": "Czech",
        "total": 436,
        "total_words": 15271,
        "translated": 436,
        "translated_percent": 100.0,
        "translated_words": 3201,
        "url": "http://hosted.weblate.org/engage/weblate/cs/",
        "url_translate": "http://hosted.weblate.org/projects/weblate/main/cs/"
    },
    {
        "code": "nl",
        "failing": 21,
        "failing_percent": 4.8,
        "fuzzy": 11,
        "fuzzy_percent": 2.5,
        "last_author": null,
        "last_change": null,
        "name": "Dutch",
        "total": 436,
        "total_words": 15271,
        "translated": 319,
        "translated_percent": 73.2,
        "translated_words": 3201,
        "url": "http://hosted.weblate.org/engage/weblate/nl/",
        "url_translate": "http://hosted.weblate.org/projects/weblate/main/nl/"
    },
    {
        "code": "el",
        "failing": 11,
        "failing_percent": 2.5,
        "fuzzy": 21,
        "fuzzy_percent": 4.8,
        "last_author": null,
        "last_change": null,
        "name": "Greek",
        "total": 436,
        "total_words": 15271,
        "translated": 312,
        "translated_percent": 71.6,
        "translated_words": 3201,
        "url": "http://hosted.weblate.org/engage/weblate/el/",
        "url_translate": "http://hosted.weblate.org/projects/weblate/main/el/"
    }
]

RSS 消息來源#

翻譯的更改導出到 RSS 頻道。

GET /exports/rss/(string: project)/(string: component)/(string: language)/#: 用翻譯近期的更改檢索 RSS 頻道。

GET /exports/rss/(string: project)/(string: component)/#: 用組件的近期更改檢索 RSS 頻道。

GET /exports/rss/(string: project)/#: 用項目的近期更改檢索 RSS 頻道。

GET /exports/rss/language/(string: language)/#: 用語言的近期更改檢索 RSS 頻道。

GET /exports/rss/#: 用 Weblate 事件的近期更改檢索 RSS 頻道。

也參考

RSS on Wikipedia

Weblate 客戶端#

安裝#

Weblate 客戶端是分開上市的，包括 Python 模塊。要使用下面的命令，您需要安裝 wlc：

pip install wlc

Docker usage#

Web2客戶端也可作為Docker Image提供。

該圖像在Docker Hub上發佈：https://hub.docker.com/r/weblate/wlc

安裝中：

docker pull weblate/wlc

Docker Container使用WebLate的預設設置並連接到位於localhost中部署的API。API URL和API_KEY可以通過Weberate接受的參數配置。

啟動容器的命令使用以下語法：

docker run --rm weblate/wlc [WLC_ARGS]

例：

docker run --rm weblate/wlc --url https://hosted.weblate.org/api/ list-projects

您可能希望傳送您的 wlc-config`給 Docker 容器，最簡單的方法是將您當前的目錄添加為 :file:/home/webleate` volume：

docker run --volume $PWD:/home/weblate --rm weblate/wlc show

入門#

wlc 配置存儲在 ~/.config/weblate 中（其他位置參見 ref:wlc-config）,請創建它以匹配您的環境：

[weblate]
url = https://hosted.weblate.org/api/

[keys]
https://hosted.weblate.org/api/ = APIKEY

然後，您可以在預設服務器上調用命令：

wlc ls
wlc commit sandbox/hello-world

也參考

配置文件

Synopsis#

wlc [arguments] <command> [options]

命令實際上指示應該執行哪個操作。

描述#

Weblate 客戶端是一個 Python 庫和命令行實用程序，可使用 Weblate 的 REST API 遠程管理 Weblate。命令行實用程序可以作為 wlc 調用，並且內置在 wlc 上。

Arguments#

程序接受以下參數來定義輸出格式或使用哪個Weblate實例。這些參數必須位於任何命令之前。

--format {csv,json,text,html}#: 指定輸出格式。

--url URL#: 指定 API URL。覆蓋在配置文件中找到的任何值，請參閱配置文件。該網址應以 /api/ 結尾，例如 https://hosted.weblate.org/api/。

--key KEY#: 指定要使用的 API 使用者密鑰。覆蓋在配置文件中找到的任何值，請參閱配置文件。您可以在 Weblate 的個人資料中找到密鑰。

--config PATH#: 覆蓋配置文件路徑，請參閱配置文件。

--config-section SECTION#: 覆蓋正在使用的配置文件部分，請參閱配置文件。

Commands#

以下命令可用：

version#: 打印當前版本。

list-languages#: 列出 Weblate 中使用的語言。

list-projects#: 列出 Weblate 中的項目。

list-components#: Lists components in Weblate.

list-translations#: Lists translations in Weblate.

show#: 顯示 Weblate 對象（翻譯，組件或項目）。

ls#: 列出 Weblate 對象（翻譯，組件或項目）。

commit#: 提交在 Weblate 對象（翻譯，組件或項目）中所做的更改。

pull#: 拉取遠程倉儲的更改到 Weblate 對像中（翻譯，組件或項目）。

push#: 將 Weblate 對象更改推送到遠程倉儲（翻譯，組件或項目）。

reset#: 在 0.7 版本新加入: Supported since wlc 0.7.

重置 Weblate 對像中的更改以匹配遠程存儲庫（翻譯，組件或項目）。

cleanup#: 在 0.9 版本新加入: Supported since wlc 0.9.

刪除 Weblate 對像中所有未跟踪的更改以匹配遠程倉儲（翻譯，組件或項目）。

repo#: 顯示給定 Weblate 對象（翻譯，組件或項目）的倉儲狀態。

stats#: 顯示給定 Weblate 對象（翻譯，組件或項目）的詳細統計數據。

lock-status#: 在 0.5 版本新加入: Supported since wlc 0.5.

顯示鎖定狀態。

lock#: 在 0.5 版本新加入: Supported since wlc 0.5.

鎖定組件以防止在 Weblate 中進一步翻譯。

unlock#: 在 0.5 版本新加入: Supported since wlc 0.5.

解鎖 Weblate 組件的翻譯。

changes#: 在 0.7 版本新加入: 從 wlc 0.7 和 Weblate 2.10 開始受支持。

顯示給定對象的更改。

download#

在 0.7 版本新加入: Supported since wlc 0.7.

Downloads a translation file.

--convert#: 轉換文件格式，如果未指定，則在服務器上不進行任何轉換，並且將文件原樣下載到倉儲中。

--output#: 指定要保存輸出的文件，如果未指定，則將其打印到 stdout。

upload#

在 0.9 版本新加入: Supported since wlc 0.9.

Uploads a translation file.

--overwrite#: 上傳時覆蓋現有翻譯。

--input#: 從中讀取內容的文件，如果未指定，則從 stdin 中讀取。

--method#: Upload method to use, see 導入方法.

--fuzzy#: 模糊（標記為需要編輯）的字串處理（empty, process, approve）

--author-name#: Author name, to override currently authenticated user

--author-email#: Author e-mail, to override currently authenticated user

提示

您可以通過傳遞``–help``獲取更多有關調用單個命令的更詳細信息：wlc ls - help。

配置文件#

.weblate, .weblate.ini, weblate.ini: Per project configuration file
C:\Users\NAME\AppData\weblate.ini: 在 Windows 上使用配置文件。
~/.config/weblate: 使用者配置文件
/etc/xdg/weblate: System wide configuration file

該程序遵循 XDG 規範，因此您可以通過環境變量 XDG_CONFIG_HOME 或 XDG_CONFIG_DIRS 來調整配置文件的位置。在 Windows 系統上 `APPDATA``目錄是配置文件的首選位置。

可以在 [weblate] 部分中配置以下設置（您可以通過 --config-section 進行自定義）：

key: 用於訪問 Weblate 的 API KEY。

url: API 服務器網址，預設為 http://127.0.0.1:8000/api/。

translation: 預設翻譯的路徑 —— 組件或項目。

配置文件是一個 INI 文件，例如：

[weblate]
url = https://hosted.weblate.org/api/
key = APIKEY
translation = weblate/application

另外，API 密鑰可以存儲在 [keys] 部分中：

[keys]
https://hosted.weblate.org/api/ = APIKEY

這樣，您就可以在版本控制系統（VCS ）倉儲中使用 .weblate 配置時，將密鑰存儲在個人設置中，以便 wlc 知道它應該與哪個服務器通信。

Examples#

Print current program version:

$ wlc version
version: 0.1

列出所有項目：

$ wlc list-projects
name: Hello
slug: hello
url: http://example.com/api/projects/hello/
web: https://weblate.org/
web_url: http://example.com/projects/hello/

上傳翻譯檔：

$ wlc upload project/component/language --input /tmp/hello.po

您還可以指定 wlc 應該從事的項目：

$ cat .weblate
[weblate]
url = https://hosted.weblate.org/api/
translation = weblate/application

$ wlc show
branch: main
file_format: po
source_language: en
filemask: weblate/locale/*/LC_MESSAGES/django.po
git_export: https://hosted.weblate.org/git/weblate/application/
license: GPL-3.0+
license_url: https://spdx.org/licenses/GPL-3.0+
name: Application
new_base: weblate/locale/django.pot
project: weblate
repo: git://github.com/WeblateOrg/weblate.git
slug: application
template:
url: https://hosted.weblate.org/api/components/weblate/application/
vcs: git
web_url: https://hosted.weblate.org/projects/weblate/application/

通過此設置，可以輕鬆地提交當前項目中待定的更改：

$ wlc commit

Weblate 的 Python API#

安裝#

The Python API is shipped separately, you need to install the Weblate 客戶端 (wlc) to have it.

pip install wlc

`wlc`#

`WeblateException`#

exception wlc.WeblateException#: 所有異常的基類。

`Weblate`#

class wlc.Weblate(key='', url=None, config=None)#

參數:

key (str) – User key
url (str) – API Server URL，如果沒有指定預設值
config (wlc.config.WeblateConfig) – 配置對象，覆蓋任何其他參數。

訪問API的類，定義API鍵和可選的API URL。

get(path)#

參數:: path (str) – Request path
回傳型別:: object

執行單個API呼叫。

post(path, **kwargs)#

參數:: path (str) – Request path
回傳型別:: object

執行單個API呼叫。

`wlc.config`#

`WeblateConfig`#

class wlc.config.WeblateConfig(section='wlc')#

參數:: section (str) – Configuration section to use

XDG規範之後的配置文件解析器。

load(path=None)#

參數:: path (str) – 從中加載配置的路徑。

從文件中加載配置，如果沒有指定，則從“WLC”配置文件（：“文件：〜/ .config / wlc）中加載（：file：/ etc / xdg / wlc）。

`wlc.main`#

wlc.main.main(settings=None, stdout=None, args=None)#

參數:

settings (list) – 作為元組列表覆蓋的設置
stdout (object) – 用於打印輸出的stdout文件對象，使用``sys.stdout```
args (list) – 要處理的命令行參數，使用``sys.args``

命令行界面的主要入口點。

@wlc.main.register_command(command)#: 註冊 Command`裝飾器類別在主要解析程式 :func:`main 中。

`Command`#

class wlc.main.Command(args, config, stdout=None)#: 用於調用命令的主類。

配置手冊#

安裝 Weblate#

使用 Docker 安裝#

通過 dockerized Weblate 部署，您可以在幾秒鐘內啟動並運行您的個人 Weblate 實例。 Weblate 的所有依賴項已包含在內。 PostgreSQL 被新建為預設資料庫。

硬件要求#

Weblate 應該可以在任何現代硬件上正常運行，以下是在單個主機（ Weblate，資料庫和 Web 服務器）上運行 Weblate 所需的最低配置：

3 GB of RAM
2 CPU 核心
1 GB 的存儲空間

內存越多越好 —— 用於所有級別的緩存（文件系統，資料庫和 Weblate ）。

許多並髮使用者會增加所需的 CPU 內核數量。對於數百個翻譯組件，推薦至少有 4 GB 的內存。

典型的資料庫存儲用量大約為每 1 百萬單詞 300 MB。克隆倉儲所需的存儲空間會變化，但 Weblate 試圖通過淺克隆將其大小最小化。

備註

根據 Weblate 中管理的翻譯大小，安裝 Weblate 的實際要求差異很大。

安裝#

以下示例假設您擁有一個工作正常的 Docker 環境，並安裝了 docker-compose。請查看 Docker 文件以獲取說明。

克隆 weblate-docker 存儲庫：

git clone https://github.com/WeblateOrg/docker-compose.git weblate-docker
cd weblate-docker

建立一個 docker-compose.override.yml 檔案並調整為您所需的設定。參閱 Docker 環境變數瞭解更多相關設定參數。

version: '3'
services:
  weblate:
    ports:
      - 80:8080
    environment:
      WEBLATE_EMAIL_HOST: smtp.example.com
      WEBLATE_EMAIL_HOST_USER: user
      WEBLATE_EMAIL_HOST_PASSWORD: pass
      WEBLATE_SERVER_EMAIL: weblate@example.com
      WEBLATE_DEFAULT_FROM_EMAIL: weblate@example.com
      WEBLATE_SITE_DOMAIN: weblate.example.com
      WEBLATE_ADMIN_PASSWORD: password for the admin user
      WEBLATE_ADMIN_EMAIL: weblate.admin@example.com

備註

如果未設置 WEBLATE_ADMIN_PASSWORD，則使用首次啟動時顯示的隨機密碼創建管理員使用者。

提供的例子使 Weblate 偵聽端口 80，在 docker-compose.override.yml 文件中編輯端口映射來更改。

啟動 Weblate 容器：
```
docker-compose up
```

享受您的 Weblate 部署，可以在 weblate 容器的端口 80 上進行訪問。

在 3.7.1-6 版本變更: 在 2019 年 7 月（從 3.7.1-6 標籤開始）中，容器未以 root 使用者身份運行。這已將裸露端口從 80 更改為 8080。

也參考

Invoking management commands

選擇 Docker hub 標籤#

您在 Docker hub 使用以下的標籤，可用的標籤列表請參考 https://hub.docker.com/r/weblate/weblate/tags/ 。

標籤名稱	描述	用例
`latest`	Weblate 穩定版本，符合最新版本的發佈	在正式環境中滾動式更新
`<VERSION>-<PATCH>`	Weblate stable release	明確定義其佈署版本於正式環境中
`edge`	基於 Weblate 穩定版本作開發修正於 Docker 容器（例如更新相依套件）	滾動式更新於暫存環境中
`edge-<DATE>-<SHA>`	基於 Weblate 穩定版本作開發修正於 Docker 容器（例如更新相依套件）	明確定義其佈署版本於暫存環境中
`bleeding`	依 Git 上的 Weblate 開發版本	滾動式更新來測試即將發佈的 Weblate 功能
`bleeding-<DATE>-<SHA>`	依 Git 上的 Weblate 開發版本	明確定義其佈署版本來設定即將發佈的 Weblate 功能

Every image is tested by our CI before it gets published, so even the bleeding version should be quite safe to use.

具有 HTTPS 支持的 Docker 容器#

請參閱安裝以獲取常規部署說明，本節僅提及與之相比的差異。

使用自己的 SSL 證書#

在 3.8-3 版本新加入.

如果您要使用自己的 SSL 證書，只需將文件放入 Weblate 數據卷中（請參閱 Docker 容器 volumes）：

ssl/fullchain.pem 包含證書，包括任何需要的 CA 證書
ssl/privkey.pem 包含有私鑰

擁有這兩個文件的使用者必須與啟動 docker 容器並將文件掩碼設置為 600 （僅擁有使用者可讀可寫）的使用者為同一使用者。

此外，Weblate 容器現在將在端口 4443 上接受 SSL 連接，您將要在 docker compose override 中包括 HTTPS 的端口轉發：

version: '3'
services:
  weblate:
    ports:
      - 80:8080
      - 443:4443

如果您已經在同一服務器上託管其他站點，則反向代理（例如 NGINX ）可能會使用端口 80 和 443。要將 HTTPS 連接從 NGINX 傳遞到 docker 容器，可以使用以下配置：

server {
    listen 443;
    listen [::]:443;

    server_name <SITE_URL>;
    ssl_certificate /etc/letsencrypt/live/<SITE>/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/<SITE>/privkey.pem;

    location / {
            proxy_set_header HOST $host;
            proxy_set_header X-Forwarded-Proto https;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Host $server_name;
            proxy_pass https://127.0.0.1:<EXPOSED_DOCKER_PORT>;
    }
}

將 <SITE_URL>，<SITE> 和 <EXPOSED_DOCKER_PORT> 替換為您環境中的實際值。

使用 Let’s Encrypt 自動生成 SSL 證書#

如果要在公共安裝中使用`Let’s Encrypt <https://letsencrypt.org/>`_ 自動生成的SSL 證書，則需要在其他Docker 容器中添加反向HTTPS 代理，這將使用`https-portal <https ://hub.docker.com/r/steveltn/https-portal/>`_。這是在 docker-compose-https.yml 文件中使用的。然後使用您的設置創建一個 docker-compose-https.override.yml 文件：

version: '3'
services:
  weblate:
    environment:
      WEBLATE_EMAIL_HOST: smtp.example.com
      WEBLATE_EMAIL_HOST_USER: user
      WEBLATE_EMAIL_HOST_PASSWORD: pass
      WEBLATE_SITE_DOMAIN: weblate.example.com
      WEBLATE_ADMIN_PASSWORD: password for admin user
  https-portal:
    environment:
      DOMAINS: 'weblate.example.com -> http://weblate:8080'

每當調用 docker-compose 時，您都需要將兩個文件都傳遞給它，然後執行以下操作：

docker-compose -f docker-compose-https.yml -f docker-compose-https.override.yml build
docker-compose -f docker-compose-https.yml -f docker-compose-https.override.yml up

升級 Docker 容器#

通常，只更新 Weblate 容器並保持 PostgreSQL 容器為您的版本是一個好主意，因為升級 PostgreSQL 會很痛苦，並且在大多數情況下不會帶來很多好處。

在 4.10-1 版本變更: Since Weblate 4.10-1, the Docker container uses Django 4.0 what requires PostgreSQL 10 or newer, please upgrade it prior to upgrading Weblate. See Upgrade from 4.9 to 4.10 and Upgrading PostgreSQL container.

您可以通過堅持使用現有的 docker-compose，並且只是拉取最新映像，然後重新啟動，來執行此操作：

# Fetch latest versions of the images
docker-compose pull
# Stop and destroy the containers
docker-compose down
# Spawn new containers in the background
docker-compose up -d
# Follow the logs during upgrade
docker-compose logs -f

Weblate 資料庫應在首次啟動時自動遷移，並且不需要其他手動操作。

備註

Upgrades across major versions are not supported by Weblate. For example, if you are on 3.x series and want to upgrade to 4.x, first upgrade to the latest 4.0.x-y image (at time of writing this it is the 4.0.4-5), which will do the migration and then continue upgrading to newer versions.

You might also want to update the docker-compose repository, though it’s not needed in most case. See Upgrading PostgreSQL container for upgrading the PostgreSQL server.

Upgrading PostgreSQL container#

PostgreSQL containers do not support automatic upgrading between version, you need to perform the upgrade manually. Following steps show one of the options of upgrading.

也參考

https://github.com/docker-library/postgres/issues/37

Stop Weblate container:
```
docker-compose stop weblate cache
```

備份資料庫：

docker-compose exec database pg_dumpall --clean --username weblate > backup.sql

Stop the database container:
```
docker-compose stop database
```

移除 PostgreSQL volume：

docker-compose rm -v database
docker volume remove weblate-docker_postgres-data

Adjust docker-compose.yml to use new PostgreSQL version.
啟動資料庫容器：
```
docker-compose up -d database
```

從備份中恢復資料庫：

cat backup.sql | docker-compose exec -T database psql --username weblate --dbname postgres

(Optional) Update password for the Weblate user. This might be needed when migrating to PostgreSQL 14 or 15 as way of storing passwords has been changed:
```
docker-compose exec -T database psql --username weblate --dbname postgres -c "ALTER USER weblate WITH PASSWORD 'weblate'"
```
啟動所有剩下的容器：
```
docker-compose up -d
```

Admin sign in#

設置容器之後，您可以使用 WEBLATE_ADMIN_PASSWORD 中提供的密碼以管理員使用者身份登錄，或者如果未設置該密碼，則在首次啟動時生成隨機密碼。

要重置管理員密碼，請在 WEBLATE_ADMIN_PASSWORD 設置為新密碼的情況下重啟容器。

也參考

WEBLATE_ADMIN_PASSWORD, WEBLATE_ADMIN_NAME, WEBLATE_ADMIN_EMAIL

過程數量和內存消耗#

基於CPU的數量，自動確定UWSGI和CELERY的工人流程數。這適用於大多數雲虛擬機，因為它們通常具有很少的CPU和良好的內存量。

在您有很多 CPU 核心並且碰到內存用盡問題情況下，嘗試減少 worker 的數量：

environment:
  WEBLATE_WORKERS: 2

您還可以微調單個 worker 類別：

environment:
  WEB_WORKERS: 4
  CELERY_MAIN_OPTIONS: --concurrency 2
  CELERY_NOTIFY_OPTIONS: --concurrency 1
  CELERY_TRANSLATE_OPTIONS: --concurrency 1

也參考

WEBLATE_WORKERS CELERY_MAIN_OPTIONS, CELERY_NOTIFY_OPTIONS, CELERY_MEMORY_OPTIONS, CELERY_TRANSLATE_OPTIONS, CELERY_BACKUP_OPTIONS, CELERY_BEAT_OPTIONS, WEB_WORKERS

平行擴展#

在 4.6 版本新加入.

您可以運行多個 Weblate 容器以水平擴展服務。 /app/data`volume 必須由所有容器共享，建議使用群集文件系統，如 Glusterfs。 :file:/app/cache` volume 應該為每個容器分開配置。

每個WebLate容器都有定義的角色：envvar：`weblate_service`環境變量。請仔細跟踪文件，因為某些服務應該在群集中僅運行一次，並且服務的訂單也是如此。

您可以在“docker-compose`` repo中”找到示例設置為“docker-compose-split.yml <https：//github.com/weblateorg/docker-compose/blob/main/docker-compose-split.yml>`__。

Docker 環境變數#

許多 Weblate 的 :ref:`config`可以透過環境變數設定到 Docker 容器中。

If you need to define a setting not exposed through Docker environment variables, see Configuration beyond environment variables.

通用設置#

WEBLATE_DEBUG#

使用 DEBUG 配置 Django 調試模式。

示例：

environment:
  WEBLATE_DEBUG: 1

也參考

停用除錯模式

WEBLATE_LOGLEVEL#: 配置日誌記錄的詳細程度。

WEBLATE_LOGLEVEL_DATABASE#: Configures the logging of the database queries verbosity.

WEBLATE_SITE_TITLE#: 更改所有頁面頁眉上顯示的站點標題。

WEBLATE_SITE_DOMAIN#: Configures the site domain. This parameter is required.

也參考

設置正確的網站域名, SITE_DOMAIN

WEBLATE_ADMIN_NAME#

WEBLATE_ADMIN_EMAIL#

配置站點管理員的姓名和電子郵件。它用於 ADMINS 設置和創建管理員使用者（有關此信息，請參閱 WEBLATE_ADMIN_PASSWORD）。

示例：

environment:
  WEBLATE_ADMIN_NAME: Weblate admin
  WEBLATE_ADMIN_EMAIL: noreply@example.com

也參考

Admin sign in, 合適的管理參數設定, ADMINS

WEBLATE_ADMIN_PASSWORD#

設置管理員使用者的密碼。

如果未設置並且管理員使用者不存在，則會使用首次啟動容器時顯示的隨機密碼來創建它。
如果未設置並且管理員使用者存在，則不執行任何操作。
如果設置，則在每次容器啟動時都會對管理員使用者進行調整，以匹配 WEBLATE_ADMIN_PASSWORD，WEBLATE_ADMIN_NAME 和 WEBLATE_ADMIN_EMAIL。

警告

將密碼存儲在配置文件中可能會帶來安全風險。考慮僅將此變量用於初始設置（或讓 Weblate 在初始啟動時生成隨機密碼）或用於密碼恢復。

也參考

:ref:“docker-admin-login`”

WEBLATE_ADMIN_PASSWORD_FILE#: 設置指向包含管理員使用者密碼的一個文件。

也參考

WEBLATE_ADMIN_PASSWORD

WEBLATE_SERVER_EMAIL#: The email address that error messages are sent from.

也參考

SERVER_EMAIL, 郵件外送設定

WEBLATE_DEFAULT_FROM_EMAIL#: 配置外發電子郵件的地址。

也參考

DEFAULT_FROM_EMAIL, 郵件外送設定

WEBLATE_CONTACT_FORM#: 配置聯繫表單行為，請參閱：設置：contact_form。

WEBLATE_ALLOWED_HOSTS#

使用 ALLOWED_HOSTS 配置允許的 HTTP 主機名。

預設為 * 來允許所有的主機名稱。

示例：

environment:
  WEBLATE_ALLOWED_HOSTS: weblate.example.com,example.com

也參考

ALLOWED_HOSTS, 允許的網域設定, 設置正確的網站域名

WEBLATE_REGISTRATION_OPEN#

通過切換 REGISTRATION_OPEN 配置是否打開註冊。

示例：

environment:
  WEBLATE_REGISTRATION_OPEN: 0

WEBLATE_REGISTRATION_ALLOW_BACKENDS#

配置可用於通過 REGISTRATION_ALLOW_BACKENDS 創建新帳戶的身份驗證方法。

示例：

environment:
  WEBLATE_REGISTRATION_OPEN: 0
  WEBLATE_REGISTRATION_ALLOW_BACKENDS: azuread-oauth2,azuread-tenant-oauth2

WEBLATE_REGISTRATION_REBIND#: 在 4.16 版本新加入.

Configures REGISTRATION_REBIND.

WEBLATE_TIME_ZONE#

在 Weblate 中配置使用的時區，請參閱 TIME_ZONE。

備註

為了更改 Docker 自己的時區，使用 TZ 環境變量。

示例：

environment:
  WEBLATE_TIME_ZONE: Europe/Prague

WEBLATE_ENABLE_HTTPS#

讓 Weblate 假定在反向 HTTPS 代理後面操作，這使 Weblate 在電子郵件和 API 鏈接中使用 HTTPS，或者在 cookies 上設置安全標記。

提示

可能的警告請參見 ENABLE_HTTPS 文件。

備註

這不會使 Weblate 容器接受 HTTPS 連接，您同樣需要配置它，例子請參見具有 HTTPS 支持的 Docker 容器。

示例：

environment:
  WEBLATE_ENABLE_HTTPS: 1

也參考

ENABLE_HTTPS 設置正確的網站域名, WEBLATE_SECURE_PROXY_SSL_HEADER

WEBLATE_INTERLEDGER_PAYMENT_POINTERS#: 在 4.12.1 版本新加入.

Lets Weblate set the meta[name=monetization] field in the head of the document. If multiple are specified, chooses one randomly.

也參考

INTERLEDGER_PAYMENT_POINTERS

WEBLATE_IP_PROXY_HEADER#

讓 Weblate 從任何給定的 HTTP 標頭中取回 IP 地址。在使用 Weblate 容器之前的反向代理時使用它。

允許 IP_BEHIND_REVERSE_PROXY 並設置 IP_PROXY_HEADER。

備註

格式必須符合 Django 的要求。 Django transforms 原始 HTTP 標頭如下命名：

將所有字符裝換為大寫
用下劃線替換任何連字符
前面添加 HTTP_ 前綴字

所以 X-Forwarded-For 將被映射到 HTTP_X_FORWARDED_FOR。

示例：

environment:
  WEBLATE_IP_PROXY_HEADER: HTTP_X_FORWARDED_FOR

WEBLATE_SECURE_PROXY_SSL_HEADER#

代表 HTTP 標頭/值的組合的元組，用於表達請求，這樣的元組是安全的。當 Weblate 在進行終止SSL 的反向代理之後運行時，這是需要的，終止 SSL 不通過標準 HTTPS 標頭。

示例：

environment:
  WEBLATE_SECURE_PROXY_SSL_HEADER: HTTP_X_FORWARDED_PROTO,https

也參考

SECURE_PROXY_SSL_HEADER

WEBLATE_REQUIRE_LOGIN#

啟用 REQUIRE_LOGIN 而在整個 Weblate 上強制認證。

示例：

environment:
  WEBLATE_REQUIRE_LOGIN: 1

WEBLATE_LOGIN_REQUIRED_URLS_EXCEPTIONS#

WEBLATE_ADD_LOGIN_REQUIRED_URLS_EXCEPTIONS#

WEBLATE_REMOVE_LOGIN_REQUIRED_URLS_EXCEPTIONS#

使用 LOGIN_REQUIRED_URLS_EXCEPTIONS 來為整個 Webate 安裝所需的身份驗證添加 URL 例外。

可以替換整個設置，或者使用 ADD 和 REMOVE 變量修改預設值。

WEBLATE_GOOGLE_ANALYTICS_ID#: 通過 GOOGLE_ANALYTICS_ID 來配置用於 Google Analytics 的 ID。

WEBLATE_GITHUB_USERNAME#

WEBLATE_GITHUB_TOKEN#

WEBLATE_GITHUB_HOST#: Configures GitHub pull-requests integration by changing GITHUB_CREDENTIALS.

也參考

GitHub pull requests

WEBLATE_GITLAB_USERNAME#

WEBLATE_GITLAB_TOKEN#

WEBLATE_GITLAB_HOST#

Configures GitLab merge-requests integration by changing GITLAB_CREDENTIALS.

示例：

WEBLATE_GITLAB_USERNAME=weblate
WEBLATE_GITLAB_HOST=gitlab.com
WEBLATE_GITLAB_TOKEN=token

也參考

GitLab 合併請求

WEBLATE_GITEA_USERNAME#

WEBLATE_GITEA_TOKEN#

WEBLATE_GITEA_HOST#: Configures Gitea pull-requests integration by changing GITEA_CREDENTIALS.

也參考

Gitea pull requests

WEBLATE_PAGURE_USERNAME#

WEBLATE_PAGURE_TOKEN#

WEBLATE_PAGURE_HOST#: Configures Pagure merge-requests integration by changing PAGURE_CREDENTIALS.

也參考

Pagure 合併請求

WEBLATE_BITBUCKETSERVER_USERNAME#

WEBLATE_BITBUCKETSERVER_TOKEN#

WEBLATE_BITBUCKETSERVER_HOST#: Configures Bitbucket Server pull-requests integration by changing BITBUCKETSERVER_CREDENTIALS.

也參考

Bitbucket Server pull requests

WEBLATE_DEFAULT_PULL_MESSAGE#: 設定拉取請求預設的標題與訊息透過 API 改變 DEFAULT_PULL_MESSAGE

也參考

DEFAULT_PULL_MESSAGE

WEBLATE_SIMPLIFY_LANGUAGES#: 配置語言簡化策略，請參見 SIMPLIFY_LANGUAGES。

WEBLATE_DEFAULT_ACCESS_CONTROL#: 為新項目配置預設的存取控制，請參見 DEFAULT_ACCESS_CONTROL。

WEBLATE_DEFAULT_RESTRICTED_COMPONENT#: 為新組件的受限制的訪問配置預設值，請參見 DEFAULT_RESTRICTED_COMPONENT。

WEBLATE_DEFAULT_TRANSLATION_PROPAGATION#: 為新組件的允許翻譯再用配置預設值，請參見 DEFAULT_TRANSLATION_PROPAGATION。

WEBLATE_DEFAULT_COMMITER_EMAIL#: 配置 DEFAULT_COMMITER_EMAIL。

WEBLATE_DEFAULT_COMMITER_NAME#: 配置 DEFAULT_COMMITER_NAME。

WEBLATE_DEFAULT_SHARED_TM#: 配置 DEFAULT_SHARED_TM.

WEBLATE_AKISMET_API_KEY#: 配置 Akismet API 密鑰，請參見 AKISMET_API_KEY。

WEBLATE_GPG_IDENTITY#: 配置提交的 GPG 簽名，請參見 WEBLATE_GPG_IDENTITY。

也參考

簽署 GnuPG 的 Git 承諾

WEBLATE_URL_PREFIX#: 配置 Weblate 運行的 URL 前綴，請參見 URL_PREFIX。

WEBLATE_SILENCED_SYSTEM_CHECKS#: 配置您不想要顯示的檢查，請參見 SILENCED_SYSTEM_CHECKS。

WEBLATE_CSP_SCRIPT_SRC#

WEBLATE_CSP_IMG_SRC#

WEBLATE_CSP_CONNECT_SRC#

WEBLATE_CSP_STYLE_SRC#

WEBLATE_CSP_FONT_SRC#: 允許定制 Content-Security-Policy HTTP 標頭。

也參考

:ref:“CSP”，：設置：“CSP_Script_src`”，

WEBLATE_LICENSE_FILTER#: 配置 LICENSE_FILTER.

WEBLATE_LICENSE_REQUIRED#: 配置 LICENSE_REQUIRED

WEBLATE_WEBSITE_REQUIRED#: 配置 WEBSITE_REQUIRED

WEBLATE_HIDE_VERSION#: 配置 HIDE_VERSION。

WEBLATE_BASIC_LANGUAGES#: 配置 BASIC_LANGUAGES.

WEBLATE_DEFAULT_AUTO_WATCH#: 配置 DEFAULT_AUTO_WATCH.

WEBLATE_RATELIMIT_ATTEMPTS#

WEBLATE_RATELIMIT_LOCKOUT#

WEBLATE_RATELIMIT_WINDOW#: 在 4.6 版本新加入.

Configures rate limiter.

提示

您可以設置任何速率限制器範圍的配置。為此設置的任何設置添加``Web21```:ref:速率限制。

也參考

頻次限制, RATELIMIT_ATTEMPTS, RATELIMIT_WINDOW, RATELIMIT_LOCKOUT

WEBLATE_API_RATELIMIT_ANON#

WEBLATE_API_RATELIMIT_USER#: 在 4.11 版本新加入.

Configures API rate limiting. Defaults to 100/day for anonymous and 5000/hour for authenticated users.

也參考

API 頻次限制

WEBLATE_ENABLE_HOOKS#: 在 4.13 版本新加入.

Configures ENABLE_HOOKS.

WEBLATE_ENABLE_AVATARS#: 在 4.6.1 版本新加入.

配置 ENABLE_AVATARS.

WEBLATE_AVATAR_URL_PREFIX#: 在 4.15 版本新加入.

Configures AVATAR_URL_PREFIX.

WEBLATE_LIMIT_TRANSLATION_LENGTH_BY_SOURCE_LENGTH#: 在 4.9 版本新加入.

Configures LIMIT_TRANSLATION_LENGTH_BY_SOURCE_LENGTH.

WEBLATE_SSH_EXTRA_ARGS#: 在 4.9 版本新加入.

Configures SSH_EXTRA_ARGS.

WEBLATE_BORG_EXTRA_ARGS#: 在 4.9 版本新加入.

配置 BORG_EXTRA_ARGS 。

WEBLATE_ENABLE_SHARING#: 在 4.14.1 版本新加入.

Configures ENABLE_SHARING.

WEBLATE_EXTRA_HTML_HEAD#: 在 4.15 版本新加入.

Configures EXTRA_HTML_HEAD.

WEBLATE_PRIVATE_COMMIT_EMAIL_TEMPLATE#: 在 4.15 版本新加入.

Configures PRIVATE_COMMIT_EMAIL_TEMPLATE.

WEBLATE_PRIVATE_COMMIT_EMAIL_OPT_IN#: 在 4.15 版本新加入.

Configures PRIVATE_COMMIT_EMAIL_OPT_IN.

WEBLATE_UNUSED_ALERT_DAYS#: 在 4.17 版本新加入.

Configures UNUSED_ALERT_DAYS.

WEBLATE_CORS_ALLOWED_ORIGINS#

在 4.16 版本新加入.

Allow CORS requests from given origins.

示例：

environment:
  WEBLATE_CORS_ALLOWED_ORIGINS: https://example.com,https://weblate.org

CLIENT_MAX_BODY_SIZE#

在 4.16.3 版本新加入.

Configures maximal body size accepted by the built-in web server.

environment:
    CLIENT_MAX_BODY_SIZE: 200m

提示

This variable intentionally lacks WEBLATE_ prefix as it is shared with third-party container used in 使用 Let’s Encrypt 自動生成 SSL 證書.

Automatic suggestion settings#

在 4.13 版本變更: Automatic suggestion services are now configured in the user interface, see 配置自動建議.

The existing environment variables are imported during the migration to Weblate 4.13, but changing them will not have any further effect.

身份驗證設置#

LDAP#

WEBLATE_AUTH_LDAP_SERVER_URI#

WEBLATE_AUTH_LDAP_USER_DN_TEMPLATE#

WEBLATE_AUTH_LDAP_USER_ATTR_MAP#

WEBLATE_AUTH_LDAP_BIND_DN#

WEBLATE_AUTH_LDAP_BIND_PASSWORD#

WEBLATE_AUTH_LDAP_BIND_PASSWORD_FILE#: Path to the file containing the LDAP server bind password.

也參考

WEBLATE_AUTH_LDAP_BIND_PASSWORD

WEBLATE_AUTH_LDAP_CONNECTION_OPTION_REFERRALS#

WEBLATE_AUTH_LDAP_USER_SEARCH#

WEBLATE_AUTH_LDAP_USER_SEARCH_FILTER#

WEBLATE_AUTH_LDAP_USER_SEARCH_UNION#

WEBLATE_AUTH_LDAP_USER_SEARCH_UNION_DELIMITER#

LDAP authentication configuration.

直接綁定的例子：

environment:
  WEBLATE_AUTH_LDAP_SERVER_URI: ldap://ldap.example.org
  WEBLATE_AUTH_LDAP_USER_DN_TEMPLATE: uid=%(user)s,ou=People,dc=example,dc=net
  # map weblate 'full_name' to ldap 'name' and weblate 'email' attribute to 'mail' ldap attribute.
  # another example that can be used with OpenLDAP: 'full_name:cn,email:mail'
  WEBLATE_AUTH_LDAP_USER_ATTR_MAP: full_name:name,email:mail

搜索與綁定的例子：

environment:
  WEBLATE_AUTH_LDAP_SERVER_URI: ldap://ldap.example.org
  WEBLATE_AUTH_LDAP_BIND_DN: CN=ldap,CN=Users,DC=example,DC=com
  WEBLATE_AUTH_LDAP_BIND_PASSWORD: password
  WEBLATE_AUTH_LDAP_USER_ATTR_MAP: full_name:name,email:mail
  WEBLATE_AUTH_LDAP_USER_SEARCH: CN=Users,DC=example,DC=com

聯合搜索與綁定的例子：

environment:
  WEBLATE_AUTH_LDAP_SERVER_URI: ldap://ldap.example.org
  WEBLATE_AUTH_LDAP_BIND_DN: CN=ldap,CN=Users,DC=example,DC=com
  WEBLATE_AUTH_LDAP_BIND_PASSWORD: password
  WEBLATE_AUTH_LDAP_USER_ATTR_MAP: full_name:name,email:mail
  WEBLATE_AUTH_LDAP_USER_SEARCH_UNION: ou=users,dc=example,dc=com|ou=otherusers,dc=example,dc=com

針對活動目錄（ Active Directory ）的搜索與綁定的例子：

environment:
  WEBLATE_AUTH_LDAP_BIND_DN: CN=ldap,CN=Users,DC=example,DC=com
  WEBLATE_AUTH_LDAP_BIND_PASSWORD: password
  WEBLATE_AUTH_LDAP_SERVER_URI: ldap://ldap.example.org
  WEBLATE_AUTH_LDAP_CONNECTION_OPTION_REFERRALS: 0
  WEBLATE_AUTH_LDAP_USER_ATTR_MAP: full_name:name,email:mail
  WEBLATE_AUTH_LDAP_USER_SEARCH: CN=Users,DC=example,DC=com
  WEBLATE_AUTH_LDAP_USER_SEARCH_FILTER: (sAMAccountName=%(user)s)

也參考

LDAP 身份驗證

GitHub#

WEBLATE_SOCIAL_AUTH_GITHUB_KEY#

WEBLATE_SOCIAL_AUTH_GITHUB_SECRET#

WEBLATE_SOCIAL_AUTH_GITHUB_ORG_KEY#

WEBLATE_SOCIAL_AUTH_GITHUB_ORG_SECRET#

WEBLATE_SOCIAL_AUTH_GITHUB_ORG_NAME#

WEBLATE_SOCIAL_AUTH_GITHUB_TEAM_KEY#

WEBLATE_SOCIAL_AUTH_GITHUB_TEAM_SECRET#

WEBLATE_SOCIAL_AUTH_GITHUB_TEAM_ID#: 允許 GitHub 驗證。

Bitbucket#

WEBLATE_SOCIAL_AUTH_BITBUCKET_OAUTH2_KEY#

WEBLATE_SOCIAL_AUTH_BITBUCKET_OAUTH2_SECRET#

WEBLATE_SOCIAL_AUTH_BITBUCKET_KEY#

WEBLATE_SOCIAL_AUTH_BITBUCKET_SECRET#: 允許 Butbucket 驗證。

Facebook#

WEBLATE_SOCIAL_AUTH_FACEBOOK_KEY#

WEBLATE_SOCIAL_AUTH_FACEBOOK_SECRET#: 允許 Facebook 驗證 2.

Google#

WEBLATE_SOCIAL_AUTH_GOOGLE_OAUTH2_KEY#

WEBLATE_SOCIAL_AUTH_GOOGLE_OAUTH2_SECRET#

WEBLATE_SOCIAL_AUTH_GOOGLE_OAUTH2_WHITELISTED_DOMAINS#

WEBLATE_SOCIAL_AUTH_GOOGLE_OAUTH2_WHITELISTED_EMAILS#: 允許 Google OAuth 2。

GitLab#

WEBLATE_SOCIAL_AUTH_GITLAB_KEY#

WEBLATE_SOCIAL_AUTH_GITLAB_SECRET#

WEBLATE_SOCIAL_AUTH_GITLAB_API_URL#: 允許 GitLab 驗證 2。

Gitea#

WEBLATE_SOCIAL_AUTH_GITEA_API_URL#

WEBLATE_SOCIAL_AUTH_GITEA_KEY#

WEBLATE_SOCIAL_AUTH_GITEA_SECRET#: Enables Gitea authentication.

Azure Active Directory#

WEBLATE_SOCIAL_AUTH_AZUREAD_OAUTH2_KEY#

WEBLATE_SOCIAL_AUTH_AZUREAD_OAUTH2_SECRET#: 允許 Azure 活動目錄身份驗證，請參見微軟 Azure Active Directory。

帶有租戶支持的Azure 活動目錄#

WEBLATE_SOCIAL_AUTH_AZUREAD_TENANT_OAUTH2_KEY#

WEBLATE_SOCIAL_AUTH_AZUREAD_TENANT_OAUTH2_SECRET#

WEBLATE_SOCIAL_AUTH_AZUREAD_TENANT_OAUTH2_TENANT_ID#: 允許帶有租戶支持的Azure 活動目錄身份驗證，請參見微軟 Azure Active Directory。

Keycloak#

WEBLATE_SOCIAL_AUTH_KEYCLOAK_KEY#

WEBLATE_SOCIAL_AUTH_KEYCLOAK_SECRET#

WEBLATE_SOCIAL_AUTH_KEYCLOAK_PUBLIC_KEY#

WEBLATE_SOCIAL_AUTH_KEYCLOAK_ALGORITHM#

WEBLATE_SOCIAL_AUTH_KEYCLOAK_AUTHORIZATION_URL#

WEBLATE_SOCIAL_AUTH_KEYCLOAK_ACCESS_TOKEN_URL#

WEBLATE_SOCIAL_AUTH_KEYCLOAK_TITLE#

WEBLATE_SOCIAL_AUTH_KEYCLOAK_IMAGE#: 允許 Keycloak 身份驗證，請參見 documentation。

Linux 銷售商#

您可以通過將後面的變量設置為任何值，使用 Linux 銷售商身份驗證服務來允許身份驗證。

WEBLATE_SOCIAL_AUTH_FEDORA#

WEBLATE_SOCIAL_AUTH_OPENSUSE#

WEBLATE_SOCIAL_AUTH_OPENINFRA#

WEBLATE_SOCIAL_AUTH_UBUNTU#

Slack#

WEBLATE_SOCIAL_AUTH_SLACK_KEY#

SOCIAL_AUTH_SLACK_SECRET#: 允許 Slack 身份驗證，請參見 Slack。

OpenID 連結#

在 4.13-1 版本新加入.

WEBLATE_SOCIAL_AUTH_OIDC_OIDC_ENDPOINT#

WEBLATE_SOCIAL_AUTH_OIDC_KEY#

WEBLATE_SOCIAL_AUTH_OIDC_SECRET#

WEBLATE_SOCIAL_AUTH_OIDC_USERNAME_KEY#: Configures generic OpenID Connect integration.

也參考

OIDC (OpenID Connect)

SAML#

在第一次啟動容器時自動產生自簽名的 SAML 密鑰。在您想要使用自己的密鑰的情況下，將證書和私鑰放置在:file:/app/data/ssl/saml.crt 和:file:`/app/data/ssl/saml.key `中。

WEBLATE_SAML_IDP_ENTITY_ID#

WEBLATE_SAML_IDP_URL#

WEBLATE_SAML_IDP_X509CERT#

WEBLATE_SAML_IDP_IMAGE#

WEBLATE_SAML_IDP_TITLE#: SAML 身份提供者設置，請參見 SAML 身份驗證。

Other authentication settings#

WEBLATE_NO_EMAIL_AUTH#: Disables e-mail authentication when set to any value. See 關閉密碼身份驗證.

PostgreSQL 資料庫設定#

資料庫由 docker-compose.yml 建立，所以這些設置影響 Weblate 和 PostgreSQL 容器。

也參考

Weblate 的資料庫設置

POSTGRES_PASSWORD#: PostgreSQL 密碼。

POSTGRES_PASSWORD_FILE#: 包含PostgreSQL密碼的文件的路徑。用作postgres_password的替代品。

POSTGRES_USER#: PostgreSQL 使用者名。

POSTGRES_DATABASE#: PostgreSQL 資料庫名稱。

POSTGRES_HOST#: PostgreSQL 服務器主機名成或 IP 地址。預設為 database。

POSTGRES_PORT#: PostgreSQL 服務器端口。預設為無（使用預設值）。

POSTGRES_SSL_MODE#: 配置 PostgreSQL 如何處理 SSL 連接到服務器，可能的選項請參見 SSL Mode Descriptions

POSTGRES_ALTER_ROLE#: 在遷移過程中配置要改變的角色名稱，請參見配置 Weblate 來使用 PostgreSQL。

POSTGRES_CONN_MAX_AGE#

在 4.8.1 版本新加入.

The lifetime of a database connection, as an integer of seconds. Use 0 to close database connections at the end of each request (this is the default behavior).

Enabling connection persistence will typically, cause more open connection to the database. Please adjust your database configuration prior enabling.

配置的例子：

environment:
    POSTGRES_CONN_MAX_AGE: 3600

也參考

CONN_MAX_AGE, Persistent connections

POSTGRES_DISABLE_SERVER_SIDE_CURSORS#

在 4.9.1 版本新加入.

Disable server side cursors in the database. This is necessary in some pgbouncer setups.

配置的例子：

environment:
    POSTGRES_DISABLE_SERVER_SIDE_CURSORS: 1

也參考

DISABLE_SERVER_SIDE_CURSORS, Transaction pooling and server-side cursors

資料庫備份設定#

也參考

下載的數據用於備份

WEBLATE_DATABASE_BACKUP#: 使用 DATABASE_BACKUP 配置每日資料庫轉儲。預設為 plain。

快取伺服器設定#

Weblate 強烈推薦使用 Redis，在 Docker 中運行 Weblate 時您必須提供 Redis 事例。

也參考

允許緩存

REDIS_HOST#: Redis 服務器主機名稱或 IP 地址。預設為 cache。

REDIS_PORT#: Redis 服務器端口。預設為 6379。

REDIS_DB#: Redis 資料庫編號，預設為 1。

REDIS_PASSWORD#: Redis 服務器密碼，預設不使用。

REDIS_PASSWORD_FILE#: Path to the file containing the Redis server password.

也參考

REDIS_PASSWORD

REDIS_TLS#: 允許使用 SSL 進行 Redis 連接。

REDIS_VERIFY_SSL#: 可以用於禁止 Redis 連接的 SSL 身份認證。

郵件伺服器設定#

要使外發電子郵件正常工作，您需要提供一個郵件服務器。

TLS 設定範例：

environment:
    WEBLATE_EMAIL_HOST: smtp.example.com
    WEBLATE_EMAIL_HOST_USER: user
    WEBLATE_EMAIL_HOST_PASSWORD: pass

SSL 設定範例：

environment:
    WEBLATE_EMAIL_HOST: smtp.example.com
    WEBLATE_EMAIL_PORT: 465
    WEBLATE_EMAIL_HOST_USER: user
    WEBLATE_EMAIL_HOST_PASSWORD: pass
    WEBLATE_EMAIL_USE_TLS: 0
    WEBLATE_EMAIL_USE_SSL: 1

也參考

設定外寄郵件信箱

WEBLATE_EMAIL_HOST#: 郵件服務器主機名或 IP 地址。

也參考

WEBLATE_EMAIL_PORT, WEBLATE_EMAIL_USE_SSL, WEBLATE_EMAIL_USE_TLS, EMAIL_HOST

WEBLATE_EMAIL_PORT#: 郵件服務器端口，預設為 25。

也參考

EMAIL_PORT

WEBLATE_EMAIL_HOST_USER#: E-mail authentication user.

也參考

EMAIL_HOST_USER

WEBLATE_EMAIL_HOST_PASSWORD#: E-mail authentication password.

也參考

EMAIL_HOST_PASSWORD

WEBLATE_EMAIL_HOST_PASSWORD_FILE#: Path to the file containing the e-mail authentication password.

也參考

WEBLATE_EMAIL_HOST_PASSWORD

WEBLATE_EMAIL_USE_SSL#: 與 SMTP 服務器通信時是否使用隱式 TLS（安全）連接。在大多數電子郵件文件中，這種 TLS 連接類型稱為 SSL。通常在端口 465 上使用。如果遇到問題，請參閱顯式 TLS 設置 WEBLATE_EMAIL_USE_TLS。

在 4.11 版本變更: 支援 SSL/TLS 將依 :envvar:`WEBLATE_EMAIL_PORT`自動啟用。

也參考

WEBLATE_EMAIL_PORT, WEBLATE_EMAIL_USE_TLS, EMAIL_USE_SSL

WEBLATE_EMAIL_USE_TLS#: 與 SMTP 服務器通訊時是否使用 TLS（安全）連接。這用於顯式 TLS 連接，通常在端口 587 或 25 上。如果您遇到掛起的連接，請參見隱式 TLS 設置 WEBLATE_EMAIL_USE_SSL。

在 4.11 版本變更: 支援 SSL/TLS 將依 :envvar:`WEBLATE_EMAIL_PORT`自動啟用。

也參考

WEBLATE_EMAIL_PORT, WEBLATE_EMAIL_USE_SSL, EMAIL_USE_TLS

WEBLATE_EMAIL_BACKEND#: 將 Django 後端配置為用於發送電子郵件。

也參考

郵件外送設定, EMAIL_BACKEND

WEBLATE_AUTO_UPDATE#: Configures if and how Weblate should update repositories.

也參考

AUTO_UPDATE

備註

這是布林值的設定（使用 "true" 或 "false"）。

Site integration#

WEBLATE_GET_HELP_URL#: 配置 GET_HELP_URL.

WEBLATE_STATUS_URL#: 配置 STATUS_URL.

WEBLATE_LEGAL_URL#: 配置: setting:LEGAL_URL.

WEBLATE_PRIVACY_URL#: Configures PRIVACY_URL.

錯誤報告#

推薦從安裝中系統地收集錯誤，請參見蒐集錯誤訊息報告。

要啟用對 Rollbar 的支持，請進行以下設置：

ROLLBAR_KEY#: 您的 Rollbar 發佈服務器訪問令牌。

ROLLBAR_ENVIRONMENT#: 您的 Rollbar 環境，預設為 production。

要啟用對 Sentry 的支持，請進行以下設置：

SENTRY_DSN#: 您的 Sentry DSN。

SENTRY_ENVIRONMENT#: 您的 Sentry 環境（可選）。

Localization CDN#

WEBLATE_LOCALIZE_CDN_URL#

WEBLATE_LOCALIZE_CDN_PATH#

在 4.2.1 版本新加入.

:ref:`addon-weblate.cdn.cdnjs`的配置。

WEBLATE_LOCALIZE_CDN_PATH 是容器內的路徑。它應該存儲在持久卷上，而不能存儲在瞬態存儲器中。

一種可能性是存儲在 Weblate 數據目錄中：

environment:
  WEBLATE_LOCALIZE_CDN_URL: https://cdn.example.com/
  WEBLATE_LOCALIZE_CDN_PATH: /app/data/l10n-cdn

備註

您負責設置Weblate生成的文件的服務，它只在配置的位置存儲文件。

也參考

使用 Weblate CDN 翻譯 HTML 和 JavaScript, LOCALIZE_CDN_URL, LOCALIZE_CDN_PATH

更改允許的 app 、檢查、附加元件或自動修復#

在 3.8-5 版本新加入.

可以通過後面的變量來調整允許的檢查、附加元件或自動修復的內建配置：

WEBLATE_ADD_APPS#

WEBLATE_REMOVE_APPS#

WEBLATE_ADD_CHECK#

WEBLATE_REMOVE_CHECK#

WEBLATE_ADD_AUTOFIX#

WEBLATE_REMOVE_AUTOFIX#

WEBLATE_ADD_ADDONS#

WEBLATE_REMOVE_ADDONS#

示例：

environment:
  WEBLATE_REMOVE_AUTOFIX: weblate.trans.autofixes.whitespace.SameBookendingWhitespace
  WEBLATE_ADD_ADDONS: customize.addons.MyAddon,customize.addons.OtherAddon

也參考

CHECK_LIST, AUTOFIX_LIST, WEBLATE_ADDONS, INSTALLED_APPS

Container settings#

WEBLATE_WORKERS#

在 4.6.1 版本新加入.

在容器中運行的工人進程基數。未設置時，基於可用的CPU核心數，在容器啟動時自動確定。

It is used to determine CELERY_MAIN_OPTIONS, CELERY_NOTIFY_OPTIONS, CELERY_MEMORY_OPTIONS, CELERY_TRANSLATE_OPTIONS, CELERY_BACKUP_OPTIONS, CELERY_BEAT_OPTIONS, and WEB_WORKERS. You can use these settings to fine-tune.

CELERY_MAIN_OPTIONS#

CELERY_NOTIFY_OPTIONS#

CELERY_MEMORY_OPTIONS#

CELERY_TRANSLATE_OPTIONS#

CELERY_BACKUP_OPTIONS#

CELERY_BEAT_OPTIONS#

這些變量允許您調整 Celery worker 選項。它可以用於調整併發性（ --concurrency 16 ），或使用不同的池實現（ --pool=gevent ）。

預設情況下，並發工作人員的數量基於：envvar：weblate_workers。

示例：

environment:
  CELERY_MAIN_OPTIONS: --concurrency 16

也參考

:doc:“Celery Worker”選項<Celery：Reference / Celery.Bin.Worker>`，：Ref：“芹菜”

WEB_WORKERS#

配置應該執行多少個 uWSGI workers。

依 WEBLATE_WORKERS 為設定值。

示例：

environment:
  WEB_WORKERS: 32

WEBLATE_SERVICE#

定義應在容器內執行哪些服務，使用對象平行擴展。

Following services are defined:

celery-beat: Celery任務調度程序，只能運行一個實例。該容器也負責資料庫結構遷移，並且應該在其他人之前啟動。
celery-backup: 凱利工人備份，只能運行一個例子。
celery-celery: Generic Celery worker.
celery-memory: Translation memory Celery worker.
celery-notify: Notifications Celery worker.
celery-translate: Automatic translation Celery worker.
web: Web 服務器。

Docker 容器 volumes#

Weblate 容器導出了兩個卷（數據和緩存）。其他服務容器（PostgreSQL 或 Redis）也具有其數據卷，但本文件未涵蓋這些數據卷。

數據卷用於存儲 Weblate 持久數據（例如克隆的倉儲）或自定義 Weblate 安裝。

Docker 卷在主機系統上的位置取決於您的 Docker 配置，但通常存儲在 /var/lib/docker/volumes/weblate-docker_weblate-data/_data/ 中。 (該路徑由您的 docker-compose 目錄的名稱、容器和卷的名稱組成）。在容器中，它掛載為 /app/data。

The cache volume is mounted as /app/cache and is used to store static files and CACHE_DIR. Its content is recreated on container startup and the volume can be mounted using ephemeral filesystem such as tmpfs.

當手動建立 volumes 時，請在容器中指定的資料夾擁有者權限設定為 UID 1000。

也參考

Docker 卷文件

Configuration beyond environment variables#

Docker environment variables are intended to expose most configuration settings of relevance for Weblate installations.

If you find a setting that is not exposed as an environment variable, and you believe that it should be, feel free to ask for it to be exposed in a future version of Weblate.

If you need to modify a setting that is not exposed as a Docker environment variable, you can still do so, either from the data volume or extending the Docker image.

也參考

定制 Weblate

資料 volume 的覆蓋設定#

You can create a file at /app/data/settings-override.py, i.e. at the root of the data volume, to extend or override settings defined through environment variables.

Overriding settings by extending the Docker image#

To override settings at the Docker image level instead of from the data volume:

建立自訂的 Python 套件.
Add a module to your package that imports all settings from weblate.settings_docker.

For example, within the example package structure defined at 建立 Python 模塊, you could create a file at weblate_customization/weblate_customization/settings.py with the following initial code:
```
from weblate.settings_docker import *
```

Create a custom Dockerfile that inherits from the official Weblate Docker image, and then installs your package and points the DJANGO_SETTINGS_MODULE environment variable to your settings module:

FROM weblate/weblate

USER root

COPY weblate_customization /usr/src/weblate_customization
RUN pip install --no-cache-dir /usr/src/weblate_customization
ENV DJANGO_SETTINGS_MODULE=weblate_customization.settings

USER 1000

Instead of using the official Weblate Docker image, build a custom image from this Dockerfile file.

There is no clean way to do this with docker-compose.override.yml. You could add build: . to the weblate node in that file, but then your custom image will be tagged as weblate/weblate in your system, which could be problematic.

So, instead of using the docker-compose.yml straight from the official repository, unmodified, and extending it through docker-compose.override.yml, you may want to make a copy of the official docker-compose.yml file, and edit your copy to replace image: weblate/weblate with build: ..

See the Compose file build reference for details on building images from source when using docker-compose.
Extend your custom settings module to define or redefine settings.

You can define settings before or after the import statement above to determine which settings take precedence. Settings defined before the import statement can be overridden by environment variables and setting overrides defined in the data volume. Setting defined after the import statement cannot be overridden.

You can also go further. For example, you can reproduce some of the things that weblate.docker_settings does, such as exposing settings as environment variables, or allow overriding settings from Python files in the data volume.

替換 logo 和其它靜態文件#

在 3.8-5 版本新加入.

Weblate 附帶的靜態文件可以通過放置到 /app/data/python/customize/static 中來覆蓋（請參閱 Docker 容器 volumes）。例如，創建 /app/data/python/customize/static/favicon.ico 將替換 favicon。

提示

在容器啟動時，這些文件被複製到相應的位置，因此需要在更改卷的內容後重新啟動 Weblate。

This approach can be also used to override Weblate templates. For example 法律 documents can be placed into /app/data/python/customize/templates/legal/documents.

或者，您也可以包括自己的模塊（請參閱定制 Weblate），並將其作為單獨的捲添加到 Docker 容器中，例如：

weblate:
  volumes:
    - weblate-data:/app/data
    - ./weblate_customization/weblate_customization:/app/data/python/weblate_customization
  environment:
    WEBLATE_ADD_APPS: weblate_customization

Configuring PostgreSQL server#

The PostgtreSQL container uses default PostgreSQL configuration and it won’t effectively utilize your CPU cores or memory. It is recommended to customize the configuration to improve the performance.

The configuration can be adjusted as described in Database Configuration at https://hub.docker.com/_/postgres. The configuration matching your environment can be generated using https://pgtune.leopard.in.ua/.

Container internals#

The container is using supervisor to start individual services. In case of 平行擴展, it only starts single service in a container.

確認服務狀態使用：

docker-compose exec --user weblate weblate supervisorctl status

There are individual services for each Celery queue (see 使用 Celery 的後台任務 for details). You can stop processing some tasks by stopping the appropriate worker:

docker-compose exec --user weblate weblate supervisorctl stop celery-translate

在 Debian 和 Ubantu 上安裝#

硬件要求#

Weblate 應該可以在任何現代硬件上正常運行，以下是在單個主機（ Weblate，資料庫和 Web 服務器）上運行 Weblate 所需的最低配置：

3 GB of RAM
2 CPU 核心
1 GB 的存儲空間

內存越多越好 —— 用於所有級別的緩存（文件系統，資料庫和 Weblate ）。

許多並髮使用者會增加所需的 CPU 內核數量。對於數百個翻譯組件，推薦至少有 4 GB 的內存。

典型的資料庫存儲用量大約為每 1 百萬單詞 300 MB。克隆倉儲所需的存儲空間會變化，但 Weblate 試圖通過淺克隆將其大小最小化。

備註

根據 Weblate 中管理的翻譯大小，安裝 Weblate 的實際要求差異很大。

安裝#

系統要求#

安裝所需的依賴包，來建立 Python 模塊（參見軟件要求）：

apt install -y \
   libxml2-dev libxslt-dev libfreetype6-dev libjpeg-dev libz-dev libyaml-dev \
   libffi-dev libcairo-dev gir1.2-pango-1.0 libgirepository1.0-dev \
   libacl1-dev libssl-dev libpq-dev libjpeg-dev build-essential \
   python3-gdbm python3-dev python3-pip python3-virtualenv virtualenv git

根據您想要使用的特性來安裝想要的可選依賴包（參見可選依賴性）：

apt install -y \
   tesseract-ocr libtesseract-dev libleptonica-dev \
   libldap2-dev libldap-common libsasl2-dev \
   libxmlsec1-dev

可選地安裝生產服務器運行所需要的軟件，參見服務器運行中、 Weblate 的資料庫設置、使用 Celery 的後台任務。根據於您的安裝所佔的空間，您會想要在特定的服務器上運行這些組件。

本地安裝的使用說明：

# Web server option 1: NGINX and uWSGI
apt install -y nginx uwsgi uwsgi-plugin-python3

# Web server option 2: Apache with ``mod_wsgi``
apt install -y apache2 libapache2-mod-wsgi-py3

# Caching backend: Redis
apt install -y redis-server

# Database server: PostgreSQL
apt install -y postgresql postgresql-contrib

# SMTP server
apt install -y exim4

Python 模塊#

提示

我們使用 virtualenv 在與您的系統隔開的環境安裝 Weblate。如果您不熟悉，查看 virtualenv User Guide。

為 Weblate 新建 virtualenv：
```
virtualenv ~/weblate-env
```
為 Weblate 激活 virtualevn ：
```
. ~/weblate-env/bin/activate
```
Install Weblate including all optional dependencies:
```
# Install Weblate with all optional dependencies
pip install "Weblate[all]"
```
Please check 可選依賴性 for fine-tuning of optional dependencies.
備註

在一些 Linux 發行版運行 Weblate 發生 libffi 相關錯誤：
```
ffi_prep_closure(): bad user_data (it seems that the version of the libffi library seen at runtime is different from the 'ffi.h' file seen at compile-time)
```
This is caused by incompatibility of binary packages distributed via PyPI with the distribution. To address this, you need to rebuild the package on your system:
```
pip install --force-reinstall --no-binary :all: cffi
```

配置 Weblate#

備註

The following assumes the virtualenv used by Weblate is activated (by executing . ~/weblate-env/bin/activate). If not, specify the full path to the weblate command as ~/weblate-env/bin/weblate.

將文件:file:~/weblate-env/lib/python3.9/site-packages/weblate/settings_example.py 複製為:file:~/weblate-env/lib/python3.9/site-packages/ weblate/settings.py。
Adjust the values in the new settings.py file to your liking. You will need to provide at least the database credentials and Django secret key, but you will want more changes for production setup, see 調整配置.
Create the database and its structure for Weblate (the example settings use PostgreSQL, check Weblate 的資料庫設置 for a production-ready setup):
```
weblate migrate
```
Create an account for the administrator user and copy its password to the clipboard, and also save it for later use:
```
weblate createadmin
```
Collect the static files for your web server (see 服務器運行中 and 靜態檔案服務):
```
weblate collectstatic
```
Compress the JavaScript and CSS files (optional, see 壓縮客戶端素材):
```
weblate compress
```
Start the Celery workers. This is not necessary for development purposes, but strongly recommended otherwise. 使用 Celery 的後台任務 has more info:
```
~/weblate-env/lib/python3.9/site-packages/weblate/examples/celery start
```
Start the development server (服務器運行中 details a production setup):
```
weblate runserver
```

安裝後#

恭喜，您的 Weblate 服務現在已上線了，您可以開始使用它。

您可以在 http://localhost:8000/ 訪問 Weblate。
Sign in with admin credentials obtained during installation or register with new users.
現在，您可以在 Weblate virtualenv 活動時使用 weblate 命令來運行 Weblate 命令。
您可以使用 Ctrl+C 來停止測試的服務器。
Review potential issues with your installation either on /manage/performance/ URL (see 管理介面) or using weblate check --deploy, see 生產設置.

添加翻譯#

打開管理界面（ http://localhost:8000/create/project/ ），並新建您想要翻譯的項目。更多細節請參見項目配置。

這裡所有需要您指定的只是項目名稱及其網站。
新建組件，它是翻譯的真實對象——它執行版本控制系統（VCS ）倉儲，並用於選擇那個文件被翻譯。更多細節請參見組件配置。

The important fields here are: 組件名稱, 源始碼倉儲, and 文件掩碼 for finding translatable files. Weblate supports a wide range of formats including GNU gettext, Android字串資源, 蘋果 iOS 字串, Java 屬性, Stringsdict format or Fluent format, see 支持的文件格式 for more details.
一旦完成上面的工作（根據您的版本控制系統 VCS 倉儲的大小，以及需要翻譯的信息數量，這可能是個漫長的過程），您就可以開始翻譯了。

在 SUSE 和 openSUSE 上安裝#

硬件要求#

Weblate 應該可以在任何現代硬件上正常運行，以下是在單個主機（ Weblate，資料庫和 Web 服務器）上運行 Weblate 所需的最低配置：

3 GB of RAM
2 CPU 核心
1 GB 的存儲空間

內存越多越好 —— 用於所有級別的緩存（文件系統，資料庫和 Weblate ）。

許多並髮使用者會增加所需的 CPU 內核數量。對於數百個翻譯組件，推薦至少有 4 GB 的內存。

典型的資料庫存儲用量大約為每 1 百萬單詞 300 MB。克隆倉儲所需的存儲空間會變化，但 Weblate 試圖通過淺克隆將其大小最小化。

備註

根據 Weblate 中管理的翻譯大小，安裝 Weblate 的實際要求差異很大。

安裝#

系統要求#

安裝所需的依賴包，來建立 Python 模塊（參見軟件要求）：

zypper install \
   libxslt-devel libxml2-devel freetype-devel libjpeg-devel zlib-devel \
   libyaml-devel libffi-devel cairo-devel pango-devel \
   gobject-introspection-devel libacl-devel python3-pip python3-virtualenv \
   python3-devel git

根據您想要使用的特性來安裝想要的可選依賴包（參見可選依賴性）：

zypper install tesseract-ocr tesseract-devel leptonica-devel
zypper install libldap2-devel libsasl2-devel
zypper install libxmlsec1-devel

本地安裝的使用說明：

# Web server option 1: NGINX and uWSGI
zypper install nginx uwsgi uwsgi-plugin-python3

# Web server option 2: Apache with ``mod_wsgi``
zypper install apache2 apache2-mod_wsgi

# Caching backend: Redis
zypper install redis-server

# Database server: PostgreSQL
zypper install postgresql postgresql-contrib

# SMTP server
zypper install postfix

Python 模塊#

提示

我們使用 virtualenv 在與您的系統隔開的環境安裝 Weblate。如果您不熟悉，查看 virtualenv User Guide。

為 Weblate 新建 virtualenv：
```
virtualenv ~/weblate-env
```
為 Weblate 激活 virtualevn ：
```
. ~/weblate-env/bin/activate
```
Install Weblate including all optional dependencies:
```
# Install Weblate with all optional dependencies
pip install "Weblate[all]"
```
Please check 可選依賴性 for fine-tuning of optional dependencies.
備註

在一些 Linux 發行版運行 Weblate 發生 libffi 相關錯誤：
```
ffi_prep_closure(): bad user_data (it seems that the version of the libffi library seen at runtime is different from the 'ffi.h' file seen at compile-time)
```
This is caused by incompatibility of binary packages distributed via PyPI with the distribution. To address this, you need to rebuild the package on your system:
```
pip install --force-reinstall --no-binary :all: cffi
```

配置 Weblate#

備註

將文件:file:~/weblate-env/lib/python3.9/site-packages/weblate/settings_example.py 複製為:file:~/weblate-env/lib/python3.9/site-packages/ weblate/settings.py。
Adjust the values in the new settings.py file to your liking. You will need to provide at least the database credentials and Django secret key, but you will want more changes for production setup, see 調整配置.
Create the database and its structure for Weblate (the example settings use PostgreSQL, check Weblate 的資料庫設置 for a production-ready setup):
```
weblate migrate
```
Create an account for the administrator user and copy its password to the clipboard, and also save it for later use:
```
weblate createadmin
```
Collect the static files for your web server (see 服務器運行中 and 靜態檔案服務):
```
weblate collectstatic
```
Compress the JavaScript and CSS files (optional, see 壓縮客戶端素材):
```
weblate compress
```
Start the Celery workers. This is not necessary for development purposes, but strongly recommended otherwise. 使用 Celery 的後台任務 has more info:
```
~/weblate-env/lib/python3.9/site-packages/weblate/examples/celery start
```
Start the development server (服務器運行中 details a production setup):
```
weblate runserver
```

安裝後#

恭喜，您的 Weblate 服務現在已上線了，您可以開始使用它。

您可以在 http://localhost:8000/ 訪問 Weblate。
Sign in with admin credentials obtained during installation or register with new users.
現在，您可以在 Weblate virtualenv 活動時使用 weblate 命令來運行 Weblate 命令。
您可以使用 Ctrl+C 來停止測試的服務器。
Review potential issues with your installation either on /manage/performance/ URL (see 管理介面) or using weblate check --deploy, see 生產設置.

添加翻譯#

打開管理界面（ http://localhost:8000/create/project/ ），並新建您想要翻譯的項目。更多細節請參見項目配置。

這裡所有需要您指定的只是項目名稱及其網站。
新建組件，它是翻譯的真實對象——它執行版本控制系統（VCS ）倉儲，並用於選擇那個文件被翻譯。更多細節請參見組件配置。

The important fields here are: 組件名稱, 源始碼倉儲, and 文件掩碼 for finding translatable files. Weblate supports a wide range of formats including GNU gettext, Android字串資源, 蘋果 iOS 字串, Java 屬性, Stringsdict format or Fluent format, see 支持的文件格式 for more details.
一旦完成上面的工作（根據您的版本控制系統 VCS 倉儲的大小，以及需要翻譯的信息數量，這可能是個漫長的過程），您就可以開始翻譯了。

在 Redhat 、 Fedora 和 CentOS 上安裝#

硬件要求#

Weblate 應該可以在任何現代硬件上正常運行，以下是在單個主機（ Weblate，資料庫和 Web 服務器）上運行 Weblate 所需的最低配置：

3 GB of RAM
2 CPU 核心
1 GB 的存儲空間

內存越多越好 —— 用於所有級別的緩存（文件系統，資料庫和 Weblate ）。

許多並髮使用者會增加所需的 CPU 內核數量。對於數百個翻譯組件，推薦至少有 4 GB 的內存。

典型的資料庫存儲用量大約為每 1 百萬單詞 300 MB。克隆倉儲所需的存儲空間會變化，但 Weblate 試圖通過淺克隆將其大小最小化。

備註

根據 Weblate 中管理的翻譯大小，安裝 Weblate 的實際要求差異很大。

安裝#

系統要求#

安裝所需的依賴包，來建立 Python 模塊（參見軟件要求）：

dnf install \
   libxslt-devel libxml2-devel freetype-devel libjpeg-devel zlib-devel \
   libyaml-devel libffi-devel cairo-devel pango-devel \
   gobject-introspection-devel libacl-devel python3-pip python3-virtualenv \
   python3-devel git

根據您想要使用的特性來安裝想要的可選依賴包（參見可選依賴性）：

dnf install tesseract-langpack-eng tesseract-devel leptonica-devel
dnf install libldap2-devel libsasl2-devel
dnf install libxmlsec1-devel

本地安裝的使用說明：

# Web server option 1: NGINX and uWSGI
dnf install nginx uwsgi uwsgi-plugin-python3

# Web server option 2: Apache with ``mod_wsgi``
dnf install apache2 apache2-mod_wsgi

# Caching backend: Redis
dnf install redis

# Database server: PostgreSQL
dnf install postgresql postgresql-contrib

# SMTP server
dnf install postfix

Python 模塊#

提示

我們使用 virtualenv 在與您的系統隔開的環境安裝 Weblate。如果您不熟悉，查看 virtualenv User Guide。

為 Weblate 新建 virtualenv：
```
virtualenv ~/weblate-env
```
為 Weblate 激活 virtualevn ：
```
. ~/weblate-env/bin/activate
```
Install Weblate including all optional dependencies:
```
# Install Weblate with all optional dependencies
pip install "Weblate[all]"
```
Please check 可選依賴性 for fine-tuning of optional dependencies.
備註

在一些 Linux 發行版運行 Weblate 發生 libffi 相關錯誤：
```
ffi_prep_closure(): bad user_data (it seems that the version of the libffi library seen at runtime is different from the 'ffi.h' file seen at compile-time)
```
This is caused by incompatibility of binary packages distributed via PyPI with the distribution. To address this, you need to rebuild the package on your system:
```
pip install --force-reinstall --no-binary :all: cffi
```

配置 Weblate#

備註

將文件:file:~/weblate-env/lib/python3.9/site-packages/weblate/settings_example.py 複製為:file:~/weblate-env/lib/python3.9/site-packages/ weblate/settings.py。
Adjust the values in the new settings.py file to your liking. You will need to provide at least the database credentials and Django secret key, but you will want more changes for production setup, see 調整配置.
Create the database and its structure for Weblate (the example settings use PostgreSQL, check Weblate 的資料庫設置 for a production-ready setup):
```
weblate migrate
```
Create an account for the administrator user and copy its password to the clipboard, and also save it for later use:
```
weblate createadmin
```
Collect the static files for your web server (see 服務器運行中 and 靜態檔案服務):
```
weblate collectstatic
```
Compress the JavaScript and CSS files (optional, see 壓縮客戶端素材):
```
weblate compress
```
Start the Celery workers. This is not necessary for development purposes, but strongly recommended otherwise. 使用 Celery 的後台任務 has more info:
```
~/weblate-env/lib/python3.9/site-packages/weblate/examples/celery start
```
Start the development server (服務器運行中 details a production setup):
```
weblate runserver
```

安裝後#

恭喜，您的 Weblate 服務現在已上線了，您可以開始使用它。

您可以在 http://localhost:8000/ 訪問 Weblate。
Sign in with admin credentials obtained during installation or register with new users.
現在，您可以在 Weblate virtualenv 活動時使用 weblate 命令來運行 Weblate 命令。
您可以使用 Ctrl+C 來停止測試的服務器。
Review potential issues with your installation either on /manage/performance/ URL (see 管理介面) or using weblate check --deploy, see 生產設置.

添加翻譯#

打開管理界面（ http://localhost:8000/create/project/ ），並新建您想要翻譯的項目。更多細節請參見項目配置。

這裡所有需要您指定的只是項目名稱及其網站。
新建組件，它是翻譯的真實對象——它執行版本控制系統（VCS ）倉儲，並用於選擇那個文件被翻譯。更多細節請參見組件配置。

The important fields here are: 組件名稱, 源始碼倉儲, and 文件掩碼 for finding translatable files. Weblate supports a wide range of formats including GNU gettext, Android字串資源, 蘋果 iOS 字串, Java 屬性, Stringsdict format or Fluent format, see 支持的文件格式 for more details.
一旦完成上面的工作（根據您的版本控制系統 VCS 倉儲的大小，以及需要翻譯的信息數量，這可能是個漫長的過程），您就可以開始翻譯了。

在 macOS 中安裝#

硬件要求#

Weblate 應該可以在任何現代硬件上正常運行，以下是在單個主機（ Weblate，資料庫和 Web 服務器）上運行 Weblate 所需的最低配置：

3 GB of RAM
2 CPU 核心
1 GB 的存儲空間

內存越多越好 —— 用於所有級別的緩存（文件系統，資料庫和 Weblate ）。

許多並髮使用者會增加所需的 CPU 內核數量。對於數百個翻譯組件，推薦至少有 4 GB 的內存。

典型的資料庫存儲用量大約為每 1 百萬單詞 300 MB。克隆倉儲所需的存儲空間會變化，但 Weblate 試圖通過淺克隆將其大小最小化。

備註

根據 Weblate 中管理的翻譯大小，安裝 Weblate 的實際要求差異很大。

安裝#

系統要求#

安裝所需的依賴包，來建立 Python 模塊（參見軟件要求）：

brew install python pango cairo gobject-introspection libffi glib libyaml
pip install virtualenv

Make sure pip will be able to find the libffi and openssl versions provided by homebrew — this will be needed during the installation build step.

export PKG_CONFIG_PATH="/usr/local/opt/libffi/lib/pkgconfig:/usr/local/opt/openssl@3/lib/pkgconfig"

根據您想要使用的特性來安裝想要的可選依賴包（參見可選依賴性）：

brew install tesseract

本地安裝的使用說明：

# Web server option 1: NGINX and uWSGI
brew install nginx uwsgi

# Web server option 2: Apache with ``mod_wsgi``
brew install httpd

# Caching backend: Redis
brew install redis

# Database server: PostgreSQL
brew install postgresql

Python 模塊#

提示

我們使用 virtualenv 在與您的系統隔開的環境安裝 Weblate。如果您不熟悉，查看 virtualenv User Guide。

為 Weblate 新建 virtualenv：
```
virtualenv ~/weblate-env
```
為 Weblate 激活 virtualevn ：
```
. ~/weblate-env/bin/activate
```
Install Weblate including all optional dependencies:
```
# Install Weblate with all optional dependencies
pip install "Weblate[all]"
```
Please check 可選依賴性 for fine-tuning of optional dependencies.
備註

在一些 Linux 發行版運行 Weblate 發生 libffi 相關錯誤：
```
ffi_prep_closure(): bad user_data (it seems that the version of the libffi library seen at runtime is different from the 'ffi.h' file seen at compile-time)
```
This is caused by incompatibility of binary packages distributed via PyPI with the distribution. To address this, you need to rebuild the package on your system:
```
pip install --force-reinstall --no-binary :all: cffi
```

配置 Weblate#

備註

將文件:file:~/weblate-env/lib/python3.9/site-packages/weblate/settings_example.py 複製為:file:~/weblate-env/lib/python3.9/site-packages/ weblate/settings.py。
Adjust the values in the new settings.py file to your liking. You will need to provide at least the database credentials and Django secret key, but you will want more changes for production setup, see 調整配置.
Create the database and its structure for Weblate (the example settings use PostgreSQL, check Weblate 的資料庫設置 for a production-ready setup):
```
weblate migrate
```
Create an account for the administrator user and copy its password to the clipboard, and also save it for later use:
```
weblate createadmin
```
Collect the static files for your web server (see 服務器運行中 and 靜態檔案服務):
```
weblate collectstatic
```
Compress the JavaScript and CSS files (optional, see 壓縮客戶端素材):
```
weblate compress
```
Start the Celery workers. This is not necessary for development purposes, but strongly recommended otherwise. 使用 Celery 的後台任務 has more info:
```
~/weblate-env/lib/python3.9/site-packages/weblate/examples/celery start
```
Start the development server (服務器運行中 details a production setup):
```
weblate runserver
```

安裝後#

恭喜，您的 Weblate 服務現在已上線了，您可以開始使用它。

您可以在 http://localhost:8000/ 訪問 Weblate。
Sign in with admin credentials obtained during installation or register with new users.
現在，您可以在 Weblate virtualenv 活動時使用 weblate 命令來運行 Weblate 命令。
您可以使用 Ctrl+C 來停止測試的服務器。
Review potential issues with your installation either on /manage/performance/ URL (see 管理介面) or using weblate check --deploy, see 生產設置.

添加翻譯#

打開管理界面（ http://localhost:8000/create/project/ ），並新建您想要翻譯的項目。更多細節請參見項目配置。

這裡所有需要您指定的只是項目名稱及其網站。
新建組件，它是翻譯的真實對象——它執行版本控制系統（VCS ）倉儲，並用於選擇那個文件被翻譯。更多細節請參見組件配置。

The important fields here are: 組件名稱, 源始碼倉儲, and 文件掩碼 for finding translatable files. Weblate supports a wide range of formats including GNU gettext, Android字串資源, 蘋果 iOS 字串, Java 屬性, Stringsdict format or Fluent format, see 支持的文件格式 for more details.
一旦完成上面的工作（根據您的版本控制系統 VCS 倉儲的大小，以及需要翻譯的信息數量，這可能是個漫長的過程），您就可以開始翻譯了。

從原始碼中安裝#

Please follow the installation instructions for your system first up to installing Weblate:
使用 Git 來抓取最新的 Weblate 資源（或下載 tarball 包並將其解壓）：
```
git clone https://github.com/WeblateOrg/weblate.git weblate-src
```
另外，您可以發佈檔案。從可以從我們的網站 <https://weblate.org/> 來下載。下載是加密簽名的，參見驗證發佈簽名。

將當前的 Weblate 代碼安裝到 virtualenv 中：

. ~/weblate-env/bin/activate
pip install -e weblate-src

將 weblate/settings_example.py 複製為 weblate/settings.py。
Adjust the values in the new settings.py file to your liking. You will need to provide at least the database credentials and Django secret key, but you will want more changes for production setup, see 調整配置.
新建 Weblate 使用的資料庫，參見 Weblate 的資料庫設置。
建立 Django 表、靜態文件和初始數據（參見填滿資料庫和填滿資料庫）：
```
weblate migrate
weblate collectstatic
weblate compress
```
備註

無論任何時候更新倉儲時，都應該重複這一步驟。

在 OpenShift 中安裝#

使用OpenShift Weblate模板，您可以在幾秒鐘內啟動並運行您的個人Weblate實例。 Weblate的所有依賴項都已經包含在內。 PostgreSQL被設置為預設資料庫，並且使用持久化卷聲明。

您可以在 <https://github.com/WeblateOrg/openshift/> 找到模板。

安裝#

下面的示例假設您有一個正常運作的OpenShift v3.x環境，它已經安裝``oc``客戶端工具。請查看OpenShift文件中的說明。

：文件：template.yml`非常適合運行OpenShift中的所有組件。還有：文件：“模板 - 外部PostgreSQL.yml”不啟動PostgreSQL服務器，並允許您配置外部PostgreSQL服務器。

Web 控制台#

從`template.yml <https://github.com/WeblateOrg/openshift/blob/main/template.yml>`_ 複製原始內容，並將它們導入您的項目，然後在OpenShift web 控制台使用``Create `` 按鈕來新建您的應用。 web 控制台將提示您模板使用的所有參數的值。

CLI#

為了將 Weblate 模板上傳到您當前項目的模板庫中，使用後面的命令傳遞 template.yml 文件：

$ oc create -f https://raw.githubusercontent.com/WeblateOrg/openshift/main/template.yml \
   -n <PROJECT>

現在模板可以使用 CLI 的 web 控制台以供選擇。

參數值#

模板的 parameters 部分列出了您可以覆蓋的參數。您可以通過使用後面的命令並指定要使用的文件通過 CLI 列出它們：

$ oc process --parameters -f https://raw.githubusercontent.com/WeblateOrg/openshift/main/template.yml

# If the template is already uploaded
$ oc process --parameters -n <PROJECT> weblate

Provisioning#

還可以使用 CLI 來處理模板，並使用生成的配置來立即新建對象。

$ oc process -f https://raw.githubusercontent.com/WeblateOrg/openshift/main/template.yml \
    -p APPLICATION_NAME=weblate \
    -p WEBLATE_VERSION=4.3.1-1 \
    -p WEBLATE_SITE_DOMAIN=weblate.app-openshift.example.com \
    -p POSTGRESQL_IMAGE=docker-registry.default.svc:5000/openshift/postgresql:9.6 \
    -p REDIS_IMAGE=docker-registry.default.svc:5000/openshift/redis:3.2 \
    | oc create -f

在成功地遷移並部署特定的``WEBLATE_SITE_DOMAIN``參數後，Weblate 事件就應該可用了。

設置容器之後，您可以使用 WEBLATE_ADMIN_PASSWORD 中提供的密碼以管理員使用者身份登錄，或者如果未設置密碼，則使用首次啟動時生成的隨機密碼。

要重置管理員密碼，請在將``WEBLATE_ADMIN_PASSWORD``設置為相應的“Secret”中的新密碼的情況下，重啟容器。

Eliminate#

$ oc delete all -l app=<APPLICATION_NAME>
$ oc delete configmap -l app= <APPLICATION_NAME>
$ oc delete secret -l app=<APPLICATION_NAME>
# ATTTENTION! The following command is only optional and will permanently delete all of your data.
$ oc delete pvc -l app=<APPLICATION_NAME>

$ oc delete all -l app=weblate \
    && oc delete secret -l app=weblate \
    && oc delete configmap -l app=weblate \
    && oc delete pvc -l app=weblate

配置#

通過處理模板，將新建各自的 ConfigMap，並且可以用於定制 Weblate 映像。 ConfigMap 直接作為環境變量掛載，並且在每次更改時觸發新的部署。對於更多配置選項，環境變量的完成列表請參見 Docker 環境變數 for full list of environment variables。

在 Kubernetes 上安裝#

備註

本手冊尋找有 Kubernetes 經驗的貢獻者來詳細介紹安裝過程。

憑藉 Kubernetes Helm 圖表，您可以在幾秒鐘內啟動並運行您的個人Weblate實例。 Weblate的所有依賴項都已經包含在內。 PostgreSQL被設置為預設資料庫，並且使用持久化卷聲明。

您可以在 <https://github.com/WeblateOrg/helm/> 找到圖標，並且它可以在 <https://artifacthub.io/packages/helm/weblate/weblate> 顯示。

安裝#

helm repo add weblate https://helm.weblate.org
helm install my-release weblate/weblate

配置#

對於更進一步的設定，參閱 :ref:`docker-environment`取得完整的環境變數列表。

根據您的設置和經驗，為您選擇適當的安裝方法：

軟件要求#

操作系統#

Weblate 已知運行在 Linux 、 FreeBSD 和 macOS 上。其他類 Unix 的系統也很可能支持運行。

Windows 不支持 Weblate。但仍然可能工作，並願意接受補丁。

其他服務#

Weblate 為其操作使用其他服務。至少需要後面的服務運行：

PostgreSQL 資料庫服務器，請參見 Weblate 的資料庫設置。
Redis 服務器，用於緩存和任務隊列，請參見使用 Celery 的後台任務。
SMTP 服務器，用於發送電子郵件，請參見設定外寄郵件信箱。

Python 依賴性#

Weblate 用 Python 編寫，並且支持 Python 3.6 或更新版本。可以使用 pip 或您的發佈包來安裝依賴性，完全列表可在 requirements.txt 中找到。

值得關注的套件：

Django: https://www.djangoproject.com/
Celery: https://docs.celeryq.dev/
Translate Toolkit （翻譯工具包）: https://toolkit.translatehouse.org/
translation-finder: https://github.com/WeblateOrg/translation-finder
Python Social Auth: https://python-social-auth.readthedocs.io/
Django REST 框架: https://www.django-rest-framework.org/

可選依賴性#

後面的模塊對 Weblate的一些特性是必須的。可以在 requirements-optional.txt 中找到。

Mercurial （可選用支援 Mercurial）: https://www.mercurial-scm.org/
phply （可選用支援 PHP 字串）: https://github.com/viraptor/phply
tesserocr （可選用字串的可見語境 OCR）: https://github.com/sirfz/tesserocr
akismet （可選用針對垃圾郵件的保護）: https://github.com/Nekmo/python-akismet
ruamel.yaml （可選用 YAML files）: https://pypi.org/project/ruamel.yaml/
Zeep （可選用 ms-terminology）: https://docs.python-zeep.org/
aeidon （可選用 Subtitle files）: https://pypi.org/project/aeidon/
ruamel.yaml （可選用 YAML files）: https://projectfluent.org/

提示

當使用 pip 安裝時，您可以直接指定預想的功能：

pip install "Weblate[PHP,Fluent]"

或您可以安裝 Weblate 並包含所有可以選用的功能：

pip install "Weblate[all]"

或您可以安裝 Weblate 並不包含任何可選用的功能：

pip install Weblate

後端資料庫的套件#

Weblate 支持 PostgreSQL 、 MySQL 和 MariaDB 資料庫，更多細節請參見 Weblate 的資料庫設置和後端文件。

其他系統要求#

後面的依賴性必須安裝在系統上：

Git: https://git-scm.com/
Pango 、 Cairo 和相關的標頭文件與 GObject introspection 資料: https://cairographics.org/， https://pango.gnome.org/，請參見 Pango 與 Cairo
git-review （可選用支援 Gerrit）: https://pypi.org/project/git-review/
git-svn （可選用支援 Subversion）: https://git-scm.com/docs/git-svn
tesseract 及其數據（可選用支援截圖 OCR）: https://github.com/tesseract-ocr/tesseract
licensee （當創建組件並發現授權條款時可選用）: https://github.com/licensee/licensee

構建時的套件#

為了構建一些 Python 依賴性，您可能需要安裝其依賴庫。這取決於您如何安裝它們，因此請參考單獨包的文件。如果您使用預編譯 Wheels 並使用 pip 安裝或使用分發包時，您不會需要那些。

Pango 與 Cairo#

在 3.7 版本變更.

Weblate 使用 Pango 和 Cairo 來提供位圖 widget（請參參見推動翻譯）並提供檢查（請參見管理字型）。為了適當地安裝 Python 綁定需要首先安裝系統庫的那些—— Cairo 和 Pango 都是需要的，由此需要 Glib。所有那些需要與開發文件和 GObject 內省數據一起安裝。

驗證發佈簽名#

Weblate 的發佈由發佈開發者通過密碼簽發。當前是 Michal Čihař。他的 PGP 密鑰指紋是：

63CB 1DF1 EF12 CF2A C0EE 5A32 9C27 B313 42B7 511D

並且可以從 <https://keybase.io/nijel> 得到更多識別信息。

應該驗證簽名與下載的壓縮檔案匹配。這種方式可以確保您使用發佈的相同編碼。還應該核實簽名的日期，確定下載了最新的版本。

每個壓縮檔案伴隨 .asc 文件在一起，它包含了需要使用的 PGP 簽名。一旦它們處於相同的文件夾內，就可以驗證簽名了：

$ gpg --verify Weblate-3.5.tar.xz.asc
gpg: assuming signed data in 'Weblate-3.5.tar.xz'
gpg: Signature made Ne 3. března 2019, 16:43:15 CET
gpg:                using RSA key 87E673AF83F6C3A0C344C8C3F4AA229D4D58C245
gpg: Can't check signature: public key not found

正如您所看到的，GPG抱怨它不知道公鑰。此時應該執行以下步驟之一：

使用 wkd 來下載密鑰：

$ gpg --auto-key-locate wkd --locate-keys michal@cihar.com
pub   rsa4096 2009-06-17 [SC]
      63CB1DF1EF12CF2AC0EE5A329C27B31342B7511D
uid           [ultimate] Michal Čihař <michal@cihar.com>
uid           [ultimate] Michal Čihař <nijel@debian.org>
uid           [ultimate] [jpeg image of size 8848]
uid           [ultimate] Michal Čihař (Braiins) <michal.cihar@braiins.cz>
sub   rsa4096 2009-06-17 [E]
sub   rsa4096 2015-09-09 [S]

從 Michal’s server 下載鑰匙鏈，然後將其導入：

$ gpg --import wmxth3chu9jfxdxywj1skpmhsj311mzm

從一個密鑰服務器下載並導入密鑰：

$ gpg --keyserver hkp://pgp.mit.edu --recv-keys 87E673AF83F6C3A0C344C8C3F4AA229D4D58C245
gpg: key 9C27B31342B7511D: "Michal Čihař <michal@cihar.com>" imported
gpg: Total number processed: 1
gpg:              unchanged: 1

這會將情況改善一點——在這點上可以驗證給定密鑰的簽名是正確的，但仍然不能相信密鑰中使用的名稱：

$ gpg --verify Weblate-3.5.tar.xz.asc
gpg: assuming signed data in 'Weblate-3.5.tar.xz'
gpg: Signature made Ne 3. března 2019, 16:43:15 CET
gpg:                using RSA key 87E673AF83F6C3A0C344C8C3F4AA229D4D58C245
gpg: Good signature from "Michal Čihař <michal@cihar.com>" [ultimate]
gpg:                 aka "Michal Čihař <nijel@debian.org>" [ultimate]
gpg:                 aka "[jpeg image of size 8848]" [ultimate]
gpg:                 aka "Michal Čihař (Braiins) <michal.cihar@braiins.cz>" [ultimate]
gpg: WARNING: This key is not certified with a trusted signature!
gpg:          There is no indication that the signature belongs to the owner.
Primary key fingerprint: 63CB 1DF1 EF12 CF2A C0EE  5A32 9C27 B313 42B7 511D

The problem here is that anybody could issue the key with this name. You need to ensure that the key is actually owned by the mentioned person. The GNU Privacy Handbook covers this topic in the chapter Validating other keys on your public keyring. The most reliable method is to meet the developer in person and exchange key fingerprints, however you can also rely on the web of trust. This way you can trust the key transitively through signatures of others, who have met the developer in person.

一旦信任了密鑰，警告就不會發生：

$ gpg --verify Weblate-3.5.tar.xz.asc
gpg: assuming signed data in 'Weblate-3.5.tar.xz'
gpg: Signature made Sun Mar  3 16:43:15 2019 CET
gpg:                using RSA key 87E673AF83F6C3A0C344C8C3F4AA229D4D58C245
gpg: Good signature from "Michal Čihař <michal@cihar.com>" [ultimate]
gpg:                 aka "Michal Čihař <nijel@debian.org>" [ultimate]
gpg:                 aka "[jpeg image of size 8848]" [ultimate]
gpg:                 aka "Michal Čihař (Braiins) <michal.cihar@braiins.cz>" [ultimate]

如果簽名非法（壓縮的檔案被更改），那麼會得到清晰的錯誤，而無論密鑰是否可信：

$ gpg --verify Weblate-3.5.tar.xz.asc
gpg: Signature made Sun Mar  3 16:43:15 2019 CET
gpg:                using RSA key 87E673AF83F6C3A0C344C8C3F4AA229D4D58C245
gpg: BAD signature from "Michal Čihař <michal@cihar.com>" [ultimate]

文件系統權限#

Weblate 進程需要能夠讀寫它保存數據的目錄 - setting:DATA_DIR。該目錄下的所有文件都應該由運行所有 Weblate 進程的使用者擁有和可寫入（通常是 WSGI 和 Celery，見服務器運行中 and 使用 Celery 的後台任務）。

預設的配置放置在 Weblate 源的相同樹下，然而您會想要將這些移動到更好的位置，如： /var/lib/weblate。

Weblate 試圖自動建立這些文件夾，但當沒有權限去執行時會失敗。

當運行管理命令時應該小心，它們應該由 Weblate 自己運行的相同使用者來運行，否則一些文件的權限會是錯誤的。

In the Docker container, all files in the /app/data volume have to be owned by the weblate user inside the container (UID 1000).

也參考

靜態檔案服務

Weblate 的資料庫設置#

推薦使用 PostgreSQL 資料庫服務器來運行 Weblate。

也參考

使用強力的資料庫引擎、 Databases 、從其它資料庫遷移到 PostgreSQL

PostgreSQL#

PostgreSQL 通常是基於 Django 的網站的最好選擇。它是實現 Django 資料庫層而使用的參考資料庫。

備註

Weblate 使用三字母的擴展名，在某些情況下需要單獨安裝。查找 postgresql-contrib 或類似命名的包。

也參考

PostgreSQL notes

建立 PostgreSQL資料庫#

在另一個單獨的資料庫中運行 Weblate，並將使用者賬戶分開通常是個好方法：

# If PostgreSQL was not installed before, set the main password
sudo -u postgres psql postgres -c "\password postgres"

# Create a database user called "weblate"
sudo -u postgres createuser --superuser --pwprompt weblate

# Create the database "weblate" owned by "weblate"
sudo -u postgres createdb -E UTF8 -O weblate weblate

提示

如果不想 Weblate 在 PostgreSQL 中使用超級使用者，可以省略掉。在模式中必須作為 PostgreSQL 超級使用者，來手動執行一些遷移步驟的情況下， Weblate 將使用：

CREATE EXTENSION IF NOT EXISTS pg_trgm WITH SCHEMA weblate;
CREATE EXTENSION IF NOT EXISTS btree_gin WITH SCHEMA weblate;

配置 Weblate 來使用 PostgreSQL#

PostgreSQL 的 settings.py 片段：

DATABASES = {
    "default": {
        # Database engine
        "ENGINE": "django.db.backends.postgresql",
        # Database name
        "NAME": "weblate",
        # Database user
        "USER": "weblate",
        # Name of role to alter to set parameters in PostgreSQL,
        # use in case role name is different than user used for authentication.
        # "ALTER_ROLE": "weblate",
        # Database password
        "PASSWORD": "password",
        # Set to empty string for localhost
        "HOST": "database.example.com",
        # Set to empty string for default
        "PORT": "",
    }
}

資料庫的合併執行了Weblate 使用的 ALTER ROLE 資料庫角色。在多數情況下，角色的名稱與使用者名匹配。在更富在的設置中，角色的名稱與使用者名不同，而在資料庫合併過程中會得到不存在的角色的錯誤信息（psycopg2.errors.UndefinedObject: role "weblate@hostname" does not exist` `，角色“weblate@hostname”不存在）。已知這會在 PostgreSQL 的 Azure 資料庫時發生，但並不僅限於這種環境。請將 ``ALTER_ROLE 設置為資料庫合併過程中 Weblate 應該更改的角色的名稱。

MySQL 與 MariaDB#

提示

一些 Weblate 特性使用 PostgreSQL 會執行得更好。這包括搜索與翻譯記憶庫，它們都使用了資料庫中的全文本特性，而 PostgreSQL 的實施更勝一籌。

Weblate 還可以使用 MySQL 或 MariaDB，使用與兩個資料庫相關的 Django 而導致的警告，請參見 MySQL notes 和 MariaDB notes。由於這些限制，我們建議對新安裝使用 PostgreSQL。

Weblate 需要至少 5.7.8 版的或至少 10.2.7 版的 MariaDB。

Configuring Weblate to use MySQL/MariaDB#

MySQL 和 MariaDB 的 settings.py 片段：

DATABASES = {
    "default": {
        # Database engine
        "ENGINE": "django.db.backends.mysql",
        # Database name
        "NAME": "weblate",
        # Database user
        "USER": "weblate",
        # Database password
        "PASSWORD": "password",
        # Set to empty string for localhost
        "HOST": "127.0.0.1",
        # Set to empty string for default
        "PORT": "3306",
        # In case you wish to use additional
        # connection options
        "OPTIONS": {},
    }
}

開始安裝前還應該在 MySQL 或 MariaDB 中創建 weblate 使用者賬戶。使用下面的命令來實現：

GRANT ALL ON weblate.* to 'weblate'@'localhost' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;

其他配置#

設定外寄郵件信箱#

Weblate 在各種情況下會發出電子郵件——用於激活賬戶，以及使用者配置的各種通知。對於這些需要訪問 SMTP 服務器。

郵件服務器使用這些設置進行配置: EMAIL_HOST, EMAIL_HOST_PASSWORD, EMAIL_USE_TLS, EMAIL_USE_SSL, django: EMAIL_HOST_USER and EMAIL_PORT。從名稱就可以大概知道它們的含義，但是您可以在Django 文件中找到更多信息。

提示

在得到有關不支持的認證的情況下（例如 SMTP AUTH extension not supported by server），這最可能因為使用不安全的鏈接並且服務器拒絕以這種方式認證而導致。在這種情況下嘗試啟動 EMAIL_USE_TLS。

也參考

:ref:“調試郵件”，:ref:“在Docker容器中配置傳出電子郵件<docker-mail>`

在反向代理後面運行#

Weblate 的幾個特性依賴於能夠得到客戶端 IP 地址。這包括頻次限制、針對垃圾郵件的保護或稽核記錄。

在預設設置中， Weblate 從 WSGI 句柄設置的 REMOTE_ADDR 中解析 IP 地址。

在運行反向代理的情況下，這個字段很可能包含其地址。需要配置 Weblate 來信任附加的 HTTP 標頭，並從中解析 IP 地址。這不能預設允許，因為在不使用反向代理的安裝時，這會允許 IP 地址欺騙。允許 IP_BEHIND_REVERSE_PROXY 對多數常見設置就足夠了，但您還必須調整 IP_PROXY_HEADER 和 IP_PROXY_OFFSET。

另一個需要被注意的事項是 Host 。它應該要與 SITE_DOMAIN 相符合。反向代理伺服器可能需要額外的設定（例如使用 ProxyPreserveHost On 於 Apache 或 proxy_set_header Host $host; 於 nginx 中）。

也參考

針對垃圾郵件的保護, 頻次限制, 稽核記錄, IP_BEHIND_REVERSE_PROXY, IP_PROXY_HEADER, IP_PROXY_OFFSET, SECURE_PROXY_SSL_HEADER

HTTP 代理#

Weblate 執行版本控制系統（VCS ）命令，並且那些從環境中接受代理配置。推薦的方法是在 settings.py 中定義代理設置：

import os

os.environ["http_proxy"] = "http://proxy.example.com:8080"
os.environ["HTTPS_PROXY"] = "http://proxy.example.com:8080"

也參考

代理伺服器環境變量

調整配置#

也參考

配置的例子

將 weblate/settings_example.py 複製到 weblate/settings.py，並且調整它與您的設置匹配。您可能想要調整後面的選項：

ADMINS

網站管理者的列表，當發生故障時它們接收通知，例如合併失敗或 Django 錯誤的通知。

也參考

ADMINS, 合適的管理參數設定

ALLOWED_HOSTS

需要設置這個，來列出您的網站支持服務的主機。例如：
ALLOWED_HOSTS = ["demo.weblate.org"]
另外可以包括通配符：
ALLOWED_HOSTS = ["*"]
也參考

ALLOWED_HOSTS, WEBLATE_ALLOWED_HOSTS, 允許的網域設定

SESSION_ENGINE

配置如何存儲會話。在保持預設的資料庫後端引擎的情況下，應該安排 weblate clearsessions 從資料庫中刪除舊的會話。

如果使用 Redis 作為緩存（請參見允許緩存），推薦也使用它作為會話：
SESSION_ENGINE = "django.contrib.sessions.backends.cache"
也參考

Configuring the session engine, SESSION_ENGINE

DATABASES

到資料庫服務器的連接性，細節請查看 Django 的文件。

也參考

Weblate 的資料庫設置, DATABASES, Databases

DEBUG

對於任何生產服務器禁止這項。允許調試模式時， Django 會在出錯的情況下向使用者顯示回溯信息，當禁止時，錯誤將每封電子郵箱發送到 ADMINS （請參見上面）。

調試模式還使 Weblate 變慢，因為在這種情況下 Django 內部存儲了非常多的信息。

也參考

DEBUG, 停用除錯模式

DEFAULT_FROM_EMAIL

用於發送電子郵件的電子郵件發件人地址，例如註冊電子郵箱。

也參考

DEFAULT_FROM_EMAIL

SECRET_KEY

金鑰會被 Django 簽署相同資訊在瀏覽器 cookies 中，參閱 Django金鑰瞭解更多資訊。

也參考

SECRET_KEY

SERVER_EMAIL

用作向管理員發送電子郵件的發送者地址的郵箱，例如通知失敗的合併。

也參考

SERVER_EMAIL

填滿資料庫#

在配置準備好之後，可以運行 weblate migrate 來建立資料庫結構。現在您將能夠使用管理界面建立翻譯項目。

在想要非交互式地運行安裝的情況下，可以使用 weblate migrate --noinput，然後使用 createadmin 命令來建立管理使用者。

一旦完成，您將可以在管理界面檢查 Performance report，它會提示您網站上潛在的非最優的配置。

也參考

配置, 特殊權限列表與內建角色

生產設置#

對於生產設置，可以進行後面的章節中描述的調整。最嚴格的設置將觸發警告，如果超級使用者登錄的話，警告由頂部條的感嘆標記來指示：

同樣也推薦查看由 Django 觸發的檢查（儘管可能不需要修復所有的檢查）：

weblate check --deploy

還可以復查來自管理介面的每個檢查表。

也參考

Deployment checklist

停用除錯模式#

禁止 Django 的調試模式（ DEBUG ）：

DEBUG = False

在調試模式打開時，Django 存儲所有執行的查詢，並將錯誤的回溯顯示給使用者，這在生產設置中是不需要的。

也參考

調整配置

合適的管理參數設定#

將正確的管理地址設置到 ADMINS 設置中，來確定服務器出現一些故障時誰接收電子郵件，例如：

ADMINS = (("Your Name", "your_email@example.com"),)

也參考

調整配置

設置正確的網站域名#

在管理界面調整網站名稱和域名，否則 RSS 中的鏈接或註冊電子郵件地址將不工作。這使用 SITE_DOMAIN 來配置，它應該包含網站域名。

在 4.2 版本變更: 在 4.2 版本之前，替代使用了 Django 網站框架，請參見 The “sites” framework。

也參考

：參考:ref:“生產 - 主機”，:ref:“生產-SSL`：設置：Site_Domain，：envvar：weblate_site_domain，：設置：enable_https

正確的 HTTPS 設定#

強烈推薦使用加密的 HTTPS 協議運行 Weblate。將其允許後，可以在設置中設置 ENABLE_HTTPS ：

ENABLE_HTTPS = True

提示

您還會想要新建 HSTS，更多細節請參見 SSL/HTTPS。

也參考

ENABLE_HTTPS, 允許的網域設定, 設置正確的網站域名

設定合適的 SECURE_HSTS_SECONDS#

如果您的網站基於 SSL 上提供服務，那麼必須考慮 settings.py 中 SECURE_HSTS_SECONDS 的設置值，來允許 HTTP Strict Transport Security （ HTTP 腳本傳輸安全）。預設設置為 0，如下所示。

SECURE_HSTS_SECONDS = 0

如果設置為非 0 整數，那麼在所有還不曾具有它的響應時， django.middleware.security.SecurityMiddleware 設置 HTTP Strict Transport Security 標頭。

警告

不正確地設置這項會導致您的網站不可逆地（有時）崩潰。請首先閱讀 HTTP Strict Transport Security 文件。

使用強力的資料庫引擎#

請使用 PostgreSQL 作為生產環境，更多信息請參見 Weblate 的資料庫設置。
使用相鄰的區域運作資料庫，網路的效能與可靠性會影響 Weblate 的使用體驗。
確認資料庫的效能或調校其設定檔，例如使用 PGTune 。

也參考

Weblate 的資料庫設置, 從其它資料庫遷移到 PostgreSQL, 調整配置, Databases

允許緩存#

如果可能，通過調整 CACHES 配置變量來使用來自 Django 的 Redis，例如：

CACHES = {
    "default": {
        "BACKEND": "django_redis.cache.RedisCache",
        "LOCATION": "redis://127.0.0.1:6379/0",
        # If redis is running on same host as Weblate, you might
        # want to use unix sockets instead:
        # 'LOCATION': 'unix:///var/run/redis/redis.sock?db=0',
        "OPTIONS": {
            "CLIENT_CLASS": "django_redis.client.DefaultClient",
            "PARSER_CLASS": "redis.connection.HiredisParser",
        },
    }
}

提示

在為緩存更改 Redis 設置的情況下，也會需要為 Celery 來調整，請參見使用 Celery 的後台任務。

也參考

個人頭像快取, Django’s cache framework

個人頭像快取#

除了 Django 的緩存， Weblate 還執行頭像緩存。推薦使用單獨的、文件後端緩存來用於這個目的：

CACHES = {
    "default": {
        # Default caching backend setup, see above
        "BACKEND": "django_redis.cache.RedisCache",
        "LOCATION": "unix:///var/run/redis/redis.sock?db=0",
        "OPTIONS": {
            "CLIENT_CLASS": "django_redis.client.DefaultClient",
            "PARSER_CLASS": "redis.connection.HiredisParser",
        },
    },
    "avatar": {
        "BACKEND": "django.core.cache.backends.filebased.FileBasedCache",
        "LOCATION": os.path.join(DATA_DIR, "avatar-cache"),
        "TIMEOUT": 604800,
        "OPTIONS": {
            "MAX_ENTRIES": 1000,
        },
    },
}

也參考

：設置：enabent_avatars，：設置：avatar_url_prefix，頭像，:ref:spections-cache`，django：主題/緩存

郵件外送設定#

Weblate 需要在幾種情況下發送電子郵件，這些電子郵件應具有正確的發送者地址，請配置:setting:SERVER_EMAIL 和 DEFAULT_FROM_EMAIL，與您的環境匹配，例如：

SERVER_EMAIL = "admin@example.org"
DEFAULT_FROM_EMAIL = "weblate@example.org"

備註

為了禁止 Weblate 發送電子郵件，將 EMAIL_BACKEND 設置為 django.core.mail.backends.dummy.EmailBackend。

這將禁止所有電子郵件的投遞，包括註冊或密碼重置電子郵件。

也參考

:ref:“配置”，:ref:“外郵件”，：STD：設置：Django：Email_Backend，：std：設置：django：default_mail，：std：設置：django：server_email

允許的網域設定#

Django 需要 ALLOWED_HOSTS 保存您的網站允許服務的域名列表，將其保持空置會屏蔽任何請求。

在沒有配置來匹配 HTTP 服務器的情況下，會得到錯誤信息，如 Invalid HTTP_HOST header: '1.1.1.1'. You may need to add '1.1.1.1' to ALLOWED_HOSTS.

提示

在 Docker 容器上，這可以使用，為 WEBLATE_ALLOWED_HOSTS。

也參考

ALLOWED_HOSTS, WEBLATE_ALLOWED_HOSTS, 設置正確的網站域名

Django金鑰#

SECRET_KEY 設置由 Django 使用來進行 cookies 簽名，應該真正產生自己的值，而不是使用來自舉例的設置的值。

可以使用與 Weblate 一起上市的 weblate-generate-secret-key，來產生新的密鑰。

也參考

SECRET_KEY

執行維護事項#

為了優化性能，在後台運行一些維護任務是個好方法。現在這由使用 Celery 的後台任務自動進行，並且包括後面的任務：

配置健康性的檢查（每小時）。
提交待定的更改（每小時），請參見簡易提交和 commit_pending。
更新組件警告（每天）。
更新遠程分支（每晚），請參見 AUTO_UPDATE。
翻譯記憶庫備份到 JSON （每天），請參見 dump_memory。
全文本和資料庫維護任務（每天和每週任務），請參見 cleanuptrans。

在 3.2 版本變更: 從 3.2 版本開始，執行這些任務的預設方式是使用 Celery，並且 Weblate 已經具有一些適當的配置，請參見使用 Celery 的後台任務。

系統的地區與編碼#

系統的地區應該設置為兼容 UTF-8 的。在多數 Linux 發佈中這是預設的設置。在您的系統不能兼容的情況下，請將地區更改為 UTF-8 變體。

例如通過編輯 /etc/default/locale 並設置 LANG="C.UTF-8"。

在一些情況下，個別獨立的伺服器設定檔會分別在其本地端。在發行版與網站伺服器版本間的差異，請針對您的網頁伺服器套件狀況確認文件。

在 Ubuntu 上的 Apache 使用 /etc/apache2/envvars ：

export LANG='en_US.UTF-8'
export LC_ALL='en_US.UTF-8'

在 CentOS 上的 Apache 使用 /etc/sysconfig/httpd (或 /opt/rh/httpd24/root/etc/sysconfig/httpd):

LANG='en_US.UTF-8'

使用定制的證書授權#

Weblate 在 HTTP 請求時驗證 SSL 證書。在使用定制的證書授權的情況下，這樣定制的證書授權在預設 bundles 的中不被信任，您必須將其證書添加為可信任。

傾向使用的方法是在系統層次進行，更多細節請查看您的發佈的文件（例如在debian 中，這可以通過將CA 證書放置在:file:/usr/local/share/ca-certificates/，並運行:command:update-ca-certificates 來完成）。

一旦完成，系統工具就會信任證書，這包括 Git。

對於 Python 代碼，需要配置請求來使用系統 CA bundle，而不是與它一起上市的那個。這可以通過將後面的模板放到 settings.py 來實現（路徑是 Debian 特有的）：

import os

os.environ["REQUESTS_CA_BUNDLE"] = "/etc/ssl/certs/ca-certificates.crt"

壓縮客戶端素材#

Weblate 帶有一組 JavaScript 和 CSS 文件。由於性能的原因，在將其發送到客戶端前最好進行壓縮。在預設配置中，這通過耗費一點經常資源而在運行中完成。在大型安裝中，推薦允許離線壓縮模式。這需要在配置中完成，並且必須在每次 weblate 升級時觸發壓縮。

配置切換很簡單，通過允許 django.conf.settings.COMPRESS_OFFLINE，並配置 django.conf.settings.COMPRESS_OFFLINE_CONTEXT （後者已經包括在例子的配置中）：

COMPRESS_OFFLINE = True

在每個部署中，您需要壓縮文件來匹配當前的版本：

weblate compress

提示

官方 Docker 鏡像已經允許了這個特性。

也參考

Common Deployment Scenarios, 靜態檔案服務

服務器運行中#

提示

如果您沒有在下面描述的服務經歷，您可能需要嘗試:doc:安裝/ docker。

需要幾個服務來運行Weblate，推薦的設置包括：

資料庫服務器（請參見 Weblate 的資料庫設置）
緩存服務器（請參見允許緩存）
用於靜態文件和終結 SSL 的前端 web 服務器（請參見靜態檔案服務）
用於動態內容的 WSGI 服務器（請參見 NGINX 和 uWSGI 的配置例子）
用於執行後台任務的 Celery （請參見使用 Celery 的後台任務）

備註

這些服務之間由一些依賴性，例如當啟動 Celery 或 uwsgi 進程時，緩存和資料庫應該運行。

在多數情況下，需要在單一（虛擬）服務器上運行所有服務，但在您的安裝是重載的情況下，可以將這些服務拆開。對此的唯一限制是 Celery 和 Wsgi 服務器需要訪問 DATA_DIR。

備註

WSGI 進程和 Celery 進程必須在同一使用者下被執行，否則 DATA_DIR 中的文件將以混合的所有權來存儲，導致運行問題。

還請參見文件系統權限和使用 Celery 的後台任務。

網頁伺服器運行中#

運行 Weblate 與運行其他任何基於 Django 的程序沒什麼不同。 Django通常作為 uWSGI 或 fcgi 執行（請參見下面不同 web 服務器的例子）。

為了檢測的目的，您可以在 Django 中使用內建的 web 服務器：

weblate runserver

警告

在生產設置中不要使用這個服務器。它還沒有通過安全審查或性能檢測。還請參見 runserver 上的 Django 文件。

提示

Django 內建服務只通過允許 DEBUG 來為靜態文件提供服務，因為它只用於開發的目的。對於生產使用，請參見 NGINX 和 uWSGI 的配置例子、 Apache 的配置例子 Apache 和 Gunicorn 的配置例子和靜態檔案服務中的wsgi 設置。

靜態檔案服務#

Django 需要將其靜態文件收集在一個單一文件夾中。為此，執行 weblate collectstatic --noinput。這會將靜態文件複製到 STATIC_ROOT 設置指定的文件夾中（這預設為 DATA_DIR 內的 static 文件夾）。

推薦直接從您的 web 服務器為靜態文件提供服務，對於後面的路徑應該使用它：

/static/: 為 Weblate 的靜態文件和管理界面（由 STATIC_ROOT 定義）提供服務。
/media/: 用於上傳使用者媒體（例如截屏）。
/favicon.ico: 應該重寫，重寫規則為 /static/favicon.ico 提供服務。

也參考

NGINX 和 uWSGI 的配置例子, Apache 的配置例子, Apache 和 Gunicorn 的配置例子, 壓縮客戶端素材, How to deploy Django, django :howto/static-files/deployment

內容安全策略（CSP）#

預設的 Weblate 配置允許 weblate.middleware.SecurityMiddleware 中間件，它設置與 HTTP 標頭相關的安全，如 Content-Security-Policy 或 X-XSS-Protection。這些被預設新建，與 Weblate 及其配置一起工作，但這對您的環境需要定制化。

也參考

：設置：csp_script_src，：設置：csp_img_src，：設置：csp_connect_src，：設置：csp_style_src，：設置：csp_font_src

NGINX 和 uWSGI 的配置例子#

為了運行生產web 服務器，使用與Weblate 一起安裝的wsgi 封裝（在虛擬env 的情況下，它安裝為:file:~/weblate-env/lib/python3.9/site-packages/weblate/wsgi.py ` ）。別忘了將 Python 的搜索路徑同樣設置為您的虛擬 env （例如在 uWSGI 中使用 ``virtualenv = /home/user/weblate-env` ）。

後面的配置將 Weblate 作為 NGINX web 服務器下的 uWSGI 來運行。

NGINX 的配置（還作為 weblate/examples/weblate.nginx.conf 來獲得）：

#
# nginx configuration for Weblate
#
# You will want to change:
#
# - server_name
# - change /home/weblate/weblate-env to location where Weblate virtualenv is placed
# - change /home/weblate/data to match your DATA_DIR
# - change python3.9 to match your Python version
# - change weblate user to match your Weblate user
#
server {
    listen 80;
    server_name weblate;
    # Not used
    root /var/www/html;

    location ~ ^/favicon.ico$ {
        # DATA_DIR/static/favicon.ico
        alias /home/weblate/data/static/favicon.ico;
        expires 30d;
    }

    location /static/ {
        # DATA_DIR/static/
        alias /home/weblate/data/static/;
        expires 30d;
    }

    location /media/ {
        # DATA_DIR/media/
        alias /home/weblate/data/media/;
        expires 30d;
    }

    location / {
        include uwsgi_params;
        # Needed for long running operations in admin interface
        uwsgi_read_timeout 3600;
        # Adjust based to uwsgi configuration:
        uwsgi_pass unix:///run/uwsgi/app/weblate/socket;
        # uwsgi_pass 127.0.0.1:8080;
    }
}

uWSGI 的配置（還作為 weblate/examples/weblate.uwsgi.ini 來獲得）：

#
# uWSGI configuration for Weblate
#
# You will want to change:
#
# - change /home/weblate/weblate-env to location where Weblate virtualenv is placed
# - change /home/weblate/data to match your DATA_DIR
# - change python3.9 to match your Python version
# - change weblate user to match your Weblate user
#
[uwsgi]
plugins       = python3
master        = true
protocol      = uwsgi
socket        = 127.0.0.1:8080
wsgi-file     = /home/weblate/weblate-env/lib/python3.9/site-packages/weblate/wsgi.py

# Add path to Weblate checkout if you did not install
# Weblate by pip
# python-path   = /path/to/weblate

# In case you're using virtualenv uncomment this:
virtualenv = /home/weblate/weblate-env

# Needed for OAuth/OpenID
buffer-size   = 8192

# Reload when consuming too much of memory
reload-on-rss = 250

# Increase number of workers for heavily loaded sites
workers       = 8

# Enable threads for Sentry error submission
enable-threads = true

# Child processes do not need file descriptors
close-on-exec = true

# Avoid default 0000 umask
umask = 0022

# Run as weblate user
uid = weblate
gid = weblate

# Enable harakiri mode (kill requests after some time)
# harakiri = 3600
# harakiri-verbose = true

# Enable uWSGI stats server
# stats = :1717
# stats-http = true

# Do not log some errors caused by client disconnects
ignore-sigpipe = true
ignore-write-errors = true
disable-write-exception = true

也參考

How to use Django with uWSGI

Apache 的配置例子#

推薦當 Weblate 使用 WSGI 時使用 prefork MPM。

後面的配置將 Weblate 作為 WSGI 來運行，您需要允許 ``mod_wsgi``（作為 weblate/examples/apache.conf 來獲得）：

#
# VirtualHost for Weblate
#
# You will want to change:
#
# - ServerAdmin and ServerName
# - change /home/weblate/weblate-env to location where Weblate virtualenv is placed
# - change /home/weblate/data to match your DATA_DIR
# - change python3.9 to match your Python version
# - change weblate user to match your Weblate user
#
<VirtualHost *:80>
    ServerAdmin admin@weblate.example.org
    ServerName weblate.example.org

    # DATA_DIR/static/favicon.ico
    Alias /favicon.ico /home/weblate/data/static/favicon.ico

    # DATA_DIR/static/
    Alias /static/ /home/weblate/data/static/
    <Directory /home/weblate/data/static/>
        Require all granted
    </Directory>

    # DATA_DIR/media/
    Alias /media/ /home/weblate/data/media/
    <Directory /home/weblate/data/media/>
        Require all granted
    </Directory>

    # Path to your Weblate virtualenv
    WSGIDaemonProcess weblate python-home=/home/weblate/weblate-env user=weblate request-timeout=600
    WSGIProcessGroup weblate
    WSGIApplicationGroup %{GLOBAL}

    WSGIScriptAlias / /home/weblate/weblate-env/lib/python3.9/site-packages/weblate/wsgi.py process-group=weblate
    WSGIPassAuthorization On

    <Directory /home/weblate/weblate-env/lib/python3.9/site-packages/weblate/>
        <Files wsgi.py>
        Require all granted
        </Files>
    </Directory>

</VirtualHost>

備註

Weblate 需要 Python 3，所以請確認您運行 modwsgi 的 Python 3 變體。它通常作為獨立的包來獲得，例如 libapache2-mod-wsgi-py3。

也參考

系統的地區與編碼, How to use Django with Apache and mod_wsgi

Apache 和 Gunicorn 的配置例子#

後面的配置在 Gunicorn 和 Apache 2.4 中運行 Weblate （作為 weblate/examples/apache.gunicorn.conf 獲得）：

#
# VirtualHost for Weblate using gunicorn on localhost:8000
#
# You will want to change:
#
# - ServerAdmin and ServerName
# - change /home/weblate/weblate-env to location where Weblate virtualenv is placed
# - change /home/weblate/data to match your DATA_DIR
# - change python3.9 to match your Python version
# - change weblate user to match your Weblate user
#
<VirtualHost *:443>
    ServerAdmin admin@weblate.example.org
    ServerName weblate.example.org

    # DATA_DIR/static/favicon.ico
    Alias /favicon.ico /home/weblate/data/static/favicon.ico

    # DATA_DIR/static/
    Alias /static/ /home/weblate/data/static/
    <Directory /home/weblate/data/static/>
        Require all granted
    </Directory>

    # DATA_DIR/media/
    Alias /media/ /home/weblate/data/media/
    <Directory /home/weblate/data/media/>
        Require all granted
    </Directory>

    SSLEngine on
    SSLCertificateFile /etc/apache2/ssl/https_cert.cert
    SSLCertificateKeyFile /etc/apache2/ssl/https_key.pem
    SSLProxyEngine On

    ProxyPass /favicon.ico !
    ProxyPass /static/ !
    ProxyPass /media/ !

    ProxyPass / http://localhost:8000/
    ProxyPassReverse / http://localhost:8000/
    ProxyPreserveHost On
</VirtualHost>

也參考

How to use Django with Gunicorn

在路徑下運行 Weblate#

推薦當 Weblate 使用 WSGI 時使用 prefork MPM。

為``/weblate`` 下的 Weblate 提供服務的 Apache 配置的例子。再次使用 mod_wsgi （還作為 weblate/examples/apache-path.conf 獲得）：

#
# VirtualHost for Weblate, running under /weblate path
#
# You will want to change:
#
# - ServerAdmin and ServerName
# - change /home/weblate/weblate-env to location where Weblate virtualenv is placed
# - change /home/weblate/data to match your DATA_DIR
# - change python3.9 to match your Python version
# - change weblate user to match your Weblate user
#
<VirtualHost *:80>
    ServerAdmin admin@weblate.example.org
    ServerName weblate.example.org

    # DATA_DIR/static/favicon.ico
    Alias /weblate/favicon.ico /home/weblate/data/static/favicon.ico

    # DATA_DIR/static/
    Alias /weblate/static/ /home/weblate/data/static/
    <Directory /home/weblate/data/static/>
        Require all granted
    </Directory>

    # DATA_DIR/media/
    Alias /weblate/media/ /home/weblate/data/media/
    <Directory /home/weblate/data/media/>
        Require all granted
    </Directory>

    # Path to your Weblate virtualenv
    WSGIDaemonProcess weblate python-home=/home/weblate/weblate-env user=weblate request-timeout=600
    WSGIProcessGroup weblate
    WSGIApplicationGroup %{GLOBAL}

    WSGIScriptAlias /weblate /home/weblate/weblate-env/lib/python3.9/site-packages/weblate/wsgi.py process-group=weblate
    WSGIPassAuthorization On

    <Directory /home/weblate/weblate-env/lib/python3.9/site-packages/weblate/>
        <Files wsgi.py>
        Require all granted
        </Files>
    </Directory>

</VirtualHost>

此外，您必須調整 weblate/settings.py ：

URL_PREFIX = "/weblate"

使用 Celery 的後台任務#

在 3.2 版本新加入.

Weblate 使用 Celery 來執行常規或是背景的排程任務。您應該運行一組 Celery 服務來執行任務，例如它會負責處理以下的運作（此列表非完整）：

透過 webhooks 接收來自外部的服務中（參閱通知掛勾）。
執行規律的維護任務如備份、清理與每日的附加元件或更新。（參閱備份和移動 Weblate、 BACKGROUND_TASKS、附加元件）。
Running 自動翻譯.
Sending digest notifications.
降載 wsgi 執行緒執行昂貴的運作。
Committing pending changes (see 簡易提交).

A typical setup using Redis as a backend looks like this:

CELERY_TASK_ALWAYS_EAGER = False
CELERY_BROKER_URL = "redis://localhost:6379"
CELERY_RESULT_BACKEND = CELERY_BROKER_URL

也參考

Redis broker configuration in Celery

您應該啟動 Celery worker 來處理任務，並且定時任務，這可以直接在命令行完成（調試和開發時最有用）：

./weblate/examples/celery start
./weblate/examples/celery stop

備註

Celery 進程和 WSGI 進程必須在同一使用者下被執行，否則 DATA_DIR 中的文件將以混合的所有權來存儲，導致運行問題。

還請參見文件系統權限和服務器運行中。

執行 Celery 排程任務在 wsgi 使用 eager 模式#

備註

這將會在網頁介面中造成效能的衝擊影響，也會造成常規的觸發功能失效（例如提交暫緩的修正、摘要通知或備份）。

For development, you might want to use eager configuration, which does process all tasks in place:

CELERY_TASK_ALWAYS_EAGER = True
CELERY_BROKER_URL = "memory://"
CELERY_TASK_EAGER_PROPAGATES = True

運行 Celery 作為系統服務#

您更可能想要運行 Celery 作為守護進程，這由 Daemonization 來涵蓋。對於使用 systemd 的最通常的 Linux 設置，您可以使用與下面列出的 examples 文件夾一起上市的例子文件。

Systemd 單元作為 /etc/systemd/system/celery-weblate.service 放置：

[Unit]
Description=Celery Service (Weblate)
After=network.target

[Service]
Type=forking
User=weblate
Group=weblate
EnvironmentFile=/etc/default/celery-weblate
WorkingDirectory=/home/weblate
RuntimeDirectory=celery
RuntimeDirectoryPreserve=restart
LogsDirectory=celery
ExecStart=/bin/sh -c '${CELERY_BIN} multi start ${CELERYD_NODES} \
  -A ${CELERY_APP} --pidfile=${CELERYD_PID_FILE} \
  --logfile=${CELERYD_LOG_FILE} --loglevel=${CELERYD_LOG_LEVEL} ${CELERYD_OPTS}'
ExecStop=/bin/sh -c '${CELERY_BIN} multi stopwait ${CELERYD_NODES} \
  --pidfile=${CELERYD_PID_FILE}'
ExecReload=/bin/sh -c '${CELERY_BIN} multi restart ${CELERYD_NODES} \
  -A ${CELERY_APP} --pidfile=${CELERYD_PID_FILE} \
  --logfile=${CELERYD_LOG_FILE} --loglevel=${CELERYD_LOG_LEVEL} ${CELERYD_OPTS}'

[Install]
WantedBy=multi-user.target

環境配置作為 /etc/default/celery-weblate 放置：

# Name of nodes to start
CELERYD_NODES="celery notify memory backup translate"

# Absolute or relative path to the 'celery' command:
CELERY_BIN="/home/weblate/weblate-env/bin/celery"

# App instance to use
# comment out this line if you don't use an app
CELERY_APP="weblate.utils"

# Extra command-line arguments to the worker,
# increase concurrency if you get weblate.E019
CELERYD_OPTS="--beat:celery --queues:celery=celery --prefetch-multiplier:celery=4 \
    --queues:notify=notify --prefetch-multiplier:notify=10 \
    --queues:memory=memory --prefetch-multiplier:memory=10 \
    --queues:translate=translate --prefetch-multiplier:translate=4 \
    --concurrency:backup=1 --queues:backup=backup  --prefetch-multiplier:backup=2"

# Logging configuration
# - %n will be replaced with the first part of the nodename.
# - %I will be replaced with the current child process index
#   and is important when using the prefork pool to avoid race conditions.
CELERYD_PID_FILE="/run/celery/weblate-%n.pid"
CELERYD_LOG_FILE="/var/log/celery/weblate-%n%I.log"
CELERYD_LOG_LEVEL="INFO"

使用 logrotate 來旋轉 Celery 記錄的額外配置將被放置為 /etc/logrotate.d/celery:

/var/log/celery/*.log {
        weekly
        missingok
        rotate 12
        compress
        notifempty
}

使用 Celery beat 的周期性任務#

Weblate 帶有內建的定時任務設置。然而您可以在 settings.py 中定義另外的任務，例如請參見簡易提交。

任務應該由 Celery beats 守護進程執行。在不能正常工作的情況下，它可能不會運行，或者其資料庫崩潰。在這樣的情況下檢查 Celery 啟動日誌，來找出根本原因。

觀察 Celery 狀態#

You can find current length of the Celery task queues in the 管理介面 or you can use celery_queues on the command-line. In case the queue will get too long, you will also get configuration error in the admin interface.

警告

Celery 錯誤預設之存儲在 Celery 日誌中，並且使用者不可見。在您想要了解故障概況的情況下，推薦配置蒐集錯誤訊息報告。

也參考

監測 Weblate, 如何檢查 Weblate 是否被正確地設置？, Configuration and defaults, Workers Guide, Daemonization, Monitoring and Management Guide, celery_queues

監測 Weblate#

Weblate 提供 /healthz/ URL 作為簡單的健康檢查來使用，例如使用 Kubernetes。 Docker 容器具有使用此 URL 的內置運行狀況檢查。

用於監視Weberate的指標，您可以使用：http：get：`/ api / metrics /`api端點。

也參考

如何檢查 Weblate 是否被正確地設置？, 觀察 Celery 狀態, Weblate plugin for Munin

蒐集錯誤訊息報告#

與其他任何軟件一樣，Weblate 可能會失敗。為了收集有用的故障狀態，我們推薦使用第三方服務來收集此類信息。這在 Celery 任務失敗的情況下尤其有用，否則將只會向日誌報告錯誤，而您不會收到有關它們的通知。 Weblate 支持以下服務：

Sentry#

Weblate 內置了對 Sentry 的支持。要使用它，只需在 settings.py 中設置 SENTRY_DSN：

SENTRY_DSN = "https://id@your.sentry.example.com/"

Rollbar#

Weblate 具有對 Rollbar 的內置支持。要使用它，只需遵循 Rollbar notifier for Python 的說明即可。

簡而言之，您需要調整 settings.py ：

# Add rollbar as last middleware:
MIDDLEWARE = [
    # … other middleware classes …
    "rollbar.contrib.django.middleware.RollbarNotifierMiddleware",
]

# Configure client access
ROLLBAR = {
    "access_token": "POST_SERVER_ITEM_ACCESS_TOKEN",
    "client_token": "POST_CLIENT_ITEM_ACCESS_TOKEN",
    "environment": "development" if DEBUG else "production",
    "branch": "main",
    "root": "/absolute/path/to/code/root",
}

將會自動整合所有必要的設定，您將會蒐集到來自伺服器或是使用端的錯誤訊息。

備註

Error logging also includes exceptions that were gracefully handled, but might indicate a problem - such as failed parsing of an uploaded file.

將 Weblate 遷移到其他服務其中#

將 Weblate 遷移到其他服務器應該非常簡單，然而它將數據存儲在幾個位置，您應該小心遷移。最佳的方式時停止 Weblate 再遷移。

遷移資料庫#

Depending on your database backend, you might have several options to migrate the database. The most straightforward approach is to use database native tools, as they are usually the most effective (e.g. mysqldump or pg_dump). Alternatively you can use replication in case your database supports it.

也參考

Migrating between databases described in 從其它資料庫遷移到 PostgreSQL.

遷移 VSC 儲存庫#

存儲在 DATA_DIR 下的版本控制系統（VCS）同樣需要遷移。您可以簡單地複制它們，或使用 rsync 來更有效地遷移。

其他註釋#

不要忘記移動 Weblate 會使用的其他服務，如 Redis 、 Cron 任務或定制的身份驗證後端。

Weblate 部署#

如果多個組件分享相同的倉儲，需要分別將他們全部鎖定：

佈署第三方套件於 Weblate#

備註

後面的部署不是由 Weblate 團隊開發或支持的。部分設置會與本文件中描述的有偏差。

Bitnami Weblate 棧#

Bitnami provides a Weblate stack for many platforms at <https://bitnami.com/stack/weblate>.

也參考

Weblate packaged by Bitnami

Weblate Cloudron Package#

Cloudron 是自託管 web 應用的平台。安裝有 Cloudron 的 Weblate 會自動更新。軟件包由 Cloudron 團隊在它們的 Weblate package repo 上維護。

在 YunoHost 中的 Weblate#

自託管項目 YunoHost 為 Weblate提供了包。一旦安裝了 YunoHost，就可以同其它應用一樣安裝 Weblate。它還為您提供帶有備份和恢復的完全工作棧，但您必須為特定應用編輯設置文件。

可以使用管理界面，或這個按鈕（它將帶您到您的服務器）：

還能夠使用命令行界面：

yunohost app install https://github.com/YunoHost-Apps/weblate_ynh

升級 Weblate#

Docker 鏡像升級#

官方 Docker 鏡像（參見使用 Docker 安裝）集成了所有 Weblate 升級步驟。除了拉取最新版本外，通常不需要手動步驟。

也參考

升級 Docker 容器

通用的升級說明#

在升級前，請檢查當前的軟件要求，因為他們可能被更改。一旦所有的要求被安裝或升級，請調整您的 settings.py，來匹配配置中的更改（正確的值請諮詢 settings_example.py）。

在升級前總是查看版本特定說明。在您跳過一些版本的情況下，請遵從在升級中您跳過的所有版本的指示。有時最好升級到一些中間版本，來確保平滑遷移。跨多發行版本的升級應該可以工作，但還沒有像單一版本升級一樣測試過。

備註

推薦在升級前執行全資料庫備份，使您可以在升級失敗的情況下回滾資料庫，請參見備份和移動 Weblate。

停止 WSGI 和 Celery 進程。升級可能執行資料庫的不兼容更改，因此在升級中避免舊的進程運行總是安全的。

升級 Weblate 代碼。

對於 pip 安裝，可以通過後面的來實現：

pip install -U "Weblate[all]==version"

或者，如果您只想獲取最新發佈的版本：

pip install -U "Weblate[all]"

If you don’t want to install all of the optional dependencies do:

pip install -U Weblate

通過 Git 核實，您需要取回新的原始碼併升級您的安裝：

cd weblate-src
git pull
# Update Weblate inside your virtualenv
. ~/weblate-env/bin/pip install -e .
# Install dependencies directly when not using virtualenv
pip install --upgrade -r requirements.txt
# Install optional dependencies directly when not using virtualenv
pip install --upgrade -r requirements-optional.txt

New Weblate release might have new 可選依賴性, please check if they cover features you want.
升級配置文件，所需的步驟請參考 settings_example.py 或版本特定說明。
Upgrade database structure:
```
weblate migrate --noinput
```
收集升級的靜態文件（請參見服務器運行中和靜態檔案服務）：
```
weblate collectstatic --noinput --clear
```
壓縮 JavaScript 和 CSS 文件（可選步驟，請參見壓縮客戶端素材）：
```
weblate compress
```
如果您運行來自 Git 的版本，每次升級時還應該重新生成 locale 文件。可以通過調用後面的來進行：
```
weblate compilemessages
```
驗證您的設置合理（還請參見生產設置）：
```
weblate check --deploy
```
Restart Celery worker (see 使用 Celery 的後台任務).

版本特定說明#

Upgrade from 2.x#

如果從 2.x 發佈版本升級，首先總是升級到 3.0.1，然後繼續在 3.x 系列中升級。跳過這步的升級不被支持，並且會中斷。

也參考

Weblate 3.0 文件中關於從 2.20 升級到 3.0

Upgrade from 3.x#

如果從 3.x 發佈版本升級，首先總是升級到 4.0.4 或 4.1.1，然後繼續在 4.x 系列中升級。跳過這步的升級不被支持，並且會中斷。

也參考

`Weblate 4.0 文件中關於從3.11 升級到4.0 <https://docs.weblate.org/en/weblate-4.0.4/admin/upgrade.html#upgrade-from-3-11-to-4-0> `_

從 4.0 升級到 4.1#

請按照通用的升級說明來執行升級。

显著的配置与依赖性更改：

在 settings_example.py 中有几项更改，最显著的是中间件的更改，请由此调整您的设置。
有幾個新的文件格式，在修改 WEBLATE_FORMATS 的情況下，您會想要將他們包括進來。
有幾個新的質量檢查，在修改 CHECK_LIST 的情況下，您會想要將他們包括進來。
在 DEFAULT_THROTTLE_CLASSES 設置中有幾項更改，來允許在 API 中報告速率限制。
有幾個新的且更新的要求。
在 INSTALLED_APPS 中有一些更改。
The MT_DEEPL_API_VERSION setting has been removed in Version 4.7. The DeepL machine translation now uses the new MT_DEEPL_API_URL instead. You might need to adjust MT_DEEPL_API_URL to match your subscription.

也參考

通用的升級說明

從 4.1 升級到 4.2#

請按照通用的升級說明來執行升級。

显著的配置与依赖性更改：

從 3.x 發佈版本升級不再支持，請首先升級到 4.0 或 4.1。
有幾個新的且更新的要求。
在 settings_example.py 中有几项更改，最显著的是新中间件和更改的应用订购。
基於 JSON 格式的密鑰是不再包括前導的點。在資料庫遷移過程中調整字串，但在您依賴於導出或 API 中的密鑰時，外部組件會需要調整。
Celery 配置更改，不再使用 memory 隊列。請調整您的啟動腳本和 CELERY_TASK_ROUTES 設置。
現在在設置中配置 Weblate 域，請參見 SITE_DOMAIN`（或 :envvar:`WEBLATE_SITE_DOMAIN）。在運行 Weblate 前您將不得不配置它。
使用者資料庫上的使用者名和電子郵件字段現在應該不因為大小寫敏感而不同。它之前錯誤地沒有被 PostgreSQL 強制。

也參考

通用的升級說明

從 4.2 升級到 4.3#

請按照通用的升級說明來執行升級。

显著的配置与依赖性更改：

在質量檢查中有一些更改，在您調整 CHECK_LIST 的情況下會想將他們包括進來。
源語言屬性從項目移動到 API 中揭露的組件。在使用時您會需要更新 Weblate 客戶端。
根據翻譯的字串數量，資料庫遷移到 4.3 會花費很長時間（期望每 10 萬個字串的遷移時間大約為 1 小時）。
在 INSTALLED_APPS 中有一些更改。
有個新的設置 SESSION_COOKIE_AGE_AUTHENTICATED，補充了 SESSION_COOKIE_AGE。
在使用 hub`或 :command:`lab`與 GitHub 或GitLab 集成的情況下，需要重新配置它，請參見 :setting:`GITHUB_CREDENTIALS 和 GITLAB_CREDENTIALS。

在 4.3.1 版本變更:

Celery 配置更改，加入了 memory 隊列。請調整您的啟動腳本和 CELERY_TASK_ROUTES 設置。

在 4.3.2 版本變更:

附加元件的``post_update``方法現在加入額外的``skip_push``參數。

也參考

通用的升級說明

從 4.3 升級到 4.4#

請按照通用的升級說明來執行升級。

显著的配置与依赖性更改：

在 INSTALLED_APPS 中有一處更改，必須將 weblate.configuration 添加在那裡。
現在需要 Django 3.1。
在使用 MySQL 或 MariaDB 的情況下，需要的最低版本提高了，請參見 MySQL 與 MariaDB。

在 4.4.1 版本變更:

單語 gettext now uses both msgid and msgctxt when present. This will change identification of translation strings in such files breaking links to Weblate extended data such as screenshots or review states. Please make sure you commit pending changes in such files prior upgrading and it is recommended to force loading of affected component using loadpo.
增加了 translate-toolkit 的最低需求版本，來處理幾個文件格式問題。

也參考

通用的升級說明

從 4.4 升級到 4.5#

請按照通用的升級說明來執行升級。

显著的配置与依赖性更改：

如果您有大詞彙表，遷移可能需要相當長的時間。
Glossaries are now stored as regular components.
刪除詞彙表API，使用定期翻譯API來訪問詞彙表。
:setting:`django:INSTALLED_APPS`中有一處更改， - ``weblate.metrics``應被添加。

在 4.5.1 版本變更:

“Pyahocorasick”模塊有一個新的依賴。

也參考

通用的升級說明

從 4.5 升級到了 4.6#

請按照通用的升級說明來執行升級。

显著的配置与依赖性更改：

有幾個新的文件格式，在修改 WEBLATE_FORMATS 的情況下，您會想要將他們包括進來。
創建組件的 API 現在自動使用 Weblate internal URLs，見:http:post:/api/projects/(string:project)/components/。
依賴關係和：設置：`django：password_hashers`更喜歡argon2以獲取密碼散列。

也參考

通用的升級說明

從 4.6 升級到了 4.7#

請按照通用的升級說明來執行升級。

显著的配置与依赖性更改：

在 settings_example.py 中有几项更改，最显著的是中间件的更改(MIDDLEWARE)，请由此调整您的设置。
The DeepL machine translation now has a generic MT_DEEPL_API_URL setting to adapt to different subscription models more flexibly. The MT_DEEPL_API_VERSION setting is no longer used.
Django 3.2 is now required.

也參考

通用的升級說明

Upgrade from 4.7 to 4.8#

請按照通用的升級說明來執行升級。

在這次的發佈沒有額外需要升級的步驟。

也參考

通用的升級說明

Upgrade from 4.8 to 4.9#

請按照通用的升級說明來執行升級。

There is a change in storing metrics, the upgrade can take long time on larger sites.

也參考

通用的升級說明

Upgrade from 4.9 to 4.10#

請按照通用的升級說明來執行升級。

這是會影響每一專案的改動，這個改動會在數千個專案上，並在網站上花點時間執行。
Django 4.0 has made some incompatible changes, see Backwards incompatible changes in 4.0. Weblate still supports Django 3.2 for now, in case any of these are problematic. Most notable changes which might affect Weblate:
- Dropped support for PostgreSQL 9.6, Django 4.0 supports PostgreSQL 10 and higher.
- Format of CSRF_TRUSTED_ORIGINS was changed.
The Docker container now uses Django 4.0, see above for changes.

也參考

通用的升級說明

Upgrade from 4.10 to 4.11#

請按照通用的升級說明來執行升級。

Weblate now requires Python 3.7 or newer.
The implementation of 管理單一專案的存取控制 has changed, removing the project prefix from the group names. This affects API users.
Weblate now uses charset-normalizer instead of chardet module for character set detection.
Changed in 4.11.1: There is a change in REST_FRAMEWORK setting (removal of one of the backends in DEFAULT_AUTHENTICATION_CLASSES).

也參考

通用的升級說明

Upgrade from 4.11 to 4.12#

請按照通用的升級說明來執行升級。

There are no special steps required.

也參考

通用的升級說明

Upgrade from 4.12 to 4.13#

請按照通用的升級說明來執行升級。

The 語言定義 are now automatically updated on upgrade, use UPDATE_LANGUAGES to disable that.
Handling of context and location has been changed for Windows RC files, HTML files, IDML Format, and 文字檔 file formats. In most cases the context is now shown as location.
The machine translation services are now configured using the user interface, settings from the configuration file will be imported during the database migration.

也參考

通用的升級說明

Upgrade from 4.13 to 4.14#

請按照通用的升級說明來執行升級。

The Java formatting checks now match GNU gettext flags. The flags set in Weblate will be automatically migrated, but third-party scripts will need to use java-printf-format instead of java-format and java-format instead of java-messageformat.
The jellyfish dependency has been replaced by rapidfuzz.
Changed in 4.14.2: Deprecated insecure configuration of VCS service API keys via _TOKEN/_USERNAME configuration instead of _CREDENTIALS list. In Docker, please add matching _HOST directive. For example see WEBLATE_GITHUB_HOST and GITHUB_CREDENTIALS.

也參考

通用的升級說明

Upgrade from 4.14 to 4.15#

請按照通用的升級說明來執行升級。

Weblate now requires btree_gin extension in PostgreSQL. The migration process will install it if it has sufficient privileges. See 建立 PostgreSQL資料庫 for manual setup.
The Docker image no longer enables debug mode by default. In case you want it, enable it in the environment using WEBLATE_DEBUG.
The database migration make take hours on larger instances due to recreating some of the indexes.
Changed in 4.15.1: The default value for DEFAULT_PAGINATION_CLASS in rest framework settings was changed.

也參考

通用的升級說明

Upgrade from 4.15 to 4.16#

請按照通用的升級說明來執行升級。

Celery beat is now storing the tasks schedule in the database, CELERY_BEAT_SCHEDULER and INSTALLED_APPS need to be changed for that.
The deprecated VCS setting for credentials is no longer supported, see Upgrade from 4.13 to 4.14.
Upgrade of django-crispy-forms requires changes in INSTALLED_APPS.
Integration of django-cors-headers requires changes in INSTALLED_APPS and MIDDLEWARE.

也參考

通用的升級說明

Upgrade from 4.16 to 4.17#

請按照通用的升級說明來執行升級。

Migration to rewritten metrics storage might take considerable time on larger Weblate instance (expect around 15 minutes per GB of metrics_metric table). To reduce downtime, you can copy weblate/metrics/migrations/*.py from Weblate 4.17 to 4.16 and start the migration in the background. Once it is completed, perform full upgrade as ususal.

也參考

通用的升級說明

從 Python 2 升級到 Python 3#

Weblate 不再支持早於 3.6 版本的 Python。確保仍運行在較早版本的情況下，請先在現有版本上執行搬遷到 Python 3，並在後面進行升級。請參見 Upgrading from Python 2 to Python 3 in the Weblate 3.11.1 documentation。

從其它資料庫遷移到 PostgreSQL#

If you are running Weblate on other dabatase than PostgreSQL, you should consider migrating to PostgreSQL as Weblate performs best with it. The following steps will guide you in migrating your data between the databases. Please remember to stop both web and Celery servers prior to the migration, otherwise you might end up with inconsistent data.

建立 PostgreSQL資料庫#

在另一個單獨的資料庫中運行 Weblate，並將使用者賬戶分開通常是個好方法：

# If PostgreSQL was not installed before, set the main password
sudo -u postgres psql postgres -c "\password postgres"

# Create a database user called "weblate"
sudo -u postgres createuser -D -P weblate

# Create the database "weblate" owned by "weblate"
sudo -u postgres createdb -E UTF8 -O weblate weblate

使用 Django JSON 轉儲來遷移#

最簡單的遷移方法是使用 Django JSON 轉儲。這對於較小的安裝工作得很好。在更大的網站，您會想要使用 pgloader 代替，請參見使用 pgloader 遷移到 PostgreSQL。

添加 PostgreSQL 作為到 :file:`settings.py`的另外的資料庫連接：

DATABASES = {
    "default": {
        # Database engine
        "ENGINE": "django.db.backends.mysql",
        # Database name
        "NAME": "weblate",
        # Database user
        "USER": "weblate",
        # Database password
        "PASSWORD": "password",
        # Set to empty string for localhost
        "HOST": "database.example.com",
        # Set to empty string for default
        "PORT": "",
        # Additional database options
        "OPTIONS": {
            # In case of using an older MySQL server, which has MyISAM as a default storage
            # 'init_command': 'SET storage_engine=INNODB',
            # Uncomment for MySQL older than 5.7:
            # 'init_command': "SET sql_mode='STRICT_TRANS_TABLES'",
            # If your server supports it, see the Unicode issues above
            "charset": "utf8mb4",
            # Change connection timeout in case you get MySQL gone away error:
            "connect_timeout": 28800,
        },
    },
    "postgresql": {
        # Database engine
        "ENGINE": "django.db.backends.postgresql",
        # Database name
        "NAME": "weblate",
        # Database user
        "USER": "weblate",
        # Database password
        "PASSWORD": "password",
        # Set to empty string for localhost
        "HOST": "database.example.com",
        # Set to empty string for default
        "PORT": "",
    },
}

運行遷移，並將任何插入到表格中的數據 drop 掉：

weblate migrate --database=postgresql
weblate sqlflush --database=postgresql | weblate dbshell --database=postgresql

將遺留資料庫進行轉儲，並導入 PostgreSQL

weblate dumpdata --all --output weblate.json
weblate loaddata weblate.json --database=postgresql

調整 DATABASES 而只使用 PostgreSQL 資料庫作為預設，將遺留連接刪除掉。

現在 Weblate 應該準備好從 PostgreSQL 資料庫運行了。

使用 pgloader 遷移到 PostgreSQL#

pgloader 是通用遷移工具，將數據遷移到 PostgreSQL。您可以使用它來遷移 Weblate 資料庫。

調整 settings.py 文件而將 PostgreSQL 用作資料庫。

遷移 PostgreSQL 中的模式：

weblate migrate
weblate sqlflush | weblate dbshell

運行 pgloader 來轉移數據。後面的腳本可以用於遷移資料庫，但您會想要學習更多關於 pgloader 的知識，來理解它做什麼以及調整它來匹配您的設置：

LOAD DATABASE
     FROM      mysql://weblate:password@localhost/weblate
     INTO postgresql://weblate:password@localhost/weblate

WITH include no drop, truncate, create no tables, create no indexes, no foreign keys, disable triggers, reset sequences, data only

ALTER SCHEMA 'weblate' RENAME TO 'public'
;

Migrating from Pootle#

因為 Weblate 開始編寫出來替換 Pootle，所以支持從 Pootle 遷移使用者賬戶。您可以將 Pootle 的使用者轉儲，並使用 importusers 將他們導入。

備份和移動 Weblate#

Project level backups#

在 4.14 版本新加入.

警告

恢復備份功能只支援使用 PostgreSQL 或 MariaDB 10.5+ 的資料庫。

專案會從 Weblate 備份所有翻譯內容（專案、組件、翻譯、字串評註、建議或查核）。這適合用在轉移專案到另一個 Weblate 翻譯平台。

您可以執行一個專案的備份，透過 Manage ↓ Backups 。而備份可以在建立新專案的時候恢復（參閱：添加翻譯項目和組件）。

目前備份資料不包含存取控制與歷史資訊。

評註與建議會與其建立者之名稱一同備份。匯入時若有相符則指定到其使用者。若無相符使用者，將會指定為匿名者名稱。

保存在伺服器上所產生的備份將以 PROJECT_BACKUP_KEEP_DAYS 與 PROJECT_BACKUP_KEEP_COUNT 參數設定（預設將保存近 3 個備份檔案 30 天）。

使用 BorgBackup 自動備份#

在 3.9 版本新加入.

Weblate 內置了對使用 BorgBackup 創建服務備份的支持。 Borg 創建了節省空間的加密備份，可以安全地存儲在雲中。可以從管理界面中的 Backups 選項卡上控製備份。

在 4.4.1 版本變更: PostgreSQL 和 MySQL/MariaDB 資料庫都包括在自動備份中。

使用 Borg 的備份是遞增的， Weblate 配置為保留後面的備份：

近 14 日的每日備份
近 8 週的每週備份
近 6 個月的每月備份

Borg 加密金鑰#

BorgBackup 創建加密的備份，如果沒有密碼，您將無法恢復它們。密碼是在添加新的備份服務時生成的，您應該複製它並將其保存在一個安全的地方。

如果您在使用 Weblate 支援備份儲存，請同樣備份您的私有 SSH 密鑰，因為它用來訪問您的備份。

也參考

borg init

自訂備份#

資料庫備份可透過 DATABASE_BACKUP 設定。
自訂創建備份可使用 BORG_EXTRA_ARGS 設定值。

Weblate 支援備份儲存#

備份您的 Weblate 執行個體最簡單方式是在 weblate.org 購買備份服務。這是您如何讓它運行起來的方式：

在 https://weblate.org/support/#backup 購買備份服務。
在管理界面輸入得到的密鑰，請參見整合支援。
Weblate 將連接到雲服務，並獲取備份的訪問信息。
從 Backups 標籤開啟新的備份配置。
備份您的 Borg 憑證以至可從憑證恢復您的備份，參閱： Borg 加密金鑰。

提示

為了安全起見，有打開所有東西的手動步驟。沒有您的同意，就不會有數據發送到通過註冊步驟得到的備份倉儲。

使用客戶的備份存儲#

也可以使用自己的存儲來備份。 SSH 可以用於在遠程目的地存儲備份，目標服務器需要安裝 BorgBackup。

也參考

General 在 Borg 文件中

本地文件系統#

推薦去指定本地備份的絕對路徑，例如 /path/to/backup。該目錄必須可由運行 weblate 的使用者寫入（請參見文件系統權限）。在目錄不存在的情況下，Weblate 會嘗試新建它，但需要適當的權限才能這麼做。

提示

在 Docker 中運行 Weblate時，請確保備份位置揭露為來自 Weblate 容器的一個卷。否則，備份文件將在其所在的容器重啟時被 Docker 丟棄。

一個選項是將備份放置在一個現有的捲中。例如， /app/data/borgbackup。這是容器中的一個現有的捲。

您也可以在 Docker 的編寫文件中為備份目的添加一個新的容器，例如使用 /borgbackup:

services:
  weblate:
    volumes:
      - /home/weblate/data:/app/data
      - /home/weblate/borgbackup:/borgbackup

備份所存儲的目錄由 UID 1000 所有，否則 Weblate 將無法把備份寫入那裡。

Remote backups#

要建立遠端備份，您必須將`BorgBackup`_ 安裝到另一個伺服器上，確保它可接受透過 SSH 密鑰的連線：

準備一個您的備份將用來存放的伺服器。
將其安裝 SSH 服務（在大部分的 Linux 發行版本中您將能預設的取得）。
安裝 BorgBackup 在伺服器中。大部分的 Linux 發行版本擁有可取得的套件（參閱 Installation）。
選擇一個現有的使用者或建立新的使用者將於備份使用。
新增 Weblate 的 SSH 金鑰於使用者中，將使 Weblate SSH 連線到伺服器時不需要密碼（參閱 Weblate SSH 密鑰）。
Configure the backup location in Weblate as user@host:/path/to/backups or ssh://user@host:port/path/to/backups.

提示

Weblate 支援備份儲存 provides you automated remote backups without any effort.

也參考

borg list ， borg extract

從 BorgBackup 恢復備份#

恢復功能會訪問您的備份倉儲，並準備備份密碼。
用 borg list REPOSITORY 列出服務器上的所有備份。
使用 borg extract REPOSITORY::ARCHIVE 將所需備份恢復到當前目錄。
從放置在 Weblate 數據目錄下 backup 目錄中的 SQL 備份中恢復資料庫（請參見下載的數據用於備份）。
將 Weblate 配置（ backups/settings.py，請參見下載的數據用於備份）複製到正確的位置，請參見調整配置。

當使用 Docker 容器時，設定檔已經包含在容器中，您應該恢復原始的環境變數。 environment.yml 檔案或許能幫助您（參閱下載的數據用於備份）。
將整個存儲的數據目錄複製到 DATA_DIR 所配置的位置。

當使用 Docker 容器放置資料到 volume 中，請參閱 Docker 容器 volumes。

請確認檔案是否擁有正確的擁有權或權限，參閱文件系統權限。

Borg 會話可能看上去是這個樣子的：

$ borg list /tmp/xxx
Enter passphrase for key /tmp/xxx:
2019-09-26T14:56:08                  Thu, 2019-09-26 14:56:08 [de0e0f13643635d5090e9896bdaceb92a023050749ad3f3350e788f1a65576a5]
$ borg extract /tmp/xxx::2019-09-26T14:56:08
Enter passphrase for key /tmp/xxx:

也參考

borg list, borg extract

手動備份#

取決於您想保存什麼， Weblate 存儲的類型數據會備份在各自的位置。

提示

如果您正進行手動備份，您也許想要關閉Weblate 關於缺乏備份的警告，方法是添加``weblate.I028`` 到:file:settings.py 中的:setting:django:SILENCED_SYSTEM_CHECKS；對於Docker，則是:envvar:WEBLATE_SILENCED_SYSTEM_CHECKS。

SILENCED_SYSTEM_CHECKS.append("weblate.I028")

資料庫#

實際存儲位置依賴於資料庫的設置。

提示

資料庫是最重要的存儲。定期對資料庫進行備份。沒有資料庫，所有的翻譯都會消失。

原生資料庫備份#

推薦的方式是使用資料庫的本地工具如 pg_dump 或 mysqldump 來保存資料庫的轉儲。這通常比 Django 備份表現得好，並且可以連同數據一道，恢復完整表格。

您可以在較新的 Weblate 發行版中恢復這個備份，當運行於 migrate 時，它將執行所有必需的遷移。請參考升級 Weblate 了解如何在版本間升級的更多詳細信息。

Django 資料庫備份#

另外，可以使用 Django 的 dumpdata 命令備份您的資料庫。那種方式是不依托資料庫的，並且可以用於先要更改資料庫後端的情況。

恢復資料庫之前，您需要確保恢復備份和執行備份的實例運行的是完全相同的 Weblate 版本。這是必要的，因為資料庫結構在不同版本之間會發生變化，您可能會以某種方式破壞數據。安裝相同版本後，用 migrate 運行所有資料庫遷移。

之後，一些條目將已經在資料庫中創建，您也會在資料庫備份中看到它們。推薦的方法是使用管理 shell 手動刪除這些條目 (見：ref:invoke-manage)：

weblate shell
>>> from weblate.auth.models import User
>>> User.objects.get(username='anonymous').delete()

檔案#

如果您有足夠的備份空間，只需備份整個 DATA_DIR。這是一個安全帶，即使它包含一些您不想要的文件。下面的部分詳細描述了應該備份和可以跳過的內容。

下載的數據用於備份#

在 4.7 版本變更: 環境設定匯出到檔案 environment.yml ，協助在恢復 Docker 環境設定時使用。

存儲在 DATA_DIR /backups 中。

Weblate 這裡備份各種數據，可以包括這些文件用於更完整的備份。文件每日更新（需要運行 Celery beat 服務器，請參見使用 Celery 的後台任務）。當前，這包括：

Weblate 設置為 settings.py （還有擴展版，在 settings-expanded.py ）。
PostgreSQL 資料庫備份為 database.sql。
環境設定匯出檔案 environment.yml。

資料庫備份預設保存為純文本，但也可以通過 :setting:`DATABASE_BACKUP`來進行壓縮或整個跳過。

使用資料庫工具恢復資料庫備份，例如：

psql --file=database.sql weblate

版本控制儲存庫#

存儲在 DATA_DIR ``/vcs``中。

版本控制存儲庫包含帶有 Weblate 更改的上游存儲庫的副本。如果您對所有翻譯組件啟用了:ref:component-push_on_commit`，那麼所有 Weblate 變化都包括在上游。不需要在 Weblate 端備份存儲庫，因為它們可以從上游位置再次克隆，不會丟失數據。

SSH 和 GPG 密鑰#

存儲在 DATA_DIR /ssh 和 DATA_DIR /home 中。

如果正在使用 Weblate 生成的 SSH 或 GPG 密鑰，您應該備份這些位置。否則將丟失私有密鑰，並且您將不得不重新生成新的密鑰。

使用者已上傳檔案#

存儲在 DATA_DIR /media 中。

您應當備份所有使用者上傳的文件（例如字串的可見語境）。

Celery 任務#

Celery 任務隊列可能會包含一些信息，但通常無需進行備份。您最多會丟失尚未被翻譯記憶庫處理的更新。無論如何，建議在恢復時執行全文或存儲庫更新，這樣就不會有丟失這些內容的問題。

也參考

使用 Celery 的後台任務

手動備份的命令行#

使用 cron 作業，您可以設置一條每天執行的 Bash 命令，例如：

$ XZ_OPT="-9" tar -Jcf ~/backup/weblate-backup-$(date -u +%Y-%m-%d_%H%M%S).xz backups vcs ssh home media fonts secret

`XZ_OPT`後面引號之間的字串允許您選擇自己的 xz 選項，例如用於壓縮的內存量；見 https://linux.die.net/man/1/xz

您可以根據需要調整文件夾和文件的列表。為了避免保存翻譯記憶庫（在備份文件夾中），您可以使用：

$ XZ_OPT="-9" tar -Jcf ~/backup/weblate-backup-$(date -u +%Y-%m-%d_%H%M%S).xz backups/database.sql backups/settings.py vcs ssh home media fonts secret

恢復手動備份#

將已經備份的所有數據恢復。
使用 updategit 更新所有倉儲。
```
weblate updategit --all
```

移動 Weblate 安裝#

按照上面備份與恢復說明，將您的安裝遷移到不同系統。

也參考

從 Python 2 升級到 Python 3, 從其它資料庫遷移到 PostgreSQL

身份核對#

使用者註冊#

Weblate 的預設設置使用 python-social-auth，網站上處理新使用者註冊的一種形式。確定電子郵箱後，新使用者可以通過使用一種第三方服務來貢獻或證實。

還可以使用 REGISTRATION_OPEN 關閉新使用者註冊。

身份驗證嘗試服從於頻次限制。

身份驗證後台#

Django的內置解決方案用途是進行身份驗證，包括用各種社交登錄選項進行驗證。使用它意味著可以導入基於 Django 其他項目的使用者資料庫（請參見 Migrating from Pootle ）。

也可以另外新建 Django，相對於其他方式進行身份驗證。

也參考

身份驗證設置描述瞭如何配置官方 Docker 鏡像的身份驗證。

密碼驗證#

預設 settings.py 與一組合理的設置 AUTH_PASSWORD_VALIDATORS 在一起：

密碼不能與其它個人信息太相似。
密碼需至少10個字元。
密碼不能是常見的密碼。
密碼不能只含數字。
密碼不能包括單個字符或只有空白字符。
密碼與您過去使用的密碼不匹配。

可以自定義這個設置來匹配密碼政策。

可以另外安裝 django-zxcvbn-password 這會非常實際地估計密碼的難度，並允許拒絕低於下面適當閾值的密碼。

SAML 身份驗證#

在 4.1.1 版本新加入.

请遵守 Python Social Auth 的指示来配置。显著的差异有：

Weblate 支持單一 IDP，在 SOCIAL_AUTH_SAML_ENABLED_IDPS 中被稱為 weblate。
SAML XML 元數據 URL 為 /accounts/metadata/saml/。
後面的設置自動填入： SOCIAL_AUTH_SAML_SP_ENTITY_ID 、 SOCIAL_AUTH_SAML_TECHNICAL_CONTACT 、 SOCIAL_AUTH_SAML_SUPPORT_CONTACT

配置的例子：

# Authentication configuration
AUTHENTICATION_BACKENDS = (
    "social_core.backends.email.EmailAuth",
    "social_core.backends.saml.SAMLAuth",
    "weblate.accounts.auth.WeblateUserBackend",
)

# Social auth backends setup
SOCIAL_AUTH_SAML_SP_ENTITY_ID = f"https://{SITE_DOMAIN}/accounts/metadata/saml/"
SOCIAL_AUTH_SAML_SP_PUBLIC_CERT = "-----BEGIN CERTIFICATE-----"
SOCIAL_AUTH_SAML_SP_PRIVATE_KEY = "-----BEGIN PRIVATE KEY-----"
SOCIAL_AUTH_SAML_ENABLED_IDPS = {
    "weblate": {
        "entity_id": "https://idp.testshib.org/idp/shibboleth",
        "url": "https://idp.testshib.org/idp/profile/SAML2/Redirect/SSO",
        "x509cert": "MIIEDjCCAvagAwIBAgIBADA ... 8Bbnl+ev0peYzxFyF5sQA==",
        "attr_name": "full_name",
        "attr_username": "username",
        "attr_email": "email",
    }
}
SOCIAL_AUTH_SAML_ORG_INFO = {
    "en-US": {
        "name": "example",
        "displayname": "Example Inc.",
        "url": "http://example.com"
    }
}
SOCIAL_AUTH_SAML_TECHNICAL_CONTACT = {
    "givenName": "Tech Gal",
    "emailAddress": "technical@example.com"
}
SOCIAL_AUTH_SAML_SUPPORT_CONTACT = {
    "givenName": "Support Guy",
    "emailAddress": "support@example.com"
}

預設的設定檔會萃取出使用者資訊透過以下的屬性值，請設定您的 IDP 來提估給他們：

屬性值	SAML URI reference
全名	`urn:oid:2.5.4.3`
名字	`urn:oid:2.5.4.42`
Last name	`urn:oid:2.5.4.4`
郵件信箱	`urn:oid:0.9.2342.19200300.100.1.3`
使用者名稱	`urn:oid:0.9.2342.19200300.100.1.1`

提示

在以上的範例中與被定義為 IDP 的 Docker 映像檔名為 weblate。您可能需要設定此字串為 Relay 在您的 IDP 中。

也參考

:ref:“在Docker <docker-collect>`中配置收集，psa：beftends / collect

LDAP 身份驗證#

LDAP 身份驗證可以使用 django-auth-ldap 軟件包而最好地實現。可以使用通常的方式安裝：

# Using PyPI
pip install django-auth-ldap>=1.3.0

# Using apt-get
apt-get install python-django-auth-ldap

提示

此包包含於 Docker 容器中，見使用 Docker 安裝。

備註

在 Python LDAP 3.1.0 模塊中有一些不兼容，導致可能無法使用那個版本。如果得到錯誤信息`AttributeError: 『module』 object has no attribute 『_trace_level』 <https://github.com/python-ldap/python-ldap/issues/226>`_，將python-ldap 降回到3.0. 0 版可能會有幫助。

一旦安裝了軟件包，就可以將其鉤入 Django 身份驗證了：

# Add LDAP backed, keep Django one if you want to be able to sign in
# even without LDAP for admin account
AUTHENTICATION_BACKENDS = (
    "django_auth_ldap.backend.LDAPBackend",
    "weblate.accounts.auth.WeblateUserBackend",
)

# LDAP server address
AUTH_LDAP_SERVER_URI = "ldaps://ldap.example.net"

# DN to use for authentication
AUTH_LDAP_USER_DN_TEMPLATE = "cn=%(user)s,o=Example"
# Depending on your LDAP server, you might use a different DN
# like:
# AUTH_LDAP_USER_DN_TEMPLATE = 'ou=users,dc=example,dc=com'

# List of attributes to import from LDAP upon sign in
# Weblate stores full name of the user in the full_name attribute
AUTH_LDAP_USER_ATTR_MAP = {
    "full_name": "name",
    # Use the following if your LDAP server does not have full name
    # Weblate will merge them later
    # 'first_name': 'givenName',
    # 'last_name': 'sn',
    # Email is required for Weblate (used in VCS commits)
    "email": "mail",
}

# Hide the registration form
REGISTRATION_OPEN = False

備註

您應當從設置的:setting:django:AUTHENTICATION_BACKENDS`部分移除`』social_core.backends.email.EmailAuth』，否則使用者不能夠在Weblate中設置他們的密碼，並使用它進行身份驗證。為了生成權限和方便匿名使用者，仍需保留’weblate.accounts.auth.WeblateUserBackend』``。它還允許您使用一個本地管理帳戶登錄，如果您已經創建了它（如，通過使用:djadmin:createadmin）。

使用 Bind Password#

如果可以為身份驗證使用直接綁定，那麼需要使用搜索，並為使用者搜索提供綁定，例如：

import ldap
from django_auth_ldap.config import LDAPSearch

AUTH_LDAP_BIND_DN = ""
AUTH_LDAP_BIND_PASSWORD = ""
AUTH_LDAP_USER_SEARCH = LDAPSearch(
    "ou=users,dc=example,dc=com", ldap.SCOPE_SUBTREE, "(uid=%(user)s)"
)

Active Directory integration#

import ldap
from django_auth_ldap.config import LDAPSearch, NestedActiveDirectoryGroupType

AUTH_LDAP_BIND_DN = "CN=ldap,CN=Users,DC=example,DC=com"
AUTH_LDAP_BIND_PASSWORD = "password"

# User and group search objects and types
AUTH_LDAP_USER_SEARCH = LDAPSearch(
    "CN=Users,DC=example,DC=com", ldap.SCOPE_SUBTREE, "(sAMAccountName=%(user)s)"
)

# Make selected group a superuser in Weblate
AUTH_LDAP_USER_FLAGS_BY_GROUP = {
    # is_superuser means user has all permissions
    "is_superuser": "CN=weblate_AdminUsers,OU=Groups,DC=example,DC=com",
}

# Map groups from AD to Weblate
AUTH_LDAP_GROUP_SEARCH = LDAPSearch(
    "OU=Groups,DC=example,DC=com", ldap.SCOPE_SUBTREE, "(objectClass=group)"
)
AUTH_LDAP_GROUP_TYPE = NestedActiveDirectoryGroupType()
AUTH_LDAP_FIND_GROUP_PERMS = True

# Optionally enable group mirroring from LDAP to Weblate
# AUTH_LDAP_MIRROR_GROUPS = True

也參考

Django Authentication Using LDAP, Authentication

CAS 身份驗證#

可以使用軟件包如 django-cas-ng 來實現 CAS 身份驗證。

第一步通過 CAS 揭示了使用者電子郵箱字段。這必須在 CAS 服務器自身來配置，並需要至少運行 CAS v2，因為 CAS v1 不支持屬性。

第二步更新 Weblate，來使用 CAS 服務器和屬性。

安裝 django-cas-ng：

pip install django-cas-ng

一旦安裝了軟件包，就可以通過修改 settings.py 文件將其鉤連到 Django 身份驗證系統：

# Add CAS backed, keep the Django one if you want to be able to sign in
# even without LDAP for the admin account
AUTHENTICATION_BACKENDS = (
    "django_cas_ng.backends.CASBackend",
    "weblate.accounts.auth.WeblateUserBackend",
)

# CAS server address
CAS_SERVER_URL = "https://cas.example.net/cas/"

# Add django_cas_ng somewhere in the list of INSTALLED_APPS
INSTALLED_APPS = (..., "django_cas_ng")

最後，可以使用信號將電子郵箱字段投射到使用者對像上。為了生效，必須將信號從 django-cas-ng 軟件包導入，並將您的代碼與這個信號連接。在設置文件中這樣做可能產生問題，這樣建議將它放進去：

在您的 app 配置的 django.apps.AppConfig.ready() 方法
在項目的 urls.py 文件中（當沒有模塊存在時）

from django_cas_ng.signals import cas_user_authenticated
from django.dispatch import receiver


@receiver(cas_user_authenticated)
def update_user_email_address(sender, user=None, attributes=None, **kwargs):
    # If your CAS server does not always include the email attribute
    # you can wrap the next two lines of code in a try/catch block.
    user.email = attributes["email"]
    user.save()

也參考

Django CAS NG <https://github.com/django-cas-ng/django-cas-ng>`_`Django CAS NG

配置第三方 Django 身份驗證#

一般地，任何 Django 身份認證插件應該可以在 Weblate 上工作。只需要按照插件的說明，只記住安裝了 Weblate 使用者後台。

也參考

LDAP 身份驗證, CAS 身份驗證

典型的安裝包括，將身份驗證後台添加到 AUTHENTICATION_BACKENDS，並將身份驗證 app （如果有的話）安裝到 INSTALLED_APPS ：

AUTHENTICATION_BACKENDS = (
    # Add authentication backend here
    "weblate.accounts.auth.WeblateUserBackend",
)

INSTALLED_APPS += (
    # Install authentication app here
)

存取控制#

Weblate 具有一個精細的權利系統，可以為整個實例或在有限範圍內分配使用者權限。

在 3.0 版本變更: 在 Weblate 3.0之前的權利系統是基於Django 的，但現在是專門為Weblate構建的。如果您使用的是舊版本，請查閱該版本的文件，此處的資訊將不適用。

簡單的訪問控制#

如果您不是管理整個 Weblate 的安裝，而只是有權限管理某些項目（例如在託管的 Weblate），您的存取控制管理選項僅限於以下設定。如果您不需要任何複雜的設定，這些就足夠了。

專案存取控制#

備註

Projects running the gratis Libre plan on Hosted Weblate are always Public. You can switch to the paid plan if you want to restrict access to your project.

您可以透過選擇不同的:guilabel:`存取控制`設定來限制使用者對單個項目的存取。可用的選項有：

Public

任何人都看得到。

任何通過身份核對的使用者都可以貢獻。

所有人都可能可以存取VCS 儲存庫。

Choose this for open-source projects, or when your Weblate instance is private or locked-down.

Protected

任何人都看得到。

只有選定的使用者可以貢獻。

只有選定的使用者可以存取 VCS 儲存庫。

Choose this to gain visibility, but still have control over who can contribute.

Private

只有選定的使用者看得到。

只有選定的使用者可以貢獻。

只有選定的使用者可以存取 VCS 儲存庫。

Choose this for projects that should not be publicly exposed at all.

Custom

只有選定的使用者看得到。

只有選定的使用者可以貢獻。

只有選定的使用者可以存取 VCS 儲存庫。

Not available on Hosted Weblate.

You will have to set up all the permissions using 自訂存取控制.

Choose this on your own Weblate instance if you want to define access in a specific, finely customizable way.

可以在每個項目的配置（:guilabel:`Manage↓:guilabel:`Settings）的:guilabel:`Access`選項卡中更改Access控制。

可以透過 DEFAULT_ACCESS_CONTROL 修改預設值。

備註

即使對於 “私有” 項目，也會公開有關項目的一些信息: 儘管具有訪問控制設置，所有項目的計數都會包含在整個實例的統計信息和語言摘要裡面。您的項目名稱和其他信息不會揭露。

備註

項目中預設提供“公開”，”受保護”，及“私有”的使用者權限組合, Weblate的實例管理員也可以使用:ref:`custom settings <custom-acl>`進行個性化定制.

也參考

存取控制

管理單一專案的存取控制#

有 Manage project access 特權的使用者（請參見特殊權限列表與內建角色）可以管理專案內的使用者，透過將他們加入到專案內。初始的團隊由 Weblate 系統建立，但額外新增的可以被定義提供更多較仔細的存取控制。您可以限制團隊翻譯的語言與指派已定義的角色（參閱：特殊權限列表與內建角色）。

以下的團隊將隨著每一專案自動建立：

於`公開`、`保護`與`隱私`專案：

管理: 包含此專案所有可使用的權限。
複查 (僅限 :ref:`review workflow <reviews>`設置為打開): 可以在復查時批准翻譯。

只限‘受保護’及‘私有’項目：

翻譯: 可以翻譯項目，並將離線的翻譯上傳。
原文: 可以編輯來源字串 (如果在 project settings 中允許的話 )及來源字串信息。
語言: 可以管理已翻譯的語言（新增或移除翻譯字串）。
詞彙表: 可以管理字典檔（新增或移除項目與上傳）。
記憶: 可以管理翻譯記憶。
螢幕擷圖: 可以管理截圖（新增或移除他們或與來源文字作關聯）。
自動翻譯: 可以使用自動翻譯。
VCS: 可以管理版本控制系統（VCS）並訪問導出的倉儲。
帳單: 可以訪問賬單信息和設置（請參見帳單）。

這些功能可在 Access control 頁面上找到，頁面訪問路徑為項目 menu Manage ↓ Users。

團隊管理員#

在 4.15 版本新加入.

每一團隊可以擁有團隊的管理員，他可以新增或移除團隊中的成員。對於想要建立自治的團隊是很有用的。

新使用者邀請函#

此外，除了將現有使用者添加到項目之外，還可以邀請新使用者。將立即創建任何新使用者，但是該帳戶將保持不活動狀態，直到使用通過電子郵件發送的邀請中的鏈接登錄為止。不需要具有任何站點範圍的權限，就可以這麼做，項目級別的訪問管理權限 (如，Administration 組成員資格) 就足夠了。

提示

如果被邀請的使用者錯過了邀請的有效性，則可以在密碼重置表單中使用被邀請的電子郵件地址設置密碼，因為已經創建了帳戶。

在 3.11 版本新加入: 重新發送使用者邀請電子郵件是有可能的 (使任何之前發送的邀請無效)。

同樣的邀請函數可以從管理界面 :guilabel:`使用者`標籤。

禁用使用者#

在 4.7 版本新加入.

避免一些行為惡意的使用者在您的專案中，您可以限制他們貢獻。被限制的使用者若有權限依舊能看到專案，但是他不能做出貢獻。

單一專案權限管理#

將專案設定為`保護`、隱私`與 :ref:`manage users <manage-acl> 並在 Weblate 介面中管理每個專案的使用者。

預設情況下，這可以防止 Weblate 授權 Users 和 Viewers 提供 default teams 由於這些團隊所擁有的設定。這不會阻止您通過更改預設團隊，為預設團隊創建新的一個項目，或者為以下單個組件創建其他自定義設定，或者如自訂存取控制所描述。

其中一個透過 Weblate 使用者介面管理權限的主要好處是，您可以將其委派給其他使用者，而不需要給予他們超級使用者權限。為了這樣做，請將他們加入專案的 Administration 團隊。

自訂存取控制#

備註

This feature is unavailable on Hosted Weblate.

權限系統基於團隊和角色，其中角色定義一組權限，團隊將其與使用者和翻譯相關聯。參閱使用者，角色，團隊與權限瞭解更多資訊。

Weberate’s Access Control系統的最強大功能僅通過以下方式提供:ref:Django管理員界面<admin-interface>。您可以使用它來管理任何項目的權限。您不一定必須將其切換到“自定義”:ref:“訪問控制<ACL>”使用它。但是，您必須具有超級使用者權限才能使用它。

如果您對實現的詳細信息不感興趣，並且只想根據預設值創建一個簡單的配置，或者沒有對整個 Weblate 安裝的站點廣泛訪問（如託管的 Weblate），請參閱簡單的訪問控制。

常見設定#

此部分包含了一些您可能感興趣的常用配置選項的概覽。

網站範圍內的權限管理#

要一次管理整個執行個體的權限，請將使用者新增到合適的 default teams:

使用者（預設完成於經由 automatic team assignment）。
`審稿人員（如果您使用的是:ref:“評論工作流程<評論>”與專用評論者）。
“經理”（如果您想將大多數管理操作委派給其他人）。

您應該使所有專案設置為公開`（參閱 :ref:`acl），否則網站層級的權限將對使用者與檢閱者不會有任何影響。

您還可以賦予您所選擇的一些額外權限到預設組。例如，您可能希望允許管理所有使用者的屏幕截圖。

您也可以定義一些新的自定義團隊。如果您想繼續管理這些團隊的網站範圍內的權限，請選擇適當的 Project selection （如 All projects 或 All public projects ）。

為語言、組件或專案自訂權限#

您可以創建自己的專用團隊來管理不同對象（如語言，組件和項目）的權限。您不能透過新增一組自定義的團隊來撤銷任何來自全站設定的權限或某一團隊的權限，即使這些團隊只能授予額外的權限。

示例：

如果您想要（無論出於何種原因）允許翻譯到特定語言（讓我們說“捷克語”）僅在一組封閉式的可靠翻譯器，同時保持翻譯到其他語言公眾，您將不得不：

從所有使用者中刪除翻譯捷克語的權限。在預設配置中，可以通過修改使用者來完成此操作 default team。

群組使用者#

語言選取

如定義

語言

除捷克語以外

為捷克語翻譯新增專門組別。

捷克語翻譯群組#

角色

超級使用者

專案選取

所有公開專案

語言選取

如定義

語言

捷克語

新增團隊中您希望賦予權限的使用者。

正如您所看到的，這種方式的權限管理是強大的，但可能是相當繁瑣的工作。除非授予超級使用者權限，否則您無法將其委派給另一個使用者。

使用者，角色，團隊與權限#

身份驗證模型包括幾個對象：

許可: Weblate 定義的個人權限。權限不能分配給使用者。這只能通過分配角色來完成。
角色: 角色定義為一組權限。這允許在幾個地方重複使用這些組，使管理更容易。
使用者: 使用者可隸屬於許多個團隊。
群組: 使用者組連接角色、使用者和身份驗證對象（項目、語言和組件列表）。

備註

一個團隊可以沒有分配角色，在這種情況下，假設任何人能訪問專案（見下文）。

專案的瀏覽權限#

使用者必須為團隊成員並團隊連結到專案或任何組件的成員。擁有成員身份就足夠了，瀏覽項目不需要特定的權限（這被用於預設的查看者小組，見 default-groups ）。

組件的瀏覽權限#

使用者一旦能夠訪問組件的項目，就可以不受限制地訪問組件。（並將擁有該項目授予使用者的所有權限）。在開啟受限制的訪問的情況下，訪問組件需要對該組件（或該組件所在的組件列表）具有顯式權限。

團隊範圍#

The scope of the permission assigned by the roles in the teams are applied by the following rules:

如果團隊指定任何 Component list，所有在團隊已賦予到成員的權限也將賦權在團隊裡組件列表中的所有組件。若無額外指定的權限在所有的專案，這些組件在 Components 與 Projects 會被忽略。
If the team specifies any Components, all the permissions given to the members of that team are granted for all the components attached to the team, and an access with no additional permissions is granted for all the projects these components are in. Projects are ignored.
Otherwise, if the team specifies any Projects, either by directly listing them or by having Projects selection set to a value like All public projects, all those permissions are applied to all the projects, which effectively grants the same permissions to access all projects unrestricted components.
The restrictions imposed by a team’s Languages are applied separately, when it’s verified if a user has an access to perform certain actions. Namely, it’s applied only to actions directly related to the translation process itself like reviewing, saving translations, adding suggestions, etc.

提示

使用 Language selection 或 Project selection 來自動包括所有語言或項目。

示例：

可以這麼說這是一個專案 foo 擁有組件： foo/bar 與 foo/baz 以及以下的團隊：

群組西班牙語管理審查員#

角色

審核字串, 管理倉儲

組件

foo/bar

語言

西班牙語

該組的成員將有以下權限（假定使用預設角色設定）：

一般（瀏覽）訪問整個項目``foo``，包括它的兩個組件：foo / bar``和``foo / baz。

審核字串 foo/bar 在西班牙語翻譯中（不在其他地方）。

管理整個```foo / bar``jociticory的VCS。提交待定的翻譯人員對所有語言進行的更改。

自動團隊分派#

在底部的 Group 編輯頁面 Django admin interface，您可以指定 Automatic team assignments，在正規表示法的列表中根據其電子郵件自動建立的使用者分配團隊。此操作僅在帳戶建立時發生。

The most common use-case for the feature is to assign all new users to some default team. In order to do so, you will probably want to keep the default value (^.*$) in the regular expression field. Another use-case for this option might be to give some additional privileges to employees of your company by default. Assuming all of them use corporate e-mail addresses on your domain, this can be accomplished with an expression like ^.*@mycompany.com.

備註

Automatic team assignment to Users and Viewers is always recreated when upgrading from one Weblate version to another. If you want to turn it off, set the regular expression to ^$ (which won’t match anything).

備註

直到現在，無法通過使用者界面向某些團隊批量新增已現有使用者。為此，您可以使用以下方法 REST API 。

預設團隊和角色#

After installation, a default set of teams is created (see 團隊列表).

These roles and teams are created upon installation. The built-in roles are always kept up to date by the database migration when upgrading. You can’t actually change them, please define a new role if you want to define your own set of permissions.

特殊權限列表與內建角色#

範圍	權限	角色
帳單（參閱帳單）	檢視帳單資訊	Administration, Billing
更動	下載更動處	Administration
評註	張貼評註	管理權限、編輯來源、超級使用者、審核字串、翻譯
	刪除評註	Administration
	解決評註	管理權限、審核字串
組件	編輯組件設定	Administration
組件	鎖定組件，防止翻譯	Administration
詞彙表	增加詞彙表條目	Administration, Manage glossary, Power user
	編輯詞彙表條目	Administration, Manage glossary, Power user
	刪除詞彙表條目	Administration, Manage glossary, Power user
	上傳詞彙表條目	Administration, Manage glossary, Power user
自動建議	使用自動建議	管理權限、編輯來源、超級使用者、審核字串、翻譯
翻譯記憶	編輯翻譯記憶	Administration, Manage translation memory
翻譯記憶	刪除翻譯記憶	Administration, Manage translation memory
專案	編輯專案設定	Administration
專案	管理專案存取權	Administration
回報	下載報表	Administration
螢幕擷圖	加入畫面快照	Administration, Manage screenshots
	編輯畫面快照	Administration, Manage screenshots
	刪除畫面快照	Administration, Manage screenshots
來源字串	編輯額外字串資訊	Administration, Edit source
字串	新增新字串	Administration
	移除字串	Administration
	略過未通過查核	管理權限、編輯來源、超級使用者、審核字串、翻譯
	編輯字串	管理權限、編輯來源、超級使用者、審核字串、翻譯
	檢閱字串	管理權限、審核字串
	當施行建議時編輯字串	管理權限、審核字串
	編輯來源字串	Administration, Edit source, Power user
建議	接受建議	管理權限、編輯來源、超級使用者、審核字串、翻譯
	新增建議	管理權限、編輯來源、新增建議、超級使用者、審核字串、翻譯
	刪除建議	Administration, Power user
	建議的投票	管理權限、編輯來源、超級使用者、審核字串、翻譯
翻譯	加入新語言的翻譯	Administration, Power user, Manage languages
	執行自動翻譯	Administration, Automatic translation
	刪除既有的翻譯	Administration, Manage languages
	下載翻譯檔案	管理權限、編輯來源、存取倉儲、超級使用者、審核字串、翻譯、管理語言
	加入多種新語言的翻譯	Administration, Manage languages
上傳	定義上傳翻譯的作者	Administration
	以上傳內容覆蓋現在的翻譯	管理權限、編輯來源、超級使用者、審核字串、翻譯
	上傳翻譯	管理權限、編輯來源、超級使用者、審核字串、翻譯
VCS	存取內部倉儲	Administration, Access repository, Power user, Manage repository
	將更動提交到內部倉儲	Administration, Manage repository
	從內部倉儲推入更動	Administration, Manage repository
	重設內部倉儲中的更動	Administration, Manage repository
	檢視上游倉儲的位置	Administration, Access repository, Power user, Manage repository
	更新內部倉儲	Administration, Manage repository
全網站範圍的特權	使用管理介面
	加入新的專案
	加入語言定義
	管理語言定義
	管理團隊
	管理使用者
	管理角色
	管理公告
	管理翻譯記憶
	管理機器翻譯
	管理組件列表

備註

站點範圍的特權不會被授予任何預設角色。它們功能強大，非常接近超級使用者的地位。它們中的大多數都會影響到您的 Weblate 安裝中的所有項目。

團隊列表#

The following teams are created upon installation (or after executing setupgroups) and you are free to modify them. The migration will, however, re-create them if you delete or rename them.

訪客

定義未經身份驗證的使用者權限。

This team only contains anonymous users (see ANONYMOUS_USER_NAME).

You can remove roles from this team to limit permissions for non-authenticated users.

預設角色: Add suggestion, Access repository

審查員

This role ensures visibility of public projects for all users. By default, all users are members of this team.

By default, automatic team assignment makes all new accounts members of this team when they join.

預設角色：無

使用者

Default team for all users.

By default, automatic team assignment makes all new accounts members of this team when they join.

預設角色: Power user

審核員

審核員專用的群組（參閱翻譯工作流）。

預設角色：審核字串

管理員

管理員專用群組。

預設角色：管理權限

警告

Never remove the predefined Weblate teams and users as this can lead to unexpected problems! If you have no use for them, you can removing all their privileges instead.

Additional access restrictions#

If you want to use your Weblate installation in a less public manner, i.e. allow new users on an invitational basis only, it can be done by configuring Weblate in such a way that only known users have an access to it. In order to do so, you can set REGISTRATION_OPEN to False to prevent registrations of any new users, and set REQUIRE_LOGIN to /.* to require signing in to access all the site pages. This is basically the way to lock your Weblate installation.

提示

您可以使用內建的 :ref:`invite-user`新增使用者。

翻譯專案數#

翻譯組織#

項目/組件的可翻譯的版本控制系統（VCS ）內容，由 Weblate 組織成樹狀結構。

底層對像是項目配置，該項目配置應將所有翻譯歸在一起（例如，多個版本的應用程序翻譯和/或隨附的文件）。
在上面的級別上，:ref:`component`（實際上是要翻譯的組件），您定義要使用的版本控制系統（VCS ）倉儲以及要翻譯的文件的掩碼。
在:ref:component 上方，有單獨的翻譯，當版本控制系統（VCS ）倉儲中出現翻譯文件（與:ref:component 中定義的:ref:`component-filemask`匹配）時，Weblate會自動處理這些翻譯。

Weblate 支持 Translate Toolkit 支持的多種翻譯格式（雙語和單語），請參閱支持的文件格式。

備註

您可以使用 Weblate internal URLs 共享克隆的版本控制系統（VCS ）倉儲。當您有許多共享同一版本控制系統（VCS ）的組件時，強烈推薦使用此功能。它提高了性能並減少了所需的磁盤空間。

添加翻譯項目和組件#

在 3.2 版本變更: 已包含用於添加項目和組件的界面，您不再需要使用 Django 管理界面。

在 3.4 版本變更: 現在，添加組件的過程是多階段的，可以自動發現大多數參數。

根據您的權限，新的翻譯項目和組件可以被創建。具備 :guilabel:`Add new projects`權限的使用者總是可以這麼做。如果使用付費託管，您還可以從管理賬單的使用者賬戶基於套餐限額創建它們。

您可以在單獨的頁面上查看當前的結算方案：

您可以從此處開始創建項目，也可以使用導航條中的菜單來填寫翻譯項目的基本信息以完成添加：

創建項目後，您將直接進入項目頁面：

只需單擊一次即可啟動創建新翻譯組件的操作。創建組件的過程是多階段的，並自動檢測大多數翻譯參數。有幾種創建組件的方法：

來自版本控制: 從遠程版本控制倉儲創建組件。
來自既有組件: 通過選擇不同的文件為現有組件創建其他組件。
額外分支: 僅針對不同分支，為現有組件創建其他組件。
上傳翻譯檔: 如果您沒有版本控製或不想將其與 Weblate 集成，則將翻譯文件上傳到 Weblate。您以後可以使用網絡界面或 Weblate 的 REST API 更新內容。
翻譯文件: Upload single document or translation file and translate that.
從頭開始: 創建空白翻譯項目並手動添加字串。

一旦有了現有的翻譯組件，就可以使用同一倉儲輕鬆地為其他文件或分支添加新的組件。

首先，您需要填寫名稱和倉儲位置：

在下一頁上，將顯示已發現的可翻譯資源的列表：

_images/user-add-component-discovery.png

最後，您檢查翻譯組件信息並填寫可選詳細信息：

也參考

Django 管理界面, 項目配置, 組件配置

項目配置#

創建一個翻譯項目，然後在其中添加一個新的翻譯組件。這個項目就像一個架子，裡面堆放著真正的翻譯。同一項目中的所有組件共享建議及其字典；翻譯也將自動傳播到單個項目中的所有組件（除非在組件配置中關閉），請參見翻譯記憶。

也參考

與 Weblate 集成

這些基本屬性被新建並通知翻譯人員項目：

專案名稱#

詳細的項目名稱，用於顯示項目名稱。

也參考

PROJECT_NAME_RESTRICT_RE

URL slug#

適用於 URL 的項目名稱。

專案網站#

譯者可以在其中找到有關該項目的更多信息的 URL。

這是必需參數，除非關閉：設置：websents_required。

也參考

PROJECT_WEB_RESTRICT_HOST, PROJECT_WEB_RESTRICT_NUMERIC, PROJECT_WEB_RESTRICT_RE

翻譯指示#

Text describing localization process in the project, and any other information useful for translators. Markdown can be used for text formatting or inserting links.

設定「Language-Team」檔案標頭#

Weblate 是否應管理 Language-Team 頭（目前這是僅 GNU gettext 功能）。

使用共享的翻譯記憶#

是否使用共享翻譯記憶庫，有關更多詳細信息，請參見共享的翻譯記憶。

The default value can be changed by DEFAULT_SHARED_TM.

貢獻至共享翻譯記憶#

是否貢獻到共享翻譯記憶庫，請參閱共享的翻譯記憶以獲取更多詳細信息。

The default value can be changed by DEFAULT_SHARED_TM.

備註

This feature is unavailable on Hosted Weblate.

存取控制#

配置每個項目的訪問控制，請參閱專案存取控制以獲取更多詳細信息。

可以透過 DEFAULT_ACCESS_CONTROL 修改預設值。

啟用檢閱#

允許复核翻譯的工作流程，請參見專門的審核者。

啟用來源檢閱#

啟用審核來源字串的工作流程，參閱源字串複查。

也參考

Receiving source string feedback, 評註

啟用掛勾#

是否將未經身份驗證的通知掛勾用於此倉儲。

也參考

中間語言檔案, 源字串的質量網關, 雙語和單語格式, 語言定義

語言別名#

將翻譯導入到Weblate時定義語言代碼映射。當您的存儲庫中的語言代碼不一致，並且您希望在Weblate中獲得一致的視圖，或者如果您想使用翻譯文件的非標準命名時，可以使用此方法。

典型的使用情況會是將美國英語映射到英語：en_US:en

由逗號分隔的多個映射：en_GB:en,en_US:en

使用非標準編碼：ia_FOO:ia

提示

當匹配翻譯文件時映射語言代碼，並且映射是大小寫敏感的，所以您確保使用與文件名中使用的形式相同的源語言代碼。

也參考

添加新的翻譯, 語言碼, 解析語系碼

組件配置#

組件是用於翻譯的內容的分組。您輸入版本控制系統（VCS）倉儲位置和想要翻譯那個文件的掩碼，Weblate 會自動地從這個版本控制系統（VCS）中取回，並找到所有匹配的翻譯文件。

也參考

與 Weblate 集成

您可以在支持的文件格式中找到一些典型配置的例子。

備註

推薦將翻譯文件保持在合理的大小——在您的案例中使用任何合理的工具（獨立的 app 或附加元件、書籍的章節或網站）來分割翻譯文件。

Weblate 能夠輕鬆處理 10000 個字串，但大的翻譯組件的分割工作和翻譯者之間的協調更困難。

如果翻譯的語言定義丟失，會新建一個空的定義，並且命名為「cs_CZ (generated)」。您應該調整定義，並將其反饋給 Weblate 的作者，從而丟失的語言可以包括在下一次的發佈版本中。

使用版本控制系統（VCS）工作的所有重要參數都包含在組件中，並且從中取出翻譯：

組件名稱#

冗長組件名稱，用於顯示組件的名稱。

組件標識串#

適用於 URLs 的組件名稱。

組件項目#

組件所屬的項目配置。

版本控制系統#

使用的版本控制系統（VCS），細節請參見：版本控制整合。

也參考

推送 Weblate 的更改

源始碼倉儲#

版本控制系統（VCS）倉儲，用於拉取更改。

也參考

指定 URLs 的更多細節請參見訪問存儲庫。

提示

這可以或者是真實的版本控制系統（VCS）的 URL，或者是 weblate://project/component，指示了倉儲應該與其它組件分享。更多細節請參見 Weblate internal URLs。

倉儲推送 URL#

用於推送的倉儲 URL。這個設置用於 Git 和 Mercurial，並且當這個空白時推送支持為這些關閉。

For linked repositories, this is not used and setting from linked component applies.

也參考

關於如何指定倉儲 URL 的更多細節請見訪問存儲庫，並且關於從 Weblate 推送更改的更多細節，請參見推送 Weblate 的更改。

倉儲瀏覽器#

用於顯示源文件（已使用消息的位置）倉儲瀏覽器的的 URL。當空白時將不生成這樣的連接。您可以使用模板標記。

例如在 GitHub 上，使用像：``https://github.com/WeblateOrg/hello/blob/{{branch}}/{{filename}}#L{{line}}``那樣的一些東西

In case your paths are relative to different folder (path contains ..), you might want to strip leading directory by parentdir filter (see 模板標記): https://github.com/WeblateOrg/hello/blob/{{branch}}/{{filename|parentdir}}#L{{line}}

已匯出倉儲 URL#

由 Weblate 進行的更改被導出的 URL。當不使用持續本地化時，或者當需要手動合併更改時，這是重要的。您可以為 Git 倉儲使用 Git 導出器，來將其自動化。

倉儲分支#

從版本控制系統（VCS）核實哪個分支，以及從哪裡尋找翻譯。

For linked repositories, this is not used and setting from linked component applies.

推送分支#

用於推送更改的分支，留為空白來使用倉儲分支。

For linked repositories, this is not used and setting from linked component applies.

備註

此功能目前只支持Git、GitLab和GitHub，無法在其他VCS集成中工作。

也參考

推送 Weblate 的更改

文件掩碼#

要翻譯的文件的掩碼，包括路徑。它應包含一個「*」替換語言代碼（有關處理方式的信息，請參閱語言定義）。如果您的倉儲包含多個翻譯文件（例如，多個 gettext 域），則您需要為每個文件創建一個組件。

例如``po/.po`` 或 ``locale//LC_MESSAGES/django.po``。

如果文件名包含特殊字符（例如``[，]``），則需要將這些特殊字符轉義為 [[] 或 []]。

也參考

雙語和單語格式, “There are more files for the single language (en)”（單一語言‘英語’有多個文件）是什麼意思？

單語的基底語言檔#

包含字串定義的譯文模板文件，用於單語言組件。

也參考

雙語和單語格式, “There are more files for the single language (en)”（單一語言‘英語’有多個文件）是什麼意思？

編輯基底檔#

對於單語言組件是否允許編輯譯文模板文件。

中間語言檔案#

對於單語言組件的單一語言文件。在多數情況下，這是開發者提供的翻譯文件，並且在新建真正的源字串時使用。

When set, the source strings are based on this file, but all other languages are based on 單語的基底語言檔. In case the string is not translated into the source language, translating to other languages is prohibited. This provides 源字串的質量網關.

也參考

源字串的質量網關, 雙語和單語格式, “There are more files for the single language (en)”（單一語言‘英語’有多個文件）是什麼意思？

新翻譯的模板#

Base file used to generate new translations.

Keep this field empty for most of the monoligual formats. Those are typically able to start from an empty file.
Choose .pot file with GNU gettext PO files.
Choose blank file without translations, if you have one.
Choose 單語的基底語言檔 for monolingual formats that need a full set of keys present.
Choose 單語的基底語言檔 for document translations.
Choose any translation file for others.
Template file can be the same as the base file in most cases.

提示

In many monolingual formats Weblate starts with empty file by default. Use this in case you want to have all strings present with empty value when creating new translation.

也參考

添加新的翻譯, 加入新翻譯, 雙語和單語格式, “There are more files for the single language (en)”（單一語言‘英語’有多個文件）是什麼意思？

檔案格式#

翻譯文件格式，還請參見支持的文件格式。

來源字串臭蟲回報位址#

用於匯報上游缺陷的電子郵箱地址。 Weblate 中做出的任何字串註釋的通知，也由這個地址接收。

允許翻譯再用#

您可以關閉項目內從其它組件到這個組件的翻譯的傳播。這真正依賴於您在翻譯的是什麼，有時最好多次使用同一個翻譯。

對於單語言翻譯，除非您跨越整個項目中使用相同的 ID，通常關閉它是個好主意。

預設值可以通過 DEFAULT_TRANSLATION_PROPAGATION 來更改。

也參考

跨組件保持翻譯一致

啟用建議#

對於這個組件，建議的翻譯是否被接受。

建議投票#

為建議打開投票，請參見建議投票。

自動接受建議#

自動接收被投票的建議，請參見建議投票。

翻譯旗標#

質量檢查和其他 Weblate 行為的定制，請參見使用標誌自定義行為。

強制查核#

檢查哪個不能被忽視的列表，請參見強制檢查。

備註

執行檢查不會自動啟用它，您仍然應該使用:ref:“自定義檢查”:ref:“Component-Check_Flags`或：Ref：”其他“。

翻譯授權條款#

翻譯的許可（不需要與原始碼的許可相同）。

貢獻者協議書#

使用者必須先同意使用者協議才能翻譯此組件。

加入新翻譯#

如何處理創建新語言的請求。可用選項：

聯絡維護者: 使用者可以選擇所需的語言，項目維護者將收到有關該語言的通知。由他們決定是否向倉儲添加（或不添加）語言。
指向翻譯指示 URL: 向使用者顯示的頁面鏈接描述了開始新翻譯的過程。如果需要更正式的流程（例如，在開始實際翻譯之前組成人員團隊），請使用此選項。
建立新語言檔: 使用者可以選擇語言，然後 Weblate 會自動為其新建文件並開始翻譯。
停用加入新翻譯: 使用者將無法選擇開始新的翻譯。

提示

項目管理員可以添加新的翻譯，即使它是可能的（:ref:Ref：`Component-New_base`或從空文件開始的文件格式支持）。

也參考

添加新的翻譯, 新翻譯的模板

管理字串#

在 4.5 版本新加入.

配置WebLate中的使用者是否將被允許添加新字串並刪除現有字串。調整此項以匹配您的本地化工作流程 - 如何介紹新字串。

對於雙語格式，通常從原始碼中提取字串（例如，通過使用:program:xgettext）並禁用Web2中添加新字串（在下次更新翻譯文件時將被丟棄）。在WebLate中，您可以為每個翻譯管理字串，並且它不會在所有翻譯中強制執行字串。

對於單晶格式，字串僅在源語言上管理，並在翻譯中自動添加或刪除。一旦翻譯，字串會在翻譯文件中出現。

也參考

雙語和單語格式, Adding new strings, POST /api/translations/(string:project)/(string:component)/(string:language)/units/

語言代碼類型#

用來生成使用 Weblate 建立之翻譯檔名的自訂語言代碼。

備註

Weblate recognizes any of the language codes when parsing translation files, following settings only influences how new files are created.

預設基於檔案格式: 依賴於文件格式，對於其中的多數使用 POSIX。
POSIX 樣式，使用底線當作分隔符號: 典型地由 gettext 和相關工具使用，生成像 pt_BR 那樣的語言代碼。
POSIX 樣式，使用底線當作分隔符，包含地區碼: POSIX 風格的語言代碼即使不必要時也包括國家代碼；例如 cs_CZ）。
BCP 樣式，使用連字號當作分隔符號: 典型地在 web 平台上使用，生成像 pt-BR 那樣的語言編碼。
BCP 樣式，使用連字號當作分隔符號，包含地區碼: BCP 風格的語言代碼即使不必要時也包括國家代碼；例如 cs-CZ）。
BCP 樣式，使用連字號作為分隔符號、舊式語言代碼: Uses legacy codes for Chinese and BCP style notation.
BCP 樣式，使用連字號作為分隔符號，小寫: BCP style notation, all in lower case (for example cs-cz).
Apple App Store 中介資料樣式: Style suitable for uploading metadata to Apple App Store.
Google Play 中介資料樣式: Style suitable for uploading metadata to Google Play Store.
Android 樣式: 只在Android apps 中使用，生成像 pt-rBR 那樣的語言代碼。
Linux 樣式: Locales as used by Linux, uses legacy codes for Chinese and POSIX style notation.

也參考

添加新的翻譯, 語言碼, 解析語系碼, 語言別名

合併類型#

You can configure how updates from the upstream repository are handled. The actual implementation depends on VCS, see 版本控制整合.

衍合

Rebases Weblate commits on top of upstream repository on update. This provides clean history without extra merge commits.

在復雜融合的情況下，變基可能使您產生麻煩，因此請仔細考慮是否允許它們。

You might need to enable force pushing by choosing Git 使用強制推送 as 版本控制系統, especially when pushing to a different branch.

合併

Upstream repository changes are merged into Weblate one. This setting utilizes fast-forward when possible. This is the safest way, but might produce a lot of merge commits.

不快轉合併

Upstream repository changes are merged into Weblate one with doing a merge commit every time (even when fast-forward would be possible). Every Weblate change will appear as a merge commit in Weblate repository.

預設值可以由 :setting:`DEFAULT_MERGE_STYLE`更改。

Commit, add, delete, merge, add-on, and merge request messages#

當提交翻譯時使用的消息，請參見模板標記。

Default value can be changed by DEFAULT_ADD_MESSAGE, DEFAULT_ADDON_MESSAGE, DEFAULT_COMMIT_MESSAGE, DEFAULT_DELETE_MESSAGE, DEFAULT_MERGE_MESSAGE, DEFAULT_PULL_MESSAGE.

提交時一併推送#

是否自動推送已提交的項目到上游倉儲。啟用時，當 Weblate 將更改提交到其基礎存儲庫中，就會啟動推送。（請參見簡易提交）。為了能真正啟用推送功能，需配置 Repository push URL。

更動後提交的經過時間#

設置在後台任務或 :djadmin:`commit_pending`管理命令提交更改前，這些更改存在的時長 (以小時為單位)。一旦存在至少一個比該時長更舊的更改，便會提交組件中的所有更改。

預設值可以由 COMMIT_PENDING_HOURS 更改。

提示

有其他情況可能會提交掛起的更改，請參閱:ref:“懶惰提交”。

有錯誤時鎖定#

鎖定組件 (及關聯的組件，見:ref:internal-urls )，觸發條件是第一個失敗的推送，合併到其上游存儲庫，或從中拉出。這樣可以避免添加其他衝突，這些衝突必須手動解決。

一旦倉儲沒有故障留下來了，組件將會自動解鎖。

來源語言#

用於源字串的語言。如果您要翻譯的不是英語，請更改此選項。

提示

如果您正在從英語翻譯雙語文件，但又希望能夠在英語翻譯中進行修復，選擇 English (Developer) 作為一種源語言以避免源語言和現有翻譯之間名稱上的衝突。

對於單語言翻譯，您可以使用這種情況下的中間翻譯，請參見中間語言檔案。

語言篩選#

Regular expression used to filter the translation when scanning for file mask. It can be used to limit the list of languages managed by Weblate.

備註

單出現在文件名中時，您需要列出語言代碼。

過濾的一些例子：

過濾器的描述	正則表達式
Selected languages only	`^(cs\|de\|es)$`
排除的語言	`^(?!(it\|fr)$).+$`
只篩選兩個字母的代碼	`^..$`
排除非語言文件	`^(?!(blank)$).+$`
包括所有文件（預設）	`^[^.]+$`

變體的正則表達式#

用於確定字串變體的正則表達式，請見字串變量。

備註

Most of the fields can be edited by project owners or administrators, in the Weblate interface.

也參考

Weblate 支持 Git 和 Mercurial 意外的 VCS 嗎？, 翻譯組件警告

優先度#

較高優先度的組件會優先提供給翻譯者。

在 4.15 版本變更: This now also affects ordering of matched glossary terms.

受限制的訪問#

備註

This feature is unavailable on Hosted Weblate.

組件預設對訪問項目的任何人都可見，即使不能在組件中進行任何更改。這會容易地使翻譯在項目內保持一致。

無論項目級別權限如何，限制組件的訪問或組件列表級別將接管到組件的訪問權限。您必須明確授予對其的訪問權限。這可以通過授予對新使用者組的訪問並將使用者放入其中，或使用預設的“自定義”或“私有”訪問控制組。

預設設置可在 DEFAULT_RESTRICTED_COMPONENT 中更改。

提示

這也應用於項目管理員—請確認切換狀態後，您不會丟失對組件的訪問。

當作詞彙表#

在 4.5 版本新加入.

允許使用該組件作為術語表。您可以配置其列出方式，借助詞彙表色彩。

詞彙表將在以下所有項目中訪問:ref:“組件鏈接”。

建議啟用:ref:“組件 - Manage_Units”，以便為它們添加新單詞。

也參考

詞彙表

詞彙表色彩#

顯示顏色，用於顯示單詞匹配時使用的詞彙表。

模板標記#

Weblate 在需要提供文本的幾個地方使用簡單的標記語言。它基於 The Django template language，因此能夠非常強大。

當前它用在：

提交消息格式，請參見組件配置
幾個附加元件

可以在組件模板中得到後面的變量：

{{ language_code }}: 語言碼
{{ language_name }}: 語言名稱
{{ component_name }}: 組件名稱
{{ component_slug }}: 組件標識串
{{ project_name }}: 專案名稱
{{ project_slug }}: 項目標識串
{{ url }}: 翻譯 URL
{{ filename }}: 翻譯檔名
{{ stats }}: 翻譯統計數據，這具有進一步的屬性，示例如下。
{{ stats.all }}: Total strings count
{{ stats.fuzzy }}: 需要審核的字串數量
{{ stats.fuzzy_percent }}: 需要審核的字串數量百分比
{{ stats.translated }}: Translated strings count
{{ stats.translated_percent }}: Translated strings percent
{{ stats.allchecks }}: 檢查失敗的字串數量
{{ stats.allchecks_percent }}: 檢查失敗的字串百分比
{{ author }}: 當前提交的作者，只在提交範圍可用。
{{ addon_name }}: Name of currently executed add-on, available only in the add-on commit message.

後面的變量在倉儲瀏覽器或編輯器模板中可用：

{{branch}}: 當前的分支
{{line}}: line in file
{{filename}}: 文件名，您也可以使用 parentdir 過濾器，例如 {{filename|parentdir}}，來剝除前導部分

您可以將它們與過濾器結合：

{{ component|title }}

您可以使用條件：

{% if stats.translated_percent > 80 %}Well translated!{% endif %}

有另外的標籤用於替換字符：

{% replace component "-" " " %}

您可以將它與過濾器結合：

{% replace component|capfirst "-" " " %}

還有另外的過濾器來操作文件名：

Directory of a file: {{ filename|dirname }}
File without extension: {{ filename|stripext }}
File in parent dir: {{ filename|parentdir }}
It can be used multiple times:  {{ filename|parentdir|parentdir }}

……以及其他 Django 模板特性。

導入速度#

取回版本控制系統（VCS）倉儲，並將翻譯導入 Weblate，依賴於您的翻譯的大小，這會是漫長的過程。這裡是一些提示：

優化配置#

對於測試並調試 Weblate，預設的配置是有用的，當用於生產設置時，您應該進行一些調整。它們中的很多都對形成具有巨大的衝擊。特別是，更多細節請查看生產設置：

Check resource limits#

如果導入巨大的翻譯或倉儲，您會遭到服務器資源限制的打擊。

檢查空閒內存的量，通過操作系統來緩存翻譯，將極大地提高性能。
如果有很多字串需要處理的話，磁盤操作會是瓶頸——磁盤被 Weblate 和資料庫施加壓力。
另外的 CPU 核心會幫助提高後台任務的性能（請參見使用 Celery 的後台任務）。

Disable unneeded checks#

一些質量檢查可以使非常昂貴的，而如果不需要，在導入時省略可以節省一些時間。配置的信息請參見 CHECK_LIST。

自動新建組件#

In case your project has dozen of translation files (e.g. for different gettext domains, or parts of Android apps), you might want to import them automatically. This can either be achieved from the command-line by using import_project or import_json, or by installing the 組件探索 add-on.

To use the add-on, you first need to create a component for one translation file (choose the one that is the least likely to be renamed or removed in future), and install the add-on on this component.

對於管理命令，您需要新建包含所有組件的項目，然後運行 import_project 或 import_json。

也參考

管理命令, 組件探索

語言定義#

為了恰當地呈現不同的翻譯，需要提供有關語言名稱、文本方向、複數定義和語言代碼的信息。

Built-in language definitions#

Weblate 中包括了大約 600 種語言的定義，並且每次發佈時列表都在擴大。無論何時更新 Weblate 時（更特別地是無論何時執行 weblate migrate`時，請參見 :ref:`generic-upgrade-instructions）。語言資料庫都被更新，來包括 Weblate 上市時的所有語言定義。

這個特性可以使用 UPDATE_LANGUAGES`來禁止。還可以使用 :djadmin:`setuplang 來強制更新資料庫，從而匹配 Weblate 內建數據。

也參考

Extending built-in language definitions, Current language definitions

解析語系碼#

While parsing translations, Weblate attempts to map language code (usually the ISO 639-1 one) from the 文件掩碼 to any existing language object.

您可以通過語言別名在項目層次來進一步調整這種映射。

如果無法找到精確的匹配，將嘗試把其融入一種現有的語言。已嘗試以下措施：

大小寫不敏感的查詢。
Normalizing underscores and dashes.
Looking up built-in language aliases.
Looking up by language name.
忽略給定語言的預設國家代碼 — 選擇 cs 而非 cs_CZ。

如果這也失敗了，將使用預設值創建一個新的語言定義 (從左到右的文本方向，一個複數)。自動創建的帶有代碼 xx_XX 的語言將被命名為 xx_XX (generated)。您可能想稍後在管理界面中更改這個（見:ref:changing-languages），並將它報告給問題跟踪器（見:ref:contributing），這樣的話，正確的定義就可以添加到即將發佈的Weblate版本中。

提示

在您看到有些不想要的內容作為語言的情況下，您會想要調整語言篩選，當分析翻譯時忽略這樣的文件。

也參考

語言碼, 添加新的翻譯

改變語系定義#

您可以在語言界面來更改語言定義（ /languages/ URL ）。

當編輯時，確認所有字段都是正確的（特別是複數和正文方向），否則譯者將不能正常編輯這些翻譯。

Ambiguous language codes and macrolanguages#

In many cases it is not a good idea to use macrolanguage code for a translation. The typical problematic case might be Kurdish language, which might be written in Arabic or Latin script, depending on actual variant. To get correct behavior in Weblate, it is recommended to use individual language codes only and avoid macrolanguages.

也參考

宏語言定義 <https://iso639-3.sil.org/about/scope#Macrolanguages>，宏語言列表 <https://iso639-3.sil.org/code_tables/macrolanguage_mappings/data>

語言定義#

每種語言都包括後面的字段：

語言碼#

Code identifying the language. Weblate prefers two letter codes as defined by ISO 639-1, but uses ISO 639-2 or ISO 639-3 codes for languages that do not have two letter code. It can also support extended codes as defined by BCP 47.

也參考

解析語系碼, 添加新的翻譯

語言名稱#

語言的可見名稱。還要根據使用者界面語言將 Weblate 中包括的語言名稱進行本地化。

文字方向#

確定語言是從右向左還是從左向右書寫。對於多數語言這個屬性都能夠正確地自動監測。

複數數量#

語言中使用的複數的數量。

複數公式#

Gettxt 兼容的複數公式，用於確定根據給定的數量使用哪種複數形式。

也參考

複數, GNU gettext 工具: 複數形式<https://www.gnu.org/software/gettext/manual/html_node/Plural-forms.html>, `Language Plural Rules by the Unicode Consortium `_

語言使用者數量#

Number of worldwide speakers of this language.

持續本地化#

有適當的基礎結構，因此您的翻譯緊隨開發。這樣，翻譯人員可以一直進行翻譯，而不必在發佈之前處理大量的新文本。

也參考

與 Weblate 集成描述了將您的開發集成到 Weblate 中的基本方式。

這是過程：

開發人員進行更改並將其推送到版本控制系統（VCS ）倉儲。
可以選擇更新翻譯文件（這取決於文件格式，請參閱當已經更新了模板時，為什麼 Weblate 仍然顯示舊的字串？）。
Weblate 從版本控制系統（VCS ）倉儲中拉取更改，請參閱更新倉儲。
一旦 Weblate 檢測到翻譯更改，便會根據翻譯者的訂閱設置通知他們。
翻譯者使用 Weblate Web 界面提交翻譯，或上傳離線更改。
翻譯者完成後，Weblate 會將更改提交到本地倉儲（請參閱簡易提交），如果有權限將其推回（請參閱推送 Weblate 的更改）。

更新倉儲#

應該新建一些從他們的源來更新後端倉儲的方式。

使用通知掛勾來與多數常見的代碼託管服務集成：
在倉儲管理中或使用 Weblate 的 REST API 或 Weblate 客戶端來手動觸發更新
允許 AUTO_UPDATE 在您的Weblate事例上自動更新所有組件
執行 updategit （選擇項目，或 --all 來更新全部）

每當Weblate更新存儲庫時，更新後插件都將被觸發，請參見：附加元件。

避免發生合併衝突#

當相同的文件在 Weblate 之內與之外都更改時導致 Weblate 的合併衝突。有兩種方法來處理——避免在 Weblate 之外編輯，或者將 Weblate 集成到您的更新過程中，從而在更新 weblate 之外的文件之前刷新更改。

第一種方法容易用於單語言文件——可以添加 Weblate 之內的新字串，並將文件的整個編輯留在那裡。對於雙語言文件，通常存在某種消息提取過程而從原始碼產生翻譯文件。在一些情況下，這可以分成兩部分——一部分用於提取過程產生模板（例如使用:program:xgettext 產生gettex POT ），然後下一步過程將它合併到真正的翻譯中（例如使用:program :msgmerge 更新gettext PO 文件）。可以在 Weblate 中執行第二步，它將確認在這個操作前所有待定的更改都包括進去了。

第二種方法可以這樣實現，使用 Weblate 的 REST API，當您在自己一側進行更改時，強制 Weblate 推送所有待定的更改，並鎖定翻譯。

進行更新的腳本看起來像這樣：

# Lock Weblate translation
wlc lock
# Push changes from Weblate to upstream repository
wlc push
# Pull changes from upstream repository to your local copy
git pull
# Update translation files, this example is for Django
./manage.py makemessages --keep-pot -a
git commit -m 'Locale updates' -- locale
# Push changes to upstream repository
git push
# Tell Weblate to pull changes (not needed if Weblate follows your repo
# automatically)
wlc pull
# Unlock translations
wlc unlock

如果多個組件分享相同的倉儲，需要分別將他們全部鎖定：

wlc lock foo/bar
wlc lock foo/baz
wlc lock foo/baj

備註

例子使用了 Weblate 客戶端，這需要配置（API 密鑰）來遠程控制 Weblate。可以通過使用 HTTP 客戶端代替 wlc，例如 curl 來實現，請參見 Weblate 的 REST API。

也參考

Weblate 客戶端

從 GitHub 自動接收更改#

Weblate 伴隨 GitHub 本地支持。

如果使用 Hosted Weblate，推薦的方法是安裝 Weblate app，該方法能夠得到正確的設置，而不必設置很多東西。它還可以用於將更改推送回來。

為了在每次推送到 GitHub 倉儲時接收通知，將 Weblate Webhook 添加到倉儲設置（ Webhooks ）中，如下圖所示：

對於負載 URL，將 /hooks/github/ 增補到您的 Weblate URL中，例如對於 Hosted Weblate 服務，這是 https://hosted.weblate.org/hooks/github/。

可以將其他設置保留為預設值（ Weblate 可以處理內容類型，並只消費 push 事件）。

也參考

POST /hooks/github/, 從託管的Weberate訪問存儲庫

從 Bitbucket 自動接收更改#

Weblate 已經支持Bitbucket webhooks，添加倉儲推送時觸發的webhook，目的地為您的Weblate 安裝上的``/hooks/bitbucket/`` （例如``https://hosted.weblate.org/hooks/bitbucket/ `` ）。

也參考

POST /hooks/bitbucket/, 從託管的Weberate訪問存儲庫

從 GitLab 自動接收更改#

Weblate 已經支持GitLab hooks，添加項目的webhook，目的地為您的Weblate 安裝上的``/hooks/gitlab/`` （例如``https://hosted.weblate.org/hooks/gitlab/`` ）。

也參考

POST /hooks/gitlab/, 從託管的Weberate訪問存儲庫

從 Pagure 自動接受更改#

在 3.3 版本新加入.

Weblate 已經支持Pagure hooks，添加項目的webhook，目的地為您的Weblate 安裝上的``/hooks/pagure/`` （例如``https://hosted.weblate.org/hooks/pagure/`` ）。這可以在 Project options 之下的 Activate Web-hooks 中完成：

也參考

POST /hooks/pagure/, 從託管的Weberate訪問存儲庫

從 Azure Repos 自動接收更改#

在 3.8 版本新加入.

Weblate 已經支持Azure Repos web hooks，為:guilabel:Code pushed 事件添加webhook，目的地為您的Weblate 安裝上的``/hooks/azure/`` URL （例如``https://hosted.weblate .org/hooks/azure/`` ）。這可以在 Project settings 之下的 Service hooks 中完成。

也參考

Web hooks in Azure DevOps manual, POST /hooks/azure/, 從託管的Weberate訪問存儲庫

從 Gitea Repos 自動接收更改#

在 3.9 版本新加入.

Weblate 已經支持Gitea webhooks，為:guilabel:Push events 事件添加:guilabel:Gitea Webhook，目的地為您的Weblate 安裝上的``/hooks/gitea/`` URL （例如``https:/ /hosted.weblate.org/hooks/gitea/`` ）。這可以在 Settings 之下的 Webhooks 中完成。

也參考

Gitea 手冊中的 Webhooks <https://docs.gitea.io/en-us/webhooks/>`_, POST /hooks/gitea/, 從託管的Weberate訪問存儲庫

從 Gitee Repos 自動接收更改#

在 3.9 版本新加入.

Weblate 已經支持Gitee webhooks，為:guilabel:Push 事件添加:guilabel:Webhook，目的地為您的Weblate 安裝上的``/hooks/gitee/`` URL （例如``https://hosted .weblate.org/hooks/gitee/`` ）。這可以在 Management 之下的 Webhooks 中完成。

也參考

Gitee 手冊中的 Webhoks <https://gitee.com/help/categories/40>`_, POST /hooks/gitee/, 從託管的Weberate訪問存儲庫

每晚自動更新倉儲#

Weblate 在後面合併更改時，每晚自動獲取遠程倉儲來提高性能。可以選擇將其同樣轉換為進行每晚合併，通過允許 AUTO_UPDATE。

推送 Weblate 的更改#

每個翻譯組件可以新建推送 URL（請參見倉儲推送 URL ），在那種情況下 Weblate 能夠將更改推送到遠程倉儲。 Weblate 還可以配置在每次提交時自動推送更改（這是預設的，請參見提交時一併推送）。如果不想更改自動給推送，可以在 Repository maintenance 之下手動進行，或通過 wlc push 使用 API。

推送選項根據使用的版本控制整合而不同，更多細節可以在那個章節中找到。

In case you do not want direct pushes by Weblate, there is support for GitHub pull requests, GitLab 合併請求, Gitea pull requests, Pagure 合併請求 pull requests or Gerrit reviews, you can activate these by choosing GitHub, GitLab, Gitea, Gerrit or Pagure as 版本控制系統 in 組件配置.

整體上， Git 、 GitHub 和 GitLab 可以具有後面的選項：

需要的設置	版本控制系統	倉儲推送 URL	推送分支
不推送	Git	空	空
直接推送	Git	SSH URL	空
Push to separate branch	Git	SSH URL	分支名稱
來自叉子的 GitHub 拉取請求	GitHub pull requests	空	空
來自分支的 GitHub 拉取請求	GitHub pull requests	SSH URL [1]	分支名稱
來自叉子的 GitLab 結合請求	GitLab 合併請求	空	空
來自分支的 GitLab 結合請求	GitLab 合併請求	SSH URL [1]	分支名稱
Gitea merge request from fork	Gitea pull requests	空	空
Gitea merge request from branch	Gitea pull requests	SSH URL [1]	分支名稱
來自分叉的Pargue合併請求	Pagure 合併請求	空	空
來自分支的 Pagure合併請求	Pagure 合併請求	SSH URL [1]	分支名稱

備註

還可以允許 Weblate 提交後更改的自動推送，這可以在提交時一併推送中完成。

也參考

請參見訪問存儲庫來設置 SSH 密鑰，和簡易提交獲得關於 Weblate 決定提交更改的信息。

受保護的分支#

如果在受保護的分支上使用 Weblate，可以配置使用拉取請求，並執行翻譯的實際複查（對您不知道的語言可能有問題）。另一個方法是去掉對 Weblate 推送使用者的這個限制。

例如在 GitHub，這可以在倉儲配置中進行：

與其他相互影響#

Weblate 通過使用它的 API，使與他人的交流更容易。

也參考

Weblate 的 REST API

簡易提交#

Weblate會盡可能將同一作者的提交分組到一個提交中。這大大減少了提交的數量，但是如果您想同步版本控制系統（VCS ）倉儲，例如合併，您可能需要明確地告訴它去做提交（這對:guilabel:Managers`組是預設允許的，參見:ref:`privileges）。

如果多個組件分享相同的倉儲，需要分別將他們全部鎖定：

某人另外更改了已經被更改的字串。
來自上游的結合發生了。
明確地請求了提交。
A file download is requested.
更改比組件配置上定義為 Age of changes to commit 的時間段更陳舊。

提示

Commits are created for every component. So in case you have many components you will still see lot of commits. You might utilize 匯併 Git 提交 add-on in that case.

If you want to commit changes more frequently and without checking of age, you can schedule a regular task to perform a commit. This can be done using Periodic Tasks in Django 管理界面. First create desired Interval (for example 120 seconds). Then add new periodic task and choose weblate.trans.tasks.commit_pending as Task with {"hours": 0} as Keyword Arguments and desired interval.

用腳本處理倉儲#

自訂 Weblate 與倉儲互動方式是附加元件。關於如何通過插件執行外部腳本的資訊，請參閱 Executing scripts from add-on。

跨組件保持翻譯一致#

一旦具有多個翻譯組件，您會想要確保相同的字串具有相同的翻譯。這可以在幾個層次實現。

翻譯宣傳#

With 允許翻譯再用 enabled (what is the default, see 組件配置), all new translations are automatically done in all components with matching strings. Such translations are properly credited to currently translating user in all components.

備註

翻譯宣傳需要密鑰來匹配單語言翻譯格式，因此在建立翻譯密鑰匙請記住。

一致性檢查#

在字串不同時不一致會啟動檢查。您可以藉此來手動複查其差異，並選擇正確的翻譯。

自動翻譯#

Automatic translation based on different components can be way to synchronize the translations across components. You can either trigger it manually (see 自動翻譯) or make it run automatically on repository update using add-on (see 自動翻譯).

翻譯許可#

您可以指定翻譯輸入哪種授權方式。當翻譯對公眾公開時這特別重要，這樣明確規定如何使用。

您應該指定組件配置版權信息。您應該避免那些需要獲得貢獻者版權協議的情況，儘管這是可能的。

版權信息#

在指定版權信息的時候（版權名稱和 URL ），這個信息顯示在各個組件配置的翻譯信息部分。

如果不需要特別同意的話，這通常是放置許可信息的最佳位置。如果您的項目或翻譯不是開源項目，那麼您最可能需要事先同意。

貢獻者協議書#

如果您指定了貢獻者版權協議，那麼只有同意協議的使用者能夠做出貢獻。當進入到翻譯時，這是清晰可見的步驟：

輸入的文本被格式化為段落，並非且可以包括外部連接。不能使用 HTML 標記。

使用者版權#

任何使用者可以在其簡介的實例中看到所有公開項目的所有翻譯版權：

翻譯程序#

建議投票#

Everyone can add suggestions by default, to be accepted by signed in users. Suggestion voting can be used to make use of a string when more than one signed-in user agrees, by setting up the 組件配置 with Suggestion voting to turn on voting, and Autoaccept suggestions to set a threshold for accepted suggestions (this includes a vote from the user making the suggestion if it is cast).

備註

一旦新建了自動接受，那麼普通使用者會失去直接保存翻譯或接受建議的特權。要繞過這一點，可以通過當建議強制時編輯字串 permission。

您可以將這些與 access control 合併到以下設置中的一個：

使用者建議並對建議進行投票，並且有限的組控制接受什麼。 ——打開投票。 ——關閉自動接受。 ——不要讓使用者存儲翻譯。
使用者建議並對建議進行投票，一旦他們之中確定的數量同意則自動接受。 ——打開投票。 ——設置自動接受所需要的投票數量。
對建議的可選投票。（當使用者對做出的多個建議不確定時，可以由使用者可選地使用。）——只打開投票。

源字串另外的信息#

通過向字串添加額外的信息來增強翻譯過程，這些信息包括解釋、字串優先級、檢查標記和可視化上下文。有些信息可以從翻譯文件中提取，有些可以通過編輯額外的字串信息添加:

可以通過點擊緊鄰 Screenshot context 或 Flags 的「Edit」標籤而從翻譯界面直接訪問。

字串優先級#

使用 priority 標識可以更改字串優先級來為字串提供更高優先級，以便更早地進行翻譯。

提示

這可以用於以邏輯的方式將翻譯流程排序。

也參考

質量檢查

翻譯旗標#

在 3.3 版本變更: 之前被稱為 Quality checks flags，它不再只配置檢查了。

質量檢查和其他 Weblate 行為的定制，請參見使用標誌自定義行為。

The string flags are also inherited from the 翻譯旗標 at 組件配置 and flags from the translation file (see 支持的文件格式).

也參考

質量檢查, 使用標誌自定義行為

解釋#

在 4.1 版本變更: 在以前的版本中這被稱為 Extra context。

使用解釋來明確翻譯的範圍或翻譯的使用。您可以使用 Markdown 來包括連接和其它標誌。

字串的可見語境#

您可以將顯示您程序中使用的給定源字串的截屏上傳。這幫助譯者理解它用在哪裡，並且應該如何翻譯。

上傳的截屏在翻譯語境的側邊條中顯示：

additional除了源字串另外的信息，截屏在 Tools 菜單下有個單獨的管理界面。上傳截屏，將它們手動分配給源字串，或者使用光學字符識別（OCR）來進行。

一旦上傳了截屏，那麼這個界面處理管理以及源字串的聯繫：

檢查和修復#

自訂自動修正#

還可以應用除了自動修正以外自己的自動修正，並將它們包括到 AUTOFIX_LIST。

自動修復很強大，但可能導致損壞；寫腳本的時候要小心。

例如，後面的自動修復會將每次出現的字串 foo 在翻譯中替換為 bar ：

# Copyright © Michal Čihař <michal@weblate.org>
#
# SPDX-License-Identifier: GPL-3.0-or-later

from django.utils.translation import gettext_lazy as _

from weblate.trans.autofixes.base import AutoFix


class ReplaceFooWithBar(AutoFix):
    """Replace foo with bar."""

    name = _("Foobar")

    def fix_single_target(self, target, source, unit):
        if "foo" in target:
            return target.replace("foo", "bar"), True
        return target, False

為了安裝定制的檢查，在 AUTOFIX_LIST 中為 Python 類提供完全合規的路徑，請參見自訂的質量檢查、附加元件和自動修復。

使用標誌自定義行為#

You can fine-tune the Weblate behavior by using flags. This can be done on the source string level (see 源字串另外的信息), or in the 組件配置 (翻譯旗標). Some file formats also allow to specify flags directly in the format (see 支持的文件格式).

標記用逗號分隔，參數用冒號分隔。可以在字串中使用引號來包含空白字符或特定字符。例如：

placeholders:"special:value":"other value", regex:.*

單引號或是雙引號是可接受的，特殊符號就會被使用反斜線 `` 挑脫處理：

placeholders:"quoted \"string\"":'single \'quoted\''

這裡是現在能接受的標記的列表：

rst-text: 將文本視為 reStructuredText 文件，影響未更動的翻譯。
dos-eol: 使用 DOS 的行末標記，而不是 Unix的（ \r\n instead of \n ）。
read-only: 字串應該只讀，並且不能在 Weblate 中編輯。請參見唯讀字串。
priority:N: 字串的優先級。高優先級的字串首先出現被翻譯。預設的優先級是 100，字串的優先級越高，就會越早安排翻譯。
max-length:N: 將字串的最大長度限制為 N 個字符，請參見翻譯最大長度。
xml-text: 將文本看作 XML 文件，影響 XML 語法 and XML 標記。
font-family:NAME: 定義 font-family 來提供檢查，請參見管理字型。
font-weight:WEIGHT: 定義 font-weight 來提供檢查，請參見管理字型。
font-size:SIZE: 定義 font-size 來提供檢查，請參見管理字型。
font-spacing:SPACING: 定義渲染檢查的字母間隔，請參見管理字型。
icu-flags:FLAGS: Define flags for customizing the behavior of the ICU MessageFormat quality check.
icu-tag-prefix:PREFIX: Set a required prefix for XML tags for the ICU MessageFormat quality check.
placeholders:NAME:NAME2:...: 翻譯中需要的佔位字串，請參見佔位符。
replacements:FROM:TO:FROM2:TO2...: 當檢查結果文本參數時執行替換（例如在翻譯的最大長度或翻譯最大長度中）。這一典型應用的情況拓展了非譯元素，確保匹配那些即使使用了長值的文本，例如 placements:%s:」John Doe」``。
variants:SOURCE: 將此字串標記為具有匹配源的字串的變體。見字串變量。
regex:REGEX: 正則表達式用來比對翻譯，參閱：正則表達式。
forbidden: 表示術語表中的禁止翻譯，請參閱:ref:“詞彙表禁止”。
strict-same: 使用內建的單詞黑名單，來避免“沒有翻譯”的檢查提示。請參見未更動的翻譯。
check-glossary: 啟用與詞彙表不同品質確認。
angularjs-format: 啟用 AngularJS 插值字串品質確認。
c-format: 啟用 C 格式品質確認。
c-sharp-format: 啟用 C# 格式品質確認。
es-format: 啟用 ECMAScript 模板字面值品質確認。
i18next-interpolation: 啟用 i18next 插補品質確認。
icu-message-format: 啟用 ICU MessageFormat 品質確認。
java-printf-format: 啟用 Java 格式品質確認。
java-format: 啟用 Java MessageFormat 品質確認。
javascript-format: 啟用 JavaScript 格式品質確認。
lua-format: 啟用 Lua 格式品質確認。
object-pascal-format: 啟用 Object Pascal 格式品質確認。
percent-placeholders: 啟用百分比佔位符品質確認。
perl-format: 啟用 Perl 格式品質確認。
php-format: 啟用 PHP 格式品質確認。
python-brace-format: 啟用 Python 大括號格式品質確認。
python-format: 啟用 Python 格式品質確認。
qt-format: 啟用 Qt 格式品質確認。
qt-plural-format: 啟用 Qt 複數格式品質確認。
ruby-format: 啟用 Ruby 格式品質確認。
scheme-format: 啟用 Scheme 格式品質確認。
vue-format: 啟用 Vue I18n 格式品質確認。
md-text: Treat text as a Markdown document. Enable Markdown 連結, Markdown 參照, and Markdown 語法 quality checks.
case-insensitive: 調整查核為不論字母大小寫。目前只影響佔位符品質查核。
safe-html: 啟用不安全的 HTML 品質確認。
url: 字串應為 URL 組成。啟用網址品質確認。
ignore-all-checks: 略過所有品質確認。
ignore-bbcode: 略過 BBCode 標記品質確認。
ignore-duplicate: 略過連續重複單字品質確認。
ignore-check-glossary: 略過與詞彙表不同品質確認。
ignore-double-space: 略過兩個空白品質確認。
ignore-angularjs-format: 略過 AngularJS 插值字串品質確認。
ignore-c-format: Skip the C 格式 quality check.
ignore-c-sharp-format: Skip the C# 格式 quality check.
ignore-es-format: Skip the ECMAScript 模板字面值 quality check.
ignore-i18next-interpolation: Skip the i18next 插補 quality check.
ignore-icu-message-format: Skip the ICU MessageFormat quality check.
ignore-java-format: Skip the Java MessageFormat quality check.
ignore-java-printf-format: Skip the Java 格式 quality check.
ignore-javascript-format: Skip the JavaScript 格式 quality check.
ignore-lua-format: Skip the Lua 格式 quality check.
ignore-object-pascal-format: Skip the Object Pascal 格式 quality check.
ignore-percent-placeholders: Skip the 百分比佔位符 quality check.
ignore-perl-format: Skip the Perl 格式 quality check.
ignore-php-format: Skip the PHP 格式 quality check.
ignore-python-brace-format: Skip the Python 大括號格式 quality check.
ignore-python-format: Skip the Python 格式 quality check.
ignore-qt-format: Skip the Qt 格式 quality check.
ignore-qt-plural-format: Skip the Qt 複數格式 quality check.
ignore-ruby-format: Skip the Ruby 格式 quality check.
ignore-scheme-format: Skip the Scheme 格式 quality check.
ignore-vue-format: Skip the Vue I18n 格式 quality check.
ignore-translated: Skip the 已經翻譯過 quality check.
ignore-inconsistent: Skip the 不一致 quality check.
ignore-kashida: Skip the 使用 Kashida letter quality check.
ignore-md-link: Skip the Markdown 連結 quality check.
ignore-md-reflink: Skip the Markdown 參照 quality check.
ignore-md-syntax: Skip the Markdown 語法 quality check.
ignore-max-length: Skip the 翻譯最大長度 quality check.
ignore-max-size: Skip the 翻譯的最大長度 quality check.
ignore-escaped-newline: Skip the Mismatched \n quality check.
ignore-end-colon: Skip the 冒號不相符 quality check.
ignore-end-ellipsis: Skip the 刪節號不相符 quality check.
ignore-end-exclamation: Skip the 驚嘆號不相符 quality check.
ignore-end-stop: Skip the 句號不相符 quality check.
ignore-end-question: 略過問號不相符品質確認。
ignore-end-semicolon: 略過分號不相符品質確認。
ignore-newline-count: Skip the 斷列符不相配 quality check.
ignore-plurals: Skip the 缺少複數形 quality check.
ignore-placeholders: Skip the 佔位符 quality check.
ignore-punctuation-spacing: Skip the 標點符號間距 quality check.
ignore-regex: Skip the 正則表達式 quality check.
ignore-same-plurals: Skip the 相同複數形 quality check.
ignore-begin-newline: Skip the 開頭換列 quality check.
ignore-begin-space: Skip the 開頭空格 quality check.
ignore-end-newline: Skip the 換列結尾 quality check.
ignore-end-space: Skip the 空格結尾 quality check.
ignore-same: Skip the 未更動的翻譯 quality check.
ignore-safe-html: Skip the 不安全的 HTML quality check.
ignore-url: Skip the 網址 quality check.
ignore-xml-tags: Skip the XML 標記 quality check.
ignore-xml-invalid: Skip the XML 語法 quality check.
ignore-zero-width-space: Skip the 零寬度空格 quality check.
ignore-ellipsis: 略過刪節號品質查核。
ignore-icu-message-format-syntax: 略過 ICU MessageFormat 語法品質查核。
ignore-long-untranslated: 略過長期未翻譯品質查核。
ignore-multiple-failures: 略過多項未通過查核品質查核。
ignore-unnamed-format: 略過多個未命名變數品質查核。
ignore-optional-plural: 略過未複數化品質查核。

備註

通常規則是，任何檢查都使用識別文字來命名 ignore-*，所以能夠將規則應用在定制檢查中。

每個源字串的設置，在組件配置設置中，並且在翻譯文件自身中（例如在 GNU gettex 中），能夠理解這些標記。

強制檢查#

在 3.11 版本新加入.

您可以通過設定組件配置中的強制查核，來設定不能省略的檢查列表。列出每個檢查在使用者界面中都不能省略，並且檢查失敗的任何字串都被標記為 Needs editing （參閱翻譯狀態）。

備註

無法自動啟用強制查核。查核可透過新增一致性標記或組件標記而被啟用。

也參考

源字串另外的信息，翻譯旗標

管理字型#

在 3.7 版本新加入.

提示

上傳到Weberate的字體純粹用於:ref:“Check-Max-Size`”檢查，它們在WebLate使用者界面中沒有效果。

用於計算呈現文本需要的尺寸的 :ref: 『 check-max-size 『檢查需要字體被加載進 Weblate 並被一個翻譯標識選中 (見使用標誌自定義行為)。

在您的翻譯項目 Manage 菜單下 Fonts 中的 Weblate 字體管理工具提供了接口來上傳並管理字體。可以上傳 TrueType 或 OpenType 字體，設置 font-groups 並在檢查中使用它們。

字型組允許為不同語言確定不同字型，這是非拉丁語言中典型需要的：

字型組通過名稱識別，名稱不能包含空白字符或特殊字符，這使它能夠容易地用在檢查定義中：

字型族和样式在上傳後自動識別：

可以將幾種字型加載到 Weblate 中：

為了使用字型來檢查字串長度，將適當的標記傳遞給它（請參見使用標誌自定義行為）。可能會需要後面這些：

max-size:500: 定義寬度上限（pixels）。
font-family:ubuntu: 確定字型組，通過指定其識別文字來使用。
font-size:22: 定義字型大小（pixels）。

撰寫自定義查核#

Weblate 內建了很大範圍的質量檢查，（請參見質量檢查），儘管可能沒有覆蓋想要檢查的所有內容。可以使用 CHECK_LIST 來調整執行檢查的列表，也可以添加定制的檢查。

weblate.checks.Check 子類別
設置一些屬性。
應用 check （如果想要處理代碼中的複數的話）或 check_single 方法（它將為您完成）。

一些例子：

為了安裝定制的檢查，在 CHECK_LIST 中為 Python 類提供完全合格的路徑，請參見自訂的質量檢查、附加元件和自動修復。

檢查翻譯文本不含有 “ foo ”#

這是非常簡單的檢查，只檢查翻譯中是否丟失了字串“ foo ”。

# Copyright © Michal Čihař <michal@weblate.org>
#
# SPDX-License-Identifier: GPL-3.0-or-later

"""Simple quality check example."""

from django.utils.translation import gettext_lazy as _

from weblate.checks.base import TargetCheck


class FooCheck(TargetCheck):
    # Used as identifier for check, should be unique
    # Has to be shorter than 50 characters
    check_id = "foo"

    # Short name used to display failing check
    name = _("Foo check")

    # Description for failing check
    description = _("Your translation is foo")

    # Real check code
    def check_single(self, source, target, unit):
        return "foo" in target

檢查捷克語翻譯文本的複數差異#

使用語言信息來檢查，驗證捷克語中的兩種複數形式不同。

# Copyright © Michal Čihař <michal@weblate.org>
#
# SPDX-License-Identifier: GPL-3.0-or-later

"""Quality check example for Czech plurals."""

from django.utils.translation import gettext_lazy as _

from weblate.checks.base import TargetCheck


class PluralCzechCheck(TargetCheck):
    # Used as identifier for check, should be unique
    # Has to be shorter than 50 characters
    check_id = "foo"

    # Short name used to display failing check
    name = _("Foo check")

    # Description for failing check
    description = _("Your translation is foo")

    # Real check code
    def check_target_unit(self, sources, targets, unit):
        if self.is_language(unit, ("cs",)):
            return targets[1] == targets[2]
        return False

    def check_single(self, source, target, unit):
        """We don't check target strings here."""
        return False

配置自動建議#

在 4.13 版本變更: Prior to Weblate 4.13, the services were configured in the 配置.

The support for several machine translation and translation memory services is built-in. Each service can be turned on by the administrator for whole site or at the project settings:

備註

They come subject to their terms of use, so ensure you are allowed to use them how you want.

The services translate from the source language as configured at 組件配置, see 來源語言.

也參考

自動建議

Amagama#

服務編號:: amagama
配置:: This service has no configuration.

Special installation of tmserver run by the authors of Virtaal.

也參考

Installing amaGama, Amagama, `amaGama 翻譯記憶<https://amagama.translatehouse.org/>`_

Apertium APy#

服務編號:

apertium-apy

配置:

url

API URL

開源原件機器翻譯平台提供一組有限語言的翻譯。

使用 Apertium的推薦方式是運行您自己的 Apertium-APy 服務器。

也參考

Apertium website, Apertium APy documentation

AWS#

在 3.1 版本新加入.

服務編號:

aws

配置:

`key`	存取金鑰 ID
`secret`	API 金鑰
`region`	區域名稱

Amazon Translate 是神經機器翻譯服務，用於將英語與廣泛支持的語言進行互譯。

也參考

Amazon 翻譯文件

Baidu#

在 3.2 版本新加入.

服務編號:

baidu

配置:

`key`	使用者端 ID
`secret`	使用者端秘密金鑰 (secret)

由百度提供的機器翻譯服務。

這項服務使用 API，並且您需要從百度獲得 ID 和 API 密鑰來使用它。

也參考

Baidu Translate API

DeepL#

服務編號:

deepl

配置:

`url`	API URL
`key`	API 金鑰

DeepL 是付費服務，提供一些語言的良好機器翻譯。您需要購買 DeepL API 訂閱，或者您可以使用傳統的 DeepL Pro (classic) 計劃。

API URL to use with the DeepL service. At the time of writing, there is the v1 API as well as a free and a paid version of the v2 API.

https://api.deepl.com/v2/ (在 Weblate 預設使用): Is meant for API usage on the paid plan, and the subscription is usage-based.
https://api-free.deepl.com/v2/: Is meant for API usage on the free plan, and the subscription is usage-based.
https://api.deepl.com/v1/: Is meant for CAT tools and is usable with a per-user subscription.

此前 Weblate 被 DeepL 分類為計算機輔助翻譯工具，因此應該使用 v1 API，但現在應該使用 v2 API。這樣預設為 v2，在您有現有的計算機輔助翻譯工具訂閱，並想要 Weblate 使用它的情況下，可以將其更改為 v1。

The easiest way to find out which one to use is to open an URL like the following in your browser:

https://api.deepl.com/v2/translate?text=Hello&target_lang=FR&auth_key=XXX

Replace the XXX with your auth_key. If you receive a JSON object which contains 「Bonjour」, you have the correct URL; if not, try the other three.

Weblate supports DeepL formality, it will choose matching one based on the language (for example, there is de@formal and de@informal).

也參考

DeepL website, DeepL pricing, DeepL API documentation

Glosbe#

服務編號:: glosbe
配置:: This service has no configuration.

幾乎每一種活語言的免費字典與翻譯服務。

The API is gratis to use, but usage of the translations is subject to the license of the used data source. There is a limit of calls that may be done from one IP in a set period of time, to prevent abuse.

也參考

Glosbe website

Google翻譯#

服務編號:

google-translate

配置:

key

API 金鑰

Google 提供的機器翻譯服務。

這項服務使用了 Google Translation API，您需要得到 API 密鑰，並在 Google API 控制台打開記費。

也參考

Google translate documentation

Google Translate API v3#

服務編號:

google-translate-api-v3

配置:

`credentials`	Google 翻譯服務帳號資訊
`project`	Google 翻譯專案
`location`	Google Translate 位置

Google 雲服務提供的機器翻譯服務。

也參考

Google 翻譯文件, 雲端服務驗證使用用戶端套件, 建立 Google 翻譯專案, Google 雲端 App Engine 位置

LibreTranslate#

在 4.7.1 版本新加入.

服務編號:

libretranslate

配置:

`url`	API URL
`key`	API 金鑰

LibreTranslate is a free and open-source service for machine translations. The public instance requires an API key, but LibreTranslate can be self-hosted and there are several mirrors available to use the API for free.

https://libretranslate.com/ (官方公開服務): Requires an API key to use outside of the website.

也參考

LibreTranslate website, LibreTranslate repository, LibreTranslate mirrors

Microsoft Terminology#

服務編號:: microsoft-terminology
配置:: This service has no configuration.

Microsoft Terminology Service API 允許您通過 Web 服務，可編程地訪問 Langurage Portal 上可用的術語、定義和使用者界面（ UI ）字串。

也參考

微軟術語服務 API

微軟的 Translator#

服務編號:

microsoft-translator

配置:

`key`	API 金鑰
`base_url`	應用程式基礎 URL	Available choices: `api.cognitive.microsofttranslator.com` – Global (non-regional) `api-apc.cognitive.microsofttranslator.com` – Asia Pacific `api-eur.cognitive.microsofttranslator.com` – Europe `api-nam.cognitive.microsofttranslator.com` – North America `api.translator.azure.cn` – 中國 `api.cognitive.microsofttranslator.us` – Azure US Government cloud
`endpoint_url`	身份核對服務 URL	可以使用下方的區域欄位指定區域性或多服務。 Available choices: `api.cognitive.microsoft.com` – Global `api.cognitive.azure.cn` – China `api.cognitive.microsoft.us` – Azure US Government cloud
`region`	身份核對服務區域

由 Microsoft 在 Azure 門戶提供的機器翻譯服務，作為 Cognitive Services 的一種。

Weblate 實施了 Translator API V3.

Translator Text API 第二版#

您用於Translator API V2 的密鑰可以用於 API 3。

Translator Text API 第三版#

You need to register at Azure portal and use the key you obtain there. With new Azure keys, you also need to set region to locale of your service.

提示

對於 Azure 中國，請使用您的 Azure Portal 的端點。

也參考

Cognitive Services - Text Translation API, Microsoft Azure Portal, Base URLs, 「Authenticating with a Multi-service resource」「Authenticating with an access token」 section

ModernMT#

在 4.2 版本新加入.

服務編號:

modernmt

配置:

`url`	API URL
`key`	API 金鑰

也參考

ModernMT API,

MyMemory#

服務編號:

mymemory

配置:

`email`	聯絡信箱
`username`	使用者名稱
`key`	API 金鑰

使用機器翻譯的巨量翻譯記憶庫。

Free, anonymous usage is currently limited to 100 requests/day, or to 1000 requests/day when you provide a contact e-mail address in email. You can also ask them for more.

也參考

MyMemory 網站

Netease Sight#

在 3.3 版本新加入.

服務編號:

netease-sight

配置:

`key`	使用者端 ID
`secret`	使用者端秘密金鑰 (secret)

Machine translation service provided by NetEase.

這項服務使用 API，兵器額您需要從網易得到密鑰和密碼。

也參考

NetEase Sight Translation Platform

SAP Translation Hub#

服務編號:

sap-translation-hub

配置:

`url`	API URL
`key`	API 金鑰
`username`	SAP 使用者名稱
`password`	SAP 密碼
`enable_mt`	啟用機器翻譯
`domain`	翻譯領域	翻譯領域的 ID，例如 BC。若不指定領域，這個方法會搜尋所有可用領域中的翻譯。

SAP 提供的機器翻一下服務。

You need to have a SAP account (and the SAP Translation Hub enabled in the SAP Cloud Platform) to use this service.

You can also configure whether to also use machine translation services, in addition to the term database.

備註

To access the Sandbox API, you need to set url and key.

為了存取正式環境的 API，您需要設定 url, username 與 password。

也參考

SAP Translation Hub API, Building the Base URL of SAP Translation Hub

tmserver#

服務編號:

tmserver

配置:

url

API URL

您可以通過使用 Translate-toolkit綁定的一個服務器並與之對話，來運行您自己的翻譯服務器。您還可以將它與 amaGama 服務器一起使用，它是 tmserver 的增強版本。

首先您會想要將一些數據導入翻譯記憶庫：

build_tmdb -d /var/lib/tm/db -s en -t cs locale/cs/LC_MESSAGES/django.po
build_tmdb -d /var/lib/tm/db -s en -t de locale/de/LC_MESSAGES/django.po
build_tmdb -d /var/lib/tm/db -s en -t fr locale/fr/LC_MESSAGES/django.po

啟動 tmserver 來收聽您的請求：

tmserver -d /var/lib/tm/db

設定 Weblate 與它建立連線，預設的 URL 為 http://localhost:8888/tmserver/。

也參考

tmserver Installing amaGama, Amagama, Amagama Translation Memory

IBM Watson Language Translator#

服務編號:

ibm

配置:

`url`	API URL
`key`	API 金鑰

IBM Watson Language Translator translates text from one language to another. The service offers multiple domain-specific models.

也參考

Watson Language Translator, IBM Cloud API Docs

Weblate#

服務編號:: weblate
配置:: This service has no configuration.

Weblate machine translation service can provide translations for strings that are already translated inside Weblate. It looks for exact matches in the existing strings.

Weblate 翻譯記憶#

服務編號:: weblate-translation-memory
配置:: This service has no configuration.

Use 翻譯記憶 as a machine translation service. Any string that has been translated in past (or uploaded to the translation memory) can be translated in this way.

Yandex#

服務編號:

yandex

配置:

key

API 金鑰

Yandex 提供的機器翻譯服務。

這項服務使用翻譯 API，您需要從 Yandex 得到 API 密鑰。

也參考

Yandex Translate API, Powered by Yandex.Translate

Youdao Zhiyun#

在 3.2 版本新加入.

服務編號:

youdao-zhiyun

配置:

`key`	使用者端 ID
`secret`	使用者端秘密金鑰 (secret)

有道提供的機器翻譯服務。

這項服務使用 API，您需要從有道獲得 ID 和 API 密鑰。

也參考

Youdao Zhiyun Natural Language Translation Service

Custom machine translation#

您還可以通過使用一些 Python 代碼來實施您自己的機器翻譯服務。這個例子使用 dictionary Python 模塊來實施一組固定語言的機器翻譯：

# Copyright © Michal Čihař <michal@weblate.org>
#
# SPDX-License-Identifier: GPL-3.0-or-later

"""Machine translation example."""

import dictionary

from weblate.machinery.base import MachineTranslation


class SampleTranslation(MachineTranslation):
    """Sample machine translation interface."""

    name = "Sample"

    def download_languages(self):
        """Return list of languages your machine translation supports."""
        return {"cs"}

    def download_translations(
        self,
        source,
        language,
        text: str,
        unit,
        user,
        search: bool,
        threshold: int = 75,
    ):
        """Return tuple with translations."""
        for t in dictionary.translate(text):
            yield {"text": t, "quality": 100, "service": self.name, "source": text}

You can list your own class in WEBLATE_MACHINERY and Weblate will start using that.

附加元件#

附加元件提供了自定義和自動化翻譯工作流程的方法。管理員可以從每個相應翻譯組件的 Manage ↓ :guilabel:`Addons`菜單添加和管理附加組件。

提示

您也可以透過以下來設定附加元件 API、 default_addons 或 install_addon。

內建附加元件#

自動翻譯#

在 3.9 版本新加入.

Add-on ID:

weblate.autotranslate.autotranslate

配置:

`mode`	自動翻譯模式	Available choices: `suggest` – Add as suggestion `translate` – Add as translation `fuzzy` – Add as 「Needing edit」
`filter_type`	搜尋篩選	請注意：翻譯所有字串會捨棄所有現有翻譯。 Available choices: `all` – All strings `nottranslated` – Untranslated strings `todo` – Unfinished strings `fuzzy` – Strings marked for edit `check:inconsistent` – 錯誤檢查：不一致
`auto_source`	自動翻譯的來源	Available choices: `others` – Other translation components `mt` – Machine translation
`component`	組件	輸入要用作來源的組件 slug。留空則使用本專案的所有組件。
`engines`	機器翻譯引擎
`threshold`	分數閾值

觸發:

更新組件（每日）

使用機器翻譯或其他組件自動翻譯字串。

已觸發的：

當新字串出現在組件中。
每個組件的一個月內，可以使用以下配置：設置：background_tasks。

也參考

自動翻譯, 跨組件保持翻譯一致

JavaScript 在地化 CDN#

在 4.2 版本新加入.

Add-on ID:

weblate.cdn.cdnjs

配置:

`threshold`	最低翻譯數	翻譯收錄的最低門檻。
`css_selector`	CSS 選擇器	用來偵測可在地化元素的 CSS 選擇器。
`cookie_name`	語言 Cookie 名稱	儲存語言偏好設定的 Cookie 名稱。
`files`	從 HTML 檔案擷取字串	在目前倉儲或遠端 URL 中，要解析其可翻譯字串的檔案名稱清單。

觸發:

每日，倉儲提交後、倉儲更新後

將翻譯發佈給內容遞交網路，供 JavaScript 或 HTML 在地化處理使用。

可以用於本地化靜態 HTML 網頁，或者在 JavaScript 代碼中加載本地化文件。

為您的組件生成一個唯一的 URL，您可以將其包含在 HTML 頁面中以本地化它們。詳情見使用 Weblate CDN 翻譯 HTML 和 JavaScript。

也參考

Configuring Weblate CDN add-on, 使用 Weblate CDN 翻譯 HTML 和 JavaScript, String extraction for Weblate CDN, HTML localization using Weblate CDN

移除空白字串#

在 4.4 版本新加入.

Add-on ID:: weblate.cleanup.blank
配置:: This add-on has no configuration.
觸發:: 倉儲提交後、倉儲更新後

從翻譯檔中移除沒有譯文的字串。

使用此方法可以使翻譯文件中不存在任何空字串(例如，如果您的本地化庫將它們顯示為缺失，而不是退回到來源字串)。

也參考

Weblate 除了更新翻譯，還更新翻譯文件嗎？

清理翻譯檔#

Add-on ID:: weblate.cleanup.generic
配置:: This add-on has no configuration.
觸發:: 倉儲提交前、倉儲更新前

更新所有翻譯檔以符合單語言基礎檔。對大多數檔案格式而言，這代表會移除基礎檔中不再存在的失時效翻譯金鑰。

也參考

Weblate 除了更新翻譯，還更新翻譯文件嗎？

加入遺漏語言#

Add-on ID:: weblate.consistency.languages
配置:: This add-on has no configuration.
觸發:: 每日，倉儲新增後

確保對一個項目內所有組件使用一致的一組語言。

每隔24小時，和在 Weblate 中加入新語言時，會檢查一次缺失的語言。

不像其他多數附加組件，這個附加組件影響整個項目。

提示

用自動翻譯自動翻譯新添加的字串。

組件探索#

Add-on ID:

weblate.discovery.discovery

配置:

`match`	用來比對出翻譯檔的正則表達式
`file_format`	檔案格式
`name_template`	自訂組件名稱
`base_file_template`	定義單語的基礎檔名	保留雙語翻譯檔空白。
`new_base_template`	定義新翻譯的基礎檔	用來建立新翻譯的檔案名稱。例如 gettext，請選擇 .pot 檔。
`intermediate_template`	中間語言檔案	中間翻譯檔的檔名。大部分情況下，這即是開發者提供的翻譯檔，會在建立實際來源字串時使用。
`language_regex`	語言篩選	掃描檔案遮罩時用以篩選過濾翻譯檔的正則表達式。
`copy_addons`	從主組件複製附加元件至新建立的組件
`remove`	移除檔案不存在的組件
`confirm`	我能確認上述符合項目看起來正確

觸發:

倉儲更新後

根據版本控制系統中的檔案更動自動加入或移除組件專案。

每次更新 VCS 時觸發，在其他方麵類似 :djadmin:`import_project`管理命令。通過這種方式，您可以在一個 VCS 中跟踪多個翻譯組件。

該匹配是使用允許複雜配置的正則表達式完成的，但這樣做需要一些知識。一些常見用例的例子可以在附加組件幫助部分找到。

一旦點擊了 Save，將顯示匹配組件的預覽，可以檢查配置是否匹配於自己的需要：

提示

組件發現附加用途:ref:“內部URL”。它是在多個組件之間共享VCS設置的便捷方式。鏈接組件使用通過填寫``webbleate:// project / main-component``中設置的主要組件的本地存儲庫:ref:`component-repo`字段（:guilabel:`管理`↓:guilabel:“設置”➤“：締約方標籤：每個相應組件的”版本控制系統“）。這也可以節省時間和系統資源。

也參考

模板標記

大量編輯#

在 3.11 版本新加入.

Add-on ID:

weblate.flags.bulk

配置:

`q`	查詢
`state`	要設定的狀態	Available choices: `-1` – Do not change `10` – Needs editing `20` – Translated `30` – Approved
`add_flags`	要加入的翻譯旗標
`remove_flags`	要移除的翻譯標籤
`add_labels`	要加入的標籤
`remove_labels`	要移除的標籤

觸發:

component update

大量編輯字串的旗標、標籤或狀態。

要自動化標籤操作，從搜索字串 ``NOT has:label``入手，並添加標籤直到所有字串都有所需的標籤為止。也可以完成 Weblate 元數據的其他自動化操作。

範例：

自動標籤於新字串#
Search query	`NOT has:label`
要加入的標籤	recent

Marking all App store 中介資料檔 changelog strings read-only#
Search query	`language:en AND key:changelogs/`
要加入的翻譯旗標	`read-only`

也參考

大量編輯, 使用標誌自定義行為, 字串標籤

將未變動的翻譯標記為「需要編輯」#

在 3.1 版本新加入.

Add-on ID:: weblate.flags.same_edit
配置:: This add-on has no configuration.
觸發:: 元件建立前

每當新的可翻譯字串從 VCS 匯入且符合來源字串時，會在 Weblate 中標記為需要編輯。這對於未翻譯字串有來源字串的檔案格式來說特別有用。

提示

您或許也想要加強未更動的翻譯的檢查透過加入 strict-same 標記到翻譯旗標中。

也參考

翻譯狀態

標記新來源字串為「需要編輯」#

Add-on ID:: weblate.flags.source_edit
配置:: This add-on has no configuration.
觸發:: 元件建立前

每當新來源字串由 VCS 匯入時，會在 Weblate 中標記為需要編輯。這樣您可以輕鬆過濾並編輯開發者寫的來源字串。

也參考

翻譯狀態

將新翻譯標記為「需要編輯」#

Add-on ID:: weblate.flags.target_edit
配置:: This add-on has no configuration.
觸發:: 元件建立前

每當新的可翻譯字串從 VCS 匯入時，會在 Weblate 中標記為需要編輯。這樣您可以輕鬆過濾並編輯開發者建立的翻譯。

也參考

翻譯狀態

統計數據生成器#

Add-on ID:

weblate.generate.generate

配置:

`filename`	生成的檔案名稱
`template`	生成的檔案內容

觸發:

repository pre-commit

生成內含翻譯狀態詳細資訊的檔案。

您可以使用 Django 範本在檔名或內容中，參閱：模板標記取得更多標記描述細節。

例如為每一個翻譯產生簡介檔案：

生成的檔案名稱

locale/{{ language_code }}.json

內容

{
   "language": "{{ language_code }}",
   "strings": "{{ stats.all }}",
   "translated": "{{ stats.translated }}",
   "last_changed": "{{ stats.last_changed }}",
   "last_author": "{{ stats.last_author }}",
}

也參考

模板標記

將原文預先填充進翻譯#

在 4.11 版本新加入.

Add-on ID:: weblate.generate.prefill
配置:: This add-on has no configuration.
觸發:: 更新組件（每日）

用來源字串填充翻譯字串。

所有在此組件中未翻譯的字串將會使用來源字串取代，並標記為需要編輯。請使用此功能當您不允許有空字串於翻譯檔案。

偽語系產生#

在 4.5 版本新加入.

Add-on ID:

weblate.generate.pseudolocale

配置:

`source`	來源字串
`target`	目標翻譯	本翻譯中的所有字串都將被覆寫
`prefix`	固定字串前綴
`var_prefix`	可變字串前綴
`suffix`	固定字串後綴
`var_suffix`	可變字串後綴
`var_multiplier`	可變部分乘數	重複可變部分的次數多寡，取決於來源字串的長度。
`include_readonly`	納入唯讀字串

觸發:

更新組件（每日）

藉由在來源字串加前綴與後綴，來自動生成偽語系翻譯。

偽 locale 對於查找未準備好進行本地化的字串很有用。這是通過修改所有可翻譯的來源字串來實現的，使得在用偽 locale 語言運行應用程序時很容易發現未修改的字串。

發現本地化對應物可能不適合佈局的字串也是可能的。

使用變數部分可以查找在本地化之後可能無法適合使用者界面的字串 - 它基於來源字串長度來擴充。變數部分可以藉由重複字數來表達。例如：使用 _ 當作 您好 的後綴字及其數量代表長度可為 您好___________ - 這裡的 _ 重複幾次代表相對於來源字串多少字。

字串將以下述模式產生：

Fixed string prefix Variable string prefix Source string Variable string suffix Fixed string suffix

提示

可以使用真正的語言進行檢測，但在 Weblate 中有專用的假語言環境——en_XA 和 ar_XB。

提示

您可以使用這個擴充套件來開始翻譯現有或相似的語言。一旦您加入翻譯到這組件，也將會套用擴充套件。例如：您有 fr 且想加入 fr_CA 翻譯，只需要將 fr 設定來源語言，fr_CA 為目標翻譯，並將前後綴留空。

在填滿新翻譯後卸載擴充套件以防止 Weblate 更改複製後的翻譯。

評註中的貢獻者紀錄#

Add-on ID:: weblate.gettext.authors
配置:: This add-on has no configuration.
觸發:: repository pre-commit

更新 PO 檔標頭中的評註部分以納入貢獻者姓名及貢獻年份。

PO 文件頭看上去是這樣的：

# Michal Čihař <michal@weblate.org>, 2012, 2018, 2019, 2020.
# Pavel Borecki <pavel@example.com>, 2018, 2019.
# Filip Hron <filip@example.com>, 2018, 2019.
# anonymous <noreply@weblate.org>, 2019.

更新「configure」檔案中的 ALL_LINGUAS 變數#

Add-on ID:: weblate.gettext.configure
配置:: This add-on has no configuration.
觸發:: repository post-add, daily

當新的翻譯添加時，更新 configure 、 configure.in 或任何 configure.ac 文件中的 ALL_LINGUAS 變量。

自訂 gettext 輸出#

Add-on ID:

weblate.gettext.customize

配置:

width

長列換列

預設情況下，gettext 會在第 77 個字元和新列字元處換列；加上 –no-wrap 參數後，則僅在新列字元處換列。

Available choices:

77 – Wrap lines at 77 characters and at newlines (xgettext default)

65535 – Only wrap lines at newlines (like 『xgettext –no-wrap』)

-1 – No line wrapping

觸發:

儲存後載入

允許自訂 gettext 輸出行為，例如換列。

提供了後面的選項：

於第 77 個字元處與新列處換列
僅在新列處換列
不要換列

備註

By default gettext wraps lines at 77 characters and at newlines. With the --no-wrap parameter, wrapping is only done at newlines.

更新 LINGUAS 檔案#

Add-on ID:: weblate.gettext.linguas
配置:: This add-on has no configuration.
觸發:: repository post-add, daily

當新增翻譯時更新 LINGUAS 檔。

生成 MO 檔#

Add-on ID:

weblate.gettext.mo

配置:

path

生成的 MO 檔路徑

如果未指定，將使用 PO 檔的位置。

觸發:

repository pre-commit

每次 PO 檔有變動時便自動生成 MO 檔。

生成的 MO 文件的位置可以定制化，並且其字段使用模板標記。

備註

If a translation is removed, its PO file will be deleted from the repository, but the MO file generated by this add-on will not. The MO file must be removed from the upstream manually.

更新 PO 檔以符合 POT (msgmerge)#

Add-on ID:

weblate.gettext.msgmerge

配置:

`previous`	保留翻譯字串上次的 msgid
`no_location`	移除翻譯字串的位置
`fuzzy`	使用模糊比對

觸發:

倉儲更新後

Updates all PO files (as configured by 文件掩碼) to match the POT file (as configured by 新翻譯的模板) using msgmerge.

Triggered whenever new changes are pulled from the upstream repository. Most msgmerge command-line options can be set up through the add-on configuration.

也參考

Weblate 除了更新翻譯，還更新翻譯文件嗎？

匯併 Git 提交#

Add-on ID:

weblate.git.squash

配置:

squash

提交匯併

Available choices:

all – All commits into one

language – Per language

file – 每一檔案

author – 每一作者

append_trailers

將額外資訊加入至壓縮提交的訊息

額外資訊的列看起來類似於 RFC 822 電子信箱標頭，位於提交訊息的其他自由格式部分的末尾，例如「Co-authored-by: …」。

commit_message

提交訊息

此提交訊息將用來取代從壓縮提交組合而成的提交訊息。

觸發:

repository post-commit

推送更動前先匯併 Git 提交。

以下模式之一中，Git提交可以在推送更改之前被壓縮：

所有提交匯併為一
每個語言
每個檔案
每位作者

Original commit messages are kept, but authorship is lost unless Per author is selected, or the commit message is customized to include it.

The original commit messages can optionally be overridden with a custom commit message.

預告（提交行像 Co-authored-by: … ）可選地從原始提交信息中去掉，並且添加在去掉的提交信息後面。這還可以為每一位翻譯者產生適當的 Co-authored-by: 信譽。

自訂 JSON 輸出#

Add-on ID:

weblate.json.customize

配置:

sort_keys

短 JSON 金鑰

indent

JSON 縮排

style

JSON 縮排類型

Available choices:

spaces – 空格

tabs – Tabs

觸發:

儲存後載入

允許調整 JSON 輸出行為，例如縮排或排序。

格式化 Java properties 檔案#

Add-on ID:: weblate.properties.sort
配置:: This add-on has no configuration.
觸發:: repository pre-commit

格式化並排序 Java properties 檔案。

將新行合併為 Unix ones。
Unicode 跳脫符號的大寫格式（如果有的話）。
替除空白行與評註。
依鍵值排序字串。
移除重複字串。

陳舊評註移除#

在 3.7 版本新加入.

Add-on ID:

weblate.removal.comments

配置:

age

保留的天數

觸發:

每日

設定移除評註的時間間隔。

這可以用於刪除可能變得過時的陳舊註釋。小心使用，因為陳舊的註釋不意味著失去了重要性。

陳舊建議移除#

在 3.7 版本新加入.

Add-on ID:

weblate.removal.suggestions

配置:

`age`	保留的天數
`votes`	最低投票數	移除之最低票數。當停用投票時，這個欄位不會有效果。

觸發:

每日

設定移除建議的時間間隔。

此附加組件在與建議投票一道用來刪除在給定的時間內沒有得到足夠的正面投票的建議方面非常有用。

更新 RESX 檔案#

在 3.9 版本新加入.

Add-on ID:: weblate.resx.update
配置:: This add-on has no configuration.
觸發:: 倉儲更新後

更新所有翻譯檔以符合單語言上游基底檔。未使用的字串將移除，新增加的字串將根據來源字串複製加入。

提示

如果只想刪除陳舊的翻譯鍵，那麼使用清理翻譯檔。

也參考

Weblate 除了更新翻譯，還更新翻譯文件嗎？

自訂 XML 輸出#

在 4.15 版本新加入.

Add-on ID:

weblate.xml.customize

配置:

closing_tags

包含空白的 XML 標籤的結束標籤

觸發:

儲存後載入

允許調整 XML 輸出行為，例如對於空標籤使用結束標籤而不是使用自閉合標籤。

自訂 YAML 輸出#

在 3.10.2 版本新加入.

Add-on ID:

weblate.yaml.customize

配置:

indent

YAML 縮排

width

長列換列

Available choices:

80 – 於第 80 個字元處折行

100 – 於第 100 個字元處折行

120 – 於第 120 個字元處折行

180 – 於第 180 個字元處折行

65535 – 不要換列

line_break

換行符號

Available choices:

dos – DOS (\r\n)

unix – UNIX (\n)

mac – MAC (\r)

觸發:

儲存後載入

允許調整 YAML 輸出行為，例如列長或換列。

自訂附加元件列表#

附加元件列表由 WEBLATE_ADDONS 配置。要新增其他附加元件，只需在這個設置中包含絕對類別名稱即可。

Writing add-on#

您也可以編寫自己的附加元件，創建子類別 :class:`weblate.addons.base.BaseAddon`來定義附加元件元數據，接著實施 callback 來進行處理。

也參考

開發附加元件

Executing scripts from add-on#

附加元件還可以用於執行外部腳本。這曾經集成在 Weblate 中，但現在必須寫一些代碼，將腳本包裹在附加元件中。

# Copyright © Michal Čihař <michal@weblate.org>
#
# SPDX-License-Identifier: GPL-3.0-or-later

"""Example pre commit script."""


from django.utils.translation import gettext_lazy as _

from weblate.addons.events import EVENT_PRE_COMMIT
from weblate.addons.scripts import BaseScriptAddon


class ExamplePreAddon(BaseScriptAddon):
    # Event used to trigger the script
    events = (EVENT_PRE_COMMIT,)
    # Name of the addon, has to be unique
    name = "weblate.example.pre"
    # Verbose name and long description
    verbose = _("Execute script before commit")
    description = _("This add-on executes a script.")

    # Script to execute
    script = "/bin/true"
    # File to add in commit (for pre commit event)
    # does not have to be set
    add_file = "po/{{ language_code }}.po"

安裝方法請參見自訂的質量檢查、附加元件和自動修復。

對於任何給定的組件，當前路徑設置為版本控制系統（ VCS ）倉儲的根目錄時，執行腳本。

此外，可以訪問後面的環境參數：

WL_VCS#: 使用的版本控制系統。

WL_REPO#: 上游倉儲的 URL。

WL_PATH#: 版本控制系統（ VCS ）倉儲的絕對路徑。

WL_BRANCH#: 當前組件配置的倉儲分支。

WL_FILEMASK#: 當前組件的File mask。

WL_TEMPLATE#: 單語言翻譯模板的文件名（可以為空）。

WL_NEW_BASE#: 建立新的翻譯所使用文件的文件名（可以為空）。

WL_FILE_FORMAT#: 在目前專案中使用的檔案格式。

WL_LANGUAGE#: 當前處理的翻譯的語言（對於組件級別的鉤子不可用）。

WL_PREVIOUS_HEAD#: 更新後的上個 HEAD (僅在運行更新後鉤子後可用)。

WL_COMPONENT_SLUG#: 在 3.9 版本新加入.

組件標識串用於構建 URL。

WL_PROJECT_SLUG#: 在 3.9 版本新加入.

項目標識串用於構建 URL。

WL_COMPONENT_NAME#: 在 3.9 版本新加入.

組件名稱。

WL_PROJECT_NAME#: 在 3.9 版本新加入.

專案名稱。

WL_COMPONENT_URL#: 在 3.9 版本新加入.

組件 URL。

WL_ENGAGE_URL#: 在 3.9 版本新加入.

專案參與 URL。

也參考

組件配置

Post-update repository processing#

當 VCS 的上游源發生變化時，可用於更新翻譯文件。為了實現這個功能，請記住 Weblate 只看到提交給版本控制系統（ VCS ）的文件，所以需要同意更改作為腳本的一部分。

例如 Gulp，可以使用後面的代碼來執行：

#! /bin/sh
gulp --gulpfile gulp-i18n-extract.js
git commit -m 'Update source strings' src/languages/en.lang.json

Pre-commit 翻譯處理#

在將翻譯提交到存儲庫之前，使用 commit 腳本自動更改翻譯。

它作為組成當前翻譯文件名的單一參數而通過。

翻譯記憶#

Weblate 帶有內建的翻譯記憶庫，包括下面的：

手動導入翻譯記憶庫（請參見使用者界面）。
自動存儲 Weblate 中進行的翻譯（依賴於 Translation memory scopes）。
自動導入以前的翻譯。

翻譯記憶庫中的內容可以以兩種方式之一來應用：

手動，自動建議當翻譯時查看。
Automatically, by translating strings using 自動翻譯, or 自動翻譯 add-on.

For installation tips, see Weblate 翻譯記憶, which is turned on by default.

Translation memory scopes#

在 3.2 版本新加入: 在較早的版本中，翻譯記憶庫只能從相應於當前導入的翻譯記憶庫範圍的文件中加載。

翻譯記憶庫的範圍這樣允許私有或翻譯者共享，來適應所需要的行為。

Imported translation memory#

使用 import_memory 命令導入任意翻譯記憶庫數據，使記憶的內容可用於所有的使用者和項目。

每名使用者的翻譯記憶庫#

在每個單獨使用者的個人翻譯記憶庫中自動存儲使用者的翻譯。

每個項目的翻譯記憶庫#

項目內的所有翻譯都自動存儲在項目翻譯記憶庫中，這個翻譯記憶庫只在項目內可用。

共享的翻譯記憶#

翻譯記憶庫分享打開的項目的所有翻譯，都存儲在分享的翻譯記憶庫中，可用於所有項目。

對於分享的 Weblate 安裝，請仔細考慮是否打開這個特性，因為可能導致嚴重的影響：

翻譯可以被任何人使用。
這會導致洩露秘密信息。

Managing translation memory#

使用者界面#

在 3.2 版本新加入.

在基本上使用者界面上，可以管理每名使用者每個項目的項目翻譯記憶庫。它可以用於下載、消除或導入翻譯記憶庫。

提示

JSON的翻譯記憶庫可以導入 Weblate，提供了 TMX 與其他工具進行互操作。

也參考

Weblate Translation Memory Schema

管理介面#

有幾個管理命令來操作翻譯記憶庫的內容。它們整體操作翻譯記憶庫，不會被範圍來篩選（除非被參數請求）：

dump_memory: 將記憶庫導入 JSON
import_memory: 將 TMX 或 JSON 文件導入翻譯記憶庫

配置#

所有的設置存儲在 settings.py 中，（如 Django 通常那樣）。

備註

在更改這些設置的任何一部分後，需要重新啟動 Weblate —— WSGI 和 Celery 兩個過程。

在它作為 mod_wsgi 運行的情況下，需要重新啟動 Apache，來重新加載配置。

也參考

還要請查看 Django’s documentation 中關於配置 Django 自身的參數。

AKISMET_API_KEY#

Weblate 可以使用 Akismet 檢查到來的對垃圾郵件的匿名建議。請訪問 akismet.com 來購買 API 密鑰，並將它與網站關聯。

ANONYMOUS_USER_NAME#

未登錄使用者的使用者名。

也參考

存取控制

AUDITLOG_EXPIRY#

在 3.6 版本新加入.

Weblate 應該將審計日誌保存多少天，審計日誌包括了賬戶活動的信息。

預設為 180 天。

AUTH_LOCK_ATTEMPTS#

在rate限制應用前，授權嘗試失敗的最多次數。

當前，這應用在後面的位置：

Sign in. Deletes the account password, preventing the user from signing in without requesting a new password.
Password reset. Prevents new e-mails from being sent, avoiding spamming users with too many password reset attempts.

預設到 10。

也參考

頻次限制

AUTO_UPDATE#

在 3.2 版本新加入.

在 3.11 版本變更: 更改原來的開關選項，來區別接受哪個字串。

以每天的頻率更新所有倉儲。

提示

在不使用通知掛勾來自動更新 Weblate 倉儲的情況下有用。

備註

除了字串選項還存在開關選項，用於向後兼容。

選項有：

"none": 無每日更新。
"remote" also False: 只更新遠端儲存庫。
"full" 也為 True: 更新遠程，並合併工作副本。

備註

這需要使用 Celery 的後台任務工作，並在重啟後生效。

AVATAR_URL_PREFIX#

構成頭像 URL 的前綴為： ${AVATAR_URL_PREFIX}/avatar/${MAIL_HASH}?${PARAMS}。已知後面的服務工作：

Gravatar （預設），根據 https://gravatar.com/: AVATAR_URL_PREFIX = 'https://www.gravatar.com/'
Libravatar，如 https://www.libravatar.org/: AVATAR_URL_PREFIX = 'https://www.libravatar.org/'

也參考

個人頭像快取， ENABLE_AVATARS ，頭像

AUTH_TOKEN_VALID#

身份驗證令牌和密碼重置電子郵件中臨時密碼的有效時間。以秒為單位，預設為 172800（ 2 天）。

AUTH_PASSWORD_DAYS#

How many days will Weblate reject reusing previously used password for an user.

The checking is based on the audit log, AUDITLOG_EXPIRY needs to be at least same as this.

備註

自動修復很強大，但可能導致損壞；寫腳本的時候要小心。

預設為 180 天。

AUTOFIX_LIST#

當存儲字串時應用自動修復列表。

備註

為應用自動修復見面的 Python 類提供完全合規的路徑。

可用的修復：

weblate.trans.autofixes.whitespace.SameBookendingWhitespace: 將字串開始與結尾的空白字符與元字串匹配。
weblate.trans.autofixes.chars.ReplaceTrailingDotsWithEllipsis: 替換連續的點 (…)，如果來源字串有一個對應的省略號 (…)。
weblate.trans.autofixes.chars.RemoveZeroSpace: 去掉零寬度字符，如果源字串不包含的話。
weblate.trans.autofixes.chars.RemoveControlChars: 去掉控製字符，如果源字串不包含的話。
weblate.trans.autofixes.chars.DevanagariDanda: Replaces sentence full stop in Bangla by Devanagari danda.
weblate.trans.autofixes.html.BleachHTML: 從標記為 safe-html 的字串中去掉不安全的 HTML 標記（請參見不安全的 HTML ）。

可以選擇使用哪一個：

AUTOFIX_LIST = (
    "weblate.trans.autofixes.whitespace.SameBookendingWhitespace",
    "weblate.trans.autofixes.chars.ReplaceTrailingDotsWithEllipsis",
)

也參考

自動修正, 自訂自動修正

BACKGROUND_TASKS#

在 4.5.2 版本新加入.

定義應為組件觸發冗長的維護任務的頻率。

此刻的控制項：

自動翻譯 add-on
檢查和修復重新計算

可能的選項：

``每月``（這是預設值）
weekly
daily
never

備註

當WebLate包含數千個組件時，不建議不要增加頻率。

BASIC_LANGUAGES#

在 4.4 版本新加入.

提供給使用者開始新的翻譯的語言列表。當未指定時，使用內建列表，其中包括所有常用的語言，但沒有特定國家/地區的變體。

這只是限制了非特權使用者將不想要的語言添加進來。項目管理員仍然被給出 Weblate 中定義的所有語言選擇。

備註

這對 Weblate 並不定義新的語言，它只在資料庫中篩選了現有的那些。

示例：

BASIC_LANGUAGES = {"cs", "it", "ja", "en"}

也參考

語言定義

BORG_EXTRA_ARGS#

在 4.9 版本新加入.

您可以帶入額外的參數在 :command:`borg create`中使用，當觸發內建的備份機制時。

示例：

BORG_EXTRA_ARGS = ["--exclude", "vcs/"]

也參考

borg list ， borg extract

CACHE_DIR#

在 4.16 版本新加入.

Directory where Weblate stores cache files. Defaults to cache subfolder in DATA_DIR.

Change this to local or temporary filesystem if DATA_DIR is on a network filesystem.

Docker 容器為這個使用了一個單獨的捲，請參閱 Docker 容器 volumes。

csp_script_src，csp_img_src，csp_connect_src，csp_style_src，csp_font_src#

為 Weblate 定制 Content-Security-Policy 標頭。根據允許集成的第三方服務（ Matomo 、 Google Analytics 、 Sentry ……）來自動生成標頭。

這些預設為空列表。

示例：

# Enable Cloudflare Javascript optimizations
CSP_SCRIPT_SRC = ["ajax.cloudflare.com"]

也參考

內容安全策略（CSP），`內容安全策略（csp）<https://developer.mozilla.org/en-us/docs/web/http/csp>`_

CHECK_LIST#

翻譯時執行的質量檢查列表。

備註

為實施檢查界面的 Python 類提供完全合規的路徑。

調整檢查列表，來包括與您相關的那些檢查。

所有內建的質量檢查預設都打開，可以從那裡更改設置。它們在配置的例子中被預設註釋掉，從而使用預設值。然後每個新的 Weblate 版本執行新的檢查。

可以關閉所有檢查：

CHECK_LIST = ()

可以只打開一部分檢查：

CHECK_LIST = (
    "weblate.checks.chars.BeginNewlineCheck",
    "weblate.checks.chars.EndNewlineCheck",
    "weblate.checks.chars.MaxLengthCheck",
)

備註

更改這些設置只影響新更改的翻譯，現存的檢查仍然存儲在資料庫中。為了將更改同樣應用到存儲的翻譯中，運行 updatechecks。

也參考

質量檢查, 使用標誌自定義行為

COMMENT_CLEANUP_DAYS#

在 3.6 版本新加入.

在一定天數後刪除註釋。預設為 None，意味著不刪除。

COMMIT_PENDING_HOURS#

通過後台任務方式提交待定的更改之間的小時數。

也參考

組件配置, 更動後提交的經過時間, 執行維護事項, commit_pending

CONTACT_FORM#

在 4.6 版本新加入.

配置如何發送來自聯繫人表單的電子郵件。選擇與郵件服務器配置匹配的配置。

"回覆到": 發件人用於：MailHeader：“回复”，這是預設行為。
"來自": 發件人為:mailheader:From, 您的電子郵箱服務器需要允許發送此類郵件。

DATA_DIR#

Weblate 文件夾將所有數據存儲其中。它包含到版本控制系統（VCS ）倉儲的鏈接，全文索引和外部工具的各種文件。

後面的子目錄通常存在：

home

Home 目錄用於調用腳本。

ssh

SSH 密鑰和配置。

static

靜態 Django 文件的預設位置，由 django:STATIC_ROOT`指定。見 :ref:`static-files。

Docker 容器為這個使用了一個單獨的捲，請參閱 Docker 容器 volumes。

media

Django 媒體文件的預設位置，由 django:MEDIA_ROOT`指定。包含已上傳的截屏，見 :ref:`screenshots。

vcs

翻譯版本控制儲存庫

backups

每日備份數據，細節請參考下載的數據用於備份。

fonts ：

使用者已上傳的字型，參閱：管理字型。

cache

Various caches, can be placed elsewhere using CACHE_DIR.

Docker 容器為這個使用了一個單獨的捲，請參閱 Docker 容器 volumes。

備註

這個目錄必須由 Weblate 寫入。運行作為 uWSGI 意味著 www-data 使用者應該對它具有寫入權限。

實現這個的最簡單方式是讓使用者作為目錄的所有者：

sudo chown www-data:www-data -R $DATA_DIR

預設為 /home/weblate/data，但預期需要被設定。

也參考

文件系統權限, 備份和移動 Weblate, CACHE_DIR

DATABASE_BACKUP#

在 3.1 版本新加入.

資料庫備份應該存儲為純文本，壓縮還是跳過。授權值為：

"plain"
"compressed"
"none"

也參考

備份和移動 Weblate

DEFAULT_ACCESS_CONTROL#

在 3.3 版本新加入.

新項目的預設訪問控制設置：

0: Public
1: Protected
100: Private
200: Custom

如果手動管理 ACL 則使用 Custom，這意味著不依賴於 Weblate 內部管理。

也參考

專案存取控制, 存取控制

DEFAULT_AUTO_WATCH#

在 4.5 版本新加入.

配置是否：Guilabel：“自動觀看貢獻的項目，應該打開新使用者。預設為``true``。

也參考

通知

DEFAULT_RESTRICTED_COMPONENT#

在 4.1 版本新加入.

組件限制的預設值。

也參考

受限制的訪問，團隊範圍

default_add_message，default_addon_message，default_commit_message，default_delete_message，default_merge_message#

不同操作的預設執行信息，細節請查閱組件配置。

也參考

模板標記，組件配置， Commit, add, delete, merge, add-on, and merge request messages

DEFAULT_ADDONS#

安裝在每個創建的組件上的預設附加元件。

備註

此設置只影響新創建的組件。

例：

DEFAULT_ADDONS = {
    # Add-on with no parameters
    "weblate.flags.target_edit": {},
    # Add-on with parameters
    "weblate.autotranslate.autotranslate": {
        "mode": "suggest",
        "filter_type": "todo",
        "auto_source": "mt",
        "component": "",
        "engines": ["weblate-translation-memory"],
        "threshold": "80",
    },
}

也參考

install_addon, 附加元件, WEBLATE_ADDONS

DEFAULT_COMMITER_EMAIL#

提交者電子郵件地址預設為 noreply@weblate.org。

也參考

DEFAULT_COMMITER_NAME

DEFAULT_COMMITER_NAME#

提交者姓名預設為 Weblate。

也參考

DEFAULT_COMMITER_EMAIL

DEFAULT_LANGUAGE#

在 4.3.2 版本新加入.

例如在 :ref:`component-source_language`中使用的預設源語言。

預設為 en。匹配的語言對象需要存在於資料庫中。

也參考

語言定義, 來源語言

DEFAULT_MERGE_STYLE#

在 3.4 版本新加入.

任何新組件的合併風格。

rebase - 預設
merge

也參考

組件配置, 合併類型

DEFAULT_SHARED_TM#

在 3.2 版本新加入.

配置預設值:ref:project-use_shared_tm`和:ref:`project-contribute_shared_tm。

DEFAULT_TRANSLATION_PROPAGATION#

翻譯傳播的預設設置，預設為 True。

也參考

組件配置, 允許翻譯再用

DEFAULT_PULL_MESSAGE#

為拉取請求設定預設的抬頭與訊息。

ENABLE_AVATARS#

是否為使用者打開基於 Gravatar 的頭像。預設打開。

頭像取出並緩存在從服務器中，降低了洩漏個人信息的風險，加速了使用者體驗。

也參考

個人頭像快取， AVATAR_URL_PREFIX ，頭像

ENABLE_HOOKS#

是否允許匿名遠程鉤子。

也參考

通知掛勾

ENABLE_HTTPS#

將鏈接作為 HTTPS 還是 HTTP 發送給 Weblate。這個設置影響發送電子郵件，並產生絕對 URL。

在預設配置中，這還用於與 HTTPS 相關的幾個 Django 設置 — 啟用安全cookie、切換 HSTS 或允許重定向到 HTTPS URL。

在一些情況下HTTPS 重定向會有問題，您可以在使用反向代理進行SSL 終端連接的情況下碰到無限重定向的問題，使用反向代理進行SSL 終端連接不能將協議標頭正確地傳遞給Django。請調整自己的反向代理配置，去掉 X-Forwarded-Proto 或 Forwarded 標頭，或者配置 SECURE_PROXY_SSL_HEADER，讓 Django 正確地檢測 SSL 狀態。

也參考

：設置：django：session_cookie_secure，：設置：django：csrf_cookie_secure，：設置：django：secure_sl_redirect

EXTRA_HTML_HEAD#

在 4.15 版本新加入.

新增額外的標記於 HTML header 部分。可用來驗證是否擁有該網站，例如：

EXTRA_HTML_HEAD = '<link href="https://fosstodon.org/@weblate" rel="me">'

警告

無執行字串標記過濾，直接呈現在 HTML header 中。

GET_HELP_URL#

在 4.5.2 版本新加入.

可以找到您的 Weblate 實例支持的 URL。

GITEA_CREDENTIALS#

在 4.12 版本新加入.

用於 Gitea 服務器的憑證列表。

GITEA_CREDENTIALS = {
    "try.gitea.io": {
        "username": "weblate",
        "token": "your-api-token",
    },
    "gitea.example.com": {
        "username": "weblate",
        "token": "another-api-token",
    },
}

也參考

Gitea pull requests, Creating a Gitea personal access token

GITLAB_CREDENTIALS#

在 4.3 版本新加入.

用於 GitLab 服務器的證明列表。

GITLAB_CREDENTIALS = {
    "gitlab.com": {
        "username": "weblate",
        "token": "your-api-token",
    },
    "gitlab.example.com": {
        "username": "weblate",
        "token": "another-api-token",
    },
}

也參考

GitLab 合併請求, GitLab: Personal access token

GITHUB_CREDENTIALS#

在 4.3 版本新加入.

用於 GitHub 服務器的證明列表。

GITHUB_CREDENTIALS = {
    "api.github.com": {
        "username": "weblate",
        "token": "your-api-token",
    },
    "github.example.com": {
        "username": "weblate",
        "token": "another-api-token",
    },
}

也參考

GitHub pull requests, Creating a GitHub personal access token

BITBUCKETSERVER_CREDENTIALS#

在 4.16 版本新加入.

List for credentials for Bitbucket servers.

BITBUCKETSERVER_CREDENTIALS = {
    "git.self-hosted.com": {
        "username": "weblate",
        "token": "http-access-token",
    },
}

也參考

Bitbucket Server pull requests, Bitbucket: HTTP access token

GOOGLE_ANALYTICS_ID#

Google Analytics ID 開啟使用 Google Analytics 在 Weblate 的網頁追蹤分析。

HIDE_REPO_CREDENTIALS#

隱藏倉儲憑據避免出現在 web 界面中。在倉儲 URL 帶有使用者名和密碼的情況下， Weblate 會在相關信息顯示給使用者時將其隱藏起來。

例如除了 https://user:password@git.example.com/repo.git 會只顯示 https://git.example.com/repo.git。它也試圖以相似的方式清除版本控制系統（VCS ）錯誤信息。

備註

預設這是打開的。

HIDE_VERSION#

在 4.3.1 版本新加入.

從未進行身份驗證的使用者那裡的隱藏版本信息。這樣將所有文件的連接點連接到最新的版本，而不是與當前安裝的版本匹配文件的版本。

一些公司推薦在安全實踐上推薦隱藏版本，但不能防止攻擊者通過試探性為來找出版本。

備註

此預設為關閉。

INTERLEDGER_PAYMENT_POINTERS#

在 4.12.1 版本新加入.

用於網頁貨幣化的 Interledger Payment Pointers (ILPs) 的列表。

若指定多組，probabilistic revenue sharing 將隨機挑選一組分配。

請參閱 <https://webmonetization.org/> 了解更多。

提示

此預設值讓使用者能為自己的 Weblate 募資。

IP_BEHIND_REVERSE_PROXY#

指示 Weblate 是否在反向代理後面運行。

如果設置為 True， Weblate 會從 :setting:`IP_PROXY_HEADER`定義的標頭中得到 IP 地址。

警告

確保真正使用反向代理，並且設置了這個標頭，否則使用者將能夠假冒 IP 地址。

備註

預設這不是打開的。

也參考

在反向代理後面運行, 頻次限制, IP_PROXY_HEADER, IP_PROXY_OFFSET

IP_PROXY_HEADER#

指示當 IP_BEHIND_REVERSE_PROXY 打開時，Weblate應該從那個標頭得到 IP 地址。

預設為 HTTP_X_FORWARDED_FOR。

也參考

:ref:“反向代理”，:ref:“速率限制”，：設置：“Django：secure_proxy_sl_header`，：設置：ip_behind_reverse_proxy，：設置：Ip_proxy_offset

IP_PROXY_OFFSET#

指示 IP_PROXY_HEADER 的哪部分用作客戶端 IP 地址。

依賴於您的設置，這個標頭會包括幾個IP 地址，（例如``X-Forwarded-For: a, b, client-ip`` ），並且可以配置標頭的哪個地址在這裡用作客戶端IP 地址。

警告

設置這個會影響您安裝的安全性，應該只配置它來使用信任的代理來確定 IP 地址。

預設為 0。

也參考

:ref:“反向代理”，:ref:“速率限制”，：設置：“Django：secure_proxy_ssl_header`，：設置：ip_behind_reverse_proxy，：設置：``ip_proxy_header`

LEGAL_TOS_DATE#

在 4.15 版本新加入.

備註

您需要安裝法律才能使其作用。

使用條款最後更新日期。每當日期更新，使用者再次要求必須同意使用條款。

from datetime import date

LEGAL_TOS_DATE = date(2022, 2, 2)

LEGAL_URL#

在 3.5 版本新加入.

您的 Weblate 事例顯示其法律文件的 URL。

提示

在將您的法律文件保存在 Weblate 之外，而將其嵌入 Weblate 的情況下有用。細節請查看法律。

例：

LEGAL_URL = "https://weblate.org/terms/"

也參考

PRIVACY_URL

LICENSE_EXTRA#

包括在許可選擇中的其他許可。

備註

每個許可的定義應該是其短名稱、長名稱和 URL 的元組。

例如：

LICENSE_EXTRA = [
    (
        "AGPL-3.0",
        "GNU Affero General Public License v3.0",
        "https://www.gnu.org/licenses/agpl-3.0-standalone.html",
    ),
]

LICENSE_FILTER#

在 4.3 版本變更: 將其設置為空值現在關閉了許可提醒。

要顯示的被篩選的許可列表。在設置為空時還關閉了許可提醒。

備註

這個過濾器使用了短許可名稱。

例如：

LICENSE_FILTER = {"AGPL-3.0", "GPL-3.0-or-later"}

後面關閉了許可提醒：

LICENSE_FILTER = set()

也參考

翻譯組件警告

LICENSE_REQUIRED#

定義了是否需要組件配置中的許可屬性。

備註

預設這是關閉的。

LIMIT_TRANSLATION_LENGTH_BY_SOURCE_LENGTH#

Whether the length of a given translation should be limited. The restriction is the length of the source string × 10 characters.

提示

Set this to False to allow longer translations (up to 10,000 characters) irrespective of source string length.

備註

預設為 True.

LOCALIZE_CDN_URL 和 LOCALIZE_CDN_PATH#

These settings configure the JavaScript 在地化 CDN add-on. LOCALIZE_CDN_URL defines root URL where the localization CDN is available and LOCALIZE_CDN_PATH defines path where Weblate should store generated files which will be served at the LOCALIZE_CDN_URL.

提示

在hosted Weblate 中，這使用 https://weblate-cdn.com/。

也參考

JavaScript 在地化 CDN

LOGIN_REQUIRED_URLS#

A list of URLs you want to require signing in. (Besides the standard rules built into Weblate).

提示

這允許密碼保護整個安裝，通過使用：

LOGIN_REQUIRED_URLS = (r"/(.*)$",)
REST_FRAMEWORK["DEFAULT_PERMISSION_CLASSES"] = [
    "rest_framework.permissions.IsAuthenticated"
]

提示

同樣想要鎖住 API 訪問，如上面的例子所示。

也參考

REQUIRE_LOGIN

LOGIN_REQUIRED_URLS_EXCEPTIONS#

用於 LOGIN_REQUIRED_URLS 的例外列表。如果未指定，則允許使用者訪問登錄頁。

您可能想要包括的一些例外：

LOGIN_REQUIRED_URLS_EXCEPTIONS = (
    r"/accounts/(.*)$",  # Required for sign in
    r"/static/(.*)$",  # Required for development mode
    r"/widgets/(.*)$",  # Allowing public access to widgets
    r"/data/(.*)$",  # Allowing public access to data exports
    r"/hooks/(.*)$",  # Allowing public access to notification hooks
    r"/api/(.*)$",  # Allowing access to API
    r"/js/i18n/$",  # JavaScript localization
)

MATOMO_SITE_ID#

您想要跟踪的 Matomo （以前的 Piwik ）中的網站 ID。

備註

這個集成不支持 Matomo Tag Manager。

也參考

MATOMO_URL

MATOMO_URL#

您想要跟踪的 Matomo （以前的 Piwik ）安裝的全 URL （包括反斜杠）。更多細節請查閱 <https://matomo.org/>。

提示

這個集成不支持 Matomo Tag Manager。

例如：

MATOMO_SITE_ID = 1
MATOMO_URL = "https://example.matomo.cloud/"

也參考

MATOMO_SITE_ID

NEARBY_MESSAGES#

在查看當前翻譯字串時顯示多少字串。這只是預設值，使用者可以在 :ref:`user-profile`中調整。

DEFAULT_PAGE_LIMIT#

在 4.7 版本新加入.

當啟用分頁功能時，預設顯示多少數量。

PAGURE_CREDENTIALS#

在 4.3.2 版本新加入.

Pagure服務器憑據列表。

PAGURE_CREDENTIALS = {
    "pagure.io": {
        "username": "weblate",
        "token": "your-api-token",
    },
    "pagure.example.com": {
        "username": "weblate",
        "token": "another-api-token",
    },
}

也參考

Pagure 合併請求, Pagure API

PRIVACY_URL#

在 4.8.1 版本新加入.

您的 Weblate 執行個體顯示其法律文件的 URL。

提示

在將您的法律文件保存在 Weblate 之外，而將其嵌入 Weblate 的情況下有用。細節請查看法律。

例：

PRIVACY_URL = "https://weblate.org/terms/"

也參考

LEGAL_URL

PRIVATE_COMMIT_EMAIL_OPT_IN#

在 4.15 版本新加入.

Configures whether the private commit e-mail is opt-in or opt-out (by default it is opt-in).

也參考

個人檔案、 PRIVATE_COMMIT_EMAIL_TEMPLATE

PRIVATE_COMMIT_EMAIL_TEMPLATE#

在 4.15 版本新加入.

產生隱藏的提交者郵件信箱格式。預設為 "{username}@users.noreply.{site_domain}" 。

設定不允許空白字串。

備註

使用不同的提交用的郵件信箱是可選用的，除非已設定為 PRIVATE_COMMIT_EMAIL_OPT_IN 。使用者可以設定提交用的郵件信箱於個人檔案。

PROJECT_BACKUP_KEEP_COUNT#

在 4.14 版本新加入.

定義每個專案有多少組備份於伺服器中。預設為 3 組。

也參考

Project level backups

PROJECT_BACKUP_KEEP_DAYS#

在 4.14 版本新加入.

定義每個專案的備份將存放多久在伺服器上。預設為 30 天。

也參考

Project level backups

PROJECT_NAME_RESTRICT_RE#

在 4.15 版本新加入.

使用正則表達式定義專案的命名方式。任何相符合規則的將會駁回。

也參考

專案名稱

PROJECT_WEB_RESTRICT_HOST#

在 4.16.2 版本新加入.

Reject using certain hosts in project website. Any subdomain is matched, so including example.com will block test.example.com as well. The list should contain lower case strings only, the parsed domain is lower cased before matching.

Default configuration:

PROJECT_WEB_RESTRICT_HOST = {"localhost"}

也參考

專案網站 PROJECT_WEB_RESTRICT_NUMERIC, PROJECT_WEB_RESTRICT_RE,

PROJECT_WEB_RESTRICT_NUMERIC#

在 4.16.2 版本新加入.

Reject using numeric IP address in project website. Enabled by default.

也參考

專案網站 PROJECT_WEB_RESTRICT_HOST, PROJECT_WEB_RESTRICT_RE,

PROJECT_WEB_RESTRICT_RE#

在 4.15 版本新加入.

使用正則表達式定義專案的網站網址。任何相符合規則的網址將會駁回。

也參考

專案網站 PROJECT_WEB_RESTRICT_HOST, PROJECT_WEB_RESTRICT_NUMERIC

RATELIMIT_ATTEMPTS#

在 3.2 版本新加入.

在應用次數限制前，身份認證嘗試的最多次數。

預設為 5。

也參考

頻次限制、 RATELIMIT_WINDOW 、 RATELIMIT_LOCKOUT

RATELIMIT_WINDOW#

在 3.2 版本新加入.

應用次數限制後，可接受多少次身份認證。

秒數預設為 300 （ 5 分鐘）。

也參考

頻次限制、 RATELIMIT_ATTEMPTS 、 RATELIMIT_LOCKOUT

RATELIMIT_LOCKOUT#

在 3.2 版本新加入.

在應用次數限制後，身份認證鎖定多久。

秒數預設為 600 （ 10 分鐘）。

也參考

頻次限制、 RATELIMIT_ATTEMPTS 、 RATELIMIT_WINDOW

REGISTRATION_ALLOW_BACKENDS#

在 4.1 版本新加入.

身份驗證後端的列表，允許從中註冊。這只限制新的註冊，使用者可以使用配置的身份驗證後端，來進行身份驗證和添加身份驗證。

當限制註冊後端時，推薦保持 REGISTRATION_OPEN 為開啟狀態，否則使用者將能夠註冊，但Weblate不會在使用者界面顯示註冊的鏈接。

例：

REGISTRATION_ALLOW_BACKENDS = ["azuread-oauth2", "azuread-tenant-oauth2"]

提示

與身份驗證 URL 中使用的名稱匹配的後端名稱。

也參考

REGISTRATION_OPEN, 身份核對

REGISTRATION_CAPTCHA#

True 或 False 的值指示新賬戶註冊是否被 CAPTCHA 保護。這個設置是可選的，預設的 True 是假定不提供。

如果打開，CAPTCHA 會添加到使用者輸入其電子郵箱地址的所有頁面中：

註冊新帳號。
找回密碼。
將電子郵箱地址添加到賬戶中。
供未登錄使用者使用的聯繫表格。

REGISTRATION_EMAIL_MATCH#

允許您篩選哪個電子郵箱地址可以註冊。

預設為 .*，允許使用任何電子郵箱地址註冊。

可以用它限制註冊到單一的電子郵箱域名：

REGISTRATION_EMAIL_MATCH = r"^.*@weblate\.org$"

REGISTRATION_OPEN#

是否註冊新賬戶在當前是允許的。這個可選設置可以保持預設為 True，或更改為 False。

這個設置影響了內建的通過電子郵箱地址或通過 Python Social Auth 的身份驗證（可以使用 REGISTRATION_ALLOW_BACKENDS 為適當的後端建立白名單）。

備註

如果使用第三方身份驗證方法，如 LDAP 身份驗證，只是隱藏註冊表格，而新使用者仍然能夠登錄並建立賬戶。

也參考

REGISTRATION_ALLOW_BACKENDS, REGISTRATION_EMAIL_MATCH, 身份核對

REGISTRATION_REBIND#

在 4.16 版本新加入.

Allow rebinding authentication backends for existing users. Turn this on when migrating between authentication providers.

備註

Disabled by default to not allow adding other authentication backends to existing account. Rebinding can lead to account compromise when using more third-party authentication backends.

REPOSITORY_ALERT_THRESHOLD#

在 4.0.2 版本新加入.

觸發倉儲過期警告的閾值，或者包含了太多更改的閾值。預設為 25。

也參考

翻譯組件警告

SENTRY_DSN#

在 3.9 版本新加入.

Sentry DSN 用於蒐集錯誤訊息報告。

也參考

Sentry的Django集成

SIMPLIFY_LANGUAGES#

對於預設語言/國家組合使用簡單語言代碼。例如， fr_FR 翻譯將使用 fr 語言代碼。這通常是受歡迎的特性，因為它簡化了這些預設組合列出的語言。

如果對每種不同的變化想要不同的翻譯，那麼請將其關閉。

SITE_DOMAIN#

配置網站域名。這在很多領域產生正確的絕對鏈接是必要的（例如激活電子郵箱、通知或 RSS 推送）。

在 Weblate 運行在非標準端口時，這裡同樣要包括它。

範例：

# Production site with domain name
SITE_DOMAIN = "weblate.example.com"

# Local development with IP address and port
SITE_DOMAIN = "127.0.0.1:8000"

備註

這個設置應該只包含域名。對於配置協議，（允許或強制 HTTPS ）使用 ENABLE_HTTPS and for changing URL, use URL_PREFIX。

提示

關於 Docker 容器，網站域名通過 WEBLATE_ALLOWED_HOSTS 來配置。

也參考

:ref:“生產現場”，:ref:“生產 - 主機”，:ref:“生產-SSL`：envvar：”WebLate_Site_Domain“，：設置：”enable_https`

SITE_TITLE#

用於網站和發送電子郵件的網站名稱。

SPECIAL_CHARS#

屏幕鍵盤中包括的另外的字符，模擬鍵盤。

預設值為：

SPECIAL_CHARS = ("\t", "\n", "\u00a0", "…")

SINGLE_PROJECT#

在 3.8 版本新加入.

將使用者直接重定向到項目或組件，而不是顯示控制面板。可以將其設置為 True，在這種情況下，只在 Weblate 實際只有單一的項目時有用。另外可以設置項目標識串，將無條件地重定向到這個項目。

在 3.11 版本變更: 設置只接受項目標識串，來強制顯示那個單一項目。

例：

SINGLE_PROJECT = "test"

SSH_EXTRA_ARGS#

在 4.9 版本新加入.

允許新增自動的參數當 Weblate 調用 SSH。這在連線到使用過時的加密協定或是其他非標準的功能時有幫助的。

例如當 SSH 在 Weblate 連線時發生錯誤訊息 Unable to negotiate with legacyhost: no matching key exchange method found. Their offer: diffie-hellman-group1-sha1 ，您可以啟用來使用：

SSH_EXTRA_ARGS = "-oKexAlgorithms=+diffie-hellman-group1-sha1"

提示

此字串將透過 shell 來執行，請確認任何空白字和特殊字元有無使用引號引用。

也參考

OpenSSH 舊有選項

STATUS_URL#

Weblate 事例報告其狀態的 URL。

SUGGESTION_CLEANUP_DAYS#

在 3.2.1 版本新加入.

指示當 IP_BEHIND_REVERSE_PROXY 打開時，Weblate應該從那個標頭得到 IP 地址。

UNUSED_ALERT_DAYS#

在 4.17 版本新加入.

Configures when Component seems unused alert is triggered.

Defaults to 365 days, set to 0 to disable it.

UPDATE_LANGUAGES#

在 4.3.2 版本新加入.

控制在運行資料庫遷移時是否應該更新語言資料庫並在預設情況下啟用。這個設置對 :djadmin: setuplang 的調用沒有影響。

警告

語系顯示或許會因此而不一致。Weblate 語系定義時常擴充以及此將不會顯示語言代碼在已定義的語系中。

也參考

Built-in language definitions

URL_PREFIX#

這個設置允許在一些路徑下運行 Weblate （否則它依賴於從 web 服務器根目錄運行）。

備註

為了使用這個設置，還需要配置服務器來去掉這個前綴。例如 WSGI，可以通過設置 WSGIScriptAlias 來實現。

提示

前綴應該以 / 開始。

例：

URL_PREFIX = "/translations"

備註

這個設置在 Django’s 內建服務器中不起作用，必須調整 urls.py 來包含這個前綴。

VCS_API_DELAY#

在 4.15.1 版本新加入.

設定最少延遲秒數於第三方 API 中，請參閱 GitHub pull requests 、 GitLab 合併請求、 Gitea pull requests 與 Pagure 合併請求。

從 Weblate 到服務 API 呼叫速率限制可避免過載使用。

如果您被 GitHub 限制使用速率，調高此數值或許有用。

預設值為 10。

VCS_BACKENDS#

可用的版本控制系統（ VCS ）後端的配置。

備註

Weblate 嘗試使用您所有工具支持的後端。

提示

可以使用這個來限制選擇或添加定製版本控制系統（ VCS ）後端。

VCS_BACKENDS = ("weblate.vcs.git.GitRepository",)

也參考

版本控制整合

VCS_CLONE_DEPTH#

在 3.10.2 版本新加入.

配置 Weblate應該對倉儲進行深度為多少的克隆。

備註

當前這只在 Git 中支持。預設 Weblate 進行倉儲的淺克隆，使克隆更快並節省磁盤空間。根據應用（例如當使用定制的附加元件時），您可能想要增加深度，或通過設置為 0 來完全關閉淺克隆。

提示

在從 Weblate 推送而得到 fatal: protocol error: expected old/new/ref, got 'shallow <commit hash>' 錯誤的情況下，通過設置來完全關閉淺克隆：

VCS_CLONE_DEPTH = 0

WEBLATE_ADDONS#

附加元件可供使用的附加元件列表。為了使用，必須對給定的翻譯組件允許它們。預設包括了所有內建附加元件，當擴展列表時您可能希望保持現有的附加元件處於啟用狀態，例如：

WEBLATE_ADDONS = (
    # Built-in add-ons
    "weblate.addons.gettext.GenerateMoAddon",
    "weblate.addons.gettext.UpdateLinguasAddon",
    "weblate.addons.gettext.UpdateConfigureAddon",
    "weblate.addons.gettext.MsgmergeAddon",
    "weblate.addons.gettext.GettextCustomizeAddon",
    "weblate.addons.gettext.GettextAuthorComments",
    "weblate.addons.cleanup.CleanupAddon",
    "weblate.addons.consistency.LangaugeConsistencyAddon",
    "weblate.addons.discovery.DiscoveryAddon",
    "weblate.addons.flags.SourceEditAddon",
    "weblate.addons.flags.TargetEditAddon",
    "weblate.addons.flags.SameEditAddon",
    "weblate.addons.flags.BulkEditAddon",
    "weblate.addons.generate.GenerateFileAddon",
    "weblate.addons.json.JSONCustomizeAddon",
    "weblate.addons.xml.XMLCustomizeAddon",
    "weblate.addons.properties.PropertiesSortAddon",
    "weblate.addons.git.GitSquashAddon",
    "weblate.addons.removal.RemoveComments",
    "weblate.addons.removal.RemoveSuggestions",
    "weblate.addons.resx.ResxUpdateAddon",
    "weblate.addons.autotranslate.AutoTranslateAddon",
    "weblate.addons.yaml.YAMLCustomizeAddon",
    "weblate.addons.cdn.CDNJSAddon",
    # Add-on you want to include
    "weblate.addons.example.ExampleAddon",
)

備註

Removing the add-on from the list does not uninstall it from the components. Weblate will crash in that case. Please uninstall add-on from all components prior to removing it from this list.

也參考

附加元件, DEFAULT_ADDONS

WEBLATE_EXPORTERS#

在 4.2 版本新加入.

可用的導出程序列表，提供下載各種文件格式的翻譯或詞彙表。

也參考

支持的文件格式

WEBLATE_FORMATS#

在 3.0 版本新加入.

可供使用的文件格式列表。

備註

預設列表已經具有了常見格式。

也參考

支持的文件格式

WEBLATE_MACHINERY#

在 4.13 版本新加入.

List of machinery services available for use.

也參考

配置自動建議

WEBLATE_GPG_IDENTITY#

在 3.1 版本新加入.

Weblate 使用的身份，用於登錄 Git Commits，例如：

WEBLATE_GPG_IDENTITY = "Weblate <weblate@example.com>"

搜索 Weblate GPG 鑰匙鏈（ home/.gnupg，在 DATA_DIR 之下）。如果沒有找到，則產生密鑰，更多細節請查詢簽署 GnuPG 的 Git 承諾。

也參考

簽署 GnuPG 的 Git 承諾

WEBSITE_REQUIRED#

定義是否:ref:創建項目時必須指定Project-Web。預設情況下打開，因為這適合公共服務器設置。

配置的例子#

後面的例子作為 weblate/settings_example.py 與Weblate一起上市：

# Copyright © Michal Čihař <michal@weblate.org>
#
# SPDX-License-Identifier: GPL-3.0-or-later

import os
import platform
from logging.handlers import SysLogHandler

# Title of site to use
SITE_TITLE = "Weblate"

# Site domain
SITE_DOMAIN = ""

# Whether site uses https
ENABLE_HTTPS = False

#
# Django settings for Weblate project.
#

DEBUG = True

ADMINS = (
    # ("Your Name", "your_email@example.com"),
)

MANAGERS = ADMINS

DATABASES = {
    "default": {
        # Use "postgresql" or "mysql".
        "ENGINE": "django.db.backends.postgresql",
        # Database name.
        "NAME": "weblate",
        # Database user.
        "USER": "weblate",
        # Name of role to alter to set parameters in PostgreSQL,
        # use in case role name is different than user used for authentication.
        # "ALTER_ROLE": "weblate",
        # Database password.
        "PASSWORD": "",
        # Set to empty string for localhost.
        "HOST": "127.0.0.1",
        # Set to empty string for default.
        "PORT": "",
        # Customizations for databases.
        "OPTIONS": {
            # In case of using an older MySQL server,
            # which has MyISAM as a default storage
            # "init_command": "SET storage_engine=INNODB",
            # Uncomment for MySQL older than 5.7:
            # "init_command": "SET sql_mode='STRICT_TRANS_TABLES'",
            # Set emoji capable charset for MySQL:
            # "charset": "utf8mb4",
            # Change connection timeout in case you get MySQL gone away error:
            # "connect_timeout": 28800,
        },
        # Persistent connections
        "CONN_MAX_AGE": 0,
        # Disable server-side cursors, might be needed with pgbouncer
        "DISABLE_SERVER_SIDE_CURSORS": False,
    }
}

# Data directory, you can use following for the development purposes:
# os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))), "data")
DATA_DIR = "/home/weblate/data"
CACHE_DIR = f"{DATA_DIR}/cache"

# Local time zone for this installation. Choices can be found here:
# http://en.wikipedia.org/wiki/List_of_tz_zones_by_name
# although not all choices may be available on all operating systems.
# In a Windows environment this must be set to your system time zone.
TIME_ZONE = "UTC"

# Language code for this installation. All choices can be found here:
# http://www.i18nguy.com/unicode/language-identifiers.html
LANGUAGE_CODE = "en-us"

LANGUAGES = (
    ("ar", "العربية"),
    ("az", "Azərbaycan"),
    ("be", "Беларуская"),
    ("be@latin", "Biełaruskaja"),
    ("bg", "Български"),
    ("br", "Brezhoneg"),
    ("ca", "Català"),
    ("cs", "Čeština"),
    ("cy", "Cymraeg"),
    ("da", "Dansk"),
    ("de", "Deutsch"),
    ("en", "English"),
    ("el", "Ελληνικά"),
    ("en-gb", "English (United Kingdom)"),
    ("es", "Español"),
    ("fi", "Suomi"),
    ("fr", "Français"),
    ("gl", "Galego"),
    ("he", "עברית"),
    ("hu", "Magyar"),
    ("hr", "Hrvatski"),
    ("id", "Indonesia"),
    ("is", "Íslenska"),
    ("it", "Italiano"),
    ("ja", "日本語"),
    ("kab", "Taqbaylit"),
    ("kk", "Қазақ тілі"),
    ("ko", "한국어"),
    ("nb", "Norsk bokmål"),
    ("nl", "Nederlands"),
    ("pl", "Polski"),
    ("pt", "Português"),
    ("pt-br", "Português brasileiro"),
    ("ro", "Română"),
    ("ru", "Русский"),
    ("sk", "Slovenčina"),
    ("sl", "Slovenščina"),
    ("sq", "Shqip"),
    ("sr", "Српски"),
    ("sr-latn", "Srpski"),
    ("sv", "Svenska"),
    ("th", "ไทย"),
    ("tr", "Türkçe"),
    ("uk", "Українська"),
    ("zh-hans", "简体中文"),
    ("zh-hant", "正體中文"),
)

SITE_ID = 1

# If you set this to False, Django will make some optimizations so as not
# to load the internationalization machinery.
USE_I18N = True

# If you set this to False, Django will not format dates, numbers and
# calendars according to the current locale.
USE_L10N = True

# If you set this to False, Django will not use timezone-aware datetimes.
USE_TZ = True

# Type of automatic primary key, introduced in Django 3.2
DEFAULT_AUTO_FIELD = "django.db.models.AutoField"

# URL prefix to use, please see documentation for more details
URL_PREFIX = ""

# Absolute filesystem path to the directory that will hold user-uploaded files.
MEDIA_ROOT = os.path.join(DATA_DIR, "media")

# URL that handles the media served from MEDIA_ROOT. Make sure to use a
# trailing slash.
MEDIA_URL = f"{URL_PREFIX}/media/"

# Absolute path to the directory static files should be collected to.
# Don't put anything in this directory yourself; store your static files
# in apps' "static/" subdirectories and in STATICFILES_DIRS.
STATIC_ROOT = os.path.join(CACHE_DIR, "static")

# URL prefix for static files.
STATIC_URL = f"{URL_PREFIX}/static/"

# Additional locations of static files
STATICFILES_DIRS = (
    # Put strings here, like "/home/html/static" or "C:/www/django/static".
    # Always use forward slashes, even on Windows.
    # Don't forget to use absolute paths, not relative paths.
)

# List of finder classes that know how to find static files in
# various locations.
STATICFILES_FINDERS = (
    "django.contrib.staticfiles.finders.FileSystemFinder",
    "django.contrib.staticfiles.finders.AppDirectoriesFinder",
    "compressor.finders.CompressorFinder",
)

# Make this unique, and don't share it with anybody.
# You can generate it using weblate-generate-secret-key
SECRET_KEY = ""

TEMPLATES = [
    {
        "BACKEND": "django.template.backends.django.DjangoTemplates",
        "OPTIONS": {
            "context_processors": [
                "django.contrib.auth.context_processors.auth",
                "django.template.context_processors.debug",
                "django.template.context_processors.i18n",
                "django.template.context_processors.request",
                "django.template.context_processors.csrf",
                "django.contrib.messages.context_processors.messages",
                "weblate.trans.context_processors.weblate_context",
            ],
        },
        "APP_DIRS": True,
    }
]


# GitHub username and token for sending pull requests.
# Please see the documentation for more details.
GITHUB_CREDENTIALS = {}

# GitLab username and token for sending merge requests.
# Please see the documentation for more details.
GITLAB_CREDENTIALS = {}

# Bitbucket username and token for sending merge requests.
# Please see the documentation for more details.
BITBUCKETSERVER_CREDENTIALS = {}

# Authentication configuration
AUTHENTICATION_BACKENDS = (
    "social_core.backends.email.EmailAuth",
    # "social_core.backends.google.GoogleOAuth2",
    # "social_core.backends.github.GithubOAuth2",
    # "social_core.backends.bitbucket.BitbucketOAuth2",
    # "social_core.backends.suse.OpenSUSEOpenId",
    # "social_core.backends.ubuntu.UbuntuOpenId",
    # "social_core.backends.fedora.FedoraOpenId",
    # "social_core.backends.facebook.FacebookOAuth2",
    "weblate.accounts.auth.WeblateUserBackend",
)

# Custom user model
AUTH_USER_MODEL = "weblate_auth.User"

# Social auth backends setup
SOCIAL_AUTH_GITHUB_KEY = ""
SOCIAL_AUTH_GITHUB_SECRET = ""
SOCIAL_AUTH_GITHUB_SCOPE = ["user:email"]

SOCIAL_AUTH_GITHUB_ORG_KEY = ""
SOCIAL_AUTH_GITHUB_ORG_SECRET = ""
SOCIAL_AUTH_GITHUB_ORG_NAME = ""

SOCIAL_AUTH_GITHUB_TEAM_KEY = ""
SOCIAL_AUTH_GITHUB_TEAM_SECRET = ""
SOCIAL_AUTH_GITHUB_TEAM_ID = ""

SOCIAL_AUTH_BITBUCKET_OAUTH2_KEY = ""
SOCIAL_AUTH_BITBUCKET_OAUTH2_SECRET = ""
SOCIAL_AUTH_BITBUCKET_OAUTH2_VERIFIED_EMAILS_ONLY = True

SOCIAL_AUTH_FACEBOOK_KEY = ""
SOCIAL_AUTH_FACEBOOK_SECRET = ""
SOCIAL_AUTH_FACEBOOK_SCOPE = ["email", "public_profile"]
SOCIAL_AUTH_FACEBOOK_PROFILE_EXTRA_PARAMS = {"fields": "id,name,email"}

SOCIAL_AUTH_GOOGLE_OAUTH2_KEY = ""
SOCIAL_AUTH_GOOGLE_OAUTH2_SECRET = ""

# Social auth settings
SOCIAL_AUTH_PIPELINE = (
    "social_core.pipeline.social_auth.social_details",
    "social_core.pipeline.social_auth.social_uid",
    "social_core.pipeline.social_auth.auth_allowed",
    "social_core.pipeline.social_auth.social_user",
    "weblate.accounts.pipeline.store_params",
    "weblate.accounts.pipeline.verify_open",
    "social_core.pipeline.user.get_username",
    "weblate.accounts.pipeline.require_email",
    "social_core.pipeline.mail.mail_validation",
    "weblate.accounts.pipeline.revoke_mail_code",
    "weblate.accounts.pipeline.ensure_valid",
    "weblate.accounts.pipeline.remove_account",
    "social_core.pipeline.social_auth.associate_by_email",
    "weblate.accounts.pipeline.reauthenticate",
    "weblate.accounts.pipeline.verify_username",
    "social_core.pipeline.user.create_user",
    "social_core.pipeline.social_auth.associate_user",
    "social_core.pipeline.social_auth.load_extra_data",
    "weblate.accounts.pipeline.cleanup_next",
    "weblate.accounts.pipeline.user_full_name",
    "weblate.accounts.pipeline.store_email",
    "weblate.accounts.pipeline.notify_connect",
    "weblate.accounts.pipeline.password_reset",
)
SOCIAL_AUTH_DISCONNECT_PIPELINE = (
    "social_core.pipeline.disconnect.allowed_to_disconnect",
    "social_core.pipeline.disconnect.get_entries",
    "social_core.pipeline.disconnect.revoke_tokens",
    "weblate.accounts.pipeline.cycle_session",
    "weblate.accounts.pipeline.adjust_primary_mail",
    "weblate.accounts.pipeline.notify_disconnect",
    "social_core.pipeline.disconnect.disconnect",
    "weblate.accounts.pipeline.cleanup_next",
)

# Custom authentication strategy
SOCIAL_AUTH_STRATEGY = "weblate.accounts.strategy.WeblateStrategy"

# Raise exceptions so that we can handle them later
SOCIAL_AUTH_RAISE_EXCEPTIONS = True

SOCIAL_AUTH_EMAIL_VALIDATION_FUNCTION = "weblate.accounts.pipeline.send_validation"
SOCIAL_AUTH_EMAIL_VALIDATION_URL = f"{URL_PREFIX}/accounts/email-sent/"
SOCIAL_AUTH_LOGIN_ERROR_URL = f"{URL_PREFIX}/accounts/login/"
SOCIAL_AUTH_EMAIL_FORM_URL = f"{URL_PREFIX}/accounts/email/"
SOCIAL_AUTH_NEW_ASSOCIATION_REDIRECT_URL = f"{URL_PREFIX}/accounts/profile/#account"
SOCIAL_AUTH_PROTECTED_USER_FIELDS = ("email",)
SOCIAL_AUTH_SLUGIFY_USERNAMES = True
SOCIAL_AUTH_SLUGIFY_FUNCTION = "weblate.accounts.pipeline.slugify_username"

# Password validation configuration
AUTH_PASSWORD_VALIDATORS = [
    {
        "NAME": "django.contrib.auth.password_validation.UserAttributeSimilarityValidator"
    },
    {
        "NAME": "django.contrib.auth.password_validation.MinimumLengthValidator",
        "OPTIONS": {"min_length": 10},
    },
    {"NAME": "django.contrib.auth.password_validation.CommonPasswordValidator"},
    {"NAME": "django.contrib.auth.password_validation.NumericPasswordValidator"},
    {"NAME": "weblate.accounts.password_validation.CharsPasswordValidator"},
    {"NAME": "weblate.accounts.password_validation.PastPasswordsValidator"},
    # Optional password strength validation by django-zxcvbn-password
    # {
    #     "NAME": "zxcvbn_password.ZXCVBNValidator",
    #     "OPTIONS": {
    #         "min_score": 3,
    #         "user_attributes": ("username", "email", "full_name")
    #     }
    # },
]

# Password hashing (prefer Argon)
PASSWORD_HASHERS = [
    "django.contrib.auth.hashers.Argon2PasswordHasher",
    "django.contrib.auth.hashers.PBKDF2PasswordHasher",
    "django.contrib.auth.hashers.PBKDF2SHA1PasswordHasher",
    "django.contrib.auth.hashers.BCryptSHA256PasswordHasher",
]

# Allow new user registrations
REGISTRATION_OPEN = True

# Shortcut for login required setting
REQUIRE_LOGIN = False

# Middleware
MIDDLEWARE = [
    "weblate.middleware.RedirectMiddleware",
    "weblate.middleware.ProxyMiddleware",
    "corsheaders.middleware.CorsMiddleware",
    "django.middleware.security.SecurityMiddleware",
    "django.contrib.sessions.middleware.SessionMiddleware",
    "django.middleware.csrf.CsrfViewMiddleware",
    "weblate.accounts.middleware.AuthenticationMiddleware",
    "django.contrib.messages.middleware.MessageMiddleware",
    "django.middleware.clickjacking.XFrameOptionsMiddleware",
    "social_django.middleware.SocialAuthExceptionMiddleware",
    "weblate.accounts.middleware.RequireLoginMiddleware",
    "weblate.api.middleware.ThrottlingMiddleware",
    "weblate.middleware.SecurityMiddleware",
    "weblate.wladmin.middleware.ManageMiddleware",
]

ROOT_URLCONF = "weblate.urls"

# Django and Weblate apps
INSTALLED_APPS = [
    # Weblate apps on top to override Django locales and templates
    "weblate.addons",
    "weblate.auth",
    "weblate.checks",
    "weblate.formats",
    "weblate.glossary",
    "weblate.machinery",
    "weblate.trans",
    "weblate.lang",
    "weblate_language_data",
    "weblate.memory",
    "weblate.screenshots",
    "weblate.fonts",
    "weblate.accounts",
    "weblate.configuration",
    "weblate.utils",
    "weblate.vcs",
    "weblate.wladmin",
    "weblate.metrics",
    "weblate",
    # Optional: Git exporter
    "weblate.gitexport",
    # Standard Django modules
    "django.contrib.auth",
    "django.contrib.contenttypes",
    "django.contrib.sessions",
    "django.contrib.messages",
    "django.contrib.staticfiles",
    "django.contrib.admin.apps.SimpleAdminConfig",
    "django.contrib.admindocs",
    "django.contrib.sitemaps",
    "django.contrib.humanize",
    # Third party Django modules
    "social_django",
    "crispy_forms",
    "crispy_bootstrap3",
    "compressor",
    "rest_framework",
    "rest_framework.authtoken",
    "django_filters",
    "django_celery_beat",
    "corsheaders",
]

# Custom exception reporter to include some details
DEFAULT_EXCEPTION_REPORTER_FILTER = "weblate.trans.debug.WeblateExceptionReporterFilter"

# Default logging of Weblate messages
# - to syslog in production (if available)
# - otherwise to console
# - you can also choose "logfile" to log into separate file
#   after configuring it below

# Detect if we can connect to syslog
HAVE_SYSLOG = False
if platform.system() != "Windows":
    try:
        handler = SysLogHandler(address="/dev/log", facility=SysLogHandler.LOG_LOCAL2)
        handler.close()
        HAVE_SYSLOG = True
    except OSError:
        HAVE_SYSLOG = False

DEFAULT_LOG = "console" if DEBUG or not HAVE_SYSLOG else "syslog"
DEFAULT_LOGLEVEL = "DEBUG" if DEBUG else "INFO"

# A sample logging configuration. The only tangible logging
# performed by this configuration is to send an email to
# the site admins on every HTTP 500 error when DEBUG=False.
# See http://docs.djangoproject.com/en/stable/topics/logging for
# more details on how to customize your logging configuration.
LOGGING = {
    "version": 1,
    "disable_existing_loggers": True,
    "filters": {"require_debug_false": {"()": "django.utils.log.RequireDebugFalse"}},
    "formatters": {
        "syslog": {"format": "weblate[%(process)d]: %(levelname)s %(message)s"},
        "simple": {"format": "[%(asctime)s: %(levelname)s/%(process)s] %(message)s"},
        "logfile": {"format": "%(asctime)s %(levelname)s %(message)s"},
        "django.server": {
            "()": "django.utils.log.ServerFormatter",
            "format": "[%(server_time)s] %(message)s",
        },
    },
    "handlers": {
        "mail_admins": {
            "level": "ERROR",
            "filters": ["require_debug_false"],
            "class": "django.utils.log.AdminEmailHandler",
            "include_html": True,
        },
        "console": {
            "level": "DEBUG",
            "class": "logging.StreamHandler",
            "formatter": "simple",
        },
        "django.server": {
            "level": "INFO",
            "class": "logging.StreamHandler",
            "formatter": "django.server",
        },
        "syslog": {
            "level": "DEBUG",
            "class": "logging.handlers.SysLogHandler",
            "formatter": "syslog",
            "address": "/dev/log",
            "facility": SysLogHandler.LOG_LOCAL2,
        },
        # Logging to a file
        # "logfile": {
        #     "level":"DEBUG",
        #     "class":"logging.handlers.RotatingFileHandler",
        #     "filename": "/var/log/weblate/weblate.log",
        #     "maxBytes": 100000,
        #     "backupCount": 3,
        #     "formatter": "logfile",
        # },
    },
    "loggers": {
        "django.request": {
            "handlers": ["mail_admins", DEFAULT_LOG],
            "level": "ERROR",
            "propagate": True,
        },
        "django.server": {
            "handlers": ["django.server"],
            "level": "INFO",
            "propagate": False,
        },
        # Logging database queries
        # "django.db.backends": {
        #     "handlers": [DEFAULT_LOG],
        #     "level": "DEBUG",
        # },
        "redis_lock": {"handlers": [DEFAULT_LOG], "level": DEFAULT_LOGLEVEL},
        "weblate": {"handlers": [DEFAULT_LOG], "level": DEFAULT_LOGLEVEL},
        # Logging VCS operations
        "weblate.vcs": {"handlers": [DEFAULT_LOG], "level": DEFAULT_LOGLEVEL},
        # Python Social Auth
        "social": {"handlers": [DEFAULT_LOG], "level": DEFAULT_LOGLEVEL},
        # Django Authentication Using LDAP
        "django_auth_ldap": {"handlers": [DEFAULT_LOG], "level": DEFAULT_LOGLEVEL},
        # SAML IdP
        "djangosaml2idp": {"handlers": [DEFAULT_LOG], "level": DEFAULT_LOGLEVEL},
    },
}

# Remove syslog setup if it's not present
if not HAVE_SYSLOG:
    del LOGGING["handlers"]["syslog"]

# List of machine translations
MT_SERVICES = (
    #     "weblate.machinery.apertium.ApertiumAPYTranslation",
    #     "weblate.machinery.baidu.BaiduTranslation",
    #     "weblate.machinery.deepl.DeepLTranslation",
    #     "weblate.machinery.glosbe.GlosbeTranslation",
    #     "weblate.machinery.google.GoogleTranslation",
    #     "weblate.machinery.googlev3.GoogleV3Translation",
    #     "weblate.machinery.libretranslate.LibreTranslateTranslation",
    #     "weblate.machinery.microsoft.MicrosoftCognitiveTranslation",
    #     "weblate.machinery.microsoftterminology.MicrosoftTerminologyService",
    #     "weblate.machinery.modernmt.ModernMTTranslation",
    #     "weblate.machinery.mymemory.MyMemoryTranslation",
    #     "weblate.machinery.netease.NeteaseSightTranslation",
    #     "weblate.machinery.tmserver.AmagamaTranslation",
    #     "weblate.machinery.tmserver.TMServerTranslation",
    #     "weblate.machinery.yandex.YandexTranslation",
    #     "weblate.machinery.saptranslationhub.SAPTranslationHub",
    #     "weblate.machinery.youdao.YoudaoTranslation",
    "weblate.machinery.weblatetm.WeblateTranslation",
    "weblate.memory.machine.WeblateMemory",
)

# Machine translation API keys

# URL of the Apertium APy server
MT_APERTIUM_APY = None

# DeepL API key
MT_DEEPL_KEY = None

# LibreTranslate
MT_LIBRETRANSLATE_API_URL = None
MT_LIBRETRANSLATE_KEY = None

# Microsoft Cognitive Services Translator API, register at
# https://portal.azure.com/
MT_MICROSOFT_COGNITIVE_KEY = None
MT_MICROSOFT_REGION = None

# ModernMT
MT_MODERNMT_KEY = None

# MyMemory identification email, see
# https://mymemory.translated.net/doc/spec.php
MT_MYMEMORY_EMAIL = None

# Optional MyMemory credentials to access private translation memory
MT_MYMEMORY_USER = None
MT_MYMEMORY_KEY = None

# Google API key for Google Translate API v2
MT_GOOGLE_KEY = None

# Google Translate API3 credentials and project id
MT_GOOGLE_CREDENTIALS = None
MT_GOOGLE_PROJECT = None

# Baidu app key and secret
MT_BAIDU_ID = None
MT_BAIDU_SECRET = None

# Youdao Zhiyun app key and secret
MT_YOUDAO_ID = None
MT_YOUDAO_SECRET = None

# Netease Sight (Jianwai) app key and secret
MT_NETEASE_KEY = None
MT_NETEASE_SECRET = None

# API key for Yandex Translate API
MT_YANDEX_KEY = None

# tmserver URL
MT_TMSERVER = None

# SAP Translation Hub
MT_SAP_BASE_URL = None
MT_SAP_SANDBOX_APIKEY = None
MT_SAP_USERNAME = None
MT_SAP_PASSWORD = None
MT_SAP_USE_MT = True

# Use HTTPS when creating redirect URLs for social authentication, see
# documentation for more details:
# https://python-social-auth-docs.readthedocs.io/en/latest/configuration/settings.html#processing-redirects-and-urlopen
SOCIAL_AUTH_REDIRECT_IS_HTTPS = ENABLE_HTTPS

# Make CSRF cookie HttpOnly, see documentation for more details:
# https://docs.djangoproject.com/en/1.11/ref/settings/#csrf-cookie-httponly
CSRF_COOKIE_HTTPONLY = True
CSRF_COOKIE_SECURE = ENABLE_HTTPS
# Store CSRF token in session
CSRF_USE_SESSIONS = True
# Customize CSRF failure view
CSRF_FAILURE_VIEW = "weblate.trans.views.error.csrf_failure"
SESSION_COOKIE_SECURE = ENABLE_HTTPS
SESSION_COOKIE_HTTPONLY = True
# SSL redirect
SECURE_SSL_REDIRECT = ENABLE_HTTPS
SECURE_SSL_HOST = SITE_DOMAIN
# Sent referrrer only for same origin links
SECURE_REFERRER_POLICY = "same-origin"
# SSL redirect URL exemption list
SECURE_REDIRECT_EXEMPT = (r"healthz/$",)  # Allowing HTTP access to health check
# Session cookie age (in seconds)
SESSION_COOKIE_AGE = 1000
SESSION_COOKIE_AGE_AUTHENTICATED = 1209600
SESSION_COOKIE_SAMESITE = "Lax"
# Increase allowed upload size
DATA_UPLOAD_MAX_MEMORY_SIZE = 50000000
# Allow more fields for case with a lot of subscriptions in profile
DATA_UPLOAD_MAX_NUMBER_FIELDS = 2000

# Apply session coookie settings to language cookie as ewll
LANGUAGE_COOKIE_SECURE = SESSION_COOKIE_SECURE
LANGUAGE_COOKIE_HTTPONLY = SESSION_COOKIE_HTTPONLY
LANGUAGE_COOKIE_AGE = SESSION_COOKIE_AGE_AUTHENTICATED * 10
LANGUAGE_COOKIE_SAMESITE = SESSION_COOKIE_SAMESITE

# Some security headers
SECURE_BROWSER_XSS_FILTER = True
X_FRAME_OPTIONS = "DENY"
SECURE_CONTENT_TYPE_NOSNIFF = True

# Optionally enable HSTS
SECURE_HSTS_SECONDS = 31536000 if ENABLE_HTTPS else 0
SECURE_HSTS_PRELOAD = ENABLE_HTTPS
SECURE_HSTS_INCLUDE_SUBDOMAINS = ENABLE_HTTPS

# HTTPS detection behind reverse proxy
SECURE_PROXY_SSL_HEADER = None

# URL of login
LOGIN_URL = f"{URL_PREFIX}/accounts/login/"

# URL of logout
LOGOUT_URL = f"{URL_PREFIX}/accounts/logout/"

# Default location for login
LOGIN_REDIRECT_URL = f"{URL_PREFIX}/"

# Anonymous user name
ANONYMOUS_USER_NAME = "anonymous"

# Reverse proxy settings
IP_PROXY_HEADER = "HTTP_X_FORWARDED_FOR"
IP_BEHIND_REVERSE_PROXY = False
IP_PROXY_OFFSET = 0

# Sending HTML in mails
EMAIL_SEND_HTML = True

# Subject of emails includes site title
EMAIL_SUBJECT_PREFIX = f"[{SITE_TITLE}] "

# Enable remote hooks
ENABLE_HOOKS = True

# By default the length of a given translation is limited to the length of
# the source string * 10 characters. Set this option to False to allow longer
# translations (up to 10.000 characters)
LIMIT_TRANSLATION_LENGTH_BY_SOURCE_LENGTH = True

# Use simple language codes for default language/country combinations
SIMPLIFY_LANGUAGES = True

# Render forms using bootstrap
CRISPY_ALLOWED_TEMPLATE_PACKS = "bootstrap3"
CRISPY_TEMPLATE_PACK = "bootstrap3"

# List of quality checks
# CHECK_LIST = (
#     "weblate.checks.same.SameCheck",
#     "weblate.checks.chars.BeginNewlineCheck",
#     "weblate.checks.chars.EndNewlineCheck",
#     "weblate.checks.chars.BeginSpaceCheck",
#     "weblate.checks.chars.EndSpaceCheck",
#     "weblate.checks.chars.DoubleSpaceCheck",
#     "weblate.checks.chars.EndStopCheck",
#     "weblate.checks.chars.EndColonCheck",
#     "weblate.checks.chars.EndQuestionCheck",
#     "weblate.checks.chars.EndExclamationCheck",
#     "weblate.checks.chars.EndEllipsisCheck",
#     "weblate.checks.chars.EndSemicolonCheck",
#     "weblate.checks.chars.MaxLengthCheck",
#     "weblate.checks.chars.KashidaCheck",
#     "weblate.checks.chars.PunctuationSpacingCheck",
#     "weblate.checks.format.PythonFormatCheck",
#     "weblate.checks.format.PythonBraceFormatCheck",
#     "weblate.checks.format.PHPFormatCheck",
#     "weblate.checks.format.CFormatCheck",
#     "weblate.checks.format.PerlFormatCheck",
#     "weblate.checks.format.JavaScriptFormatCheck",
#     "weblate.checks.format.LuaFormatCheck",
#     "weblate.checks.format.ObjectPascalFormatCheck",
#     "weblate.checks.format.SchemeFormatCheck",
#     "weblate.checks.format.CSharpFormatCheck",
#     "weblate.checks.format.JavaFormatCheck",
#     "weblate.checks.format.JavaMessageFormatCheck",
#     "weblate.checks.format.PercentPlaceholdersCheck",
#     "weblate.checks.format.VueFormattingCheck",
#     "weblate.checks.format.I18NextInterpolationCheck",
#     "weblate.checks.format.ESTemplateLiteralsCheck",
#     "weblate.checks.angularjs.AngularJSInterpolationCheck",
#     "weblate.checks.icu.ICUMessageFormatCheck",
#     "weblate.checks.icu.ICUSourceCheck",
#     "weblate.checks.qt.QtFormatCheck",
#     "weblate.checks.qt.QtPluralCheck",
#     "weblate.checks.ruby.RubyFormatCheck",
#     "weblate.checks.consistency.PluralsCheck",
#     "weblate.checks.consistency.SamePluralsCheck",
#     "weblate.checks.consistency.ConsistencyCheck",
#     "weblate.checks.consistency.TranslatedCheck",
#     "weblate.checks.chars.EscapedNewlineCountingCheck",
#     "weblate.checks.chars.NewLineCountCheck",
#     "weblate.checks.markup.BBCodeCheck",
#     "weblate.checks.chars.ZeroWidthSpaceCheck",
#     "weblate.checks.render.MaxSizeCheck",
#     "weblate.checks.markup.XMLValidityCheck",
#     "weblate.checks.markup.XMLTagsCheck",
#     "weblate.checks.markup.MarkdownRefLinkCheck",
#     "weblate.checks.markup.MarkdownLinkCheck",
#     "weblate.checks.markup.MarkdownSyntaxCheck",
#     "weblate.checks.markup.URLCheck",
#     "weblate.checks.markup.SafeHTMLCheck",
#     "weblate.checks.placeholders.PlaceholderCheck",
#     "weblate.checks.placeholders.RegexCheck",
#     "weblate.checks.duplicate.DuplicateCheck",
#     "weblate.checks.source.OptionalPluralCheck",
#     "weblate.checks.source.EllipsisCheck",
#     "weblate.checks.source.MultipleFailingCheck",
#     "weblate.checks.source.LongUntranslatedCheck",
#     "weblate.checks.format.MultipleUnnamedFormatsCheck",
#     "weblate.checks.glossary.GlossaryCheck",
# )

# List of automatic fixups
# AUTOFIX_LIST = (
#     "weblate.trans.autofixes.whitespace.SameBookendingWhitespace",
#     "weblate.trans.autofixes.chars.ReplaceTrailingDotsWithEllipsis",
#     "weblate.trans.autofixes.chars.RemoveZeroSpace",
#     "weblate.trans.autofixes.chars.RemoveControlChars",
# )

# List of enabled addons
# WEBLATE_ADDONS = (
#     "weblate.addons.gettext.GenerateMoAddon",
#     "weblate.addons.gettext.UpdateLinguasAddon",
#     "weblate.addons.gettext.UpdateConfigureAddon",
#     "weblate.addons.gettext.MsgmergeAddon",
#     "weblate.addons.gettext.GettextCustomizeAddon",
#     "weblate.addons.gettext.GettextAuthorComments",
#     "weblate.addons.cleanup.CleanupAddon",
#     "weblate.addons.cleanup.RemoveBlankAddon",
#     "weblate.addons.consistency.LangaugeConsistencyAddon",
#     "weblate.addons.discovery.DiscoveryAddon",
#     "weblate.addons.autotranslate.AutoTranslateAddon",
#     "weblate.addons.flags.SourceEditAddon",
#     "weblate.addons.flags.TargetEditAddon",
#     "weblate.addons.flags.SameEditAddon",
#     "weblate.addons.flags.BulkEditAddon",
#     "weblate.addons.generate.GenerateFileAddon",
#     "weblate.addons.generate.PseudolocaleAddon",
#     "weblate.addons.generate.PrefillAddon",
#     "weblate.addons.json.JSONCustomizeAddon",
#     "weblate.addons.xml.XMLCustomizeAddon",
#     "weblate.addons.properties.PropertiesSortAddon",
#     "weblate.addons.git.GitSquashAddon",
#     "weblate.addons.removal.RemoveComments",
#     "weblate.addons.removal.RemoveSuggestions",
#     "weblate.addons.resx.ResxUpdateAddon",
#     "weblate.addons.yaml.YAMLCustomizeAddon",
#     "weblate.addons.cdn.CDNJSAddon",
# )

# E-mail address that error messages come from.
SERVER_EMAIL = "noreply@example.com"

# Default email address to use for various automated correspondence from
# the site managers. Used for registration emails.
DEFAULT_FROM_EMAIL = "noreply@example.com"

# List of URLs your site is supposed to serve
ALLOWED_HOSTS = ["*"]

# Configuration for caching
CACHES = {
    "default": {
        "BACKEND": "django_redis.cache.RedisCache",
        "LOCATION": "redis://127.0.0.1:6379/1",
        # If redis is running on same host as Weblate, you might
        # want to use unix sockets instead:
        # "LOCATION": "unix:///var/run/redis/redis.sock?db=1",
        "OPTIONS": {
            "CLIENT_CLASS": "django_redis.client.DefaultClient",
            "PARSER_CLASS": "redis.connection.HiredisParser",
            # If you set password here, adjust CELERY_BROKER_URL as well
            "PASSWORD": None,
            "CONNECTION_POOL_KWARGS": {},
        },
        "KEY_PREFIX": "weblate",
        "TIMEOUT": 3600,
    },
    "avatar": {
        "BACKEND": "django.core.cache.backends.filebased.FileBasedCache",
        "LOCATION": os.path.join(CACHE_DIR, "avatar"),
        "TIMEOUT": 86400,
        "OPTIONS": {"MAX_ENTRIES": 1000},
    },
}

# Store sessions in cache
SESSION_ENGINE = "django.contrib.sessions.backends.cache"
# Store messages in session
MESSAGE_STORAGE = "django.contrib.messages.storage.session.SessionStorage"

# REST framework settings for API
REST_FRAMEWORK = {
    # Use Django's standard `django.contrib.auth` permissions,
    # or allow read-only access for unauthenticated users.
    "DEFAULT_PERMISSION_CLASSES": [
        # Require authentication for login required sites
        "rest_framework.permissions.IsAuthenticated"
        if REQUIRE_LOGIN
        else "rest_framework.permissions.IsAuthenticatedOrReadOnly"
    ],
    "DEFAULT_AUTHENTICATION_CLASSES": (
        "rest_framework.authentication.TokenAuthentication",
        "weblate.api.authentication.BearerAuthentication",
        "rest_framework.authentication.SessionAuthentication",
    ),
    "DEFAULT_THROTTLE_CLASSES": (
        "weblate.api.throttling.UserRateThrottle",
        "weblate.api.throttling.AnonRateThrottle",
    ),
    "DEFAULT_THROTTLE_RATES": {"anon": "100/day", "user": "5000/hour"},
    "DEFAULT_PAGINATION_CLASS": "weblate.api.pagination.StandardPagination",
    "PAGE_SIZE": 50,
    "VIEW_DESCRIPTION_FUNCTION": "weblate.api.views.get_view_description",
    "UNAUTHENTICATED_USER": "weblate.auth.models.get_anonymous",
}

# Fonts CDN URL
FONTS_CDN_URL = None

# Django compressor offline mode
COMPRESS_OFFLINE = False
COMPRESS_OFFLINE_CONTEXT = [
    {"fonts_cdn_url": FONTS_CDN_URL, "STATIC_URL": STATIC_URL, "LANGUAGE_BIDI": True},
    {"fonts_cdn_url": FONTS_CDN_URL, "STATIC_URL": STATIC_URL, "LANGUAGE_BIDI": False},
]

# Require login for all URLs
if REQUIRE_LOGIN:
    LOGIN_REQUIRED_URLS = (r"/(.*)$",)

# In such case you will want to include some of the exceptions
# LOGIN_REQUIRED_URLS_EXCEPTIONS = (
#    rf"{URL_PREFIX}/accounts/(.*)$",  # Required for login
#    rf"{URL_PREFIX}/admin/login/(.*)$",  # Required for admin login
#    rf"{URL_PREFIX}/static/(.*)$",  # Required for development mode
#    rf"{URL_PREFIX}/widgets/(.*)$",  # Allowing public access to widgets
#    rf"{URL_PREFIX}/data/(.*)$",  # Allowing public access to data exports
#    rf"{URL_PREFIX}/hooks/(.*)$",  # Allowing public access to notification hooks
#    rf"{URL_PREFIX}/healthz/$",  # Allowing public access to health check
#    rf"{URL_PREFIX}/api/(.*)$",  # Allowing access to API
#    rf"{URL_PREFIX}/js/i18n/$",  # JavaScript localization
#    rf"{URL_PREFIX}/contact/$",  # Optional for contact form
#    rf"{URL_PREFIX}/legal/(.*)$",  # Optional for legal app
#    rf"{URL_PREFIX}/avatar/(.*)$",  # Optional for avatars
# )

# Silence some of the Django system checks
SILENCED_SYSTEM_CHECKS = [
    # We have modified django.contrib.auth.middleware.AuthenticationMiddleware
    # as weblate.accounts.middleware.AuthenticationMiddleware
    "admin.E408"
]

# Celery worker configuration for testing
# CELERY_TASK_ALWAYS_EAGER = True
# CELERY_BROKER_URL = "memory://"
# CELERY_TASK_EAGER_PROPAGATES = True
# Celery worker configuration for production
CELERY_TASK_ALWAYS_EAGER = False
CELERY_BROKER_URL = "redis://localhost:6379"
CELERY_RESULT_BACKEND = CELERY_BROKER_URL

# Celery settings, it is not recommended to change these
CELERY_WORKER_MAX_MEMORY_PER_CHILD = 200000
CELERY_BEAT_SCHEDULER = "django_celery_beat.schedulers:DatabaseScheduler"
CELERY_TASK_ROUTES = {
    "weblate.trans.tasks.auto_translate*": {"queue": "translate"},
    "weblate.accounts.tasks.notify_*": {"queue": "notify"},
    "weblate.accounts.tasks.send_mails": {"queue": "notify"},
    "weblate.utils.tasks.settings_backup": {"queue": "backup"},
    "weblate.utils.tasks.database_backup": {"queue": "backup"},
    "weblate.wladmin.tasks.backup": {"queue": "backup"},
    "weblate.wladmin.tasks.backup_service": {"queue": "backup"},
    "weblate.memory.tasks.*": {"queue": "memory"},
}

# CORS allowed origins
CORS_ALLOWED_ORIGINS = []
CORS_URLS_REGEX = r"^/api/.*$"

# Enable plain database backups
DATABASE_BACKUP = "plain"

# Enable auto updating
AUTO_UPDATE = False

# PGP commits signing
WEBLATE_GPG_IDENTITY = None

# Third party services integration
MATOMO_SITE_ID = None
MATOMO_URL = None
GOOGLE_ANALYTICS_ID = None
SENTRY_DSN = None
SENTRY_ENVIRONMENT = SITE_DOMAIN
AKISMET_API_KEY = None

管理命令#

備註

不同使用者下運行管理命令而不是一人運行您的 web 服務器，可以導致文件得到錯誤的權限，更多細節請查看文件系統權限。

您會找到基本的管理命令（作為Django 源中的:file:./manage.py 來獲得它，或者作為可安裝在Weblate 頂層的腳本調用:command:weblate 中的擴展組來獲得它）。

Invoking management commands#

如上面所提到的，以用依賴於您如何安裝 Weblate。

如果使用 Virtualenv 來運行 Weblate，那麼您可以或者為 weblate 指定全路徑，或者在調用前激活 virtualenv ：

# Direct invocation
~/weblate-env/bin/weblate

# Activating virtualenv adds it to search path
. ~/weblate-env/bin/activate
weblate

如果您直接使用原始碼（來源於 tarball 或 Git checkout ），管理腳本可以在 Weblate 源文件的 ./manage.py 中獲得。要運行它：

python ./manage.py list_versions

If you’ve installed Weblate using the pip installer, or by using the ./setup.py script, the weblate is installed to your path (or virtualenv path), from where you can use it to control Weblate:

weblate list_versions

對於 Docker 映像，腳本向上面一樣安裝，您可以使用 docker exec 來運行：

docker exec --user weblate <container> weblate list_versions

對於 docker-compose，過程是相似的，您只是必須使用 docker-compose exec ：

docker-compose exec --user weblate weblate weblate list_versions

在您需要向它傳遞文件的情況下，您可以臨時添加卷：

docker-compose exec --user weblate /tmp:/tmp weblate weblate importusers /tmp/users.json

也參考

安裝/ docker，:doc:westal / Venv-debian`，:doc:westall / Venv-suse`

add_suggestions#

weblate add_suggestions <project> <component> <language> <file>#

從文件導入翻譯，來作為給定翻譯的建議來使用。它跳過了複製翻譯的步驟；只會添加不同的內容。

--author USER@EXAMPLE.COM#: 建議的作者電子郵箱地址。這個使用者必須在導入前存在（您可以根據需要在管理界面建立一個）。

例：

weblate --author michal@cihar.com add_suggestions weblate application cs /tmp/suggestions-cs.po

auto_translate#

weblate auto_translate <project> <component> <language>#

在 4.6 版本變更: Added parameter for translation mode.

根據其他組件翻譯進行自動翻譯。

--source PROJECT/COMPONENT#: 指定組件，用作可獲得翻譯的來源。如果不指定，將使用項目中的所有組件。

--user USERNAME#: 指定列出的使用者名，作為翻譯的作者。如果不指定那麼使用“匿名使用者”。

--overwrite#: 是否去覆蓋現有的翻譯。

--inconsistent#: 是否去覆蓋現有的不一致的翻譯（請參見不一致）。

--add#: 如果給定的翻譯不存在，自動添加語言。

--mt MT#: 實用機器翻譯而不是其他組件作為機器翻譯。

--threshold THRESHOLD#: 用於機器翻譯的相似性閾值，預設為 80。

--mode MODE#: Specify translation mode, default is translate but fuzzy or suggest can be used.

例：

weblate auto_translate --user nijel --inconsistent --source weblate/application weblate website cs

也參考

自動翻譯

celery_queues#

weblate celery_queues#

在 3.7 版本新加入.

顯示 Celery 任務隊列的長度。

checkgit#

weblate checkgit <project|project/component>#

打印後端 Git 倉儲的當前狀態。

您可以確定或者哪個項目或組件要更新（例如 weblate/application ），或者使用 --all 來更新所有現有組件。

commitgit#

weblate commitgit <project|project/component>#

將任何可能待定的更改提交給後端 Git 倉儲。

You can either define which project or component to update (for example weblate/application), or use --all to update all existing components, or use --file-format to filter based on the file format.

commit_pending#

weblate commit_pending <project|project/component>#

提交早於給定時間段的待定更改。

您可以確定或者哪個項目或組件要更新（例如 weblate/application ），或者使用 --all 來更新所有現有組件。

--age HOURS#: 時間段以小時為單位。如果不指定，則使用在組件配置中配置的值。

備註

這由 Weblate 在後台自動執行，所以實際不需要手動調用，除了要強制早於組件配置指定的執行。

也參考

執行維護事項, COMMIT_PENDING_HOURS

cleanuptrans#

weblate cleanuptrans#

清理無主的檢查和翻譯建議。這通常不需要手動運行，因為清理在後台自動啟動。

也參考

執行維護事項

cleanup_ssh_keys#

weblate cleanup_ssh_keys#

在 4.9.1 版本新加入.

Performs cleanup of stored SSH host keys:

Removes deprecated RSA keys for GitHub which might cause issues connecting to GitHub.
Removes duplicate entries in host keys.

也參考

SSH 倉儲

createadmin#

weblate createadmin#

除非指定，否則用隨機密碼建立 admin 賬戶。

--password PASSWORD#: 在命令行提供密碼，而不要生成隨機的。

--no-password#: 不要設置密碼，這對`–update`可能有用。

--username USERNAME#: 使用給定的姓名而不是 admin。

--email USER@EXAMPLE.COM#: 指定 admin 的電子郵箱地址。

--name#: 指定 admin 的姓名（可見的）。

--update#: 更新現有的使用者（您可以用這個來更改密碼）。

dump_memory#

weblate dump_memory#

將包含 Weblate 翻譯記憶庫內容的 JSON 文件導出。

也參考

翻譯記憶, Weblate Translation Memory Schema

dumpuserdata#

weblate dumpuserdata <file.json>#

Dumps userdata to a file for later use by importuserdata.

提示

這在遷移或合併 Weblate 事例是會很方便。

import_demo#

weblate import_demo#

在 4.1 版本新加入.

依據 <https://github.com/WeblateOrg/demo> 建立一個 Demo 專案與組件。請確認 Celery 已先啟用在執行此命令前。

這在開發 Weblate 時會有用。

import_json#

weblate import_json <json-file>#

根據 JSON 數據批量導入組件。

導入的 JSON 文件結構非常符合組件對象（請參見 GET /api/components/(string:project)/(string:component)/ ）。您必須包括 name 和 filemask 字段。

--project PROJECT#: 指定從哪裡導入組件。

--main-component COMPONENT#: 對所有的使用來自這個組件的給定版本控制系統（VCS ）倉儲。

--ignore#: 跳過（已經）導入的組件。

--update#: 更新（已經）導入的組件。

JSON 文件的例子：

[
  {
    "slug": "po",
    "name": "Gettext PO",
    "file_format": "po",
    "filemask": "po/*.po",
    "new_lang": "none"
  },
  {
    "name": "Android",
    "filemask": "android/values-*/strings.xml",
    "template": "android/values/strings.xml",
    "repo": "weblate://test/test",
    "file_format": "aresource"
  }
]

也參考

import_memory

import_memory#

weblate import_memory <file>#

將 TMX 或 JSON 文件導入 Weblate 翻譯記憶庫。

--language-map LANGMAP#

允許將 TMX 的語言映射到 Weblate 翻譯記憶庫。語言代碼通常在 Weblate 進行規範化之後映射。

例如 --language-map en_US:en 將所有 en_US 字串作為 en 字串來導入。

在您的 TMX 文件地區恰好與您在Weblate使用地區不同的情況下，這會有用。

也參考

翻譯記憶, Weblate Translation Memory Schema

import_project#

weblate import_project <project> <gitrepo> <branch> <filemask>#

在 3.0 版本變更: import_project 命令現在基於組件探索插件，導致一些行為的更改，並接受一些參數。

Batch imports components into project based on the file mask.

<project> 將已存在的項目命名，組件將導入其中。

<gitrepo> 確定了要使用的 Git 倉儲的 URL，而 <branch> 說明了 Git 分支。為了從現有的 Weblate 組件導入另外的翻譯組件，使用 <gitrepo> 的 weblate://<project>/<component> URL。

<filemask> 為倉儲定義了文件發現。或者可以使用通配符來使它簡單，或者可以使用正則表達式的全部功能。

簡單的匹配對組件名稱使用 **，對語言使用 *，例如： **/*.po

正則表達式必須包含組命名的 component 和 language。例如： (?P<language>[^/]*)/(?P<component>[^-/]*)\.po

根據文件，導入與現有的組件匹配，並且添加不存在的那些。它不更改已經存在的那些。

--name-template TEMPLATE#

使用 Django 模板語法來定制組件的名稱。

例如： Documentation: {{ component }}

--base-file-template TEMPLATE#

為單語言翻譯定制譯文模板文件。

例如： {{ component }}/res/values/string.xml

--new-base-template TEMPLATE#

為另外新的翻譯定制譯文模板文件。

例如： {{ component }}/ts/en.ts

--file-format FORMAT#: 您還可以使用的文件格式（請參見：支持的文件格式），預設為自動檢測。

--language-regex REGEX#: 您可以使用這個參數指定語言過濾器（請參見：組件配置）。它必須是合法的正則表達式。

--main-component#: 您可以指定選擇哪個組件作為主要的一個——即真正包含版本控制系統（VCS ）倉儲的那個。

--license NAME#: 指定整體、項目或組件翻譯的許可。

--license-url URL#: 指定翻譯許可所在的 URL。

--vcs NAME#: 在需要指定使用哪個版本的輕質系統的情況下，您可以在這裡進行。預設版本控制是 Git。

為了給出一些例子，讓我們導入兩個項目。

第一個是 Debian 手冊翻譯，那裡的每種語言都有各自的文件夾，裡面有每個章節的翻譯：

weblate import_project \
    debian-handbook \
    git://anonscm.debian.org/debian-handbook/debian-handbook.git \
    squeeze/master \
    '*/**.po'

然後 Tangaguru 工具，那裡需要指定文件格式和譯文模板文件，並且指定所有組件和翻譯如何位於單一一個文件夾中：

weblate import_project \
    --file-format=properties \
    --base-file-template=web-app/tgol-web-app/src/main/resources/i18n/%s-I18N.properties \
    tanaguru \
    https://github.com/Tanaguru/Tanaguru \
    master \
    web-app/tgol-web-app/src/main/resources/i18n/**-I18N_*.properties

更複雜的例子是關於解析文件名而從文件名中得到正確的組件和語言，像 src/security/Numerous_security_holes_in_0.10.1.de.po：

weblate import_project \
    tails \
    git://git.tails.boum.org/tails master \
    'wiki/src/security/(?P<component>.*)\.(?P<language>[^.]*)\.po$'

篩選出指定的語言的翻譯：

./manage import_project \
    --language-regex '^(cs|sk)$' \
    weblate \
    https://github.com/WeblateOrg/weblate.git \
    'weblate/locale/*/LC_MESSAGES/**.po'

導入 Sphinx 文件，分成多個文件：

$ weblate import_project --name-template 'Documentation: %s' \
    --file-format po \
    project https://github.com/project/docs.git master \
    'docs/locale/*/LC_MESSAGES/**.po'

導入 Sphinx 文件，分成多個文件和文件夾：

$ weblate import_project --name-template 'Directory 1: %s' \
    --file-format po \
    project https://github.com/project/docs.git master \
    'docs/locale/*/LC_MESSAGES/dir1/**.po'
$ weblate import_project --name-template 'Directory 2: %s' \
    --file-format po \
    project https://github.com/project/docs.git master \
    'docs/locale/*/LC_MESSAGES/dir2/**.po'

也參考

更多具體的例子可以在通過國際化來開始章節找到，另外您會想要使用 import_json。

importuserdata#

weblate importuserdata <file.json>#

Imports user data from a file created by dumpuserdata.

importusers#

weblate importusers --check <file.json>#

從 Django auth_users 資料庫的 JSON 轉儲中導入使用者。

--check#: 使用這個選項可以檢查給定文件是否可以被導入，並且報告使用者名或電子郵箱地址可能導致的衝突。

可以從現有的 Django 安裝中導出使用者，這需要使用：

weblate dumpdata auth.User > users.json

install_addon#

在 3.2 版本新加入.

weblate install_addon --addon ADDON <project|project/component>#

將附加組件安裝到一組組件中。

--addon ADDON#: 要安裝的附加組件名稱。例如 weblate.gettext.customize。

--configuration CONFIG#: JSON encoded configuration of an add-on.

--update#: Update the existing add-on configuration.

可以或者定義將附加組件安裝到哪個項目或組件中（例如 weblate/application），或者使用 --all 來包括所有現有的組件。

為所有的組件安裝自訂 gettext 輸出：

weblate install_addon --addon weblate.gettext.customize --config '{"width": -1}' --update --all

也參考

附加元件

list_languages#

weblate list_languages <locale>#

列出 MediaWiki 標記中支持的語言——語言代碼、英語名稱和本地化名稱。

這用來生成 <https://wiki.l10n.cz/Slovn%C3%ADk_s_n%C3%A1zvy_jazyk%C5%AF>.

list_translators#

weblate list_translators <project|project/component>#

對給定的項目列出為這種語言做出貢獻的譯者:

[French]
Jean Dupont <jean.dupont@example.com>
[English]
John Doe <jd@example.com>

--language-code#: 用語言代碼而不是語言來列出名稱。

可以或者定義使用哪個項目或組件（例如 weblate/application），或者使用 --all 從所有現存的組件中列出翻譯者。

list_versions#

weblate list_versions#

列出所有 Weblate 依賴及其版本。

loadpo#

weblate loadpo <project|project/component>#

從磁盤重新加載翻譯（例如您在版本控制系統（VCS ）倉儲完成一些更新的情況下）。

--force#: 強制更新，即使文件應該是更新的。

--lang LANGUAGE#: 將處理限制為單一語言。

您可以確定或者哪個項目或組件要更新（例如 weblate/application ），或者使用 --all 來更新所有現有組件。

備註

極少調用這個，Weblate 將對每一次版本控制系統（VCS ）更新自動加載更改的文件。在您手動更改下層 Weblate 版本控制系統（VCS ）倉儲的情況下，或在更新後的一些特殊情況下才需要這個。

lock_translation#

weblate lock_translation <project|project/component>#

防止進一步翻譯組件。

提示

在您想要對下層倉儲進行一些維護時有用。

您可以確定或者哪個項目或組件要更新（例如 weblate/application ），或者使用 --all 來更新所有現有組件。

也參考

unlock_translation

move_language#

weblate move_language source target#

在 3.0 版本新加入.

允許您合併語言內容。當更新到新版本，這個新版本對使用 (generated) 前綴建立的之前未知的語言包含別名時，這會有用。它將所有內容從 source 語言移動到 target 語言。

例：

weblate move_language cze cs

移動內容後，您應該檢查是否有什麼落下了（這是因為有人在同時更新倉儲而導致的競爭情況），並且要刪除 (generated) 語言。

pushgit#

weblate pushgit <project|project/component>#

將執行的更改推送到上游版本控制系統（VCS ）倉儲。

--force-commit#: 在推送前，強制執行任何待定的更改。

您可以確定或者哪個項目或組件要更新（例如 weblate/application ），或者使用 --all 來更新所有現有組件。

備註

如果開啟了組件配置中的:ref:component-push_on_commit，Weblate 會自動推送更改，這是預設的。

unlock_translation#

weblate unlock_translation <project|project/component>#

將給定的組件解鎖，使它能夠被翻譯。

提示

在您想要對下層倉儲進行一些維護時有用。

您可以確定或者哪個項目或組件要更新（例如 weblate/application ），或者使用 --all 來更新所有現有組件。

也參考

lock_translation

setupgroups#

weblate setupgroups#

配置預設的組，並可選地將所有使用者指定到那個預設組中。

--no-privs-update#: 關閉對現有組的自動更新（只添加新的）。

--no-projects-update#: 防止對現有項目的組的自動更新。這允許將新添加的組加入到現有項目中，請參見專案存取控制。

也參考

特殊權限列表與內建角色

setuplang#

weblate setuplang#

將 Weblate 中的確定語言的列表更新。

--no-update#: 關閉現有語言的自動更新（只添加新的）。

updatechecks#

weblate updatechecks <project|project/component>#

對所有字串更新所有檢查。

提示

對檢查進行主要更改的更新是有用的。

您可以確定或者哪個項目或組件要更新（例如 weblate/application ），或者使用 --all 來更新所有現有組件。

updategit#

weblate updategit <project|project/component>#

取回遠程版本控制系統（VCS ）倉儲並更新內部緩存。

您可以確定或者哪個項目或組件要更新（例如 weblate/application ），或者使用 --all 來更新所有現有組件。

備註

通常最好在倉儲中配置鉤子，來觸發通知掛勾，而不是常規的通過 updategit 來投票。

公告#

在 4.0 版本變更: 在此前的發佈版本中，這個特性被稱為白板消息。

通過張貼網站範圍的，每個項目、組件或語言的公告，向翻譯者提供信息。

宣布翻譯的目的、截止期限、狀態或特定目標。

使用者可以接收到關注項目公告的通知（除非使用者選擇關閉）。

這會用於從發佈網站的目的到指定翻譯的目標的各種事情。

可以使用 Post announcement，在 Manage 菜單的每一屆張貼公告：

圖片顯示一個公告在控制面板上，其公告內文為：當達到 60% 以上其翻譯才會被使用。

還可以使用管理界面添加：

然後根據特定的語境顯示公告：

無指定的語境

顯示在控制面版上（登錄頁面）。

特定項目

項目內顯示，包括其所有的組件和翻譯。

特定組件

對於給定的組件機器翻譯來顯示。

特定語言

顯示語言的全景和該語言的全部翻譯。

這就是語言全景頁面上的樣子：

圖片顯示一個公告在 Czech 語言摘要上，其內容為："Czech translators rock!"。

組件列表#

指定多個列表的組件，出現在使用者控制面板上作為選項，從用使用者可以選擇一個作為預設視圖。請參見控制面板來了解更多信息。

提示

控制面板上出現的每個組件列表都會顯示狀態。

可以在管理界面的 Component lists 部分指定組件列表的名稱和內容。每種組件列表必須名稱來顯示給使用者，並具有標識串將其顯示在 URL 中。

提示

從管理界面檢查匿名使用者的控制面板設置，修改掉控制面本顯示給未授權使用者的內容。

自動化組件列表#

通過建立 Automatic component list assignment 規則，根據其標識串自動將組件添加到列表中。

對於維護大型安裝的逐漸列表有用，或者如果您希望在 Weblate 安裝中有一個包含所有組件的組件列表。

提示

製作組件列表，包含自己的 Weblate 安裝時的所有組件。

1. Define Automatic component list assignment with ^.*$ as regular expression in both the project and the component fields, as shown on this image:

Optional Weblate modules#

可以獲得幾個可選的模塊來配置您的設置。

Git 導出器#

使用 HTTP(S) 為您提供對底層 Git 倉儲的只讀訪問。

安裝#

將 weblate.gitexport 添加到 settings.py 中安裝的 apps 中：

INSTALLED_APPS += ("weblate.gitexport",)

通過安裝後遷移資料庫，將現有的倉儲導出：

weblate migrate

Usage#

模塊自動鉤入 Weblate，並且在組件配置中設置導出倉儲 URL。倉儲在 Weblate URL的 /git/ 部分下是可以訪問的，例如 https://example.org/git/weblate/main/。

公共可用項目的倉儲可以被克隆而無需認證：

git clone 'https://example.org/git/weblate/main/'

對存儲庫的受限制的訪問（使用`Private` access control 或在:setting:REQUIRE_LOGIN 處於啟用狀態時）需要一個API 令牌，獲取位置在您的:ref: user-profile <user-profile>:

git clone 'https://user:KEY@example.org/git/weblate/main/'

提示

成員或 Users 使用者組與匿名使用者預設通過 Access repository 和 Power user 角色訪問公開項目。

帳單#

這用在 Hosted Weblate 上來確定付費套餐，跟踪收據和使用限制。

安裝#

1. Add weblate.billing to installed apps in settings.py:

INSTALLED_APPS += ("weblate.billing",)

運行資料庫遷移，來可選地為模塊安裝另外的資料庫結構：

weblate migrate

Usage#

安裝後您可以在管理界面控制賬單。允許了賬單的使用者將在他們的使用者個人檔案中得到新的 Billing 標籤。

賬單模塊額外允許項目管理員不是超級使用者的情況下去新建新的項目和組件（請參見添加翻譯項目和組件）。當後面的條件滿足是這是可能的：

賬單在其配置的限制下（任何過度的使用都會阻止新建項目/組件），並且被支付（如果價格為非零值的話）
使用者是現有的帶有賬單項目的管理員，或者使用者是賬單的所有者（當為使用者新建新的賬單，而允許導入新的項目時，後者是必要的）。

在新建項目時，使用者在訪問多個賬單的情況下，能夠選擇將項目記在哪個賬單上。

法律#

這用在 Hosted Weblate 上，來提供所需的法律文件。它開始時提供空白文件，會希望您填充文件中後面的模板：

legal/documents/tos.html: 服務條款文件
legal/documents/privacy.html: Privacy policy document
legal/documents/summary.html: 服務條款與隱私政策的簡短概況

On changing the terms of service documents, please adjust LEGAL_TOS_DATE so that users are forced to agree with the updated documents.

備註

可以在這個 Git 倉儲 <https://github.com/WeblateOrg/wllegal/tree/main/wllegal/templates/legal/documents> 中獲取 Hosted Weblate 的法律文件。

這些很可能對您沒有直接的用處，但如果調整來滿足您的需求時，以此作為起點可能會比較方便。

安裝#

1. Add weblate.legal to installed apps in settings.py:

INSTALLED_APPS += ("weblate.legal",)

# Optional:

# Social auth pipeline to confirm TOS upon registration/subsequent sign in
SOCIAL_AUTH_PIPELINE += ("weblate.legal.pipeline.tos_confirm",)

# Middleware to enforce TOS confirmation of signed in users
MIDDLEWARE += [
    "weblate.legal.middleware.RequireTOSMiddleware",
]

運行資料庫遷移，來可選地為模塊安裝另外的資料庫結構：

weblate migrate

編輯 weblate/legal/templates/legal/ 文件夾中的而法律文件，與您的服務匹配。

Usage#

安裝並編輯後，法律文件顯示在 Weblate UI 中。

頭像#

頭像在服務器端下載並緩存，來減少對預設服務的網站的洩露。通過為其配置的電子郵件地址來取回頭像的內建支持，可以使用 ENABLE_AVATARS 來關閉。

Weblate currently supports:

也參考

個人頭像快取, AVATAR_URL_PREFIX, ENABLE_AVATARS

針對垃圾郵件的保護#

您可以免受使用者發送垃圾郵件的侵擾，方法是使用 Akismet 服務。

安裝`akismet` python模塊（這已包含在官方Docker Image中）。
獲取 Akismet API 密鑰。
將其存儲為：設置：akismet_api_key`或：envvar：`weblate_akismet_api_key in docker。

以下內容被發送到AkisMet進行檢查：

Suggestions from unauthenticated users
Project and component descriptions and links

備註

這（除了其它事情以外）依賴於客戶端的 IP 地址，適當的配置請參見：在反向代理後面運行。

也參考

在反向代理後面運行, AKISMET_API_KEY, WEBLATE_AKISMET_API_KEY

簽署 GnuPG 的 Git 承諾#

在 3.1 版本新加入.

所有的承諾可以由 Weblate 時間的 GnuPG 密鑰簽署。

1. Turn on WEBLATE_GPG_IDENTITY. (Weblate will generate a GnuPG key when needed and will use it to sign all translation commits.)

這個特性需要安裝 GnuPG 2.1 或更新版。

您可以在 DATA_DIR 中找到密鑰，而公鑰顯示在“關於”頁面上：

2. Alternatively you can also import existing keys into Weblate, just set HOME=$DATA_DIR/home when invoking gpg.

也參考

WEBLATE_GPG_IDENTITY

頻次限制#

在 3.2 版本變更: 頻次限制先擇接受更細粒度的配置。

在 4.6 版本變更: 速率限制不再適用於超級使用者。

Weblate 的一些操作受到頻次限制。在 RATELIMIT_WINDOW 的秒數內最多允許 RATELIMIT_ATTEMPTS 次數的嘗試。然後阻止使用者 RATELIMIT_LOCKOUT 時間。還有指定範圍的設置，例如 RATELIMIT_CONTACT_ATTEMPTS 或 RATELIMIT_TRANSLATE_ATTEMPTS。下面的表格是可用範圍的完整列表。

後面的操作受到頻次限制：

名稱	範圍	允許的嘗試	頻次限制窗口	鎖定時間
註冊	`REGISTRATION`	5	300	600
將消息發送給管理員	`MESSAGE`	2	300	600
Password authentication on sign in	`LOGIN`	5	300	600
網站範圍的搜索	`SEARCH`	6	60	60
Translating	`TRANSLATE`	30	60	600
Adding to glossary	`GLOSSARY`	30	60	600
Starting translation into a new language	`LANGUAGE`	2	300	600
Creating new project	`PROJECT`	5	600	600

If a user fails to sign in AUTH_LOCK_ATTEMPTS times, password authentication will be turned off on the account until having gone through the process of having its password reset.

這個設定也可被使用在 Docker 容器中，透過添加 WEBLATE_ 前綴字在設定名稱前。如： RATELIMIT_ATTEMPTS 可使用 WEBLATE_RATELIMIT_ATTEMPTS。

API 具有另外的速率限制設置，請參見 API 頻次限制。

也參考

頻次限制, 在反向代理後面運行, API 頻次限制

Fedora Messaging integration#

Fedora Messaging是基於AMQP的發佈者，用於Weberate中發生的所有變化。您可以在使用此操作中掛鉤正在發生的更改的其他服務。

Fedora Messaging Integration可作為單獨的Python模塊``weblate-fedora-messaging``。請參閱<https://github.com/weblateorg/fedora_messaging/>用於設置說明。

定制 Weblate#

使用 Django 和 Python 擴展與定制。將您的更改貢獻給上游，使每人都能夠受益。這降低了您的維護成本； Weblate 中的代碼對更改內部界面或重構編碼時的情況。

警告

內部界面與模板都不被認為是穩定的 API。請對每次升級都複查自己的定制，接口或其語義可能未經通知就進行更改。

也參考

為 Weblate 做貢獻

建立 Python 模塊#

如果不熟悉 Python，您可以查看 Python For Beginners，它解釋了其基本內容並指向了高級教程。

To write a file with custom Python code (called a module), a place to store it is needed, either in the system path (usually something like /usr/lib/python3.9/site-packages/) or in the Weblate directory, which is also added to the interpreter search path.

在 3.8-5 版本新加入: When using Docker, you can place Python modules in /app/data/python/ (see Docker 容器 volumes), so they can be loaded by Weblate, for example from a settings override file.

更好地是，將您的定制化轉變為適當的 Python 包：

為您的包建立文件夾（我們會使用 weblate_customization ）。

在裡面新建`setup.py` 文件來描述包：

from setuptools import setup

setup(
    name="weblate_customization",
    version="0.0.1",
    author="Your name",
    author_email="yourname@example.com",
    description="Sample Custom check for Weblate.",
    license="GPLv3+",
    keywords="Weblate check example",
    packages=["weblate_customization"],
)

建立定制代碼的 Python 模塊（也被成為 weblate_customization ）的文件夾。
在裡面建立 __init__.py 文件來確認 Python 可以導入模塊。
現在可以使用 pip install -e 安裝這個包。更多信息可以在 Editable installs 中找到。
模塊一旦安裝，就可以用在 Webalte 配置中（例如 weblate_customization.checks.FooCheck ）。

Your package structure should look like this:

weblate_customization
├── setup.py
└── weblate_customization
    ├── __init__.py
    ├── addons.py
    └── checks.py

可以在 <https://github.com/WeblateOrg/customize-example> 找到定制 Weblate 的例子，它涵蓋了下面描述的所有題目。

替換 logo 中#

建立簡單的 Django app 來包含想要覆蓋的靜態文件（請參見建立 Python 模塊）。

品牌出現在後面的文件中：

icons/weblate.svg
導航條中顯示的 Logo。

logo-*.png
根據屏幕分辨率和 web 瀏覽器的 Web 圖標。

favicon.ico
傳統瀏覽器使用的 Web 圖標。

weblate-*.png
機器人或匿名使用者使用的頭像。一些 Web 瀏覽器使用這些作為快捷圖標。

email-logo.png
在通知電子郵件中使用。

加入到 INSTALLED_APPS :

INSTALLED_APPS = (
    # Add your customization as first
    "weblate_customization",
    # Weblate apps are here…
)

運行 weblate collectstatic --noinput，來收集提供給客戶端的靜態文件。

也參考

How to manage static files (e.g. images, JavaScript, CSS), 靜態檔案服務

自訂的質量檢查、附加元件和自動修復#

要在 Weblate 中安裝您的自訂自動修正，撰寫自定義查核或 Writing add-on 代碼：

將文件放進您的包含 Weblate 定制的 Python 模塊中（請參見建立 Python 模塊）。
在專用設置（ WEBLATE_ADDONS 、 CHECK_LIST 或 AUTOFIX_LIST ）中將其完全合法的路徑添加到 Python 類中：

# Checks
CHECK_LIST += ("weblate_customization.checks.FooCheck",)

# Autofixes
AUTOFIX_LIST += ("weblate_customization.autofix.FooFixer",)

# Add-ons
WEBLATE_ADDONS += ("weblate_customization.addons.ExamplePreAddon",)

也參考

自訂自動修正、撰寫自定義查核、 Writing add-on 、 Executing scripts from add-on

管理介面#

管理界面在 :file:`/manage/`下面提供管理設置。它對於具有管理特權的登錄使用者是可用的，通過使用右上角的扳手圖標來訪問：

它包括您 Weblate 的基本視圖：

支援狀態，參閱從 Weblate 獲得支持
備份，請參見備份和移動 Weblate
Shared translation memory, see 翻譯記憶
性能報告，來複查 Weblate 的健康狀況和 Celery 隊列的長度
SSH keys management, see SSH 倉儲
所有組件的警報概述，見翻譯組件警告

Django 管理界面#

警告

Use with caution as this is a low level interface. You should not need it in most cases as most things are comfortably approachable through Weblate UI or API.

可以在這裡管理資料庫中存儲的對象，如使用者、翻譯和其他設置：

在 Reports 部分，可以檢查網站的狀態，為生產設置進行調整，或者管理用於訪問的 SSH 密鑰訪問存儲庫。

管理任意部分下的資料庫對象。最有趣的也許是 Weblate translations，您可以在這裡管理可翻譯的項目，請參見項目配置和組件配置。

Weblate languages 保持語言定義，在語言定義中進一步解釋。

加入一個專案#

添加項目作為所有組件的容器。通常可以為一部分軟件或圖書（各自參數的信息請參見項目配置）來建立一個項目：

也參考

項目配置

雙語言組件#

一旦添加了一個項目，就可以添加翻譯組件了。（關於各自參數的信息，請參見組件配置）：

也參考

組件配置, 雙語和單語格式

單語言組件#

為了使這些翻譯更容易，提供了模板文件，包含了各自源語言的對應信息 ID （通常為英語）。（對於各自參數的信息，請參見組件配置）：

也參考

組件配置, 雙語和單語格式

從 Weblate 獲得支持#

Weblate 擁有非盈利版權的開源軟件，由社區支持。訂購者接受優先支持而無需額外的費用。預付方式可以使軟件包被每個人獲得。您可以在 <https://weblate.org/support/>，找到關於當前提供的支持的更多信息。

整合支援#

在 3.8 版本新加入.

購買的支持包可以可選地集成在您的 Weblate的`subscription management <https://weblate.org/user/>`_界面中，您可以在那裡找到它的鏈接。關於您的安裝的基本事例的細節，也會以這種方式反饋給 Weblate。

提交給 Weblate 的數據#

配置 Weblate 事件的 URL
Your site title
您運行的 Weblate 版本
您 Weblate 資料庫中一些對象的記錄（項目、組件、語言、源字串和使用者）
您事件的 SSH 公鑰

此外，何時:ref:“發現-Webleate”已開啟：

公共項目列表（名稱，URL和網站）

沒有提交其它數據。

集成服務#

查看您的支持包是否合法
Weblate 支援備份儲存
探索 Weblate

提示

購買的支持包在購買時已經激活，並且不必集成它們就可以使用。

探索 Weblate#

在 4.5.2 版本新加入.

Discover Web2Rate是一個選項服務，使使用者更容易查找WebLate服務器和社區。使用者可以在<https://weblate.org/discover/>上瀏覽註冊服務，並查找有項目貢獻。

Getting listed#

提示

參與發現WebBlate使WebLate提交一些有關您服務器的信息，請參閱:ref:“支持數據”。

要使用活動支持訂閱列出您的服務器（請參閱:ref:“激活 - 支持”）在“發現WebLate”中，您需要執行此操作，請在“管理”面板中：

列出您的服務器，沒有Socation WebBlate中的支持訂閱：

Register yourself at <https://weblate.org/user/>
Register your Weblate server in the discovery database at <https://weblate.org/subscription/discovery/>
確認WebBlate中的服務激活，然後使用以下方式在Web20管理頁面中的發現列表：Guilabel：“啟用發現”按鈕：

Customizing listing#

您可以通過在<https://weblate.org/user/>上提供文本和圖像（570 x 260像素）來自定義列表。

合法文件#

備註

在此，您將找到各種法律信息，您可能需要在某些法律司法管轄區中運營Webleate。它作為指導手段提供，沒有任何準確性或正確性的保證。最終是您有責任確保您使用Weberate符合所有適用的法律法規。

翻譯合規性#

Weblate 符合 REUSE 3.0 規範。

itar和其他出口管制#

Weberate可以在您自己的數據中心或虛擬私有云中運行。因此，它可用於存儲ITAR或其他導出控制信息，但是，最終使用者負責確保這種合規性。

託管的WebBlate服務尚未遵守符合ITAR或其他出口管制，目前尚未提供限制國家/地區訪問權限的能力。

美國加密技術管制#

Web2Rate不包含任何加密代碼，但可能是使用使用加密，數據Integrity和-Confidentiality使用加密的第三方組件的主題導出控件。

Weberate最可能將被分類為ECCN 5D002或5D992，並且作為公開可用的Libre軟件，它不應該受到耳朵（請參閱“加密項目不受耳朵的影響<https://www.bis.doc.gov/index.php /策略 - 指導/加密/ 1-encryption-item-not-project-the-ear>`_）。

Web2使用的軟件組件（僅列出與加密功能相關的組件）：

Python: 參考 https://wiki.python.org/moin/PythonSoftwareFoundationLicenseFaq#Is_Python_subject_to_export_laws.3F
GnuPG: 在 Weblate 非必須使用
Git: 在 Weblate 非必須使用
curl: 為 Git 所使用
OpenSSL: 用python和curl使用

加密密鑰的強度取決於WebBlate和In Interact的第三方組件的配置，但在任何體面設置中它將包括所有導出受限加密功能：

對稱算法超過56位
非對稱算法超過512位的整數的分解
用於非對稱算法的大於512比特的有限場的乘法群中的離散對數的計算
用於非對稱算法的組中的分立對數超過112比特的組中的離散對比度

Webleate沒有任何加密激活功能，但它可以以不涉及加密代碼的方式配置。加密功能包括：

使用安全傳輸協議（HTTPS）訪問遠程服務器
為代碼的提交生成簽名（PGP）

也參考

“出口控制（耳朵）開源軟件<https://www.magicsplat.com/blog/ear/>`_

通過國際化來開始#

有個項目，並想要將其翻譯為幾種語言？這個嚮導會幫您進行。幾種典型的情況展示出來，而多數示例是通用的，並且也可以用於其它情景。

在翻譯任何軟件之前，要認識到世界各處的語言真正不同，而您不應該根據自己的經驗做出任何假設。對於多數語言，如果嘗試從翻譯的段落中連接出句子，看起來會很奇怪。應該正常滴處理複數形式，因為很多語言對此具有復雜的規則，最終使用的國際化框架應該支持它。

最後但並非不重要的，有時將一些文本添加到翻譯的字串中是必要的。想像一下翻譯者要翻譯字串``Sun``。沒有上下文的話多數人會將它翻譯為我們最近的恆星，但它實際上也會用作星期天的縮寫。

選擇國家化框架#

選擇您的平台上任何標準化的，嘗試通過創建自己的框架來處理本地化，來避免重新發明輪子。 Weblate 支持大多數廣泛使用的框架，更多信息請參見 formats`（特別是 :ref:`fmt_capabs）。

我們對一些平台的個人推薦在下面的表格中。這基於我們的經驗，但這無法覆蓋所有的使用情況，因此做選擇時總是要考慮您的環境。

Platform	推薦的格式
Android	Android字串資源
iOS	蘋果 iOS 字串
Qt	Qt Linguist .ts
Python	GNU gettext
PHP	GNU gettext [1]
C/C++	GNU gettext
C#	RESX .NET resource files
Perl	GNU gettext
Ruby	Ruby YAML files
Web 擴展	WebExtension JSON
Java	XLIFF [2]
JavaScript	i18next JSON files [3]

一些格式更具體的工作流程在後面的章節中描述：

也參考

與 Weblate 集成, 持續本地化

與 Weblate 集成#

Weblate 基礎知識#

Project and component structure#

Importing localization project into Weblate#

Weblate 在開發時一直注意將版本管理系統（VCS）作為核心功能。因此，最簡單的方法是授予 Weblate 訪問存儲庫的權限。導入過程將指導您將翻譯配置進組件。

可以替換使用 Weblate 來設置包含所有翻譯的本地倉儲而不合併。

也參考

添加翻譯項目和組件, 如何限制 Weblate 只訪問翻譯，而不向它揭露原始碼？

Fetching updated translations from Weblate#

為了從 Weblate 取回更新的字串，可以簡單地取回基礎的Git倉儲（要么來自文件系統，要么可以通過 git-exporter`來獲得）。在這之前，您會想要提交任何掛起的更改（請參見 :ref:`lazy-commit）。這可以通過（在 Repository maintenance 中）或使用 Weblate 客戶端從命令行來實現。

如果您向 Weblate 授予了對倉儲的推送訪問，並配置了組件配置中的倉儲推送 URL，此操作可以自動進行。見推送 Weblate 的更改。

或者，您可以使用 doc:/api 來更新翻譯以匹配最新版本。

也參考

持續本地化, 推送 Weblate 的更改, 訪問存儲庫

Fetching remote changes into Weblate#

To fetch the strings newly updated in your repository into Weblate, just let it pull from the upstream repository. This can be achieved in the user interface (in the Repository maintenance), or from the command-line using Weblate 客戶端.

這可以通過在您的存儲庫中設置一個 webhook 來自動實現，每當有新的提交時，webhook 就會觸發 Webate。更多細節請參見更新倉儲。

如果您沒在用一個版本管理系統（VCS）集成，可以使用 UI 或 Weblate 的 REST API 來更新翻譯，從而與您的碼基匹配。

也參考

持續本地化, 訪問存儲庫

Adding new strings#

如您的翻譯文件與代碼一起存儲在一個版本控制系統（VCS）中，您很可能有一個現有的工作流供開發人員引入新的字串。任何添加字串的方法都將被採用，但請考慮使用源字串的質量網關以避免引入錯誤。

當翻譯文件與代碼分離時，可以通過以下方法將新字串引入 Weblate。

Manually, using Add new translation string from Tools menu in the source language.
Programmatically, using API POST /api/translations/(string:project)/(string:component)/(string:language)/units/.
通過上傳源文件為:guilabel:Replace existing translation file`（這覆蓋了現有的字串，因此請確定文件包括舊的和新的字串）或:guilabel:`Add new strings，請參見: ref:upload-method。

備註

在WebLate中添加字串的可用性取決於:ref:“Component-Manage_Units`。

Updating target language files#

For monolingual files (see 支持的文件格式) Weblate might add new translation strings not present in the 單語的基底語言檔, and not in actual translations. It does not however perform any automatic cleanup of stale strings as that might have unexpected outcomes. If you want to do this, please install 清理翻譯檔 add-on which will handle the cleanup according to your requirements.

Weblate also will not try to update bilingual files in any way, so if you need po files being updated from pot, you need to do it yourself using Update source strings 導入方法 or using 更新 PO 檔以符合 POT (msgmerge) add-on.

也參考

:ref:“處理”，:ref:“addon-webblate.cleanup.generic`，addon-webblate.cleanup.blank，addon-webblate.resx.update，addon-webblate.gettext.msgmerge

管理版本控制倉儲#

Weblate stores all translation the version control repository. It can be either connected to upstream one, or it can be only internal. The Repository maintenance lets you manipulate with the repository.

提示

With 持續本地化 the repository is automatically pushed whenever there are changes and there is usually no need to manually manipulate with it.

Following operations are available:

Commit

提交在 Weblate 資料庫而不在倉儲中任何未處理的變更，參閱簡易提交。

Push

Pushes changes to the upstream repository, if configured by 倉儲推送 URL.

Update, Pull, Rebase

Updates Weblate repository with upstream changes. It uses 合併類型 when choosing Update or you can choose different one from the dropdown menu.

Lock

鎖定會阻止翻譯者做變更

Reset from Maintenance

Resets any changes done in Weblate to match upstream repository. This will discard all translations done in Weblate and not present in the upstream repository.

Cleanup from Maintenance

從倉儲中移除未追蹤的檔案。這可能為不當的附加元件或 bugs 所造成的結果。

Force synchronization from Maintenance

Forces writing all strings to the translation files. Use this when repository files became out of sync with Weblate for some reason.

也參考

持續本地化, 版本控制整合

使用GNU gettext 來翻譯軟件#

GNU gettext 是自由軟體國際化最廣泛使用的工具之一。它提供了簡單與彈性的方式來進行軟體在地化。它有完善的支援複數格式，可以為翻譯字串增加更多的上下文內容與相當多的工具為它所打造。當然它也有 Weblate 的強力支援（參閱 GNU gettext 檔案格式說明）。

備註

如果打算在私有軟件中使用它，那麼請首先諮詢許可，它可能不適合您。

GNU gettext 可以在大量語言中使用（C、Python、PHP、Ruby、JavaScript 以及更多），並且一些 UI 框架通常已經為它帶有一些支持。標準使用是通過 gettext() 函數調用，這通常具有 _() 別名，使代碼更簡單且更容易閱讀。

此外，它提供 pgettext() 調用而為翻譯者提供另外的文本，以及提供 ngettext()，可以處理目標語言定義的附屬類型。

作為廣泛傳播的工具，它具有很多封裝，使其使用相當簡單，您也許會想嘗試其中之一，例如 intltool，而非下面描述的對 gettext 的手動調用。

工作流程概要#

GNU gettext 使用幾個文件來管理本地化工作：

PACKAGE.pot 包含從您的原始碼中提取的字串，典型地使用 xgettext 或一些高級封裝，如 intltool。
LANGUAGE.po 包含翻譯為單一語言的字串。一旦 PACKAGE.pot 更新，那麼必須由 msgmerge 來更新它。您可以使用 msginit 或在 Weblate 內新建新的語言文件。
LANGUAGE.mo 包含 LANGUAGE.po 的二進製表達，並且應用運行時使用。基本上它並不保持在版本控制之中，但在編譯時使用 msgfmt 生成。如果您想要將它放到版本控制中，可以使用生成 MO 檔附加元件在 Weblate 中產生它。

GNU gettext 總體工作流程看起來像這樣：

也參考

GNU gettext 概覽

示例程序#

使用 gettext 的 C 語言簡單程序看起來會像後面這樣：

#include <libintl.h>
#include <locale.h>
#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    int count = 1;
    setlocale(LC_ALL, "");
    bindtextdomain("hello", "/usr/share/locale");
    textdomain("hello");
    printf(
        ngettext(
            "Orangutan has %d banana.\n",
            "Orangutan has %d bananas.\n",
            count
        ),
        count
    );
    printf("%s\n", gettext("Thank you for using Weblate."));
    exit(0);
}

提取可翻譯的字串#

一旦您具有了使用gettext 調用的代碼，您可以使用`xgettext`_ 從中提取消息，並將它們存儲在`.pot <https://www.gnu.org/software/gettext/manual/gettext.html# index-files_002c-_002epot>`_ 中：

$ xgettext main.c -o po/hello.pot

備註

有另外的程序從代碼中提取字串，例如 pybabel。

這新建了模板文件，您可以用它來開始新的翻譯（使用`msginit`_），或在代碼更改後更新現有的翻譯（為此您將使用 msgmerge）。結果文件是簡單的結構化文本文件：

# SOME DESCRIPTIVE TITLE.
# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER
# This file is distributed under the same license as the PACKAGE package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2015-10-23 11:02+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=CHARSET\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=INTEGER; plural=EXPRESSION;\n"

#: main.c:14
#, c-format
msgid "Orangutan has %d banana.\n"
msgid_plural "Orangutan has %d bananas.\n"
msgstr[0] ""
msgstr[1] ""

#: main.c:20
msgid "Thank you for using Weblate."
msgstr ""

每個 msgid 行定義了要翻譯的字串，在開始的特殊空字串是包含關於翻譯的元數據的文件標頭。

開始新的翻譯#

在模板就位後，我們就可以開始我們的第一個翻譯了：

$ msginit -i po/hello.pot -l cs --no-translator -o po/cs.po
Created cs.po.

剛剛新建的 cs.po 已經有一些信息填充進去了。最重要的是它獲得了所選擇的語言的適當複數形式定義，並且您可以看到幾種複數已經根據它更改了：

# Czech translations for PACKAGE package.
# Copyright (C) 2015 THE PACKAGE'S COPYRIGHT HOLDER
# This file is distributed under the same license as the PACKAGE package.
# Automatically generated, 2015.
#
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2015-10-23 11:02+0200\n"
"PO-Revision-Date: 2015-10-23 11:02+0200\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
"Language: cs\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=ASCII\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=3; plural=(n==1) ? 0 : (n>=2 && n<=4) ? 1 : 2;\n"

#: main.c:14
#, c-format
msgid "Orangutan has %d banana.\n"
msgid_plural "Orangutan has %d bananas.\n"
msgstr[0] ""
msgstr[1] ""
msgstr[2] ""

#: main.c:20
msgid "Thank you for using Weblate."
msgstr ""

這個文件被編譯為優化的二進制形式，.mo 文件，由`GNU gettext`_ 函數在運行時使用。時使用。

更新字串#

一旦在您的程序中添加了更多的字串或更改了一些字串，您再次執行 xgettext，生成模板文件：

$ xgettext main.c -o po/hello.pot

然後您可以更新各自的翻譯文件來匹配新建的模板（這包括重新排序字串，賴於新的模板匹配）：

$ msgmerge --previous --update po/cs.po po/hello.pot

導入到 Weblate#

為了將這樣的翻譯導入 Weblate，當新建組件時，所有需要您定義的是後面的字段（字段的具體描述請參見組件配置）：

Field	Value
源始碼倉儲	您的項目的版本控制系統（VCS）倉儲的 URL
文件掩碼	`po/*.po`
新翻譯的模板	`po/hello.pot`
檔案格式	Choose gettext PO file
新增語言	選擇 :guilabel:`Create new language file`（新建新語言文件）

就是這樣，現在您已經準備號開始翻譯您的軟件了！

也參考

您可以在 GitHub: <https://github.com/WeblateOrg/hello> 上的 Weblate Hello 項目中找到帶有很多語言的 gettext 示例。

使用 Sphinx 翻譯文件#

Sphinx 是創建優美文件的工具。它使用了簡單的 reStructuredText 語法，並以多種格式輸出。如果要找個示例，那麼本文件也是用它來構建的。使用 Sphinx 的非常有用的伴侶是 Read the Docs 服務，它會免費構建並出版您的文件。

我不會聚焦在撰寫文件本身，如果您需要指導的話，只需要按照 Sphinx 網站上的指示即可。一旦準備好文件，將其翻譯是非常容易地，因為 Sphinx 帶有對此的支持，並且在其 Internationalization 中覆蓋得很好。這只不過是一些配置指令並調用 sphinx-intl 工具的事。

如果使用 Read the Docs 服務，那麼可以在 Read the Docs 上開始構建翻譯的文件。它們的 Localization of documentation 幾乎覆蓋了您需要的每一件事——創建另一個項目，設置其語言以及從主項目上鍊接它作為翻譯。

Now all you need is translating the documentation content. Sphinx generates PO file for each directory or top level file, what can lead to quite a lot of files to translate (depending on gettext_compact settings). You can import the index.po into Weblate as an initial component and then configure 組件探索 add-on to automatically discover all others.

組件配置#
組件名稱	`Documentation`
文件掩碼	`docs/locales/*/LC_MESSAGES/index.po`
新翻譯的模板	`docs/locales/index.pot`
檔案格式	gettext PO file
翻譯旗標	`rst-text`

Component discovery configuration#
用來比對出翻譯檔的正則表達式	`docs/locales/(?P<language>[^/.])/LC_MESSAGES/(?P<component>[^/])\.po`
自訂組件名稱	`文件：{{ component\|title }}`
定義新翻譯的基礎檔	`docs/locales/{{ component }}.pot`

提示

您希望 Sphinx 生成只是單一的 PO 文件嗎？從 Sphinx 3.3.0 開始可以實現，使用：

gettext_compact = "docs"

使用這種方法可以發現正在翻譯的幾個文件項目：

使用 Weblate CDN 翻譯 HTML 和 JavaScript#

Starting with Weblate 4.2 it is possible to export localization to a CDN using JavaScript 在地化 CDN add-on.

備註

此功能在託管的Weblate上配置。它需要在安裝時進行額外的配置，見 LOCALIZE_CDN_URL 和 LOCALIZE_CDN_PATH。

在安裝到您的組件中式，它將提交的翻譯推送到 CND（請參見簡易提交），而這些可以在您的 web 頁面上使用來將其本地化。

Creating component#

首先您需要新建單語言組件，它將保持您的字串，其一般指示請參見添加翻譯項目和組件。

In case you have existing repository to start with (for example the one containing HTML files), create an empty JSON file in the repository for the source language (see 來源語言), for example locales/en.json. The content should be {} to indicate an empty object. Once you have that, the repository can be imported into Weblate and you can start with an add-on configuration.

提示

在您已有翻譯的情況下，您可以將其放置在語言 JSON 文件中，而那些將在 Weblate 中使用。

對於那些不想要使用（或不具有）現有倉儲的人，當新建組件時選擇:guilabel:Start from scratch，並選擇`JSON file` 作為文件格式（這是選擇任何單語言格式都可以）。

Configuring Weblate CDN add-on#

The JavaScript 在地化 CDN add-on provides few configuration options.

最低翻譯數: 在這個閾值之上的翻譯將包含在 CDN 中。
CSS 選擇器: 配置來之 HTML 文件的哪些字串是可翻譯的，請參見 String extraction for Weblate CDN 和 HTML localization using Weblate CDN。
語言 Cookie 名稱: 包含使用者所選擇的語言的 cookie 的名稱。在JavaScript 代碼段中用於 HTML localization using Weblate CDN。
從 HTML 檔案擷取字串: 倉儲中文件的列表，或 Weblate 尋找可翻譯字串並提供它們用於翻譯的 URLs，請參見 String extraction for Weblate CDN。

String extraction for Weblate CDN#

翻譯字串必須在 Weblate 中出現。可以手動管理，使用 API 來建立，或使用 Extract strings from HTML files 列出文件或 URL，Weblate 會自動提取它們。文件必須出現在殘酷中，或者包含遠程 URL，由 Weblate下載並規則地分析。

CSS selector 的預設配置提取 CSS class l10n 的元素，例如從後面的一段中提取兩個字串：

<section class="content">
    <div class="row">
        <div class="wrap">
            <h1 class="section-title min-m l10n">Maintenance in progress</h1>
            <div class="page-desc">
                <p class="l10n">We're sorry, but this site is currently down for maintenance.</p>
            </div>
        </div>
    </div>
</section>

在不想修改現有代碼的情況下，還可以使用 * 作為選擇器處理所有元素。

備註

Right now, only text of the elements is extracted. This add-on doesn’t support localization of element attributes or elements with children.

HTML localization using Weblate CDN#

為了將 HTML 文件本地化，需要加載 weblate.js 腳本：

<script src="https://weblate-cdn.com/a5ba5dc29f39498aa734528a54b50d0a/weblate.js" async></script>

加載時，會自動發現所有匹配的翻譯元素（基於 CSS selector ），並用翻譯替換其文本。

從配置的 cookie 檢測到使用者語言，並退回到在瀏覽器中配置的使用者首選語言。

Language cookie name 可以用於與其它應用集成（例如當使用 Django 時選擇 django_language）。

JavaScript localization#

單獨的翻譯在內容分發網絡下揭露為雙語 JSON 文件。要獲取一個，您可以使用以下代碼:

fetch(("https://weblate-cdn.com/a5ba5dc29f39498aa734528a54b50d0a/cs.json")
  .then(response => response.json())
  .then(data => console.log(data));

在這種情況下需要採用實際的本地化邏輯。

本地化函式庫與套件#

Weblate 可以使用 :doc:`/api`整合到您所使用的框架中。此頁面條列了有支援 Weblate 的套件。

提示

您正在為您的框架建立 Weblate 整合工具嗎？歡迎提供您的作品，不論是直接提交 Pull Request 或寄信到 care@weblate.org 讓我們幫您條列在這裡。

翻譯組件警告#

為任何給定的翻譯組件在 Weblate 配置或翻譯項目中顯示錯誤。還提供瞭如何將找到的問題定位的指南。

當前覆蓋後面的內容：

翻譯文件中復制的源字串
翻譯中復制的語言
Merge, update, or push failures in the repository
解析翻譯文件中的錯誤
Billing limits (see 帳單)
Repository containing too many outgoing or missing commits
Missing licenses
運行加載項時錯誤（請參閱:doc:/ admin / addons）
單語翻譯設定錯誤。
Broken 組件配置
破損的 URLs
Unused screenshots
Ambiguous language code
在組件設置中未使用的新基礎
Duplicate file mask used for linked components
Component seems unused

每天更新警報，或相關更改（例如，當:ref:`組件）或更新存儲庫時）。

警告在每個各自組件頁面上列為 Alerts。如果丟失的話，組件會清除所有當前的檢查。警告不能被忽略，但一旦潛在的問題被修復就會消失。

帶有復制的字串和語言的組件看起來像這樣：

也參考

使用定制的證書授權

構建翻譯者社區#

Following these recommendations supports the creation of a full, multilingual post-editing tool. Good translations are defined through the systemic-functional model of House which aims at a contextual correct translation. Write your own post-editing guide and alter these recommendations to fit your own definitions. In most cases the browser-plugin of languageTool is useful as the proof-reading tool.

社群在地化查核列表#

在 3.9 版本新加入.

可以在每個組件的菜單中找到的 :guilabel:`Community localization checklist`（社區本地化清單）可以給予指示，使您的本地化過程對於社區翻譯者更容易。

Terminology management#

Post-editing of MT with terminology assignment influences each level of the translation process. The machine translation system can be adapted to the specific vocabulary and style with a continued training or neural fuzzy repair. Import your existing translation memory into weblate or create an initial scope with your basic terminology. In the end the lector should be instructed with additional terminology documents to guarantee a good knowledge and output in the field.

機器翻譯#

The quality of the automatic translation (often measured with the BLEU-score) correlates with editing time [1]. Choose a machine backend which supports the needed languages and domains. Make clear how the translation backend functions and which quality the post-editor has to expect.

Review translations#

The translations should be reviewed by a second person after the post-editing. With an impartial and competent revisor, the two man rule reduces the errors and improves the quality and consistency of the content.

Structured feedback#

There are many 檢查和修復 in Weblate which provide structured feedback on quality of the translations.

Translation definition#

In addition to the mentalistic and impact-based definitions which make a strong reduction, the text-based linguistic approach fits best with the implemented translation methods. A well-formulated theory for translation evaluation is House’s systemic-functional model, which focuses on the relation between original and translation. The model assumes that translation is an attempt to keep the semantic, pragmatic, and textual meaning of a text equivalent when crossing from one linguistic code to another.

The degree of quality of a translation is based on the degree of equivalence, the correspondence between the text profile and the text function. Because it cannot be calculated automatically, sufficient information should be collected to enable a uniform human evaluation. The two main parameters of agreement in a corresponding model are the macro-context – i.e. embedding in a larger social and literary context – and the micro-context consisting of field, tenor and mode.

原文#

Marina Sanchez-Torron and Philipp Koehn in Machine Translation Quality and Post-Editor Productivity, Figure 1: https://www.cs.jhu.edu/~phi/publications/machine-translation-quality.pdf
Joanna Best und Sylvia Kalina.Übersetzen und Dolmetschen: eine Orientierungs-hilfe. A. Francke Verlag Tübingen und Base, 2002. Möglichkeiten der Übersetzungskritik starting on page number 101
neural fuzzy repair, Bram Bulté and Arda Tezcan in Neural Fuzzy Repair: Integrating Fuzzy Matches into Neural MachineTranslation, 2019 https://aclanthology.org/P19-1175.pdf

管理翻譯#

Adding new strings#

New strings can be made available for translation when they appear in the base file, called 新翻譯的模板 (see 組件配置). If your file format doesn’t require such a file, as is the case with most monolingual translation flows, you can start with empty files).

添加新的翻譯#

在 Weblate 中，當使用者要求時新的語言可以立刻加入，或者新的通知會發送給項目管理員來同一或手動添加。這可以使用組件配置中的:ref:component-new_lang 來實現。

Some formats expect to start with an empty file and only translated strings to be included (for example Android字串資源), while others expect to have all keys present (for example GNU gettext). The document-based formats (for example OpenDocument Format) start with a copy of the source document and all strings marked as needing editing. In some situations this really doesn’t depend on the format, but rather on the framework you use to handle the translation (for example with JSON files).

When you specify 新翻譯的模板 in 組件配置, Weblate uses this file to start new translations. Any existing translations is removed from the file when doing so.

When 新翻譯的模板 is empty and the file format supports it, an empty file is created where new strings are added once they are translated.

The 語言代碼類型 allows you to customize language code used in generated filenames. Additionally, any mappings defined in 語言別名 are applied in reverse.

也參考

加入新翻譯, 新翻譯的模板, 語言代碼類型, 語言碼, 語言別名, 解析語系碼

備註

If you add a language file in connected remote repository, respective translation is added to the component when Weblate updates local repository.

可以在:ref:“更新-VCS”上找到存儲庫更新設置的更多信息。

Removing existing translations#

語言、組件、或是他們所在的專案是可以從每一項目的選單上移除管理 ↓ :guilabel:`移除`（也可透過 Weblate 或是遠端倉儲）。

啟動：Guilabel：“刪除”操作顯示要刪除的組件列表。您必須輸入對象的“SLUG”以確認刪除。“slug`是項目，語言或組件的路徑名，因為它可以在URL中看到它。

如果要刪除一些特定字串，則有以下方法：

手動在源文件中。他們將從翻譯項目中刪除，以及WebLate的存儲庫更新。

在 4.5 版本新加入.

在Webleate的UI通過按鈕：Guilabel：“工具”↓：圭冊：“刪除”在編輯字串時。這在文件格式之間存在差異，請參閱：:ref:“組件 - manage_units`”

備註

如果刪除連接的遠程存儲庫中的語言文件，則當Web2更新本地存儲庫時將從組件中刪除相應的轉換。

可以在:ref:“更新-VCS”上找到存儲庫更新設置的更多信息。

字串變量#

變體可以將幾個字串組合在一起，這樣翻譯人員就可以在一個地方看到字串的所有變體。

提示

縮寫（縮短表格，收縮）是變體的一個很好的例子。

Automated key based variants#

在 3.11 版本新加入.

可以定義正則表達式，基於組件配置的單語言翻譯的鍵將字串分組：

如果 Key 匹配表達式，那麼匹配部分被刪除以生成變體的根鍵。然後，具有相同根鍵的所有字串將成為單個變體組的一部分，也包括具有與根鍵完全匹配的鍵的字串。

後面的表格列出了一些使用示例：

用例	正則表達式變量	匹配的翻譯鍵
後綴標識	`(Short\|Min)$`	`monthShort`、`monthMin`、`month`
單行標識	`#[SML]`	`dial#S.key`、`dial#M.key`、`dial.key`

手動變化#

在 4.5 版本新加入.

可以使用 variant:SOURCE 標記手動連接特定字串。對於沒有鍵將字串自動分組，或將鍵不匹配的字串分組的雙語言翻譯，這是有用的，但應在翻譯時一起考慮。

也可以使用以下授權標籤添加字串的附加變體：“工具”（當時:ref:“Component-Manage_Units`正在打開）：

備註

各種字串必須最長 768 個字符。這是由於 MySQL 資料庫的兼容而導致的技術限制。

也參考

使用標誌自定義行為, 變體

Variants while translating#

當翻譯時變量在後面分組：

字串標籤#

在項目配置中通過文本和顏色將組件翻譯字串分類。

提示

Labels can be assigned to units in 源字串另外的信息 by bulk editing, or using the 大量編輯 add-on.

審查字串中#

活動報告#

活動報告檢查項目、組件或獨立使用者的翻譯的更改。

項目或組件的活動報告可以從其面板上訪問，具體位置在面板的 Info 標籤頁。

更多報告可以在 Insights`標籤上訪問，選擇 :guilabel:`Translation reports。

The activity of the currently signed in user can be seen by clicking on the user name from the user menu on the top right.

源字串的檢查#

There are many 質量檢查, some of them focus on improving the quality of source strings. Many failing checks suggest a hint to make source strings easier to translate. All types of failing source checks are displayed on the source language of every component.

翻譯字串的檢查#

翻譯字串檢查失敗錯誤地指示問題在源字串。翻譯者有時在翻譯中更正錯誤而不是將其匯報——典型的例子是在句子的末尾丟掉句號。

審查所有失敗的檢查可以提供有價值的回饋，進而改善其來源字串。為了使來源字串審查更容易，Weblate 為來源語言自動創建了翻譯，並在那裡向您顯示來源語層級的檢查：

這裡一個最有趣的檢查是多項未通過查核 ——無論何時給定字串的多個翻譯失敗時會觸發它。通常這是要查找的東西，因為這是翻譯者正常翻譯有問題的字串。

具體列表是每種語言的概況：

Receiving source string feedback#

翻譯者可以為翻譯和源字串添加註釋。每個組件配置都可以配置電子郵箱地址來接收這樣的註釋（請參見來源字串臭蟲回報位址），並且使用開發者郵件列表通常是最佳方式。可以以這種方式關注翻譯中出現的問題，處理它們，並迅速修復。

也參考

評註

推動翻譯#

Weblate 提供小程序在網站或其它源上分享，來推動翻譯項目。它還為有很好的歡迎頁面，為新貢獻者給出翻譯的基本信息。此外，可以使用臉書或推特分享與翻譯有關的信息。所有這些可能性可以在 Share 標籤上找到：

所有這些徽章都提供有簡單頁面的鏈接，解釋了使用者如何使用 Weblate 來翻譯：

翻譯進程匯報#

報告特性給出了給定時間內的翻譯進程。提供了任何給定組件相對於時間的貢獻總結。匯報工具可以在任何翻譯組件、項目或面板上的 Insights 中找到：

在這一頁面上有幾個匯報工具可用，所有工具都能夠生成 HTML、reStructuredText 或 JSON格式的輸出。前兩個格式適於將統計數據嵌入現有的文件，而 JSON 用於進一步處理數據。

翻譯者信譽#

生成用於記錄翻譯者信譽的文件——由語言分類，並列出給定語言的所有貢獻者：

* Czech

    * John Doe <john@example.com> (5)
    * Jane Doe <jane@example.com> (1)

* Dutch

    * Jane Doe <jane@example.com> (42)

提示

括號中的數字指示了給定時間內貢獻的次數。

貢獻者統計#

生成根據翻譯者姓名的已翻譯詞與字串的數量：

======================================== ======================================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ========================
Name                                     Email                                    Count total              Source words total       Source chars total       Target words total       Target chars total       Count new                Source words new         Source chars new         Target words new         Target chars new         Count approved           Source words approved    Source chars approved    Target words approved    Target chars approved    Count edited             Source words edited      Source chars edited      Target words edited      Target chars edited
======================================== ======================================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ========================
John Done                                john@example.com                                                1                        3                       24                        3                       21                        1                        3                       24                        3                       21                        0                        0                        0                        0                        0                        0                        0                        0                        0                        0
Jane Done                                jane@example.com                                                2                        5                       25                        4                       28                        2                        3                       24                        3                       21                        0                        0                        0                        0                        0                        0                        0                        0                        0                        0
======================================== ======================================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ======================== ========================

如果您根據工作量來向翻譯者支付報酬，這會很有用，它給出了關於翻譯者工作的各種統計數據。

所有統計數據可以在三個變量中得到：

Total: 編輯的字串的總數。
New: 新翻譯的字串，以前沒有翻譯。
Approved: 在復查流程中同意的字串數量（請參見專門的審核者）。
Edited: 編輯的字串，以前沒有翻譯。

後面是每項內容的計量：

Count: 字串的數量。
Edits: Number of edited characters in the string, measured in Damerau–Levenshtein distance.
`Source words`（源語言單詞）: 源語言字串中單詞的數量。
`Source characters`（源語言字符）: 源語言字串中字符的數量。
`Target words`（目標語言單詞）: 翻譯的字串中單詞的數量。
`Target characters`（目標語言字符）: 翻譯的字串中字符的數量。

為 Weblate 做貢獻#

有幾十種方法來改進 Weblate。您可以選擇一個您覺得舒服的方式，它可以是編碼、圖形設計、文件、贊助，或一個想法：

翻譯 Weblate#

Weblate 持續使用 Weblate 自身進行`translated <https://hosted.weblate.org/>`_。盡您所能，使 Weblate 能以盡可能多的人類語言提供。它讓 Weblate 更接近它的使用者！

如果您在來源字串中找到可能的錯誤，則可以將其標記為Web2編輯器中的註釋。這樣，可以討論和糾正它。如果您確定了，您也可以單擊以下鏈接：Guilabel：“來源字串位置”部分，並以修正提交PR。

Contribute to Weblate documentation#

歡迎您來改進您選擇的文件頁面。點擊符號:guilabel:`編輯在頁面的右上角的github`按鈕上輕鬆進行。

請在寫作時尊重這些指導方針：

如果有效，請勿刪除部分文件。

使用清晰易懂的語言。您正在寫科技作家，而不是一首詩。並非所有Docs讀者都是母語人士，很沉思。

Don’t be afraid to ask if you are not certain. If you have to ask about some feature while editing, don’t change its docs before you have the answer. This means: You change or ask. Don’t do both at the same time.

通過在遵循文件時執行描述的操作來驗證您的更改。

將PR與小塊的更改發送，以便更容易，更快地查看和合併。

如果要重寫並更改大文章的結構，請分兩步執行以下操作：

Rewrite

一旦重寫，審核，拋光和合併，改變另一條公關的段落的結構。

提示

您可以使用docs <https://hosted.weblate.org/projects/weblate/documentation/>`_翻譯。

Extending built-in language definitions#

語言定義是在`webleate-language-data存儲庫中<https://github.com/weblateorg/anguage-data/>`_。

You are welcome to add missing language definitions to languages.csv, other files are generated from that file.

Weblate 討論#

如果您有一個想法，不確定它是否適合問題，請不要擔心。您可以加入“Github討論<https://github.com/weblateorg/weblate/discussions>`_中的社區>`_。

為 Weblate 開發提供資金#

您可以在 donate page`_上助推 Weblate 的開發。收集到的資金用於免費託管自由軟件項目和 Weblate 的進一步開發。籌款目標和資助者的回報等選項，請查看 `donate page。

Supporters who have funded Weblate#

Weblate 支持者列表：

Yashiro Ccs
Cheng-χ at僧
Timon Reinhard
Cassidy James
Loic Dachary
Marozed
https://freedombox.org/
GNU Solidario (GNU Health)
BallotReady
Richard Nespithal
MyExpenses.Mobi
Michael Totschnig

想要加入列表中嗎？請查看 Donate to Weblate 上的選項。

開始為 Weblate 貢獻代碼#

要理解 Weblate 原始碼，請查看 Weblate 原始碼、 Weblate 前端和 Weblate 內部。

Starting with the codebase#

要讓您自己熟悉 Weblate 代碼庫，那麼請查看標記為 good first issue 的那些 bug。

You are welcome to start working on these issues without asking. Just announce that in the issue, so that it’s clear that somebody is working on that issue.

本地運行 Weblate#

開始 Weblate 開發的最舒適的方法是按照從原始碼中安裝。它將給您一個帶有可編輯的 Weblate 原始碼的虛擬環境。

複製 Weblate 原始碼：

git clone https://github.com/WeblateOrg/weblate.git
cd weblate

Create a virtualenv:
```
virtualenv .venv
.venv/bin/activate
```
安裝 Weblate（這需要一些系統依賴，見從原始碼中安裝）：
```
pip install -e .
```

安裝用於開發的所有依賴性：
```
pip install -r requirements-dev.txt
```
Start a development server:
```
weblate runserver
```
取決於配置，您也許想啟動 Celery workers：
```
./weblate/examples/celery start
```
要運行測試（更多細節見本地測試）：
```
. scripts/test-database.sh
./manage.py test
```

也參考

從原始碼中安裝

在 Docker 中本地運行 Weblate#

如果您已經安裝了 Docker 和 Docker -compose，您就可以啟動開發環境，只需運行：

./rundev.sh

它將新建 Docker 影響並啟動它。 Weblate 運行在 <http://127.0.0.1:8080/> 上，並且您可以以 admin 為使用者名， admin 為密碼來登錄。新的安裝是空的，所以您會想要以添加翻譯項目和組件來繼續。

對此，Dockerfile 和 docker-compose.yml 位於本地的 dev-docker 目錄中。

The script also accepts some parameters, to execute tests, run it with the test parameter and then specify any test parameters, for example running only tests in the weblate.machine module:

./rundev.sh test --failfast weblate.machine

備註

小心在運行測試前您的 Docker 容易活動並運行。您可以通過運行 docker ps 命令來檢查。

To display the logs:

./rundev.sh logs

為了停止後台容器，運行：

./rundev.sh stop

運行沒有任何參數的腳本將重建 Docker 容器並重啟動它。

備註

這不是用於生產的合適設置，因它包括幾個不安全的小技巧，但它們會使開發更容易。

Bootstrapping your devel instance#

您會想要使用 import_demo 來新建演示翻譯，並且使用 createadmin 來創建一名管理使用者。

使用 PyCharm 為 Weblate 編寫代碼#

PyCharm 是 Python 的著名 IDE，這裡有一些幫助您在其中建立您的 Weblate 項目的指南。

考慮到您剛剛將 GitHub 存儲庫複製到一個文件夾中，只需使用 PyCharm 打開它。一旦 IDE 打開，第一步要做的是指定您想要使用的解釋器：

可以或者選擇讓 PyCharm 為您創建 virtualenv（虛擬環境），或者選擇已經存在的：

一旦設置了解釋程序不要忘記安裝依賴：要么通過控制台(IDE的控制台預設情況下會直接使用您的 virtualenv)，或者當您得到一個關於缺少依賴項的警告時通過接口。

第二步是設置正確的信息來在 PyCharm 中原生使用 Django：理念是能夠立即觸發 IDE 中的單元測試。為此，您需要指定該 Django 項目的根路徑及其設置路徑：

要小心，Django project root`（Dejango 項目的根）是代碼庫的實際根目錄，而不是 Weblate 子目錄。關於設置，您可以使用來自代碼庫的 :file:`weblate/settings_test.py，您也可以創建自己的設置並在那裡設置它。

最後一步是運行服務器，並將斷點放置在代碼中而能夠調試它。這通過新建新的 Django Server 配置來完成：

提示

小心被稱為 :guilabel:`No reload`的屬性：如果您修改文件，它會阻止服務器被實時重新加載。這允許保留現有的調試器斷點，而它們通常會在重新加載服務器時被丟棄。

Weblate 原始碼#

Weblate 在 GitHub 上開發。歡迎您將代碼分叉並打開拉去請求。同樣歡迎任何形式的補丁。

也參考

查詢 Weblate 內部看看 Weblate 從內部看是什麼樣子的。

Coding guidelines#

編寫 Weblate 的任何代碼應該時刻記得 `Security by Design Principles`_（由設計原理來提供安全性）。

Any code should come with documentation explaining the behavior. Don’t forget documenting methods, complex code blocks, or user visible features.

Any new code should utilize PEP 484 type hints. We’re not checking this in our CI yet as existing code does not yet include them.

Coding standard and linting the code#

代碼應該符合 PEP-8 變成指南，並且應該使用 black 代碼格式化程序來格式化。

為了檢查代碼質量，可以使用 flake8，推薦的插件列在 .pre-commit-config.yaml 中，而其配置放置在 setup.cfg 中。

The easiest approach to enforce all this is to install pre-commit. The repository contains configuration for it to verify the committed files are sane. After installing it (it is already included in the requirements-lint.txt) turn it on by running pre-commit install in Weblate checkout. This way all your changes will be automatically checked.

還能夠手動觸發檢查，來檢查所有文件的運行：

pre-commit run --all

調試 Weblate#

Bugs can behave as application crashes or as various misbehavior. You are welcome to collect info on any such issue and submit it to the issue tracker.

除錯模式#

Turning on debug mode will make the exceptions show in the web browser. This is useful to debug issues in the web interface, but not suitable for a production environment because it has performance consequences and might leak private data.

In a production environment, use ADMINS to receive e-mails containing error reports, or configure error collection using a third-party service.

也參考

停用除錯模式, 合適的管理參數設定, 蒐集錯誤訊息報告

Weblate 日誌#

Weblate can produce detailed logs of what is going on in the background. In the default configuration it uses syslog and that makes the log appear either in /var/log/messages or /var/log/syslog (depending on your syslog daemon configuration).

The Celery process (see 使用 Celery 的後台任務) usually produces its own logs as well. The example system-wide setups logs to several files under /var/log/celery/.

Docker containers log to their output (as per usual in the Docker world), so you can look at the logs using docker-compose logs.

也參考

配置的例子包含 LOGGING 配置。

Not processing background tasks#

A lot of things are done in the background by Celery workers. If things like sending out e-mails or component removal does not work, there might a related issue.

要查核的事項：

Check that the Celery process is running, see 使用 Celery 的後台任務
Check the Celery queue status, either in 管理介面, or using celery_queues
Look in the Celery logs for errors (see Weblate 日誌)

不接收來自 Weblate 的電子郵件#

You can verify whether outgoing e-mail is working correctly by using the sendtestemail management command (see Invoking management commands for instructions on how to invoke it in different environments) or by using 管理介面 under the Tools tab.

These send e-mails directly, so this verifies that your SMTP configuration is correct (see 設定外寄郵件信箱). Most of the e-mails from Weblate are however sent in the background and there might be some issues with Celery involved as well, please see Not processing background tasks for debugging that.

分析應用的崩潰#

In case the application crashes, it is useful to collect as much info about the crash as possible. This can be achieved by using third-party services which can collect such info automatically. You can find info on how to set this up in 蒐集錯誤訊息報告.

無報告的故障#

很多任務寫在到 Celery 進行後台處理。故障不顯示在使用者界面上，但出現在 Celery 的日誌中。配置蒐集錯誤訊息報告會幫助您更容易地註意到這樣的故障。

性能問題#

In case Weblate performs badly in some scenario, please collect the relevant logs showing the issue, and anything that might help figuring out where the code might be improved.

如果有些請求在沒有任何提示的情況下花費了很長時間，您可能想要安裝`dogslow <https://pypi.org/project/dogslow/>`_，附加參數:ref:`collecting-errors`並在錯誤收集工具中獲取精確和詳細的回溯信息。

In case the slow performance is linked to the database, you can also enable logging of all database queries using following configuration after enabling DEBUG:

LOGGING["loggers"]["django.db.backends"] = {"handlers": ["console"], "level": "DEBUG"}

Weblate 內部#

備註

這一章將給出 Weblate 內部的基本概況。

Weblate 從 Django 得到其多數代碼架構，並基於它。

目錄結構#

Weblate 主倉儲目錄結構的速覽：

docs: 本文件的原始碼，可使用 Sphinx 來構建。
dev-docker: 運行開發服務器的 Docker 代碼，請參見在 Docker 中本地運行 Weblate。
weblate: Weblate Django 應用的的原始碼作為，請參見 Weblate 內部。
weblate/static: 客戶端文件（CSS、Javascript 和圖片），請參見 Weblate 前端。

Modules#

Weblate 包括幾個 Django 應用（一些是可選的，請參見 Optional Weblate modules）：

accounts

使用者賬戶、簡介和通知。

addons

微調 Weblate 行為的附加元件，請參見附加元件。

api

基於 Django REST framework 的 API。

auth

認證和權限。

billing

可選的帳單模塊。

checks

翻譯字串質量檢查模塊。

fonts

字體提供檢查模塊。

formats

基於 translate-toolkit 的文件格式抽象層。

gitexport

可選的 Git 導出器模塊。

lang

定義語言和復數模型的模塊。

legal

可選的法律模塊。

machinery

機器翻譯服務的集成。

memory

Built-in translation memory, see 翻譯記憶.

screenshots

屏幕截圖管理與 OCR 模塊。

trans

處理翻譯的主模塊。

utils

各種幫助功能。

vcs

版本控制系統抽象概念。

wladmin

Django 管理界面定制化。

開發附加元件#

附加元件是在 Weblate 中自定義本地化工作流的方法。

class weblate.addons.base.BaseAddon(storage=None)#

Weblate 附加元件的基本類別。

classmethod can_install(component, user)#: Check whether add-on is compatible with given component.

configure(settings)#: Save configuration.

daily(component)#: 每日觸發鉤子。

classmethod get_add_form(user, component, **kwargs)#: Return configuration form for adding new add-on.

get_settings_form(user, **kwargs)#: Return configuration form for this add-on.

post_add(translation)#: Hook triggered after new translation is added.

post_commit(component)#: Hook triggered after changes are committed to the repository.

post_push(component)#: Hook triggered after repository is pushed upstream.

post_update(component, previous_head: str, skip_push: bool)#

在倉儲從上游更新之後觸發鉤子。

參數:

previous_head (str) – 倉儲更新前的 HEAD，在初始克隆時可以是空白的。
skip_push (bool) – Whether the add-on operation should skip pushing changes upstream. Usually you can pass this to underlying methods as commit_and_push or commit_pending.

pre_commit(translation, author)#: Hook triggered before changes are committed to the repository.

pre_push(component)#: 在倉儲推送上游之前觸發鉤子。

pre_update(component)#: 在倉儲從上游更新之前觸發鉤子。

save_state()#: Save add-on state information.

store_post_load(translation, store)#

Hook triggered after a file is parsed.

它接收文件格式類的事件作為參數。

這對修復該文件格式類參數有用，例如，調整文件如何存儲。

unit_pre_create(unit)#: 創建新的單元前觸發的鉤子。

Here is an example add-on:

# Copyright © Michal Čihař <michal@weblate.org>
#
# SPDX-License-Identifier: GPL-3.0-or-later

from django.utils.translation import gettext_lazy as _

from weblate.addons.base import BaseAddon
from weblate.addons.events import EVENT_PRE_COMMIT


class ExampleAddon(BaseAddon):
    # Filter for compatible components, every key is
    # matched against property of component
    compat = {"file_format": {"po", "po-mono"}}
    # List of events add-on should receive
    events = (EVENT_PRE_COMMIT,)
    # Add-on unique identifier
    name = "weblate.example.example"
    # Verbose name shown in the user interface
    verbose = _("Example add-on")
    # Detailed add-on description
    description = _("This add-on does nothing it is just an example.")

    # Callback to implement custom behavior
    def pre_commit(self, translation, author):
        return

Weblate 前端#

前端當前使用 Bootstrap、jQuery 和一些第三方庫來構建。

Supported browsers#

Weblate 支持所有主要瀏覽器和平台的最新的、穩定的版本。

不明確支持使用最新版的 WebKit、Blink 或 Gecko的替換瀏覽器，無論是否直接還是通過平台的 web 視圖 API。然而，Weblate應該（在多數情況下）頁在這些瀏覽器中正常顯示並工作。

其它瀏覽器也能工作，但一些特性會受到限制。

依賴性管理#

The yarn package manager is used to update third party libraries. The configuration lives in scripts/yarn and there is a wrapper script scripts/yarn-update to upgrade the libraries, build them and copy to correct locations in weblate/static/vendor, where all third partly frontend code is located. The Weblate specific code should be placed directly in weblate/static or feature specific subdirectories (for example weblate/static/editor).

添加了新的第三方庫，典型包括：

# Add a yarn package
yarn --cwd scripts/yarn add PACKAGE
# Edit the script to copy package to the static folder
edit scripts/yarn-update
# Run the update script
./scripts/yarn-update
# Add files to git
git add .

編碼風格#

Weblate 依賴於 Prettier 來進行JavaScript 和 CSS 文件的代碼格式化。

我們還是用 ESLint 來檢查 JavaScript 代碼。

在地化#

如果在前端代碼中需要任何使用者可見的文本，那麼應該將其本地化。在多數情況下，所有需要的是將文本打包到 gettext 函數內部，但也有更複雜的特性來使用：

document.write(gettext('this is to be translated'));

var object_count = 1 // or 0, or 2, or 3, ...
s = ngettext('literal for the singular case',
        'literal for the plural case', object_count);

fmts = ngettext('There is %s object. Remaining: %s',
        'There are %s objects. Remaining: %s', 11);
s = interpolate(fmts, [11, 20]);
// s is 'There are 11 objects. Remaining: 20'

也參考

django文件中的翻譯主題

Icons#

Weblate 目前使用 material design 圖標。如果您想找新的符號，檢查 Material Design Icons 或 Material Design Resources。

此外，有 scripts/optimize-svg 來減小 SVG 的大小，因為多數圖標嵌入在 HTML 中，而使路徑有風格。

在 Weblate 中匯報問題#

Weblate issue tracker 託管於 Github。

歡迎報告任何問題，或提出改進建議。我們準備了各種模板，可以輕鬆地指導您完成問題報告。

如果您在 Weblate 中發現了安全問題，請查閱下方的 :ref:`security`部分。

如果您不確定您的錯誤報告或功能請求，您可以嘗試:ref:“討論”。

安全性問題#

為了給予社區實踐來響應併升級，強烈敦促您私下匯報所有的安全問題。 HackerOne 用於處理安全問題，並且而可以在 HackerOne 直接匯報。一旦您在那裡提交它，社區有有限但足夠的時間來解決事件。

另外，可以匯報給 security@weblate.org，最後也會到 HackerOne 上。

If you don’t want to use HackerOne, for whatever reason, you can send the report by e-mail to michal@weblate.org. You can choose to encrypt it using this PGP key 3CB 1DF1 EF12 CF2A C0EE 5A32 9C27 B313 42B7 511D. You can also get the PGP key from Keybase.

備註

Weblate 在很多事情上依賴於第三方組件。如果您發現一個影響這些組件的漏洞，請直接報告給相應的項目。

這些中的一些是：

Weblate 測試套件與連續集成#

測試套件存在於多數當前代碼，通過為任何新的功能添加測試情況來擴大覆蓋範圍，並確認其正常工作。

連續集成#

Current test results can be found on GitHub Actions and coverage is reported on Codecov.

有幾項工作來確認不同的方面：

單元測試
文件構建與外部鏈接
來自所有支持的發佈版本的合併測試
代碼整理
設置確認（確保生成的 dist 文件不丟失任何內容，並可以測試）

CI 的配置在 .github/workflows 目錄中。它重度使用了 ci 目錄中的幫助腳本。腳本還可以手動執行，但它們需要一些環境變量，多數用來定義 Django 設置要使用的文件和資料庫連接。它的示例定義在 scripts/test-database 中：

# Copyright © Michal Čihař <michal@weblate.org>
#
# SPDX-License-Identifier: GPL-3.0-or-later

# Simple way to configure test database from environment

# shellcheck shell=sh

# Database backend to use postgresql / mysql / mariadb
export CI_DATABASE="${1:-postgresql}"

# Database server configuration
export CI_DB_USER=weblate
export CI_DB_PASSWORD=weblate
export CI_DB_HOST=127.0.0.1

# Django settings module to use
export DJANGO_SETTINGS_MODULE=weblate.settings_test

簡單的執行看起來可以像這樣：

. scripts/test-database.sh
./ci/run-migrate
./ci/run-test
./ci/run-docs

本地測試#

如果本地運行測試套件，要使用：

DJANGO_SETTINGS_MODULE=weblate.settings_test ./manage.py test

提示

您會需要使用資料庫（PostgreSQL）服務器來檢測。 Django 預設新建另外的資料庫，以 test_ 前綴來運行測試，因此在您的設置配置使用 weblate 的情況下，測試會使用 test_weblate 資料庫。設置的指示請參見 Weblate 的資料庫設置。

weblate/settings_test.py 也用在 CI 環境中（請參見連續集成），並且可以使用環境變量調整：

# Copyright © Michal Čihař <michal@weblate.org>
#
# SPDX-License-Identifier: GPL-3.0-or-later

# Simple way to configure test database from environment

# shellcheck shell=sh

# Database backend to use postgresql / mysql / mariadb
export CI_DATABASE="${1:-postgresql}"

# Database server configuration
export CI_DB_USER=weblate
export CI_DB_PASSWORD=weblate
export CI_DB_HOST=127.0.0.1

# Django settings module to use
export DJANGO_SETTINGS_MODULE=weblate.settings_test

運行測試前，應該收集靜態文件，因為一些測試在出現時依賴於它們：

DJANGO_SETTINGS_MODULE=weblate.settings_test ./manage.py collectstatic

您也可以指定要運行的各自測試：

DJANGO_SETTINGS_MODULE=weblate.settings_test ./manage.py test weblate.gitexport

提示

測試也可以在開發者 docker 容器內執行，請參見在 Docker 中本地運行 Weblate。

也參考

運行並為 Django寫測試的更多信息請參見 Testing in Django。

數據架構#

Weblate 使用 JSON Schema 來定義外部 JSON 文件的輸入。

Weblate Translation Memory Schema#

https://weblate.org/schemas/weblate-memory.schema.json
type	array
items	The Translation Memory Item
	type	object
	properties
	category	The String Category
		1 是全局的，2 是共享的，10000000+ 是項目特定的，20000000+ 使使用者特定的
		type	integer
		examples	1
		minimum	0
		default	1
	origin	字串源頭
		Filename or component name
		type	string
		examples	test.tmx
			project/component
		default
	source	The Source String
		type	string
		examples	Hello
		minLength	1
		default
	source_language	The Source Language
		ISO 639-1 / ISO 639-2 / IETF BCP 47
		type	string
		examples	en
		pattern	^[^ ]+$
		default
	target	The Target String
		type	string
		examples	Ahoj
		minLength	1
		default
	target_language	The Target Language
		ISO 639-1 / ISO 639-2 / IETF BCP 47
		type	string
		examples	cs
		pattern	^[^ ]+$
		default
	additionalProperties	False
definitions

也參考

翻譯記憶, dump_memory, import_memory

Weblate user data export#

https://weblate.org/schemas/weblate-userdata.schema.json
type	object
properties
基本	Basic
	type	object
	properties
	username	Username
		type	string
		examples	管理
		default
	full_name	Full name
		type	string
		examples	Weblate Admin
		default
	email	E-mail
		type	string
		examples	noreply@example.com
		default
		format	電子信箱
	date_joined	Date joined
		type	string
		examples	2019-11-18T18:53:54.862Z
		default
		format	date-time
	additionalProperties	False
個人檔案	Profile
	type	object
	properties
	language	Language
		type	string
		examples	cs
		pattern	^[^ ]*$
		default
	suggested	Number of suggested strings
		type	integer
		examples	1
		default	0
	translated	Number of translated strings
		type	integer
		examples	24
		default	0
	uploaded	Number of uploaded screenshots
		type	integer
		examples	1
		default	0
	hide_completed	Hide completed translations on the dashboard
		type	boolean
		examples	False
		default	True
	secondary_in_zen	在禪譯模式中顯示第二語言翻譯
		type	boolean
		examples	True
		default	True
	hide_source_secondary	Hide source if a secondary translation exists
		type	boolean
		examples	False
		default	True
	editor_link	Editor link
		type	string
		examples
		pattern	^.*$
		default
	translate_mode	Translation editor mode
		type	integer
		examples	0
		default	0
	zen_mode	禪譯編輯模式
		type	integer
		examples	0
		default	0
	special_chars	Special characters
		type	string
		examples
		pattern	^.*$
		default
	dashboard_view	Default dashboard view
		type	integer
		examples	1
		default	0
	dashboard_component_list	Default component list
		default	null
		anyOf	type	null
			type	integer
	語言	Translated languages
		type	array
		default
		items	Language code
			type	string
			examples	cs
pattern			^.*$
default
secondary_languages	Secondary languages
	type	array
	default
	items	Language code
		type	string
		examples	sk
		pattern	^.*$
		default
已關注	Watched projects
	type	array
	default
	items	Project slug
		type	string
		examples	weblate
		pattern	^.*$
		default
additionalProperties	False
稽核紀錄	Audit log
	type	array
	default
	items	Items
		type	object
		properties
		address	IP address
			type	string
			examples	127.0.0.1
			pattern	^.*$
			default
		user_agent	User agent
			type	string
			examples	PC / Linux / Firefox 70.0
			pattern	^.*$
			default
		時間標記	Timestamp
			type	string
			examples	2019-11-18T18:58:30.845Z
			default
			format	date-time
		activity	Activity
			type	string
			examples	login
			pattern	^.*$
			default
		additionalProperties	False
definitions

也參考

使用者個人檔案, dumpuserdata

發佈 Weblate#

發佈日程#

Weblate 有兩個月的發佈週期，版本（x.y）。

主要版本的更改指示了升級過程不能跳過這個版本——在升級到更高版本的版本 x.y 之前總是必須升級到版本 x.0。

也參考

升級 Weblate

發佈計劃#

到來的版本的特性使用 Github 里程碑來收集，可以在 <https://github.com/WeblateOrg/weblate/milestones> 看到路線圖。

發佈過程#

發佈前要檢查的事情：

由 ./scripts/list-translated-languages 來檢查新翻譯的語言。
由 ./scripts/prepare-release 來設置最終版本。
Make sure screenshots are up to date make -j 12 -C docs update-screenshots.
合併任何可能掛起的翻譯：命令：wlc推動;git遠程更新;git合併起源/ web blate

執行發佈：

創建一個發佈 ./scripts/create-release --tag （要求請參見下面）。

張貼發佈手動步驟：

更新 Docker 圖像。
管理 GitHub 里程碑。
一旦檢測到 Docker 圖像，則添加標籤並推送。
將 Helm 圖表更新到新的版本。
在 .github/workflows/migrations.yml 中包含新的版本，從而在合併監測中覆蓋它。
增加網站下載鏈接中的版本。
由 ./scripts/set-version 在倉儲中增加版本。
Check that readthedocs.org did build all translations of the documentation using ./scripts/rtd-projects.

要使用 ./scripts/create-release 腳本來創建標記的話，需要後面的：

帶有私鑰的 GnuPG 用於為發佈簽名
推送訪問 Weblate git 倉儲（它推送標記）
配置的 hub 工具和訪問，在 Weblate repo 上創建發佈版本
SSH 訪問 Weblate 下載服務器（Weblate 下載複製到那裡）

Security and privacy#

小訣竅

Weblate 以安全為根本，努力維護重視使用者隱私的環境。

Development of Weblate adheres to the Best Practices of the Linux Foundation’s Core Infrastructure Initiative.

也參考

安全性問題

Security updates#

Only the latest release is guaranteed to receive security updates.

Tracking dependencies for vulnerabilities#

Security issues in our dependencies are monitored using Dependabot. This covers the Python and JavaScript libraries, and the latest stable release has its dependencies updated to avoid vulnerabilities.

提示

在第三方庫中可能存在漏洞，不會影響WebLate，因此不會通過釋放釋放的WebLate的錯誤文件來解決這些內容。

Docker 容器安全#

The Docker containers are regularly scanned using Anchore and Trivy security scanners.

這使我們能夠早期檢測漏洞并快速釋放改進。

您可以在GitHub上獲取這些掃描的結果 - 它們以SARIF格式（靜態分析結果交換格式）存儲在我們的CI上的偽影。

也參考

連續集成

Contributing to Weblate modules#

Besides the main repository, Weblate consists of several Python modules. All these follow same structure and this documentation covers them all.

For example, this covers:

wlc, Python client library, see Weblate 客戶端
translation-finder, used to discover translatable files in the repository
language-data, language definitions for Weblate, see 語言定義

Coding guidelines#

編寫 Weblate 的任何代碼應該時刻記得 `Security by Design Principles`_（由設計原理來提供安全性）。

Any code should come with documentation explaining the behavior. Don’t forget documenting methods, complex code blocks, or user visible features.

Any new code should utilize PEP 484 type hints. We’re not checking this in our CI yet as existing code does not yet include them.

測試運行中#

The tests are executed using py.test. First you need to install test requirements:

pip install -r requirements-test.txt

You can then execute the testsuite in the repository checkout:

py.test

也參考

The CI integration is very similar to Weblate 測試套件與連續集成.

Coding standard and linting the code#

代碼應該符合 PEP-8 變成指南，並且應該使用 black 代碼格式化程序來格式化。

為了檢查代碼質量，可以使用 flake8，推薦的插件列在 .pre-commit-config.yaml 中，而其配置放置在 setup.cfg 中。

還能夠手動觸發檢查，來檢查所有文件的運行：

pre-commit run --all

也參考

Weblate 原始碼

關於 Weblate#

項目目標#

Web-based continuous localization tool with tight 版本控制整合 supporting a wide range of file formats, making it easy for translators to contribute.

專案名稱#

「Weblate」由單詞」web」和」translate」融合而來。

專案網站#

The landing page is https://weblate.org and there is a cloud-hosted service at https://hosted.weblate.org. The documentation can be read at https://docs.weblate.org.

項目標識#

The project logos and other graphics are available in https://github.com/WeblateOrg/graphics.

Leadership#

This project is maintained by Michal Čihař, who can be reached at michal@weblate.org.

Authors#

Weblate was started by Michal Čihař. Since its inception in 2012, thousands of people have contributed.

授權#

More detailed licensing information is available in the Weblate source code and follows REUSE 3.0 specification.

發佈本程序希望它有用，但不具有任何質保；甚至沒有應用可銷售性或適於特定目的的質保。更多細節請參見 GNU 一般公共許可。

您應該與本程序一起收到 GNU 一般公共許可的副本。如果沒有的話，請參見 <https://www.gnu.org/licenses/>。

Weblate 4.17#

Released on April 17th 2023.

Allow to filter on language in reports.
Dropped deprecated command cleanup_celery.
Fixed private project visibility for some teams.
Automatic translation now honors target state when translating from other components.
Improved performance of public user profiles.
Improved Sentry performance integration.
Added support for Ed25519 SSH key.
Rewritten metrics storage.
Added support for searching strings by position.
文件改進。
Unchanged translation check can honor untranslatable terms from glossary.
Added automatic fixup for Devanagari danda.
Allow downloading project translation memory per language.
Added new alert on unused components.

All changes in detail.

Weblate 4.16.4#

Released on March 16th 2023.

Dependencies updates.
Improved background tasks scheduling.

All changes in detail.

Weblate 4.16.3#

Released on March 15th 2023.

Improved session handling with project backups.
Dependencies updates.
本地化更新。
文件改進。

All changes in detail.

Weblate 4.16.2#

Released on March 8th 2023.

Fixed searching in the translation memory.
Fixed automatic translation with more services.
Improved rendering of overlapping glossary term matches.
Fixed plurals parsing for non-English source language in some formats.
Added support for go-i18n v2 JSON files.

All changes in detail.

Weblate 4.16.1#

Released on March 1st 2023.

Fixed testsuite error.

All changes in detail.

Weblate 4.16#

Released on March 1st 2023.

Format string checks now also detects duplicated formats.
Improved search performance for some specially formatted strings.
Celery beat is now storing the tasks schedule in the database.
Added support for IBM Watson Language Translator.
Dropped support for VCS integration settings deprecated in 4.14.
Added support for Bitbucket Server pull requests.
Improved conflicts handling in gettext PO files.
Added support for defining strings state when adding via API.
Added support for configuring CORS allowed origins.
Added plurals support to automatic suggestions.

All changes in detail.

Weblate 4.15.2#

Released on January 25th 2023.

Enabled gotext JSON and i18next v4 formats in the default configuration.
Fixed crash on uploading corrupted files.
Show stale directories in Git repository status.

All changes in detail.

Weblate 4.15.1#

Released on January 19th 2023.

Fixed suggestions from automatic translation.
Fixed add-on page crash in some corner cases.
Fixed untranslating template for new translations in some cases.
Documented licensing using REUSE 3.0.
Fixed users pagination on team management.
Improved performance of project creation and saving.
Added support for gotext JSON files.
Added support for i18next v4 files.
Pagination in the API is now customizable.

All changes in detail.

Weblate 4.15#

Released on December 16th 2022.

Added support for browsing changes for a individual string.
Fixed plurals handling in automatic translation from other components.
Added keyboard shortcut Alt+Enter to submit string as a suggestion.
Added support for placeables in the Fluent format.
Improved performance of translation memory.
Autogenerate repoweb browsing links for well known code hosting services.
Improved performance of several views.
Improved listing of strings with plurals.
新增支援自訂 HTML 標記於標頭。
Fixed generation of MO files in the add-on to include only translated files.
Fixed rendering of regular expression flags.
Improved placeholders check behavior with plurals.
Added support for translation files naming suitable for Google Play.
Added support for labels in API.
Added support for choosing different e-mail for commits than for notifications.
The Docker image no longer enables debug mode by default.
Order glossary terms based on the glossary component priority.
Added team administrators who can add or remove members of the team.
Added a popup confirmation before deleting users.
Added add-on to customize XML output.

All changes in detail.

Weblate 4.14.2#

Released on November 5th 2022.

Added support for removing entries from translation memory.
Improved analysis on the duplicate language alert.
Improved accuracy of the consecutive duplicated words check.
Improved scaling of sending many notifications.
Improved string state handling for subtitle translation.
Deprecated insecure configuration of VCS service API keys via _TOKEN/_USERNAME configuration instead of _CREDENTIALS list.
Fixed processing of some uploaded CSV files.
Improved whitespace changes handling in diff display.
Added automatic suggestions management link to management pages.
Track comment removal/resolving in history.
Fixed restoring project backups with linked components.
Fixed captcha entering on unsuccessful registration.
Improved languages support in DeepL.
Improved webhooks compatibility with authenticated repositories.
新增支援 Python 3.11。

All changes in detail.

Weblate 4.14.1#

Released on September 15th 2022.

修復了在某些情況下生成項目備份的問題。
改進了文件上傳的錯誤報告。
在身份驗證期間從 GitHub 獲取所有使用者驗證的電子郵件。
避免在上下文或鍵上匹配詞彙表術語。
添加了刪除字串的通知。
改進了詞彙表中不可翻譯術語的管理。
在團隊管理頁面上列出團隊成員的數量。
增加群組管理介面。
啟用評價后，始終顯示評價統計資訊。
Added searching support in units API.
修復進度條在預覽流程中唯讀字串的顯示。
Improved Burmese punctuation check.
Fixed garbage collecting of metrics data.

所有變化的詳情見。

Weblate 4.14#

於 2022 年 8 月 22 日發佈。

跟踪歷史記錄中的附加更改。
Fixed parsing translation from Windows RC, HTML and text files.
Extended language code style configuration options.
Added support for plurals updated in the recent CLDR releases.
Reduced memory usage while updating components with a lot of translations.
Added support for translation domain in SAP Translation Hub.
Allow absolute links in source string locations.
Improved operation behind some reverse proxies.
Extended API to cover translation memory.
Improved document translation workflow.
Improved reliability of HTML and text files translation.
新增支援專案層級的備份。
Improved performance and memory usage of translation memory lookups.

所有變化的詳情見.

Weblate 4.13.1#

於 2022 年 7 月 1 日發佈。

Fixed tracking suggestions in history.
Fixed parsing reverse proxy info from Cloudflare.
Make parse error lock a component from translating.
Fixed configuring intermediate file in the discovery add-on.
Fixed DeepL translations behavior with placeholders.
Fixed untranslating strings via API.
新增支援透過 API 移除群組中的使用者。
Fixed audit log for user invitation e-mails.
Fixed flag names for Java formatting strings.

All changes in detail.

Weblate 4.13#

於 2022 年 6 月 15 日發佈。

Changed behavior of updating language names.
Added pagination to projects listing.
API for creating new units now returns information about newly created unit.
Component discovery now supports configuring an intermediate language.
Added fixed encoding variants to CSV formats.
Changed handling of context and location for some formats to better fit underlying implementation.
Added support for ResourceDictionary format.
Improved progress bar colors for color blind.
Fixed variants cleanup on string removal.
Compatibility with Django 4.1.
新增支援在 XLIFF 設置 XML 跳脫元件。
Improved formatting of placeholder check errors.
Redirect /.well-known/change-password to /accounts/password/.
Machine translation services are now configurable per project.
新增分開的權限在解決的評論與賦予 Review strings 角色。
Added support for storing alternative translations in the CSV file.
The placeholders check can now be case-insensitive as well.

All changes in detail.

Weblate 4.12.2#

於 2022 年 5 月 11 日發佈。

Fixed rebuilding project translation memory for some components.
Fixed sorting components by untranslated strings.
Fixed possible loss of translations while adding new language.
Ensure Weblate SSH key is generated during migrations.

All changes in detail.

Weblate 4.12.1#

於 2022 年 4 月 29 日發佈。

Fixed pull request message title.
Improved syntax error handling in Fluent format.
Fixed avatar display in notification e-mails.
Add support for web monetization.
Fixed removal of stale source strings when removing translations.

All changes in detail.

Weblate 4.12#

於 2022 年 4 月 20 日發佈。

新增支援 Amharic 在句號不相符。
新增支援 Burmese 在問號不相符。
Extended options of the 偽語系產生 add-on.
Added ignore-all-checks flag to ignore all quality checks on a string.
Avoid 偽語系產生 add-on to trigger failing checks.
新增支援 Gitea pull requests。
Added Linux style language code to 語言代碼類型.
Added support for rebuilding project translation memory.
Improved API for creating components from a file.
Add copy and clone buttons to other translations.
Make merge request message configurable at component level.
Improved maximal length restriction behavior with XML tags.
Fixed loading Fluent files with additional comments.

All changes in detail.

Weblate 4.11.2#

於 2022 年 3 月 4 日發佈。

Fixed corrupted MO files in the binary release.

All changes in detail.

Weblate 4.11.1#

於 2022 年 3 月 4 日發佈。

Fixed missing sanitizing of arguments to Git and Mercurial - CVE-2022-23915, see GHSA-3872-f48p-pxqj for more details.
Fixed loading fuzzy strings from CSV files.
新增支援透過 API 建立團隊。
Fixed user mention suggestions display.
The project tokens access can now be customized.

All changes in detail.

Weblate 4.11#

於 2022 年 2 月 25 日發佈。

Fixes stored XSS - CVE-2022-24710, see GHSA-6jp6-9rf9-gc66 for more details.
Fixed add-on installation using API.
Renamed Strings needing action to Unfinished strings.
Fixed false positives from ICU MessageFormat 語法.
Indicate lock and contributor agreement on other occurrences listing.
Fixed updating PO files with obsolete strings or missing plurals.
Improved squash add-on compatibility with Gerrit.
Automatically initialize user languages based on the Accept-Language header.
Improved error handling on string removal.
Weblate now requires Python 3.7 or newer.
Fixed some write operations with project token authentication.
Fixed string state tracking when the strings changes in the repository.
Track string changes from the repository.
Sticky header on translations listing to improve navigation.
Fixed untranslating strings in Java 屬性.
Fixed Git operation with non-ascii branch names.
New add-on 將原文預先填充進翻譯.
Added Merge without fast-forward 合併類型.
Fixed 自動翻譯 add-on trigger on newly added strings.
Improved punctuation checks for Burmese.
Added support for defining custom teams at project level to grant users access, see 管理單一專案的存取控制.
Added documentation links to alerts.
Docker container automatically enables TLS/SSL for outgoing e-mail when needed.
新增支援透過搜尋已解決的評註。
新增支援 borgbackup 1.2。
Fixed applying of Automatically translated label.

All changes in detail.

Weblate 4.10.1#

於 2021 年 12 月 22 日發佈。

Documented changes introduced by upgrading to Django 4.0.
Fixed displaying of Automatically translated label.
Fixed API display of branch in components with a shared repository.
Improved analysis on the failed push alert.
Fixed manually editing page when browsing changes.
Improved accuracy of 使用 Kashida letter.
The Weblate Docker container now uses Python 3.10.

All changes in detail.

Weblate 4.10#

於 2021 年 12 月 16 日發佈。

Added support for formality and placeholders with DeepL.
Bulk edit and search and replace are now available on project and language level.
Added filtering to search and replace.
Fixed: 「Perform automatic translation」 privilege is no longer part of the Languages group.
「Perform automatic translation」 is in the Administration and the new Automatic translation group.
Fixed generating XLSX files with special chars.
Added ability to the GitHub authentication backend to check if the user belongs to a specific GitHub organization or team.
Improved feedback on invalid parameters passed to API.
Added support for project scoped access tokens for API.
Fixed string removal in some cases.
Fixed translating newly added strings.
Label automatically translated strings to ease their filtering.

All changes in detail.

Weblate 4.9.1#

於 2021 年 11 月 19 日發佈。

Fixed upload of monolingual files after changing template.
Improved handling of whitespace in flags.
Add support for filtering in download API.
Fixed statistics display when adding new translations.
Mitigate issues with GitHub SSH key change.

All changes in detail.

Weblate 4.9#

於 2021 年 11 月 10 日發佈。

Provide more details for events in history.
Improved rendering of history.
Improved performance of the translation pages.
Added support for restricting translation file downloads.
The safe-html can now understand Markdown when used with md-text.
The max-length tag now ignores XML markup when used with xml-text.
Fixed dimensions of rendered texts in 翻譯的最大長度.
Lowered app store title length to 30 to assist with upcoming Google policy changes.
新增支援透過設定 :setting:`SSH_EXTRA_ARGS`自訂 SSH 調用。
Added checks for ICU MessageFormat.
Improved error condition handling in machine translation backends.
Highlight unusual whitespace characters in the strings.
Added option to stay on translated string while editing.
新增支援透過設定 :setting:`BORG_EXTRA_ARGS`自訂 Borg 調用。
Fixed generating of MO files for monolingual translations.
Added API endpoint to download all component translations as a ZIP file.
新增支援 Python 3.10。
新增支援重新發送郵件邀請於管理介面中。

All changes in detail.

Weblate 4.8.1#

於 2021 年 9 月 10 日發佈。

Fixed user removal in Django admin interface.
Document add-on parameters in greater detail.
Fixed JavaScript error in glossary.
Add limit to number of matches in consistency check.
Improve handling of placeholders in machine translations.
修復了使用 API 創建本地版本控制系統（VCS）附加元件。
Added PRIVACY_URL setting to add privacy policy link to the footer.
Hide member e-mail addresses from project admins.
Improved gettext PO merging in case of conflicts.
Improved glossary highlighting.
Improved safe-html flag behavior with XML checks.
Fixed commit messages for linked components.

All changes in detail.

Weblate 4.8#

於 2021 年 8 月 21 日發佈。

Added support for Apple stringsdict format.
The exact search operator is now case-sensitive with PostgreSQL.
Fixed saving glossary explanations in some cases.
文件改進。
性能改進。
Improved squash add-on compatibility with Gerrit.
Fixed adding strings to monolingual glossary components.
Improved performance in handling variants.
Fixed squash add-on sometimes skipping parsing upstream changes.
Preserve file extension for downloads.
Added support for the Fluent format.
Added support for using tabs to indent JSON formats.

All changes in detail.

Weblate 4.7.2#

於 2021 年 7 月 15 日發佈。

Support more language aliases to be configured on a project.
Fixed search string validation in API.
Fixed Git exporter URLs after a domain change.
Fixed cleanup add-on for Windows RC files.
Fixed possible crash in XLIFF updating.

All changes in detail.

Weblate 4.7.1#

於 2021 年 6 月 30 日發佈。

Improved popup for adding terms to glossary.
Added support for LibreTranslate machine translation service.
Added rate limiting on creating new projects.
Improved performance of file updates.

All changes in detail.

Weblate 4.7#

於 2021 年 6 月 17 日發佈。

Improved configuration health check.
Added support for object-pascal-format used in gettext PO, see Object Pascal 格式.
更名為：圭冊：“附近的鑰匙”到：圭冊：“類似的鑰匙”以更好地描述目的。
Added support for mi18n lang files.
Improved SAML authentication integration.
Fixed Gerrit integration to better handle corner cases.
Weblate now requires Django 3.2.
Fixed inviting users when e-mail authentication is disabled.
Improved language definitions.
新增支援停用使用者於專案中貢獻。
Fixed automatic creation of glossary languages.
衍生的附加元件說明文件。
Performance improvements for components with linked repositories.
Added support for free DeepL API.
The user management no longer needs Django admin interface.

所有變化的詳情見.

Weblate 4.6.2#

於 2021 年 5 月 8 日發佈。

修正在專案間移動已分享的組件所造成的失敗。
Fixed adding new strings to empty properties files.
修復了 RTL 語言中的副本圖標對齊。
Extended string statistics on the Info tab.
修復了 Git 中忽略的翻譯文件的處理。
Improved metrics performance.
Fixed possible bug in saving glossaries.
修復了具有不同複數規則的語言的一致性檢查行為。

所有變化的詳情見.

Weblate 4.6.1#

發佈於 2021 年 05 月 02 日。

刪除了過時的垃圾郵件防護代碼。
Improve source plural check accuracy.
更新 Docker 中的使用者界面語言列表。
Improved error messages when creating pull requests.
修復了在 Pagure 上創建合併請求的問題。
修復觸發自動安裝附加元件。
Fixed possible caching issues on upgrade.
Fixed adding new units to monolingual translations using upload.

所有變化的詳情見.

Weblate 4.6#

發佈於 2020 年 04 月 19 日。

Auto_Translate Management命令現在具有用於指定翻譯模式的參數。
新增支援文字檔。
增加了所有對象的趨勢和指標。
新增支援從第二翻譯語言直接複製文字。
新增瀏覽變化時日期過濾。
改進了活動圖表。
現在可以配置聯繫人表格電子郵件的發件人。
Improved parameters validation in component creation API.
速率限制不再適用於超級使用者。
Improved automatic translation add-on performance and reliability.
現在可以在 Docker 容器中自定義速率限制。
用於創建組件的API現在自動使用:ref:“內部URL`。
簡化了列出字串時的狀態提示。
密碼散列現在預設使用Argon2。
簡易的進度條顯示翻譯狀況。
重命名:ref:“addon-webblate.consistency.languages`以澄清目的。
Fixed saving string state to XLIFF.
Added language-wide search.
初步支持:ref:“Docker-Scaling”Docker部署。

所有變化的詳情見.

Weblate 4.5.3#

發佈於 2020 年 04 月 01 日。

修復了指標收集的問題。
Fixed possible crash when adding strings.
修正搜尋字串範例。
修正了替換上傳時可能會丟失新添加的字串的問題。

Weblate 4.5.2#

發佈於 2021 年 03 月 26 日。

Configurable schedule for automatic translation.
Added Lua format check.
忽略以下格式字串:ref:`check-duplicate`檢查。
允許從翻譯頁面上傳截圖。
向存儲庫維護添加了強製文件同步。
修復了代碼較長的語言的自動建議。
Improved performance when adding new strings.
修復了幾處質量檢查中的錯誤。
幾處性能改進。
Added integration with 探索 Weblate.
修復了對只讀字串的檢查行為。

所有變化的詳情見.

Weblate 4.5.1#

發佈於 2021 年 03 月 05 日。

修正了在某些特殊情況下編輯術語表標誌的問題。
擴展指標用法以提高幾頁的性能。
以 TMX 文件存儲正確的源語言。
Better handling for uploads of monolingual PO using API.
Improved alerts behavior on glossary components.
Improved Markdown link checks.
在麵包屑導航中指示詞彙表和源語言。
Paginated component listing of huge projects.
Improved performance of translation, component or project removal.
改進了大量編輯的性能。
固定保留“需要編輯”和“批准”狀態對ODF文件。
Improved interface for customizing translation-file downloads

所有變化的詳情見.

Weblate 4.5#

發佈於 2021 年 02 月 19 日。

Added support for lua-format used in gettext PO.
新增支援在專案間分享組件。
用多種格式標記修復了多個未命名變量檢查行為。
去掉了項目的郵件列表字段，為翻譯者提供通用說明。
Added pseudolocale generation add-on.
Added support for TermBase eXchange files.
新增支援透過標記手動定義字串變數。
Improved performance of consistency checks.
Improved performance of translation memory for long strings.
新增支援搜尋中的解釋說明。
現在可以在雙語格式中添加和刪除字串。
擴展亞馬遜機器翻譯支持的語言。
Automatically enable Java MessageFormat checks for Java Properties.
Added a new upload method to add new strings to a translation.
Added a simple interface to browse translation.
Glossaries are now stored as regular components.
刪除了作為組件API的詞彙表的特定API。
添加了切換一些 flag 的簡化界面。
新增支援無須翻譯或找不到的字詞在詞彙表中。
新增支援定義專有名詞於詞彙表中。
移動文本方向切換以獲取可視鍵盤的更多空間。
Added option to automatically watch projects user-contributed to.
添加了檢查翻譯是否與詞彙表匹配的功能。
新增支援自訂引導文字顏色。

所有變化的詳情見.

Weblate 4.4.2#

發佈於 2021 年 1 月 14 日。

修復了一個發佈的 MO 文件的崩潰問題。

Weblate 4.4.1#

發佈於 2021 年 1 月 13 日。

Fixed reverting plural changes.
修復了展示項目設置幫助。
Improved administration of users.
Improved handling of context in monolingual PO files.
修復了 HTML、ODF、IDML 和 Windows RC 格式的清理附加組件的行為。
Fixed parsing of location from CSV files.
下載文件時使用內容壓縮。
改進了從 ZIP 文件導入的使用者體驗。
Improved detection of file format for uploads.
避免在 Pagure 上複製拉取請求。
Improved performance when displaying ghost translations.
重新實現翻譯編輯器，使用原生瀏覽器文本區。
Fixed cleanup add-on breaking adding new strings.
新增附加元件的 API。

所有變化詳情見.

Weblate 4.4#

發佈於 2020 年 12 月 15 日。

Improved validation when creating a component.
Weblate 現在需要Django 3.1。
新增支援管理介面的自訂顯示功能。
修復了批量編輯時只讀狀態的處理。
Improved CodeMirror integration.
Added add-on to remove blank strings from translation files.
The CodeMirror editor is now used for translations.
為 XML、HTML、Markdown 和 reStructuredText 在翻譯編輯器中語法高亮。
Highlight placeables in translation editor.
改進了對非標準語言代碼的支持。
Added alert when using ambiguous language codes.
添加新的翻譯時，使用者會看到過濾後的語言列表。
擴展了更改歷史的搜索能力。
Improved billing detail pages and Libre hosting workflow.
Extended translation statistics API.
Improved 「other translations」 tab while translating.
添加了任務 API。
Improved performance of file upload.
改進了使用者定義的特殊字符的顯示。
Improved performance of auto-translation.
幾處使用者界面的小改進。
改進了 ZIP 文件下載的命名。
Added option for getting notifications on unwatched projects.

所有變化的詳情見.

Weblate 4.3.2#

發佈於 2020 年 11 月 4 日。

Fixed crash on certain component file masks.
Improved accuracy of the consecutive duplicated words check.
新增支援 Pagure 拉取請求。
Improved error messages for failed registrations.
恢復了將開發者註釋解析為 Markdown 格式。
簡化了預設分支非「master」的Git倉儲的安裝設置。
新建的內部倉儲現在使用主幹作為預設分支。
降低了翻譯重構文本時未更改譯文的誤報率。
修復了一些情況下的 Codemirror 顯示問題。
將範本群組改名為「來源」表明其意義。
修復了路徑較長代碼倉儲的 GitLab 拉取請求。

所有變化的詳情見.

Weblate 4.3.1#

發佈於 2020 年 10 月 21 日。

Improved auto-translation performance.
修復了授權使用者會話到期問題。
新增支援隱藏的版本資訊。
改進了鉤子與 Bitbucket 服務器的兼容性。
Improved performance of translation memory updates.
減少了內存的使用。
Improved performance of Matrix view.
Added confirmation before removing a user from a project.

所有變化的詳情見.

Weblate 4.3#

發佈於 2020 年 10 月 15 日。

包括了 API 中的使用者統計數據。
修復了分頁的頁面上訂購的組件。
為詞彙表確定了語言。
重寫了對 GitHub 和 GitLab 拉取請求的支持。
Fixed stats counts after removing suggestion.
Extended public user profile.
修復了強制檢查的配置。
改進了內建備份的文件。
將源語言屬性從項目移動到組件。
Add Vue I18n formatting check.
一般佔位符的檢查現在支持了正則表達式。
Improved look of Matrix mode.
Machinery is now called automatic suggestions.
增加了與多個GitLab或GitHub實例交互的支持。
擴展了 API 以覆蓋項目更新、單元更新與刪除，以及詞彙表。
單元 API 現在能正常處理多個字串。
組件的新建現在能夠處理上傳的 ZIP 文件或文件。
鞏固了 API 相應狀態代碼。
Support Markdown in contributor agreement.
Improved source strings tracking.
改進了 JSON、YAML 和 CSV 格式兼容性。
新增支援移除字串。
改進了文件下載的性能。
Improved repository management view.
為Android自動啟動 java 格式。
新增支援本地化截圖。
新增支援 Python 3.9。
修復了某些條件下翻譯 HTML 文件。

所有變化的詳情見.

Weblate 4.2.2#

發佈於 2020 年 09 月 02 日。

Fixed matching of source strings for JSON formats.
修復了一些驗證配置的登錄重定向。
修復了使用組同步的LDAP身份驗證。
Fixed crash in reporting automatic translation progress.
修復了啟動預告時的 Git 提交變形。
修復了使用 API 創建本地版本控制系統（VCS）組件。

Weblate 4.2.1#

發佈於 2020 年 08 月 21 日。

修復了在安裝資源中一些區域設置存儲複數。
Fixed crash in the cleanup add-on for some XLIFF files.
允許在 Docker 映像中設置本地化 CDN。

Weblate 4.2#

發佈於 2020 年 8 月 18 日。

改進了使用者頁面並添加了使用者列表。
去掉了從 3.x 版本遷移的支持，從 4.0 或 4.1 遷移。
添加了幾種單語言格式的導出。
改進了活動圖表。
可以配置字串附近顯示的數字。
Added support for locking components experiencing repository errors.
簡化了主導航（用圖表替換按鈕）。
改進了 Google Translate 集成中的語言代碼處理。
Git 變形附加組件可以生成 ``Co-authored-by:``預告。
改進了查詢搜索解析。
改進了格式字串檢查的使用者反饋。
改進了大量的狀態更改的性能。
添加了項目或組件重命名後重定向的兼容性。
為字串的統一、組件的鎖定和許可的更改添加了通知。
為 ModernMT 添加了支持。
允許在文件上傳時避免覆蓋已同意的翻譯。
去掉了一些對兼容 URL 重定向的支持。
Added check for ECMAScript template literals.
Added option to watch a component.
去掉了來自 JSON 單元密鑰的前導的點。
Removed separate Celery queue for translation memory.
Allow translating all components a language at once.
允許配置 Content-Security-Policy HTTP 標頭。
在項目層為語言別名添加支持。
幫助 HTML 或 JavaScript 本地化的新附加組件，請參見 JavaScript 在地化 CDN。
Weblate 域現在在設置中配置，請參見 SITE_DOMAIN。
新增支援透過組件與專案的搜尋。

Weblate 4.1.1#

發佈於 2020 年 06 月19 日。

修復了 Docker 中更改自動修復或附加元件配置。
修復了在“關於”頁面中可能的崩潰。
改進了字節編譯的區域設置文件的安裝。
修復了向詞彙表添加單詞。
修復了機器翻譯的鍵盤快捷鍵。
刪除了一些設置中導致丟失日誌事件的調試輸出。
修復了在項目列表中所定指示。
修復了一些設置中列出 GPG 密鑰。
為需要使用的 DeepL API 版本添加了選項。
為作為 SAML 服務提供商添加了支持，請參見 SAML 身份驗證。

Weblate 4.1#

發佈於 2020 年 06 月 15 日。

為使用包含的國家代碼新建新的翻譯添加了支持。
增加了對用截圖搜索源字串的支持。
擴展了統計數據洞察中可用的信息。
改進了在“翻譯”頁面上的搜索編輯。
改進了並發倉儲更新的處理。
在項目新建表格中包括了源語言。
包括了信用的更改計數。
修復了一些情況下的 UI 語言選擇。
允許註冊關閉時的白名單註冊方法。
改進了詞彙表中相關術語的查找。
改進了翻譯記憶庫匹配。
將相同的機器翻譯結果分組。
為編輯翻譯頁面的屏幕截圖添加了直接鏈接。
改進了刪除確認對話。
在 ZIP 下載中包括了模板。
為聲明中的標記和通知配置添加了支持。
擴展了檢查列表的細節。
為新的文件格式： Laravel PHP 字串, HTML files, OpenDocument Format, IDML Format, Windows RC files, INI 翻譯, Inno Setup INI translations, GWT 屬性, go-i18n JSON files, :ref:`arb`添加了支持。
一致地使用了放棄作為放棄檢查的狀態。
新增支援設定預設的附加元件為啟用。
修復了編輯器對放棄檢查的鍵盤快捷鍵。
改進了帶有佔位符的字串的機器翻譯。
顯示了使用者語言的幽靈翻譯，使之易於啟動。
改進了語言代碼解析。
顯示了列表中的第一個使用者語言的翻譯。
重命名來塑造為更一般的名稱變量。
添加了新的質量檢查：多個未命名變數, 長期未翻譯, 連續重複單字。
為擦除翻譯記憶庫重新引入了支持。
修復了忽略檢查源的選項。
為配置不同分支來解析更改添加了支持。
API 現在在 HTTP 標頭重報告速率限制狀態。
對 Google Translate V3 API（高級版）添加了支持。
添加了對組件層訪問限制的能力。
為翻譯標記中的空白字符和其它特殊字符添加了支持，請參見使用標誌自定義行為。
總是顯示受到的文本檢查，如果啟動的話。
API 現在支持對更改的篩選。
為項目之間分享詞彙表添加了支持。

Weblate 4.0.4#

發佈於 2020 年 05 月 7 日。

修復了測試套件在一些 Python 3.8 環境下的執行。
文件中筆誤的修復。
修復了一些情況下使用 API 新建組件的問題。
修復了移動導航中爆發的 JavaScript 錯誤。
修復了顯示一些檢查時的崩潰。
修復了屏幕截圖列表。
修復了每月摘要通知。
修復了使用翻譯中不存在的單元的中間翻譯行為。

Weblate 4.0.3#

發佈於 2020 年 05 月 2 日。

修復了報告中可能的崩潰。
使用者在註釋中的提及現在不區分大小寫。
修復了非超級使用者的 PostgreSQL 遷移。
修復了新建組件時更改倉儲 URL。
修復了上游倉儲丟失時的崩潰。

Weblate 4.0.2#

發佈於 2020 年 04 月 27 日。

改進了翻譯統計數據的性能。
改進了更改標籤的性能。
改進了大量編輯的性能。
改進了翻譯記憶庫的性能。
修復了組件刪除時可能的崩潰。
修復了一些極端情況下顯示翻譯更改的問題。
改進了 celery 隊列過長的警告。
改進了一致性檢查中的誤報。
修復了更改連接的組件倉儲時的死鎖。
包括了更改列表和 CSV 與報告中的編輯距離。
避免了對加拿大法語進行符號間隔檢查時的誤報。
修復了用佔位符導出 XLIFF。
修復了零寬度檢查的誤報。
改進了配置錯誤的報告。
改進了雙語言源上傳。
為 DeepL 機器翻譯自動檢測支持的語言。
修復了一些極端情況下的進度條顯示。
修復了非翻譯字串出發的一些檢查。

Weblate 4.0.1#

發佈於 2020 年 04 月 16 日。

修復了來自 Pypi 的軟件包安裝。

Weblate 4.0#

發佈於 2020 年 04 月 16 日。

Weblate 現在需要 Python 3.6 或更新版本。
添加了組件提醒的管理概述。
添加了斷裂的倉儲瀏覽器 URLs 的組件提醒。
改進了登陸和註冊頁面。
項目訪問控制與工作流程配置集成在項目設置中。
為 i18next 插值和嵌套添加了檢查和高亮標記。
為百分號佔位符添加檢查和高亮標記。
Display suggestions failing checks.
在歷史中記錄源字串更改。
將 Microsoft Translator 升級為版本 3 的 API。
重新應用翻譯記憶庫後端。
為在搜索中查找幾個 is: 添加了支持。
允許未更動的翻譯避免內部黑名單。
改進了從單語言 po 文件中提取註釋。
重新命名要宣布的白板消息。
修復了註冊郵件偶爾出現的問題。
改進了 LINGUAS 更新附加組件來處理更多的語法變量。
修復了編輯單語言 XLIFF 源文件。
為搜索中的準確匹配添加了支持。
擴展了 API 覆蓋屏幕截圖、使用者、使用者組、組件列表，並擴展了新建項目。
為雙語言翻譯上傳的源添加支持。
為開發者的中間語言添加支持。
新增支持來源字串的審核。
擴展了平台範圍的翻譯記憶庫的下載選項。

Weblate 3.x 系列#

Weblate 3.11.3#

發佈於 2020 年 03 月 11 日。

修復了以某種優先性來搜索字段。
修復了近期添加的字串的預定義隊列。
修復了搜索返回重複的匹配。
修復 Gmail 中提供的通知。
修復了從歷史中還原更改。
添加了到摘要通知中的事件的鏈接。
修復了賬戶刪除確認的電子郵件。
添加了對 Docker 容器中 Slack 身份認證的支持。
避免發送未訂閱語言的通知。
在性能概況中包括了 Celery 隊列。
修正附加元件說明文件的連結。
降低了為更改翻譯檢查的誤報。
提高了處理 CVE-2020-6802 的 bleach 依賴性。
修復了在歷史中列出項目層的更改。
修復了一些極端情況下的統計數據被驗證為非法。
修復了搜索某個字串狀態。
改進了格式字串檢查行為丟失百分比的問題。
修復了使用第三方提供商的身份驗證。

Weblate 3.11.2#

發佈於 2020 年 02 月 22 日。

修復了提出建議的問題。
修復了一些字串被錯誤地報告為沒有單詞的問題。

Weblate 3.11.1#

發佈於 2020 年 02 月20 日。

存檔的 Celery 設置更改。
改進了新建組件時文件名的驗證。
修復了一些依賴性的最低版本。
修復了以某個 Django 版本添加群組。
修復了手動推送到上游倉儲。
改進了詞彙表匹配。

Weblate 3.11#

發佈於 2020 年 02 月 17 日。

允許通過 API 新建組件的過程中使用版本控制系統（VCS）推送 URL。
寬度檢查現在以渲染來顯示圖像。
修復了通知電子郵件中的鏈接。
改進了純文本電子郵件的外觀。
顯示了忽略的檢查並且允許使它們再次激活。
在單語言翻譯上顯示附件的鍵。
新增支援群組字串形狀。
在系統檢查時推薦更新為新的 Weblate 版本。
對重複的語言提醒提供了更具體的分析。
在項目頁面上包括更具體的版本信息。
如果需要的話自動非淺複製本地複件。
修復了需要動作的字串下載。
New alert to warn about using the same file mask twice.
改進了 XML 代碼塊提取。
SINGLE_PROJECT 現在可以強制重定向來選擇項目。
添加了選項來解決註釋。
添加了標記的大量編輯。
為字串標籤添加了支持。
Added bulk edit add-on.
為強制檢查添加了選項。
增加了確認鏈接的預設驗證。
改進了 Matomo 集成。
修復了已經翻譯過來正確低處理源字串更改。
擴展了通過 AUTO_UPDATE 的自動更新配置。
LINGUAS 附加元件現在在 Weblate 中完全同步翻譯。

Weblate 3.10.3#

發佈於 2020 年 01 月 18 日。

支持 translate-toolkit 2.5.0。

Weblate 3.10.2#

發佈於 2020 年 01 月 18 日。

為項目添加了鎖定指示。
修復了在一些 web 瀏覽器中促使閃退的 CSS 缺陷。
修復了以非英語地區設置在系統中搜索。
改進了對 Github 和 Bitbucket 鉤子的倉儲。
修復了一些 Python 2.7 安裝中的數據的遷移。
允許 Git 錢克隆的配置。
改進了後台通知處理。
修復了在 web 瀏覽器導航回去時表格提交中斷。
配置 YAML 格式化的新附加組件。
修復了單複數形式語言中沒有進行相同的複數檢查。
修復了相同字段的 regex 搜索。

Weblate 3.10.1#

發佈於 2020 年 01 月 09 日。

擴展了新建翻譯 API。
修復了數據遷移的幾個極端情況。
與 Django 3.0 兼容。
Improved data clean-up performance.
為定制的 security.txt 添加了支持。
改進了更改日誌的麵包屑（breadcrubs）。
改進了面板上的翻譯列表。
改進了 Webhooks 的 HTTP 響應。
在 Docker 容器中添加了 GitLab 和並請求。

Weblate 3.10#

發佈於 2019 年 12 月 20 日。

改進了應用使用者界面。
添加了雙空格檢查。
修復了新建新的語言。
避免了向刪除的電子郵箱發送審計日誌。
Added support for read-only strings.
為註釋中的標記添加了支持。
允許在項目信息中放置翻譯指示文本。
為第二語言添加了複製到剪貼板。
改進了對 Mercurial 的支持。
改進了 Git 倉儲取回性能。
添加了搜索字串時間的查找。
為所有翻譯顯示源語言。
顯示字串附近的語境。
為倉儲操作的通知添加了支持。
改進了翻譯列表。
擴展了搜索能力。
為標記為編輯的自動翻譯字串添加了支持。
對連接的組件提醒避免發送重複的通知。
改進了預設的合併請求消息。
更好地指示了在禪模式下的字串狀態。
為 Yandex 翻譯中的更多語言添加了支持。
改進了通知電子郵件的外觀。
提供了翻譯許可的選擇。

Weblate 3.9.1#

發佈於 2019 年 10 月 28 日。

從備份中刪除了一些不需要的文件。
修復了報告的潛在崩潰。
修復了資料庫交叉遷移故障。
對強制推送 Git 倉儲添加了支持。
降低了註冊令牌非法的風險。
修復了賬戶刪除點擊率的限制。
添加了基於優先性的搜索。
修復了向 JSON 文件添加字串可能的崩潰。
安全 HTML 檢查於修復現在接受源字串標記。
避免向邀請的和刪除的使用者發送通知。
修復了在 Docker 容器中 Celery 的到 redis 的 SSL 連接。

Weblate 3.9#

發佈於 2019 年 10 月 15 日。

在下載的文件中包括了 Weblate 元數據。
改進了失敗檢查的 UI。
在格式檢查中指示了丟失的字串。
將法語標點間隔檢查分開。
為修復一些質量檢查錯誤添加了支持。
添加了分開的權限來新建新的項目。
擴展了字符計數的統計數據。
改進了對 Java 風格語言代碼的支持。
為新的佔位符提供的通用檢查。
為 WebExtension JSON 佔位符添加了支持。
為純 XML 格式添加了支持。
擴展了 API 的項目、組件和翻譯的刪除與新建。
為 Gitea 和 Gitee webhooks 添加了支持。
添加了新的定制的基於正則表達式的檢查。
允許配置來為分享的翻譯記憶庫做出貢獻。
添加了更多翻譯文件的 ZIP 下載。
使 XLIFF 標準兼容最大寬度和字體的解析。
為傳輸 web 應用的安全 HTML 標記添加了新的檢查並進行了修復。
對未支持的配置添加了組件提醒。
Added automatic translation add-on to bootstrap translations.
擴展了自動翻譯來添加建議。
在概覽上顯示附加組件參數。
現在通過當代的 Sengtry SDK 而不是 Raven 支持 Sentry。
更改了示例設置，更好地適配生產環境。
添加了使用 BorgBackup 的自動備份。
分離了 RESX 清理附加組件，來避免不想要的文件更新。
添加了高級搜索功能。
允許使用者下載他們自己的報告。
添加了本地化嚮導來配置組件。
增加了對 GitLab Merge Request 的支持。
改進了倉儲狀態的顯示。
在後台執行自動翻譯。

Weblate 3.8#

發佈於 2019 年 08 月 15 日。

為簡化創建相似的組件提供了支持。
為從基於 XML 的文件格式分析翻譯標記添加了支持。
將意外記入 Celery 日誌。
改善處理附加元件的效能。
改進了通知電子郵件的外觀。
修復了密碼重置行為。
改進了多數翻譯頁面的性能。
修復了 Weblate 未知的語言列表。
新增支援複製附加元件到新發現的翻譯元件中。
為用上傳來替換文件內容添加了支持。
為翻譯非基於版本控制系統（VCS）的內容添加了支持。
添加了 OpenGraph widget 圖像而在社交網絡上使用。
為動畫屏幕截圖添加了支持。
改進了單語言 XLIFF 文件的處理。
避免為單個事件發送多個通知。
為篩選更改添加了支持。
擴展了報告的預定義週期。
為 Azure Repos 添加了 webhook 支持。
待定建議或未翻譯字串的新的選擇使用通知。
添加了通知電子郵件的一鍵退訂。
修復了已翻譯檢查的誤報。
管理員的新管理界面。
字串優先性現在可以使用標記來指定。
添加了語言管理視圖。
添加了 Qt 庫和 Ruby 格式字串的檢查。
添加了配置來更好地符合單一項目安裝。
在單語言翻譯中通過源字串更改中的新字串。
添加帶有搜索功能的另外的翻譯記憶庫視圖。

Weblate 3.7.1#

發佈於 2019 年 06 月 28 日。

文件更新。
修復了一些要求限制。
更新了語言資料庫。
本地化更新。
各種使用者界面調整。
改進了對不支持但發現的翻譯文件的處理。
更詳細地報告丟失文件格式要求。

Weblate 3.7#

發佈於 2019 年 06 月 21 日。

添加了用於通知的另外的 Celery 隊列。
對於 API 瀏覽使用了與應用一致的外觀。
在報告中包括了同意的統計數據。
當更新翻譯組件時的報告過程。
允許終止運行後台組件的更新。
為文件名操作擴展了模板語言。
對於編輯器鏈接和倉儲瀏覽器 URL 使用模板。
當編輯翻譯時指示最大長度和當前字符計數。
改進了未更改翻譯檢查中的縮寫處理。
刷新了新貢獻者的登錄頁面。
新增支援 msgmerge 附加元件設定。
當發送通知時延遲打開 SMTP 連接。
改進了錯誤日誌。
允許 MO 生成附加組件中的自定義位置。
新增清理舊的建議或註釋的附加元件。
添加了選項來啟動禪編輯器的水平模式。
提高了許多被鏈接組件的導入性能。
修復了一些情況下的示例安裝。
改進了更改中提供提醒。
添加了新水平統計數據 widget。
改進了複數的格式字串檢查。
添加了字體管理工具。
提供文本尺寸的新檢查。
為字幕格式添加了支持。
包括了語言的全部完成的統計數據。
添加了在項目或全體範圍內的報告。
改進了顯示翻譯狀態時的使用者界面。
新的 Weblate 標誌和配色方案。
位圖徽章的新外觀。

Weblate 3.6.1#

發佈於 2019 年 04 月 26 日。

改進了單語言 XLIFF 文件的處理。
修復了一些極端情況下的摘要通知。
修復了附加組件腳本錯誤警告的問題。
修復了為單語言 PO 文件生成 MO 文件。
修復了未安裝檢查的顯示。
指示項目列表中管理的項目。
允許更新而從丟失的版本控制系統（VCS）倉儲恢復。

Weblate 3.6#

發佈於 2019 年 04 月 20 日。

為下載使用者數據添加了支持。
附加元件在安裝時會被自動觸發。
改進了解決合併衝突的指示。
清理附加組件現在與 app 商店元數據翻譯兼容。
當添加新語言時可配置的語言代碼語法。
警告 Python 2 的使用計劃於 2020 年 04 月終止。
為視覺鍵盤從源字串中提取特定字符。
擴展了貢獻者統計數據，來反映源計數和目標計數。
管理員和一致性附加元件現在可以新增翻譯，即使對使用者停用。
修復了禁止 Language-Team 標頭操作切換的描述。
通知註釋中提到的使用者。
從組件設置中刪除了文件格式自動檢查。
修復了為單語言 PO 文件生成 MO 文件。
添加了摘要通知。
為組件通知靜音添加了支持。
為新的提醒、白板消息或組件添加了通知。
現在可以配置管理項目的通知。
改進了三字母語言代碼的處理。

Weblate 3.5.1#

發佈於 2019 年 03 月 10 日。

修復了 Celery systemd 單元例子。
修復了帶有登錄的 HTTP 倉儲的通知。
修復了單語言翻譯中編輯源字串的競態條件。
在日誌中包括附加組件執行失敗的輸出。
改進了添加新語言選擇的驗證。
在組件設置中允許編輯文件格式。
更新安裝指示為首選 Python 3。
裝入翻譯時的性能與一致性改進。
使 Microsoft Terminology 服務與當前的 Zeep 發佈版本兼容。
本地化更新。

Weblate 3.5#

發佈於 2019 年 03 月 03 日。

改進了內建翻譯記憶庫的性能。
添加了管理全體翻譯記憶庫的界面。
改進了壞的組件狀態的提醒。
添加了管理白板消息的使用者界面。
現在可以配置附加組件提交消息。
減少更新上游倉儲時的提交數量。
修復了在項目之間移動組件時可能的元數據丟失。
改進了纏模式的導航。
添加了幾個新的質量檢查（相關的標記和 URL ）。
對 app 商店元數據文件添加了支持。
為切換 GitHub 或 Gerrit 集成添加了支持。
為卡什達字母添加了檢查。
添加選項來根據作者壓縮提交。
改進了對 XLSX 文件格式的支持。
與 Tesseract 4.0 兼容。
賬單附加組件現在在未支付賬單 45 天后刪除項目。

Weblate 3.4#

發佈於 2019 年 01 月 22 日。

為 XLIFF 佔位符添加了支持。
Celery 現在可以使用多個項目隊列。
為項目與組件的重命名和移動添加了支持。
在報告中包括字符計數。
添加了帶有翻譯文件自動檢測的翻譯組件添加嚮導。
可定制的 Git 合併提交消息。
在導航中添加了組件提醒的視覺指示。
改進了裝入翻譯文件的性能。
New add-on to squash commits prior to push.
改進了翻譯更改的顯示。
更改了預設合併風格來 rebase 並且使之可配置。
更好地處理語言代碼中的私用子標籤。
改進了全文索引更新的性能。
擴展了文件上傳 API 來支持更多的參數。

Weblate 3.3#

發佈於 2018 年 11 月30 日。

為組件和項目刪除添加了支持。
改進了一些單語言翻譯的性能。
添加了翻譯組件提醒，使翻譯的問題高亮。
當可用時揭露 XLIFF 字串 resname 作為語境。
為 XLIFF 狀態添加支持。
為 DATA_DIR 中的非可寫入文件添加檢查。
改進了更改的 CSV 導出。

Weblate 3.2.2#

發佈於 2018 年 10 月 20 日。

刪除了不再需要的 Babel 依賴性。
更新了語言定義。
改進了附加元件、LDAP 和 Celery 的文件。
修復了啟動新的 dos-eol 和 auto-java-messageformat 標記。
修復了從 PyPI 軟件包運行 setup.py 測試。
改進了複數處理。
修復了一些極端情況下失敗的翻譯上傳 API。
修復了手動更改情況下更新 Git 配置。

Weblate 3.2.1#

發佈於 2018 年 10 月 18 日。

Python 2.7 的 backports.csv 的文件依賴性。
修復根下運行測試。
改進了 gitexport 模塊中的錯誤處理。
修復了報告新添加語言的過程。
正確地向 Sentry 報告 Celery worker 錯誤。
修復了用 Qt linguist 新建新的翻譯。
修復了偶發的全文索引更新失敗。
改進了新建新組件時的驗證。
為清理舊的建議添加了支持。

Weblate 3.2#

發佈於 2018 年 10 月 06 日。

為自動化的附加組件安裝添加 install_addon 管理命令。
允許更細粒度的速率限制設置。
為 Excel 文件的導出和導入添加了支持。
改進了多組件發現附加元件情況下的組件清理。
重寫了 Microsoft Terminology 機器翻譯後端。
Weblate 現在使用 Celery 來卸載一些處理。
改進了搜索功能，並添加了正則表達式搜索。
為有道智雲機器翻譯添加了支持。
為百度 API 機器翻譯添加了支持。
集成了使用 Celery 的維護和清理任務。
改進了裝入翻譯的性能幾乎 25%。
刪除了對上傳時合併標頭的支持。
刪除了對客戶提交消息的支持。
可配置的編輯模式（禪模式/全模式）。
為向 Sentry 報告錯誤添加了支持。
為每天自動更新倉儲添加了支持。
為使用者新建項目和組件添加了支持。
Built-in translation memory now automatically stores translations done.
使用者和項目現在可以導入他們現有的翻譯記憶庫。
更好地管理屏幕截圖的相關字串。
為檢查 Java MessageFormat 添加了支持。

所提到問題的具體列表請參見 3.2 milestone on GitHub。

Weblate 3.1.1#

發佈於 2018 年 07 月 27 日。

修復了一些設置中失敗的測試套件。

Weblate 3.1#

發佈於 2018 年 07 月 27 日。

不再支持從早於 3.0.1 的更舊版本的升級。
允許覆蓋從設置中預設提交的消息。
改進 webhooks 與自主環境的兼容性。
添加了對 Amazon Translate 的支持。
與 Django 2.1 兼容。
Django system 系統檢查現在用於診斷安裝問題。
刪除了將很快關閉的 libravatar 服務的支持。
New add-on to mark unchanged translations as needing edit.
為翻譯時跳到特定位置添加支持。
現在可以定制下載翻譯。
改進了翻譯記憶庫匹配中的字串相似性的計算。
添加了由 GnuPG 簽發 Git 提交的支持。

Weblate 3.0.1#

發佈於 2018 年 06 月 10 日。

修復了自 2.20 依賴可能的合併問題。
本地化更新。
刪除了過時的鉤子的例子。
改進了緩存文件。
改進了管理文件的顯示。
改進了長語言名稱的處理。

Weblate 3.0#

發佈於 2018 年 06 月 01 日。

重寫了訪問控制。
導致移動或重命名模塊的一些代碼清理。
自動組件發現的新附加組件。
import_project 管理命令現在有一些略微不同的參數。
為 Windows RC 文件添加了基本支持。
新的附加組件，將貢獻者姓名存儲在 PO 文件標頭中。
刪除了每組件鉤子腳本，轉而使用附加元件替代。
為收集貢獻者協議添加支持。
現在在歷史中跟踪訪問控制更改。
New add-on to ensure all components in a project have same translations.
在提交消息模板中支持更多變量。
為提供另外的文本語境添加支持。

Weblate 2.x 系列#

Weblate 2.20#

發佈於 2018 年 04 月 04 日。

改進了 subversion 倉儲克隆的速度。
更改了倉儲鎖定來使用第三方庫。
為下載只需要動作的字串添加了支持。
為立刻在幾種語言中搜索添加了支持。
新附加組件來配置 gettext 輸出換行。
新附加組件來配置 JSON 格式。
為使用 RFC 6750 兼容的 Bearer 認證添加了 API 中認證的支持。
未使用機器翻譯服務自動翻譯添加了支持。
為白板消息中的 HTML 標記添加了支持。
為大量更改字串的狀態添加了支持。
現在至少需要 2.3.0 版本的Translate-toolkit，較老的版本不再支持。
Added built-in translation memory.
為面板添加了組件概況和每個組件列表概況的頁面。
為 DeepL 機器翻譯服務添加了支持。
機器翻譯結果現在緩存在 Weblate 內。
新增支援重新排序已提交的改變。

Weblate 2.19.1#

發佈於 2018 年 02 月 20 日。

修復了從 2.18 升級的合併問題。
改進了文件上傳 API 驗證。

Weblate 2.19#

發佈於 2018 年 02 月 15 日。

修復了跨一些文件格式的導入。
在審查日誌中顯示使用者友好的瀏覽器信息。
為文件添加了 TMX 導出程序。
裝入翻譯文件的各種性能改進。
添加了選項在 Weblate 中禁止訪問管理，有利於 Django。
改進了大字串的詞彙表查詢速度。
與 django_auth_ldap 1.3.0 兼容。
配置錯誤現在被存儲並被持久地報告。
在空白字符自動修復中 Honor 忽略標記。
改進了一些 Subversion 設置的兼容性。
Improved built-in machine translation service.
對 SAP Translation Hub 服務添加了支持。
為 Microsoft Terminology 服務添加了支持。
刪除了對通知電子郵件中的廣告的支持。
改進了語言層次的翻譯過程報告。
改進了不同複數形式的支持。
添加了對不使用 stdlayout 的 Subversion 倉儲的支持。
新增附加元件能自訂翻譯流程。

Weblate 2.18#

發佈於 2017 年 12 月 15 日。

擴展了貢獻者的統計數據。
改進了特殊字符可視鍵盤的配置。
為 DTD 文件格式添加了支持。
更改了鍵盤快捷鍵，較少地於瀏覽器/系統的快捷鍵衝突。
改進了對 XLIFF 文件中的同意標記的支持。
添加了對 gettext PO 文件中不換行的長字串的支持。
添加了按鈕為當前翻譯複製永久鏈接。
去掉了對 Django 1.10 的支持，而添加了對 Django 2.0 的支持。
刪除了當翻譯時對翻譯的鎖定。
對於為單語言翻譯添加新的字串添加了支持。
對專門复核人員的翻譯流程添加了支持。

Weblate 2.17.1#

發佈於 2017 年 10 月 13 日。

修復了在一些特定情況下運行測試套件的問題。
區域設置更新。

Weblate 2.17#

發佈於 2017 年 10 月 13 日。

現在 Weblate 預設進行 Git 淺克隆。
改進了更新大的翻譯文件時的性能。
為阻擋註冊的某個電子郵件地址添加了支持。
使用者現在可以刪除自己的註釋。
為搜索和替換特性添加了預覽步驟。
搜索和上傳表格時客戶端一側設置的持久性。
擴展了搜索能力。
每個項目的更細粒度的 ACL 配置。
BASE_DIR 的預設值已經更改。
添加了兩步賬戶刪除，來防止意外刪除。
現在可以編輯項目訪問控制設置。
添加了使用 Akismet 建議的可選垃圾郵件保護。

Weblate 2.16#

發佈於 2017 年 08 月 11 日。

更重新能改進。
為嵌套 JSON 格式添加了支持。
為 WebExtension JSON 格式添加了支持。
修復了 git 導出認證。
改進了某些情況下的 CSV 導入。
改進了其它翻譯 widget 的外觀。
對於表格中的文本長度現在強制進行最大長度檢測。
每個組件進行 commit_pending 時間配置。
各種使用者界面清理。
修復了組件/項目/網站範圍的翻譯搜索。

Weblate 2.15#

發佈於 2017 年 06 月 30 日。

在其它翻譯中顯示了更多相關的翻譯。
添加了選項來查看當前字串到其它語言的翻譯。
對立陶宛語預設使用 4 種複數形式。
修復了不同格式單語言文件的上傳。
改進了認證失敗的錯誤消息。
當從詞彙表刪除單詞時保持頁面狀態。
添加了直接鏈接來編輯第二語言翻譯。
添加了 Perl 格式質量檢查。
為了拒絕再次使用的密碼添加了支持。
為編輯 RTL 語言擴展了工具條。

Weblate 2.14.1#

發佈於 2017 年 05 月 24 日。

修復了將搜索結果分頁時可能的錯誤。
修復了一些極端情況下從較老的版本合併的問題。
修復了項目有人或無人監守時可能的 CSRF。
密碼重置不再認證使用者。
修復了忘記密碼是可能的略過 CAPTCHA。

Weblate 2.14#

發佈於 2017 年 05 月 17 日。

使用 AJAX 添加詞彙表條目。
登出現在使用 POST 來避免 CSRF。
API 密鑰令牌重置現在使用 POST 來避免 CSRF。
Weblate 預設設置 Content-Security-Policy。
驗證本地編輯器 URL 來避免 self-XSS。
現在預設相對於一般缺陷來驗證密碼。
向使用者通知他們賬戶的重要動作，如密碼變更。
CSV 導出現在會避免可能的公式。
安全上的各種小改進。
現在限制了認證嘗試的次數。
建議的內容存儲在歷史中。
在審計日誌中存儲重要的賬戶行為。
當刪除賬戶或添加新的團體時，詢問密碼確認。
當做出建議時顯示時間。
新的質量檢查來跟踪分號。
確保搜索鏈接可以被分享。
在 API 中包括了源字串信息和屏幕截圖。
允許通過 API 上傳覆蓋翻譯。

Weblate 2.13.1#

發佈於 2017 年 04 月 12 日。

修復了個人資料中管理的項目的列表。
修復了在一些許可丟失的情況下的合併問題。
修復了翻譯下載中當前文件的列表。
當使用者沒有特權而嘗試訪問項目時返回 HTTP 404。

Weblate 2.13#

發佈於 2017 年 04 月 12 日。

修復了翻譯模板的質量檢查。
添加了質量檢查，在丟失翻譯時觸發。
添加選項來查看使用者待定的建議。
添加選項來自動建立組件列表。
未認證使用者可以配置的預設面板。
新增選項來隨機瀏覽 25 個字串於審查。
歷史現在指示字串的更改。
添加新的翻譯時更好的錯誤報告。
在項目中添加了每種語言的搜索。
Group（群組）ACLs 現在可以限制為某個權限。
The per project ACLs are now implemented using Group ACL.
添加了更精細顆粒的特權控制。
各種小的 UI 改進。

Weblate 2.12#

發佈於 2017 年 03 月 03 日。

改進了群組的管理界面。
為 Yandex Translate API 添加了支持。
改進了網站範圍的搜索速度。
添加了項目和組件範圍的搜索。
添加了項目和組件範圍的搜索與替換。
改進了將不一致翻譯待定。
在本地編輯器中添加了開源文件的支持。
為配置帶有特殊字符的虛擬鍵盤添加了支持。
改進了帶有 OCR 支持的屏幕截圖管理來匹配源字串。
預設提交消息現在包括翻譯信息和 URL。
為 Joomla 翻譯格式添加了支持。
改進了重要的跨文件格式的可靠性。

Weblate 2.11#

發佈於 2017 年 01 月 31 日。

在語言頁麵包括了具體語言信息。
Mercurial 後端改進。
添加了選項來製定翻譯組件優先性。
更一致地使用 Group ACLs，即使具有較少使用的許可。
為鉤子腳本添加了 WL_BRANCH 變量。
改進了開發者文件。
與 Git 導出器附加組件中多個 Git 版本的更佳兼容性。
包括每個項目的和組件的統計數據。
添加語言代碼映射，來更好地支持 Microsoft Translate API。
將全文清理移動為後台工作，使去除翻譯更快速。
修復了具有單個複數形式的語言的複數源顯示。
改進了 import_project 中的錯誤處理。
更重新能改進。

Weblate 2.10.1#

發佈於 2017年 01 月20 日。

不洩露密碼重置表格上存在賬戶（CVE-2017-5537）。

Weblate 2.10#

發佈於 2016 年 12 月 15 日。

添加質量檢查，來檢查是否複數被翻譯出來。
對帶有驗證的倉儲修復了 GitHub 鉤子。
添加了可選的 Git 導出模塊。
支持 Microsoft Cognitive Services Translator API。
簡化了項目和組件使用者界面。
添加了自動修復來去除控製字符。
為項目添加了每種語言的概況。
為 CSV 導出添加了支持。
為統計數據添加了 CSV 下載。
增加了矩陣視圖，以快速概述所有翻譯。
為更改和字串添加了基本 API。
為 Apertium APy 服務器添加了支持，用於機器翻譯。

Weblate 2.9#

發佈於 2016 年 11 月 04 日。

擴展了 createadmin 管理命令的參數。
擴展了 import_json，而能夠處理現有組件。
為 YAML 文件添加了支持。
項目所有者現在可以配置翻譯組件和項目細節。
使用「Watched」（關注的）而不是「Subscribed」（訂閱的）項目。
可以從項目頁面直接關注項目。
添加多語言狀態 widget。
如果沒有顯示源的話，將第二語言高亮。
將建議刪除記錄在歷史中。
改進個人資料中語言選擇的 UX。
修復了顯示組件的白板信息。
存儲後保持偏好標籤被選擇。
更突出地顯示源字串註釋。
從 Git 倉儲自動安裝 Gettext PO 合併驅動。
添加搜索和替換特性。
為上傳可視內容（屏幕截圖）用於翻譯添加了支持。

Weblate 2.8#

發佈於 2016 年 08 月 31 日。

文件改進。
Translations.
Updated bundled JavaScript libraries.
添加了 list_translators 管理命令。
不再支持 Django 1.8。
修復了與 Django 1.10 的兼容性。
添加了 Subversion 支持。
從 XML 合法性檢查中分出不匹配的 XML 標籤。
修復了 API 來接受 HIDE_REPO_CREDENTIALS 設置。
在禪模式中顯示源更改。
Alt+PageUp/PageDown/Home/End 現在也在纏模式中工作良好。
添加提示來顯示更改的準確時間。
添加選項從翻譯頁面中選擇篩選程序和搜索。
添加了翻譯刪除的 UI。
改進了插入代碼塊時的行為。
修復了禪模式的自動鎖定問題。

Weblate 2.7#

發佈於 2016 年 07 月 10 日。

去除了 Google web translation 機器翻譯。
改進了添加翻譯時的提交消息。
修復了希伯來語的 Google Translate API。
與 Mercurial 3.8 的兼容性。
添加了 import_json 管理命令。
糾正了列出翻譯的順序。
顯示全部建議文本，而只是差別。
擴展 API（具體的倉儲狀態、統計數據、……）。
測試套件不再需要網絡範文來測試倉儲。

Weblate 2.6#

發佈於 2016 年 04 月 28 日。

修復了語言篩選程序的驗證組件。
改進了對 XLIFF 文件的支持。
修復了非英語源的機器翻譯。
添加了 REST API。
Django 1.10 的兼容性。
為白板纖細添加了分類。

Weblate 2.5#

發佈於 2016 年 03 月 10 日。

修復了項目所有者的自動翻譯。
改進了提交和推送操作的性能。
新的管理命令，從命令行添加建議。
為文件上傳時的合併註釋添加了支持。
為 C printf 格式的一些 GNU 後綴添加了支持。
文件改進。
為生成翻譯者信用添加了支持。
為生成貢獻者統計數據添加了支持。
網站範圍的搜索可以只在一種語言中搜索。
改進了亞美尼亞語的質量檢查。
為開始沒有現有翻譯的翻譯組件添加支持。
支持在 Qt TS 中添加新的翻譯。
改進了翻譯 PHP 文件的支持。
質量檢查的性能提高。
Fixed site wide search for failing checks.
添加選型來指定源語言。
改進了對 XLIFF 文件的支持。
擴展了 import_project 選項的列表。
改進了白板消息的目標。
支持跨項目的自動翻譯。
最佳化全文搜尋索引。
為自動翻譯添加了管理命令。
添加了代碼塊高亮。
為代碼塊、檢查和機器翻譯添加了鍵盤快捷方式。
改進了翻譯鎖定。
為 AngularJS 插值添加了質量檢查。
添加了廣泛的基於群組的 ACLs。
闡明了需要編輯的字串的術語（以前被稱為 fuzzy，即模糊）。
Clarified terminology on strings needing action and untranslated strings.
支持 Python 3。
去掉了對 Django 1.7 的支持。
去掉了用於新建新的 gettext PO 文件的 msginit 依賴性。
添加了可配置的面板視圖。
改進了解析錯誤的通知。
添加了選項將帶有復制名稱的組件導入 import_project。
改進了翻譯 PHP 文件的支持。
添加了字典的 XLIFF 導出。
為所有翻譯添加了 XLIFF 和 gettext PO 導出。
文件改進。
為可配置的自動群組指定添加了支持。
改進了新翻譯的添加。

Weblate 2.4#

發佈於 2015 年 09 月 20 日。

改進了對 PHP 文件的支持。
為匿名使用者添加 ACL 的能力。
改進了 import_project 命令的配置。
添加了歷史的 CSV 轉儲。
避免複製/粘貼空白字符的錯誤。
為 Bitbucket webhooks 添加了支持。
在翻譯上傳時對模糊字串更嚴格的控制。
幾個 URLs 已經更改，可能必須要更新您的書籤。
鉤子腳本以 VCS root 作為當前目錄執行。
鉤子腳本以描述當前組件的環境變量來執行。
添加了管理命令來優化全文索引。
為滾動條上報告錯誤添加了支持。
項目現在可以有多個所有者。
項目所有者可以管理自己。
為 gettext PO 中使用的 javascript-format 添加了支持。
在 XLIFF 中添加新翻譯的支持。
改進了文件格式自動檢測。
擴展了鍵盤快捷鍵。
改進了幾種語言的字典匹配。
改進了多數頁面的佈局。
支持在翻譯時將單詞添加入字典。
為篩選語言由 Weblate 管理添加了支持。
為翻譯並導入 CSV 文件添加了支持。
重寫了靜態文件的處理。
第三放服務的直接登錄/註冊鏈接，如果是唯一一個的話。
賬戶刪除時提交待定的更改。
添加管理命令來更改網站名稱。
添加選項來配置預設提交者。
在添加新翻譯後添加鉤子。
添加選項來指定多個文件來添加提交。

Weblate 2.3#

發佈於 2015 年 05 月 22 日。

去掉對 Django 1.6 和 South migrations 的支持。
支持使用 Java 屬性文件時添加新翻譯。
允許接受建議而不編輯。
改進了對 Google OAuth 2.0 的支持。
添加了對 Microsoft .resx 文件的支持。
微調了預設的 robots.txt 文件而不允許翻譯特別緩慢地進行。
簡化了接受建議的工作流程。
添加了總是接收重要通知的項目所有者。
允許禁止編輯單語言模板。
更具體的倉儲狀態視圖。
更改翻譯時編輯模板的直接鏈接。
允許為項目所有者添加更多的權限。
允許在禪模式下顯示第二語言。
支持隱藏源字串而有利於第二語言。

Weblate 2.2#

發佈於 2015 年 02 月 19 日。

性能改進。
在所在地和註釋位置的全文檢索。
New SVG/JavaScript-based activity charts.
支持 Django 1.8。
支持刪除註釋。
添加自己的 SVG 徽章。
為 Google Analytics 添加支持。
改進了翻譯文件名的處理。
為單語言 JSON 翻譯添加了支持。
在歷史中記錄組件鎖定。
支持為單語言翻譯編輯源（模板）語言。
為 Gerrti 添加了基本支持。

Weblate 2.1#

發佈於 2014 年 12 月 05 日。

為 Mercurial 倉儲添加了支持。
由 Awesome 替換了Glyphicon 字體。
添加了社交驗證服務的圖標。
更一致的按鈕顏色和圖標。
文件改進。
各種缺陷修復。
對於小屏幕自動隱藏翻譯列表中的列。
更改了文件系統路徑的配置。
改進了 SSH 密鑰處理與存儲。
改進了倉儲鎖定。
每個源字串可定制的質量檢查。
允許從面板上隱藏完成的翻譯。

Weblate 2.0#

發佈於 2014 年 11 月 06 日。

使用 Bootsctrap 的新的倉儲 UI。
重寫了 VCS 後端。
文件改進。
為網站範圍的消息添加了白板。
可配置的字串優先性。
為 JSON 文件格式添加了支持。
修復了某些情況下生成 mo 文件。
為 GitLab 通知添加了支持。
添加了支持來禁止翻譯建議。
Django 1.7 支持。
ACL 項目現在具有使用者管理。
擴展了搜索可能性。
為翻譯者給出複數的更多提示。
修復了 Git 倉儲鎖定。
與舊的 Git 版本的兼容性。
改進了 ACL 支持。
為每種語言引用和其它特殊字符添加了按鈕。
支持導出統計數據作為 JSONP。

Weblate 1.x 系列#

Weblate 1.9#

發佈於 2014 年 05 月 06 日。

Django 1.6 兼容性。
不在維護與 Django 1.4 的兼容性。
用於鎖定/解鎖翻譯的管理命令。
改進了對 Qt TS 文件的支持。
使用者現在可以刪除他們的賬戶。
頭像可以被禁止。
合併第一個和最後一個名稱屬性。
頭像現在可以取回並緩存在服務器一側。
為 shields.io 徽章添加了支持。

Weblate 1.8#

發佈於 2013 年 11 月 07 日。

關於升級的指示，請查看手冊。
更好地列出了項目概況。
用於分享的更好的可視化選型。
對匿名使用者特權的更多控制。
支持使用第三方服務登錄，更多細節請查看手冊。
使用者可以通過電子郵件地址而不是使用者名登錄。
文件改進。
改進了來源字串審查。
跨所有字串的搜索。
更好地跟踪源字串。
註冊的 Captcha 保護。

Weblate 1.7#

發佈於 2013 年 10 月 07 日。

關於升級的指示，請查看手冊。
支持檢查 Python brace 格式字符傳。
每個組件的質量檢查定制。
具體的每個翻譯的統計數據。
更改了將建議、檢查與註釋連接到字串的方式。
使用者現在可以添加文本來提交消息。
支持新語言請求的訂閱。
支持添加新的翻譯。
現在使用 Pillow 而不是 Pango+ Cairo 來提供 Widget 和圖表。
添加狀態徽章 Widget。
去掉了不合法的文本方向檢查。
字典中的更改現在在歷史中記入日誌。
Performance improvements for translation view.

Weblate 1.6#

發佈於 2013 年 07 月 25 日。

註冊時更好的錯誤處理。
更改的瀏覽。
修復了機器翻譯建議的排序。
改進了對 MyMemory 機器翻譯的支持。
為 Amagam 機器翻譯添加了支持。
頻繁使用的頁面上的各種優化。
在搜索結果中將搜索到的短語高亮。
支持存儲消息時的自動修復。
跟踪翻譯歷史和選項來還原。
為 Google Translate API 添加了翻譯。
為管理 SSH 主機密鑰添加了支持。
各種表格驗證改進。
各種質量檢查改進。
導入的性能改進。
為建議投票添加了支持。
清理管理員界面。

Weblate 1.5#

發佈於 2013 年 04 月 16 日。

關於升級的指示，請查看手冊。
添加了公共使用者頁面。
更好地命名複數形式。
為詞彙表的 TBX 導出添加了支持。
為 Bitbucket 通知添加了支持。
行為圖標現在可用於每個翻譯、語言或使用者。
擴展了 import_project admin 命令的選項。
與 Django 1.5 兼容。
現在使用 libravatar 顯示頭像。
為 pretty print JSON 導出添加了可能性。
更重新能改進。
對項目或同樣對語言，在進度條中指示失敗的檢查或模糊字串。
為客戶預提交投資與提交另外的文件添加了支持。
重寫了搜索實現更好的性能與使用者體驗。
機器翻譯的新界面。
添加了對單語言 po 文件的支持。
擴展了緩存的元數據的量，來改進各種搜索的速度。
現在也顯示單詞計數。

Weblate 1.4#

發佈於 2013 年 01 月 23 日。

修復了在字串刪除時刪除檢查/註釋。
添加了選項來禁止自動傳播翻譯。
添加了選項為合併失敗而訂閱。
正確地導入需要客戶 ttkit 導入程序的項目。
添加了網站地圖允許爬蟲更容易地訪問。
在通知電子郵件或 feed 中提供到字串的直接鏈接。
對管理員界面的各種改進。
在管理員界面中為生產設置提供提示。
添加了每種語言的 widgets 和接合頁面。
改進了翻譯鎖定處理。
為 widgets 以更多變量顯示代碼段。
在進度挑中指示失敗的檢測或模糊字串。
用於將提交信息格式化的更多選項。
修復了機器翻譯服務的錯誤處理。
改進了自動翻譯鎖定行為。
支持顯示不同於之前的源字串的更改。
為字串搜索添加了支持。
各種質量檢查改進。
支持每個項目的 ACL。
基本代碼由單元測試來覆蓋。

Weblate 1.3#

發佈於 2012 年 11 月 16 日。

與 PostgreSQL 資料庫後端兼容。
將上游 git 倉儲中刪除的語言也刪除。
改進了質量檢查處理。
添加了新的檢查（BB 代碼、XML 標記和新的行）。
支持可選地 rebasing 而不是合併。
重新定位 Weblate 的可能性（例如在 /weblate 路徑下運行）。
支持在自動檢測失敗的情況下手動選擇文件類型。
更好地支持 Android 源。
支持從 web 界面生成 SSH 密鑰。
更多的可視化數據導出。
新的按鈕來輸入一些特殊字符。
支持導出字典。
支持鎖定整個 Weblate 安裝。
檢查與支持來源字串的審查。
支持翻譯和源字串的使用者註釋。
更好地更改日誌跟踪。
現在更改可以使用 RSS 監測。
改進了對 RTL 語言的支持。

Weblate 1.2#

發佈於 2012 年 08 月 14 日。

Weblate 現在為資料庫遷移使用 South，如果升級的話請檢查升級的指示。
修復了連接 git repos 的小問題。
現在將人員與翻譯建立聯繫的簡介頁面使用 Weblate。
添加了小程序，可以用於推動翻譯項目。
添加了選項將倉儲重置為原始狀態（對於有特權的使用者）。
現在可以為翻譯鎖定項目和組件。
禁止一些翻譯的可能性。
添加新翻譯的可配置選項。
每個項目的 git 提交的配置。
簡單的防垃圾郵件保護。
主頁面更好的佈局。
支持每次提交時自動推送更改。
支持譯者電子郵件通知。
在配置編輯器中只列出使用的語言。
改進了當導入項目時對未知語言的處理。
支持翻譯者鎖定翻譯。
可選地維護 po 文件中的 Language-Team 標頭。
在 about 頁面中包括一些統計數據。
支持（並且需要）django-registration 0.8。
Caching counts of strings with failing checks.
在設置中檢查要求。
文件改進。

Weblate 1.1#

發佈於 2012 年 07 月 04 日。

改進了幾個翻譯。
新建組件時更好的驗證。
為在組件之間分享 git 倉儲添加了支持。
不必每次嘗試都提交來拉取遠程 repo。
為卸載索引添加了支持。

Weblate 1.0#

發佈於 2012 年 05 月 10 日。

改進了添加/存儲組件時的驗證。
試驗支持Android組件文件（需要打補丁的 ttkit）。
來自鉤子的更新在後台運行。
改進了安裝指示。
改進了字典中的導航。

Weblate 0.x 系列#

Weblate 0.9#

發佈於 2012 年 04 月 18 日。

修復了未知語言的導入。
改進了附近消息的列表。
改進了幾項檢查。
文件更新。
為更多的幾種語言添加了定義。
各種編碼清理。
文件改進。
更改了文件佈局。
將幫助腳本更新為 Django 1.4。
改進了翻譯時的導航。
更好地處理 po 文件的重命名。
新建組件時更好的驗證。
將完全設置集成到 syncdb 中。
為所有翻譯頁面添加了最近更改的列表。
Check for untranslated strings ignores format string only messages.

Weblate 0.8#

發佈於 2012 年 04 月 03 日。

用 Whoosh 代替自己的全文搜索。
對檢查的各種修改和改進。
新的命令更新檢查。
很多翻譯更新。
添加了字典，來存儲最常用的術語。
為倉儲狀態的概況添加了 /admin/report/。
機器翻譯頁面不再阻礙裝入頁面。
管理界面現在也包含有用的行為來更新數據。
記錄使用者所做更改的日誌。
推至提交給 Git 的能力，來產生來自單一使用者的更少的提交。
瀏覽失敗檢查的可能性。
使用已經翻譯的字串來自動翻譯。
新的顯示使用的版本的頁面。
Django 1.4 的兼容性。
從 web 界面將更改推送給遠程 repo 的能力。
添加了對其他人完成的翻譯進行複查。

Weblate 0.7#

發佈於 2012 年 02 月 16 日。

對 GitHub 通知的直接支持。
添加了對清潔孤立的檢查與翻譯的支持。
翻譯時顯示附近的字串。
翻譯時顯示相似的字串。
改進了字串的搜索。

Weblate 0.6#

發佈於 2012 年 02 月 14 日。

添加了對翻譯的消息的各種檢查。
可調整的訪問控制。
改進了對新一行翻譯的處理。
添加了客戶端一側表格的排序。
在升級時請檢查升級指示。

Weblate 0.5#

發佈於 2012 年 02 月 12 日。

通過使用後面的服務對機器翻譯的支持：
- Apertium
- 微軟的 Translator
- MyMemory
幾個新的翻譯。
改進了上游更改的合併。
更好地處理並發的 git 拉取與翻譯。
傳播那些同樣用於模糊更改的工作。
傳播那些同樣用於文件上傳的工作。
修復了使用 FastCGI（也可能是其它）時的文件下載。

Weblate 0.4#

發佈於 2012 年 02 月 08 日。

將使用嚮導添加到文件中。
修復了不需要 CSRF 保護的 API 鉤子。

Weblate 0.3#

發佈於 2012 年 02 月 08 日。

對於復數翻譯更海底顯示源。
Sphinx 格式的新文件。
翻譯時顯示第二語言。
改進了錯誤頁面，來給出現有項目的列表。
新的每種語言的統計數據。

Weblate 0.2#

發佈於 2012 年 02 月 07 日。

改進了幾種形式的驗證。
在個人資料升級時警告使用者。
記住 URL 用於登錄。
輸入複數形式時對文本區域的命名。
自動擴大翻譯區域。

Weblate 0.1#

發佈於 2012 年 02 月 06 日。

初始發佈。

角色	超級使用者
專案選取	所有公開專案
語言選取	如定義
語言	捷克語

角色	審核字串, 管理倉儲
組件	foo/bar
語言	西班牙語