Как создать правильный уровень заголовка с помощью rst2html - PullRequest
Новая
       75

Как создать правильный уровень заголовка с помощью rst2html

0 голосов
/ 09 января 2019

Я не понимаю, почему: 

H1: document title
##################

Sample H2
*********
Sample content.

Результат: 

<div class="document" id="h1-document-title">
<h1 class="title">H1: document title</h1>
<h2 class="subtitle" id="sample-h2">Sample H2</h2>

<p>Sample content.</p>
</div>

тогда 

H1: document title
##################

Sample H2
*********
Sample content.

Sample H3
*********
Sample content.

Результат: 

<div class="document" id="h1-document-title">
<h1 class="title">H1: document title</h1>

<div class="section" id="sample-h2">
<h1>Sample H2</h1>
<p>Sample content.</p>
</div>
<div class="section" id="sample-h3">
<h1>Sample H3</h1>
<p>Sample content.</p>
</div>

т.е. У меня не может быть элемента h1, за которым следует более одного h2. Спасибо.

1 Ответ

0 голосов
/ 09 января 2019

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

См. http://docutils.sourceforge.net/docs/user/rst/quickstart.html#document-title-subtitle.

Пример: 

Document title
##############

Subtitle
.........

Heading 1
*********
Sample content.

Heading 2
---------
Sample content.

Heading 3
---------
Sample content.

Из этой разметки rst2html будет генерировать HTML с заголовками следующим образом:

  • Название документа: <h1> (по центру)
  • Подзаголовок: <h2> (по центру)
  • Заголовок 1: <h1>
  • Заголовок 2: <h2>
  • Заголовок 3: <h2>
...