如何覆蓋 sphinx/locale/{language}/LC_MESSAGES/sphinx.po？

Question

我想覆蓋警告標簽。 警告是諸如note 、 warning等指令。

對於日語，標簽在https://github.com/sphinx-doc/sphinx/blob/master/sphinx/locale/ja/LC_MESSAGES/sphinx.po中定義。

有沒有一種簡單的方法可以在不更改主存儲庫的情況下覆蓋它們？

Answer 1

這對我有用（使用 Sphinx 3.3.1 測試）：

1. 從<sphinx_install_dir>/sphinx/locale/ja/LC_MESSAGES/復制日文sphinx.po

   到<your_sphinx_proj>/locales/ja/LC_MESSAGES/ 。

   注意目錄名稱locales （ locale_dirs配置選項的默認值）。

2. 為sphinx.po的副本中的相關條目（在本例中為警告）編輯msgstr 。

   沒有必要保留整個副本。 如果需要，您可以刪除未更改的條目。

3. 使用language=ja運行 sphinx-build（在 conf.py 或命令行中設置）。 在構建中生成並使用本地項目特定的sphinx.mo文件。

這意味着同一域（“sphinx”）將有兩個 *.mo 文件。 先參考本地的 sphinx.mo，使用 Sphinx 自帶的原始 sphinx.mo 作為 fallback。