Sphinx + HTML Help Workshop ：每个部分的单独页面

Question

在使用 Sphinx 构建 *.rst 文件后，我正在使用 HTML Help Workshop 创建一个 CHM 文件。

目前我的 index.rst 文件：

.. toctree::
   :maxdepth: 2

   _static/presentation_designer/feedback
   _static/presentation_designer/test

我在 'presentation_designer' 文件夹下有两个 *.rst 文件。每个 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’.

但是我得到了附件中显示的结果。

如何将它们（测试和反馈页面）放在 "Presentation Designer" 下？

Answer 1

您知道，CHM 导航窗格中的 Table 目录 (TOC) 源自您重组的文本文件，通常取决于标题、副标题和副标题。

请查看以下屏幕截图（导航窗格）以了解您的特殊要求和下面的源文件。我使用 FAR HTML 但使用 Microsoft 的 HTML Help Workshop 编译的结果 CHM 也适用于此。

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:

..目录树:: :最大深度: 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.

Sphinx + HTML Help Workshop ：每个部分的单独页面

Sphinx + HTML Help Workshop : separate page for each section

html

python-sphinx

chm

html-help-workshop