Question

我对狮身人面像很陌生。 Doc表示设置起来很容易-也许是这样，但是我很忙。我终于有了创建的.rst文件，但是当我更新了index.rst时，却遇到此错误。我确认.rst文件存在于/ docs目录中。以下是我的conf.py和索引中的syspath。

我尝试了所有这些组合，但均未成功-.rst文件位于/home/efultz/src/Sicom2.0/docs

sys.path.insert(0, os.path.abspath('/home/efultz/src/Sicom2.0/'))
sys.path.insert(0, os.path.abspath('/home/efultz/src/Sicom2.0/docs'))
sys.path.insert(0, os.path.abspath('.'))
sys.path.insert(0, os.path.abspath('../'))
sys.path.insert(0, os.path.abspath('../..'))
sys.path.insert(0, '/home/efultz/src/Sicom2.0/')

我在index.rst中有以下内容-我确认单个文件名前只有3个空格

.. toctree::
   :maxdepth: 2
   :caption: Contents:

   Base
   BaseAPI
   EventLogger
   SICOMToConnex
   SICOMToConnexAPI
   SICOMToConnexAPIProduct
   SICOMToConnexDemo
   SICOMToConnexParser
   SICOMToConnexParserAPI
   SICOMToConnexParserAPIProduct
   product
   modules

Answer 1

我发现通过配置使用相同的目录，而不是在创建.RST文件时将目录分割成所需的目录。

Sphinx toctree包含对不存在文档的引用

1 个答案: