Sphinx + HTML Help Workshop: отдельная страница для каждого раздела

Question

После создания *.rst файлов с помощью Sphinx я создаю файл CHM с помощью HTML Help Workshop.

Мой файл index.rst до сих пор:

.. toctree::
   :maxdepth: 2

   _static/presentation_designer/feedback
   _static/presentation_designer/test

У меня есть два *.rst файла, которые находятся в папке presentation_designer. Каждый файл feedback.rst и test.rst имеет свою отдельную страницу в файле CHM.

feedback.rst

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
**Presentation Designer**
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
**Leave Feedback**
""""""""""""""""""""""""""""""""""""""""""""""""""""""""""

Please feel free to leave feedback.

test.rst

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
**Presentation Designer**
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
**test**
""""""""""""""""""""""""""""""""""""""""""""""""""""""""""

Please test and click ‘submit’.

---

Но у меня есть результат, как показано в прикрепленном файле.

Как их объединить (страницы тестирования и обратной связи) в разделе "Дизайнер презентаций"?

Answer 1

Вы знаете, что оглавление (TOC) в области навигации CHM получено из вашего реструктурированного текстового файла и обычно зависит от заголовка, субтитров и субтитров.

Пожалуйста, посмотрите на следующий снимок экрана (панель навигации) для ваших особых требований и исходных файлов ниже. Полученный в результате CHM, который я скомпилировал с использованием FAR HTML, но с помощью HTML Help Workshop от Microsoft также работает для этого.

index.rst:

Welcome - CHM Sphinx Demo
=========================

Contents:

.. toctree::
   :maxdepth: 2

   first-steps/overview
   _static/presentation-designer/_presentation-designer

overview.rst:

********
Overview
********

About FAR HTML
##############
... some text

Features
########
... some text

Help Authoring:
***************
... some text

_presentation-designer.rst:

Presentation Designer
=====================

.. toctree::

   coaching
   feedback

coaching.rst:

.. toctree::
   :maxdepth: 1

Coaching conversations
######################

Feedback should not be a one-way street.

feedback.rst:

.. toctree::
   :maxdepth: 1

Real-time Feedback
##################

Feedback happens less than it should and often comes too late.