2015-10-15 98 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和它被呈現爲一個小節的標題,因爲這是獅身人面像期望在那個位置。

所以不,你不能跳過標題水平。這也是我如何解釋問題中引用的一致性段落的含義。