Rst（ReStructuredText）記号と 'overlines'の効果

Question

私はrstのドキュメントを使用しようとしていますが、よくわかりやすい参照を見つけることができません。下線と上線の記号のフォントサイズ順（昇順/降順）の順序は？私は

Header 
====== 

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

を言及しかし、私はオンラインRSTエディタでこれをしようとすると（私はこれがどのように信頼できることを確認していない）Wikipediaの記事を読んで、順序を変更している、フォントサイズ（ヘッダ順） は依存しているようです使用される記号（ - または=）に関係なく、これらのヘッダーが来る順序で（つまり、最初に<h1>を取得し、次に1つが<h2>などとなります）。

また、私はそれらを上書き用に使用すると、下線のみのものと下線の両方（下線と下線の両方）のフォントサイズが異なります（同じ記号、 - または=を使用）。つまり、オーバーラインも出力に影響します。他のシンボルを使用すると、それもフォントサイズに影響します。 そして混乱を増やすために、私は*や＃のようなシンボルの使用を見てきましたが、それらもサイズに影響するようです。

しかし、それらのすべてを試しても、私はまだこれらのシンボルのいずれかを明確な見出し/フォントサイズにマッピングすることはできません。私はまた、彼らの出現の順序がどんな効果を持つのか理解できません。そして、忘れてはならない、オーバーラインの使い方はどうやって？ reStructuredTextの（ここREST）で

Answer 1

、タイトルマークアップの2つの変種がある。

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

と

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

は、それらの間に事前定義された順序はありません、ルールは、最初の発生であります最も重要なタイトルです。発生する2番目のタイプは、2番目の重要なタイトルなどになります。

また、あなたが選択した各シンボルについて同じことが当てはまると思われるライニング、アンダーライン、アンダーライン。

どのようなシンボルを使用するかは、何よりも一般的ですが、あなたに最適なものを選んでください。

Answer 2

これはあまり明確な答えではありませんが、誰かが再び同じ疑念を抱く場合は、これが参考になると思います。

使用される記号よりも順序が重要であるようです。私の見解は、言葉で簡単に明らかにするにはあまりにも奇妙です。最初の2つの記号は、フォントサイズにトグルされた効果を持ちます。最初のオカレンスは最大のテキストサイズを提供します（オーバーラインありまたはなし）。 2番目のシンボルのサイズは1つ小さくなります（これは、オーバーライドされたときの最初のシンボルと同じです）。このシンボルの上線をトグルすると、最初のシンボル（最初のオカレンス）、すなわち最大のものと等しくなるテキストサイズが与えられます。これらの最初の2つの後に、次の2つの記号が減少するサイズを与えます。この後、シンボルは効果を持ちません。

私は後で明らかにするpythonのドキュメントユーティリティのコードを見ていきます。