14

いくつかのreStructuredTextにカラースパンを追加する方法を説明する前の質問があります。

手順を要約するには：

まず、あなたには役割があります。

.. role:: red

An example of using :red:`interpreted text`

これは次のように変換されます。

<p>An example of using <span class="red">interpreted text</span></p>

これで、赤のクラスができました。CSSを使用して色を変更できます。

.red {
    color:red;
}

複数行にまたがるテキストが必要な場合、これをどのように行いますか？例えば：

.. role:: red

:red:`paragraph 1

      paragraph 2

      paragraph 3`

段落1、2、および3はすべて「赤」になります。これを行おうとすると、警告メッセージが表示されます。

警告：インラインで解釈されたテキストまたはフレーズ参照の開始文字列と終了文字列。

スパンは作成されず、テキストに「：red：」が挿入されます。これは文字列として解釈されません（警告が示唆しているように）。

基本的に、これはreStructuredTextで行うことができますか？可能であれば、どのように行うことができますか？

Sphinx1.1.3を使用しています。

4

1 に答える 1

14

これを行うにはいくつかの方法がありますが、そのうちの1つはclassディレクティブを使用することです。

.. class:: red

    This is a paragraph.

    This is another paragraph.

ほとんどのdocutilsHTMLライターは、それをクラスhtml属性としてhtml出力に入れ、CSSでスタイルを設定できます。

ただし、特にSphinxでは、少なくとも一部のケースではrst-classなく、を使用する必要がある場合があります。class参照：https ：//www.sphinx-doc.org/en/2.0/usage/restructuredtext/basics.html

また、RestructuredTextの多くのブロックレベルの要素は、:class:ほとんど同じことを行うパラメーターを取ります。

于 2012-10-23T20:58:38.247 に答える