Перенаправить созданную Python-Sphinx веб-страницу с Jinja2

Question

Мой проект Python Sphinx restructuredtext содержит пустые разделы 1-го уровня. Как я могу перенаправить пользователей в первый подраздел вывода HTML, не прибегая к необработанному Javascript?

Привет

index.rst выглядит следующим образом:

Title
=====

.. toctree::
   :hidden:

   foo.rst
   bar.rst

Чтобы избежать отображения пустой страницы index.html, я автоматически отображаю 1-й подраздел, а именно foo.html, с помощью следующего трюка:

Title
=====

.. raw:: html

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

.. toctree::
   :hidden:

   foo.rst
   bar.rst

Возможно ли применить одинаковое поведение ко всем разделам с Jinja в Python-Sphinx, т. Е. Если тело раздела пусто и подразделы существуют, то вернуться к 1-му подразделу?

Answer 1

Добавить ярлык .

Если вы поместите ярлык непосредственно перед заголовком раздела, вы можете сослаться на него с помощью :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: затем создаст ссылку на раздел с заголовком ссылки «Раздел для перекрестных ссылок». Это работает так же хорошо, когда раздел и ссылка находятся в разных исходных файлах.