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

После создания * .rst файлов с Sphinx я создаю CHM-файл с помощью мастер-справки HTML.Sphinx + 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’.

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

Как я могу разместить их (страницы тестирования и обратной связи) в разделе «Дизайнер презентаций» вместе?

источник

2016-12-13 Sam Kim

Как вы темы в порядке одного уровня ниже папки можно увидеть выше отмеченные «Дизайнер презентаций»? –

Я думаю, вы спрашиваете о папке, которая включает в себя «Загрузить сцены» и «Расписание презентаций». Правильно? Эта папка была создана из отдельного отдельного файла, который содержит различные подразделы (например, «Загрузить сцены» и «Расписание презентаций»). Для простоты я не включил их в index.rst выше, но забудьте удалить их на картинке. Извини за это. –

Да, я видел идеальную структуру сверху, которую вы просите здесь для двух тем ниже в вашем снимке. Вы хотите, чтобы все это в «одном источнике» означало один index.rst? Или вы хотите добавить две специальные темы HTML в результате второго индекса rst и скомпилировать вместе как один CHM вручную с помощью HTML Help Workshop? Я спрашиваю, потому что можно редактировать, например. foobar.hhp для нескольких тем вручную перед компиляцией. –

Вы знаете, Содержание (ТОС) в навигационной панели CHM происходит от вашего реорганизованной текстового файла и обычно в зависимости от названия, подзаголовка унд subsubtitle.

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

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.

источник

2016-12-18 11:01:21

Ничего себе .. это работает очень хорошо .. Большое спасибо. :) –

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

ответ

Смежные вопросы