Sphinx + HTML 幫助研討會：每個部分的單獨頁面

Question

使用 Sphinx 構建 *.rst 文件后，我正在使用 HTML Help Workshop 創建一個 CHM 文件。

到目前為止我的 index.rst 文件：

.. toctree::
   :maxdepth: 2

   _static/presentation_designer/feedback
   _static/presentation_designer/test

我有兩個 *.rst 文件，它們位於“presentation_designer”文件夾下。 每個feedback.rst 和test.rst 文件在CHM 文件中都有自己單獨的頁面。

反饋。

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

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

Please feel free to leave feedback.

測試.rst

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

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

Please test and click ‘submit’.

---

但是我得到了附件中顯示的結果。

如何將它們（測試和反饋頁面）放在“演示設計器”下？

Answer 1

您知道，CHM 導航窗格中的目錄 (TOC) 源自重組的文本文件，通常取決於標題、副標題和副標題。

請查看以下屏幕截圖（導航窗格）以滿足您的特殊要求和以下源文件。 我使用FAR HTML編譯的結果 CHM 但使用 Microsoft 的 HTML Help Workshop 也適用於此。

索引.rst：

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

Contents:

.. toctree::
   :maxdepth: 2

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

概述.rst：

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

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

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

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

_presentation-designer.rst：

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

.. toctree::

   coaching
   feedback

教練.rst：

.. toctree:: :maxdepth: 1

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

Feedback should not be a one-way street.

反饋.rst：

.. toctree::
   :maxdepth: 1

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

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