Rst(ReStructuredText) 符号和上划线的效果答案

【问题标题】：Rst(ReStructuredText) symbols' and overlines' effectRst(ReStructuredText) 符号和上划线的效果
【发布时间】：2012-02-22 07:12:21
【问题描述】：

我正在尝试使用 rst 作为文档，但我无法找到好的和明确的参考。字体大小顺序（升序/降序）中下划线和上划线的符号顺序是什么？我已经阅读了提到

的维基百科文章

Header
======

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

但是当我在在线 rst 编辑器中尝试这个时（我不确定这是多么值得信赖）并更改顺序，字体大小（标题顺序）似乎取决于这些标头出现的顺序（即第一个获得<h1>，下一个获得<h2> 等），而与使用的符号（-或=）无关。

此外，当我将它们用于上划线时，它们对于只有下划线的字体和同时带有下划线和上划线的字体大小不同（使用相同的符号，- 或 =）。换句话说，overline 也会影响输出。如果使用其他符号，也会影响字体大小。为了增加混淆，我也看到了 * 和 # 等符号的使用，它们似乎也会影响大小。

但是，在尝试使用所有这些符号时，我仍然无法将这些符号中的任何一个映射到明确的标题/字体大小。我也无法理解它们的出现顺序有什么影响。不要忘记，上划线的使用是如何发挥作用的？

【问题讨论】：

标签： restructuredtext

【解决方案1】：

在 reStructuredText（此处称为 reST）中，有 2 种标题标记变体：

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

和

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

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

正如您所怀疑的，对于您选择用于下划线或下划线和上划线的每个符号也是如此。

你可以找到一些约定来作为使用什么符号，但它比其他任何东西都更常见，所以选择最适合你的。

【讨论】：

【解决方案2】：

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

似乎顺序比使用的符号更重要。我的观察太奇怪了，无法用文字轻松澄清 - 前两个符号将在字体大小上切换它们的效果。即第一次出现给出最大的文本大小（有或没有上划线）。第二个符号将有一个较小的大小（在切换上划线时等于第一个符号）。当切换此符号的上划线时，给出的文本大小将等于第一个符号（第一次出现），即最大。在前两个之后，接下来的两个符号给出了递减的大小。在此之后，任何符号都没有任何效果。

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

【讨论】：