无法将狮身人面像链接到另一个文档

Question

我试图学习狮身人面像，我坚持只是基本的例子。我在源目录中的make html上遇到以下错误。

Running Sphinx v1.1.3 
loading pickled environment... not yet created 
building [html]: targets for 2 source files that are out of date 
updating environment: 2 added, 0 changed, 0 removed 
reading sources... [100%] intro             
/home/owner/Desktop/doc/index.rst:11: ERROR: Error in "toctree" directive: 
invalid option block. 

.. toctree:: 
    :maxdepth: 2 
    intro.rst 
looking for now-outdated files... none found 
pickling environment... done 
checking consistency... /home/owner/Desktop/doc/intro.rst:: WARNING: document isn't included in any toctree 
done 
preparing documents... done 
writing output... [100%] intro             
writing additional files... genindex search 
copying static files... done 
dumping search index... done 
dumping object inventory... done 
build succeeded, 2 warnings. 

Build finished. The HTML pages are in _build/html. 

我也尝试引用intro代替intro.rst既不似乎工作。 index.rst和intro.rst位于相同的目录中。我使用sphinx-quickstart和所有默认选项制作了该项目。

Answer 1

您需要在指令的选项及其内容之间留空行。您也不需要文件扩展名。更改为：

.. toctree:: 
    :maxdepth: 2 

    intro