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

Question

我的Python Sphinx restructuredtext项目包括空的第一级部分。如何在不使用原始Javascript的情况下将用户重定向到HTML输出的第一小节？

嗨，

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:角色将生成指向该部分的链接，链接标题为“要交叉引用的部分”。当节和引用位于不同的源文件中时，此方法同样适用。