python - Python 文档或 Sphinx 文档中的文档主页？

Question

我试图获得在 Python 和 Sphinx 文档主页上获得的效果。我的意思是目录结构。 toctree 是否有任何关键字可以获得类似的效果，或者我必须手动执行此操作？我试图在文档中找到一些东西，但没有成功，遗憾的是 Sphinx 文档的主页没有提供第一个文件的来源。

有什么想法吗？

这是 Sphinx doc main page

我需要 DOCUMENTATION 部分的格式效果，其中包含第一步、搜索页面、内容和一般索引等成员。

Answer 1

Sphinx 文档 start page不是从 reST 文件生成的；它是从 Jinja templates 构建的.主模板是index.html .使用继承:index.html extends layout.html ，它又扩展了 basic/layout.html .

为了获得所需的“格式效果”，您需要研究主题和模板:

• http://sphinx-doc.org/theming.html
• http://sphinx-doc.org/templating.html