防止部分标题在reStructuredText中进行字幕转换

时间:2014-05-29 15:18:42

标签: documentation markup restructuredtext

在reStructuredText中,标题后跟较低级别标题被读作副标题:

Section 1
=========

Subtitle
--------

但是,如果我真的希望在一个标题之后立即跟进一个小节标题怎么办?根据{{​​3}},空注释"用于终止前面的构造" ,但这似乎不适用于此处,

Section 1
=========

..

Section 2
---------

仍然会转换为第1部分的标题,然后是第2部分的标题,例如rst2latexpandoc

还有另一种方法可以防止"字幕翻译"没有在章节和小节标题之间写任何实际文本?

1 个答案:

答案 0 :(得分:1)

没关系,我明白了。反斜杠后跟空格将起作用:

Section 1
=========

\ 

Section 2
--------

我从规范中的tip on Simple Tables得到了这个想法:

  

要在已处理输出的第一列中没有文本的简单表中开始新行,请使用以下方法之一:

     
      
  • 空注释(“..”),可以从已处理的输出中省略(请参阅下面的Comments
  •   
  • 反斜杠转义符(“\”)后跟一个空格(参见上面的Escaping Mechanism
  •   

恕我直言,这不是很一致:第二种方法适用于分解标题和副标题,而第一种方法则没有,正如我在我的问题中所述。