如何覆盖Sphinx插入的英文标签

12 投票
2 回答
8614 浏览
提问于 2025-04-15 19:12

我在使用Sphinx Python 文档生成器。制作 PDF 文档非常简单方便,但我遇到了一个问题。

所有生成的 PDF 文档里都有一些英文词汇,比如“chapter”(章节)、“release”(版本)和“part”(部分)。

我该如何把这些英文标签换成其他语言,或者完全去掉它们呢?

2 个回答

11

在你的 conf.py 文件中,大约在第57行,有这么一段内容(这个文件是通过 sphinx-quickstart 创建的):

# The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages.
#language = None

在我的情况下,我把它改成了:

language = nl      # bug!

当然应该是:

language = 'nl'    # don't forget the quotes :-)

这样做会适用于所有 Sphinx 的输出格式;在我的情况下,我只检查了 HTML 和 LaTeX 的输出。在 Sphinx 的官网上,有一份 支持的语言列表

8

Sphinx会生成LaTeX文件,然后再用LaTeX生成PDF文件。所以,没错,你是可以这样做的,但通常需要学习LaTeX,并且要修改一些LaTeX的设置。我快速查了一下,没找到“章节”是在哪里定义的,所以它可能是在Bjarne章节标题样式中定义的(这是默认的样式),这就意味着你需要找到这个定义,看看能不能覆盖它,或者创建一个新的定义。

LaTeX的内容非常庞大,所以深呼吸一下。不过,这绝对是可以实现的。:)

撰写回答