2016-01-18 6 views
5

私が試したすべてのレンダラーで、codecode-blockは全く同じ結果を示しています:コードブロック。どちらも正確に同じHTMLを生成します - クラスとタグの種類を含む(私はそれがdocutilsだと思います):ReSTのコードとコードブロックのディレクティブの違いは何ですか?

<pre class="code [language] literal-block"> 

どういう違いがありますか?なぜ我々は両方を持っていますか?異なるレンダリングを行うレンダラはありますか?意味の違いはありますか?

答えて

6

codeはreStructuredTextディレクティブです。 code-blockはスフィンクス指令です。

code-blockには、codeディレクティブとは異なるオプションがあります。 など。 :emphasize-lines:

スフィンクスを使用しているので、私はcode-blockディレクティブの使用をお勧めします。

code-blockを使用すると、常に正しい強調表示が得られます。 codeを使用しているときに、ときどき色や時にはリテラルコードブ​​ロックだけが表示されることがあります。私は、conf.pyのどのような設定の組み合わせが、予想通りにカラー出力を生成するかをまだ分かりません。

codeディレクティブには、SphinxドキュメントツリーとスタンドアロンのreStructuredTextドキュメントの両方でドキュメントを使用できるという利点があります。

関連する問題