翻譯元件診斷

為任何給定的翻譯元件在 Weblate 設定或翻譯專案中顯示錯誤。還提供瞭如何將找到的問題定位的指南。

目前覆寫後面的內容:

  • 翻譯檔案中複製的來源字串

  • 翻譯中複製的語言

  • 儲存庫中的合併、更新或推送失敗

  • 解析翻譯檔案中的錯誤

  • 帳單限制(請參閱 帳單

  • 儲存庫包含太多的外發或丟失的提交

  • 缺少授權

  • 執行附加元件時的錯誤(見 附加元件

  • 設定錯誤的單語或雙語翻譯。

  • 損壞的 元件設定

  • 損壞的 URL

  • 未使用的螢幕擷圖

  • 模稜兩可的語言代碼

  • 在元件設定中未使用的新基礎

  • 複製連結元件使用的檔案遮罩

  • 衝突合併請求儲存庫設定

  • 元件似乎未使用(可透過 UNUSED_ALERT_DAYS 設定)

  • 未使用的詞彙表語言

警報每天更新,或在相關變化時更新(例如,當 元件設定 被改變或當儲存庫被更新)。

可使用 WEBSITE_ALERTS_ENABLED 停用專案網站可用性檢查,如果停用 Weblate 將不再產生無法連線的專案網站的警報。

各項警示會在相應元件頁面上以 診斷 列出。

專案及工作區診斷概覽

已登入的使用者可以開啟專案及工作區頁面的 診斷 分頁。開啟時才會載入概覽,並將相同類型的警示分組,而不會針對每個元件重複顯示。

專案概覽會將專案層級的診斷項目各顯示一次,並列出受元件層級診斷項目影響的元件:

含分組診斷項目及篩選條件的專案診斷概覽

工作區概覽會依專案將專案層級的診斷項目分組,並同時使用專案名稱及元件名稱來識別元件:

含分組診斷項目及篩選條件的工作區診斷概覽

每個診斷項目最多會列出 20 個受影響的專案或元件。其他受影響的物件會以數量顯示。請開啟元件連結,以查看完整的診斷詳細資料,或在元件頁面忽略該診斷。

摘要可以依作用中或已忽略狀態、嚴重性、類別,或已登入使用者是否能處理該診斷進行篩選。分享至專案的元件,只會列在其所屬專案的診斷中。

若缺少該項目,元件會清除目前所有檢查。問題警示無法忽略,但在根本問題修正後便會消失。

資訊及警告提示用於提供改善社群在地化的指引。這些提示可以關閉,並會讓 Diagnostics 分頁顯示出來,但不代表清單中的元件發生問題。

已忽略的診斷會記錄忽略者、忽略時間及選填原因。診斷詳細資料或相關設定變更時,系統會自動重新開啟已忽略的診斷。忽略及重新開啟都會記錄在元件變更記錄中。

警告及錯誤通知只會傳送給已訂閱且有權處理該診斷的專案維護者。資訊性建議不會主動傳送通知。

自訂警示可覆寫 BaseAlert.get_dismissal_context(component, details),以納入穩定且可序列化為 JSON 的設定或診斷輸入。傳回的情境資料若有變更,便會重新開啟已忽略的警示。不應納入評估時間等非固定值。

帶有複製的字串和語言的元件看起來像這樣:

../_images/alerts.webp

有衝突的儲存庫設定

當多個 Git 元件被設定為推送到相同儲存庫和推送分支而這些元件均不從那個分支進行拉取時顯示此警告。這包括拉取或合併請求工作流以及直接推送到單獨推送分支。這樣的設定可以覆蓋共享分支。

要解決這個問題,要麼為每個元件設定不同的 Push branch,要麼用 weblate://project/component 儲存庫 URL 在不同元件間共享一個儲存庫。