【问题标题】:toctree numbering not shown on external link entries外部链接条目上未显示目录树编号
【发布时间】:2019-02-28 12:07:42
【问题描述】:

我目前正在使用 Sphinx 编写技术文档。

我使用编号的目录树。当我在目录树中插入外部 Web 链接时,呈现的条目不包含数字。

对于这个目录树:

.. toctree::
   :numbered:
   :hidden:
   :maxdepth: 2

   Administration <admin/admin.rst>
   Usage <usage/usage.rst>
   Squash TM - Squash TF Link <tm-tf-link/tm-tf.rst>
   Download <https://squash-tf.readthedocs.io/en/latest/download.html#squash-tf-execution-server>

“下载”条目有结果:

有没有人给我一些建议?

【问题讨论】:

  • IMO 这是一个错误。我找不到anything relevant in their repo,所以我建议你创建一个新问题。
  • 确实,我也认为这是一个错误,并且在他们的回购中没有发现任何关于这个主题的内容。我在打开错误之前在这里问过,以防我错过了什么。感谢您的回答。

标签: python-sphinx read-the-docs toctree


【解决方案1】:

这似乎是@StevePiercy 提到的错误。我刚刚提交了一份关于它的错误报告here。一个类似的问题是this one。但是,您可以手动设置缺失的索引。

Hello world
============

.. toctree::
   :numbered:
   :hidden:
   :maxdepth: 2

   Administration <admin/admin.rst>
   Usage <usage/usage.rst>
   Squash TM - Squash TF Link <tm-tf-link/tm-tf.rst>
   4. Download <https://squash-tf.readthedocs.io/en/latest/download.html#squash-tf-execution-server>

输出:

【讨论】:

  • 感谢您打开错误。是的,手动放置是等待修复的工作周转。
猜你喜欢
  • 2013-07-28
  • 2017-04-27
  • 1970-01-01
  • 2020-06-25
  • 1970-01-01
  • 1970-01-01
  • 2010-11-16
  • 1970-01-01
  • 1970-01-01
相关资源
最近更新 更多