狮身人面像的文件给我的警告有关toctree refrences

Contents: 

.. toctree:: 
    :maxdepth: 2 

    foo.rst 
    bar.rst 

Indices and tables 
================== 

* :ref:`genindex` 
* :ref:`modindex` 
* :ref:`search`

我试图用sphinx-build . doc它给了我警告构建它：狮身人面像的文件给我的警告有关toctree refrences

(WARNING/2) toctree references unknown document u'bar'

可能是什么原因？提前致谢。

来源

2010-12-13 user12345

与''foo.rst''是否在''bar.rst''在相同的目录中？如果没有，你可以在''foo.rst''的目录中为'bar.rst'添加一个sym-link吗？ – 2010-12-13 22:00:19

现在两者都在同一个目录中。现在错误是 - 文档不包含在任何toctree中。 – user12345 2010-12-14 06:48:55

斯芬克斯不需要toctree指令中的.rst扩展名。假设该指令类似于index.rst和bar.rst，它们位于相同的目录中，请尝试分别在您的toctree指令中分别替换foo.rst和bar.rst，使用foo和bar。

否则，请确保bar.rst位于正确的目录中（并且不在父目录或子目录中）。

来源

2010-12-13 22:03:01 ddbeck

我个人在'.toctree'例子下的每个文件都有'.rst'扩展名的生产代码，虽然'.rst'扩展名是可选的。 – 2010-12-13 22:43:14

我99％确定我已经看到一个与工作项目文件扩展名有关的错误，但我认为我们没有运行当前版本的Sphinx。所以它可能与版本有关。 – ddbeck 2010-12-14 02:21:45

直到我删除'：doc：'角色Sphinx版本1.4.5中的'.rst'扩展名时，我才有错误，所以同样的规则可能贯穿始终。 – DMfll 2016-08-20 11:56:01

我也遇到这个错误。对我来说，这是由于缩进。 “toctree”由3个空格字符缩进，而我用4个空格字符列出了第一个文件。要解决此问题，我们需要具有相同的缩进级别。

来源

2012-05-10 11:53:52 Thyag

欢迎来到堆栈溢出。请不要发表评论作为答案。一旦你有50名代表，你将能够留下评论。 – 2012-10-20 22:48:01

狮身人面像的文件给我的警告有关toctree refrences

回答

相关问题