sphinx - 如何更改文档样式表
我用sphinx生成了Python的文档，想在Qt Assistant上查看，但Python开发者用的文档主题在Qt Assistant上好像有点问题。有没有办法在生成文档之前更改或覆盖这个主题呢？
谢谢！
附注：我按照这里的一些指示操作过 http://docs.python.org/devguide/documenting.html#using-make-make-bat，但我没有执行 make html，而是用了 sphinx-build -b qthelp . build/qthelp，然后再运行 qcollectiongenerator-qt4 build/qthelp/Python.qhcp。我使用的是sphinx 1.1.3。
2 个回答
在Sphinx中进行主题设置非常简单。你只需要在你的Sphinx包目录中找到想要修改的主题，或者在网上选择一个主题。接下来，把这个主题放到一个文件夹里（比如说 _themes），然后把这个文件夹添加到你的 conf.py 文件中。默认情况下，conf.py 中应该已经有一行是用来指定主题路径的。现在，在 conf.py 中找到 html_theme，把你的主题名称填进去。
这样就可以了。
大多数标准主题都是基于 basic 主题的，并且继承了它的大部分类。你可以把这个主题当作一个实验场，因为它包含了大部分内容，而且没有复杂的继承关系。
另外，我注意到你在使用自定义构建器。自定义构建器可能也是问题所在。在Sphinx中，使用默认的HTML构建器进行主题设置效果最好。不过，基本主题可能更适合你的工作流程，因为它去掉了很多花哨的东西。
这是Python文档中的一个错误，现在已经修复了 :) 你可以查看修复的详细信息，链接在这里：http://hg.python.org/cpython/rev/2a6c33592e40 和 http://hg.python.org/cpython/rev/d6831d94dd1e