无法在Sphinx中获取TOCTREE以显示链接

Cannot Get TOCTREE in Sphinx to Show Link(无法在Sphinx中获取TOCTREE以显示链接)
本文介绍了无法在Sphinx中获取TOCTREE以显示链接的处理方法,对大家解决问题具有一定的参考价值,需要的朋友们下面随着小编来一起学习吧!

问题描述

我是新来的斯芬克斯。我尝试了该教程,但未能在内容中生成链接。我收到的错误

C:Usersmhaikalmsphinxtestsourceindex.rst:11: WARNING: toctree contains refe
rence to document 'intro' that doesn't have a title: no link will be generated
C:Usersmhaikalmsphinxtestsourceindex.rst:11: WARNING: toctree contains refe
rence to document 'zuhdi' that doesn't have a title: no link will be generated
writing additional files... (0 module code pages) genindex search
copying static files... done
dumping search index... done
dumping object inventory... done
build succeeded, 3 warnings.

Build finished. The HTML pages are in build/html.
我在与index.rst相同的目录中创建了zuhdi.rstintro.rst。如何为文档添加标题?

仅供参考,My index.rst包含以下行:

Contents:

.. toctree::
   :maxdepth: 2

   intro
   zuhdi
是否必须存在文档才能将链接放入目录树中?intro.rstzuhdi.rst只是一个空文件。

推荐答案

您收到此错误,因为您在intro.rst中没有标题。
要解决此问题,请向intro.rst添加标题。假设您希望标题为My Title,则可以通过将以下两行作为intro.rst的第一行来添加标题:

My Title
*********

请注意,您必须有足够的*个字符来为您的书目添加完整的下划线,否则您将收到有关错误的书目或其下划线的另一个错误。

这篇关于无法在Sphinx中获取TOCTREE以显示链接的文章就介绍到这了,希望我们推荐的答案对大家有所帮助,也希望大家多多支持编程学习网!

本站部分内容来源互联网,如果有图片或者内容侵犯您的权益请联系我们删除!

相关文档推荐

Leetcode 234: Palindrome LinkedList(Leetcode 234:回文链接列表)
How do I read an Excel file directly from Dropbox#39;s API using pandas.read_excel()?(如何使用PANDAS.READ_EXCEL()直接从Dropbox的API读取Excel文件?)
subprocess.Popen tries to write to nonexistent pipe(子进程。打开尝试写入不存在的管道)
I want to realize Popen-code from Windows to Linux:(我想实现从Windows到Linux的POpen-code:)
Reading stdout from a subprocess in real time(实时读取子进程中的标准输出)
How to call type safely on a random file in Python?(如何在Python中安全地调用随机文件上的类型?)