Rst(ReStructuredText)符号'和覆盖'效果

时间:2012-02-22 07:12:21

标签: restructuredtext

我正在尝试使用 rst 作为文档,但我无法找到明确的参考资料。字体大小顺序(升序/降序)下划线和上划线符号的顺序是什么?我读过提到的维基百科文章

Header
======

Sub-header
----------

但是当我在在线第一个编辑器中尝试这个(我不确定这是多么值得信赖)和更改顺序时,字体大小(标题顺序) 似乎取决于这些标题的顺序(即第一个获得<h1>,下一个获得<h2>等),而不管使用的符号( - 或=)。

另外,当我将它们用于上线时,它们对于只有下划线的那些以及同时具有下划线和下划线的那些具有不同的字体大小。上划线(使用相同的符号, - 或=)。换句话说,上线也会影响输出。如果使用其他符号,则也会影响字体大小。 为了增加混乱,我已经看到使用像*和#这样的符号,它们似乎也会影响尺寸。

但是,在尝试所有这些符号时,我仍然无法将这些符号中的任何符号映射到明确的标题/字体大小。我也无法理解它们的外观顺序有什么影响。不要忘记,如何使用上线?

2 个答案:

答案 0 :(得分:2)

在reStructuredText(特此reST)中,标题标记有两种变体:

with underline symbols
@@@@@@@@@@@@@@@@@@@@@@

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
with both under and overline symbols
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

它们之间没有预先定义的顺序,规则是第一次出现的是最重要的标题,第二种出现的类型将是第二个重要标题等。

另外,您怀疑对于下划线或下划线和下划线选择的每个符号都是如此。

你可以找到一些常规作为使用的符号,但它比其他任何东西都更常见,所以请选择最适合你的方法。

答案 1 :(得分:0)

这不是一个非常明确的答案,但如果有人再次遇到同样的疑问,我希望这可能会有所帮助。

似乎订单比使用的符号更重要。我的观察太奇怪了,无法用文字轻松澄清 - 前2个符号的效果会在字体大小上切换。第一次出现时给出最大的文本大小(有或没有上划线)。第二个符号的大小将减少一个(当切换上线时,它等于第一个符号)。当切换该符号的上划线时,给出的文本大小等于第一个符号(第一次出现),即最大符号。在前两个符号之后,接下来的两个符号会减小尺寸。在此之后,没有符号有任何影响。

我稍后会看一下python的文档实用程序代码,它将澄清。