python - 使用Sphinx使用:glob:生成Python文档

Question

我是 Sphinx 的新手。

文件/home/user/myproject/docs/source/index.rst如下:

My project contents:

.. toctree::
   :glob:

   *

我在 /home/user/myproject/docs/ 下运行 $ make html 时收到以下消息:

checking consistency... /home/user/myproject/docs/source/design/index.rst:: WARNING: document isn't included in any toctree

我做错了什么？我希望 Sphinx 根据目录层次结构自动生成结构。

Answer 1

我不认为这是受支持的操作。

幸运的是，这也不是一个非常理想的选择，因为您通常希望文档的各个部分以特定顺序出现。