2015-10-15 2 views
1

Возможно ли каким-либо образом пропустить уровни заголовков в RestructuredText? Например, данныйПропуск уровней заголовка в reStructuredText

#### 
PART 
#### 

******* 
Chapter 
******* 

Section 
======= 

Subsection 
---------- 

Subsubsection 
^^^^^^^^^^^^ 

Paragraph 
""""""""" 

Another section 
=============== 

Another Paragraph 
""""""""""""""""" 
The above heading seems to be rendered as a subsection-level heading... 

Последний абзац представляется как подраздел, а не как абзац. (Я использую Sphinx как средство визуализации.) Так что, похоже раздел уровня обнаружения является локальным, хотя RestructuredText documentation говорит, что это должно быть последовательным:

Все стили заголовка раздела не должны быть использованы, и не нужны никакие конкретные раздел стиль названия. Тем не менее, документ должен быть согласован в с его использованием названий разделов: после того, как иерархия стилей заголовков будет установлена ​​ , разделы должны использовать эту иерархию.

ответ

1

При работе Сфинкса 1.3 на документе в вопросе, предупреждение испускается:

C:\path\to\test.rst:24: SEVERE: Title level inconsistent: 

«Еще один пункт» находится на линии 24 и визуализируется как заголовок подраздела, потому что это то, что сфинкс ожидает в этом положении.

Нет, вы не можете пропустить уровни заголовков. Вот как я интерпретирую смысл прохода о согласованности, указанном в вопросе.

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