如何覆盖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/

   到<your_sphinx_proj>locales/ja/LC_MESSAGES/。

   请注意目录名locale(locale_dirs配置选项的默认值(。

2. 编辑sphinx.po.副本中相关条目的msgstr(在这种情况下为警告(

   没有必要保留整个副本。如果需要，可以删除未更改的条目。

3. 使用language=ja运行sphinx build(在conf.py中或在命令行上设置(。生成本地项目特定的sphinx.mo文件，并在构建中使用。

这意味着同一域("sphinx"(将有两个*.mo文件。首先咨询当地的狮身人面像，并使用狮身人面的原始狮身人身像作为后备。