Подразделы в reStructuredText

Question

Я пытаюсь написать документ в reStructuredText, но в настоящее время столкнулся с проблемой.

Я хочу, чтобы у документа был заголовок, он будет центрирован, а затем сразу после этого я хочу подраздел.

Я пытался сделать следующее

##############
Title
##############

+++++++++
Subtitle
+++++++++
content

Но когда я конвертирую это в PDF, заголовок и субтитры центрируются.

Answer 1

Из reStructuredText Краткое руководство пользователя заголовки и подзаголовки указываются следующим образом (выделено мной):

Чтобы указать заголовок документа в reStructuredText, используйте уникальный стиль украшения в начале документа. Чтобы указать субтитры документа, используйте другой уникальный стиль оформления сразу после заголовка документа.

Таким образом, в примере reST в вопросе Subtitle форматируется как подзаголовок, а не заголовок раздела, так как стиль оформления, используемый вокруг Subtitle, не используется нигде в документе. Далее это украшение используется вокруг двух заголовков разделов, поэтому оно не является уникальным и не рассматривается как подзаголовок:

##############
Document Title
##############

+++++++++++++++
Section 1 Title
+++++++++++++++

Section 1 content...

+++++++++++++++
Section 2 Title
+++++++++++++++

Section 2 content...

Играйте с http://www.tele3.cz/jbar/rest/rest.html Это позволяет вам быстро опробовать простой reStructuredText и проверить такие вещи, как субтитры и заголовки разделов.

Редактировать : В качестве альтернативы вы можете поместить текст между заголовком и заголовком раздела (например, реферат).

P.s. Я склоняюсь к тому, чтобы вы использовали украшения над и под заголовком, чтобы указать заголовок и подзаголовок документа, и одно украшение под заголовком, чтобы указать (под) заголовок раздела. Это позволяет легко увидеть, что я намеревался стать моим заголовком / подзаголовком. Например:

==============
Document title
==============
-----------------
Document subtitle
-----------------

Section
=======

Sub-section
-----------
etc.

Answer 2

Я думаю, что вполне естественно начинать подраздел сразу под заголовком раздела, как в

МОИ ВЕЩИ

Мое первое

...

Моя вторая вещь

...

Обходной путь, который я нашел методом проб и ошибок, состоит в том, чтобы поместить "\" (обратный слэш-пробел) в качестве нулевого содержимого между заголовком раздела изаголовок подраздела.С rst2html это дает желаемый эффект, не вводя лишнего пространства.