使用Jinja2重定向Python-Sphinx生成的网页

Question

我的Python Sphinx restructuredtext项目包含空的第一级部分。如何将用户重定向到HTML输出的第一个子部分，而不求助于原始Javascript？

嗨,

index.rst格式如下：

Title
=====

.. toctree::
   :hidden:

   foo.rst
   bar.rst

为了避免显示空白的index.html页面，我通过以下技巧自动显示第一个子部分，即foo.html：

Title
=====

.. raw:: html

   <script type="text/javascript">
   window.location.href = "foo.html"
   </script>

.. toctree::
   :hidden:

   foo.rst
   bar.rst

有没有可能在Python-Sphinx中使用Jinja对所有的节应用相同的行为，即:如果节主体是空的，并且子节存在，那么回退到第一个子节？

Answer 1

添加label。

如果将标签直接放在节标题之前，则可以使用:ref:[backtick]label-name[backtick]引用它。例如：

.. _my-reference-label:

Section to cross-reference
--------------------------

This is the text of the section.

It refers to the section itself, see :ref:`my-reference-label`.

然后，:ref:角色将生成一个指向该部分的链接，该链接的标题为“要交叉引用的部分”。当部分和引用位于不同的源文件中时，这同样有效。