python - 使 Sphinx 在 PDF 输出中生成未分类的代码块

Question

代码块在 PDF 输出中看起来很难看(检查引号):

我使用 1.1.3 版的 Sphinx，并使用以下命令生成文档:

$ make latexpdf

此外，从 PDF 复制代码片段会破坏粘贴时的缩进:

@view_config(route_name=’hello’)
def hello_world(request):
return Response(’Hello World!’)

我希望这样:

@view_config(route_name=’hello’)
def hello_world(request):
    return Response(’Hello World!’)

这样会更好:

@view_config(route_name='hello')
def hello_world(request):
    return Response('Hello World!')

Answer 1

Sphinx 确实是一个出色的工具，但我对 latexpdf 目标的默认 PDF 输出也有一些问题。

具体来说:

• 代码块中的单引号被转换为锐角样式的引号，这在源代码中看起来不正确。
• 代码块没有从正文中缩进。对我来说，这会降低它们的可读性。
• 我更喜欢其他字体和 pygments，但这只是个人选择，可以进行配置。

其中一些可以在 Sphinx conf.py 的 LaTeX 前同步码部分修复，但引号由 Sphinx 修改为自定义 LaTeX 实体，因此 upquote LaTeX 包不能用于纠正它们。

在对不同的配置选项进行了大量实验之后，我最终编写了一个小脚本来在构建 PDF 之前修改 LaTeX 源代码。脚本是 here我想要生成的输出是 here . (为了比较 here 是同一文档的默认输出。)

如果有人有更简洁的解决方案，例如可以完全通过 Sphinx conf.py 完成的解决方案，那么 ReadTheDocs 将获取更改那我会感兴趣的。

此外，从 PDF 复制和粘贴时丢失缩进的问题可能不是 Sphinx/LaTeX 问题。