Sphinx + HTML帮助研讨会:每个部分的单独页面

时间:2016-12-13 22:13:38

标签: html python-sphinx chm html-help-workshop

使用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文件中都有自己独立的页面。

feedback.rst

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

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

Please feel free to leave feedback.

test.rst

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

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

Please test and click ‘submit’.

但我已经得到了附件所示的结果。

如何将它们(测试和反馈页面)放在" Presentation Designer"一起?

section issue

1 个答案:

答案 0 :(得分:1)

您知道,CHM导航窗格中的目录(TOC)是从您的重组文本文件中派生出来的,通常取决于标题,副标题和子标题。

请查看以下截图(导航窗格)以了解您的特殊要求和下面的源文件。生成的CHM我使用FAR HTML编译,但使用Microsoft的HTML Help Workshop也正在为此工作。

Help Viewer with navigation pane and content.

<强> 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.