55

Sphinx を使用して後で Web ページを生成するために、ReStructuredText (ReST) 形式を使用していくつかのドキュメントを作成していますが、「太字イタリック」テキストを作成する方法が見つかりません。

いわゆる「強調」(斜体) と「強い強調」(太字) のテキストのマーカーがあります。それぞれ*italic text*と**bold text**です。また、この形式に関するいくつかのドキュメントで、これらの書式設定マーカーを単純に「ネスト」することはできないことを読みました。つまり、***text***(または) は太字の斜体テキスト** *text* **を生成しません。

それでも、太字とイタリックの両方のマーカーで強調されたテキストを生成する何らかの方法があるはずです。テキストの一部をそのようにマークすることは広く行われているからです。

4

3 に答える 3

35

Markdown は太字と斜体のネストをサポートしていますが、reStructuredText はサポートしていません (これは、reStructuredText で太字の斜体を表現する方法がないため、Markdown がより強力なまれなケースの 1 つです)。

https://gist.github.com/1855764

于 2012-08-16T10:02:04.023 に答える
19

HTML出力のレシピ。

my.rst:

.. role:: red
  :class: red

.. role:: bolditalic
  :class: bolditalic

:red:`WARNING` :bolditalic:`Don't be stupid!`

my.css:

.red { color: red; }
.bolditalic {
  font-weight: bold;
  font-style: italic;
}

ビルド方法:

rst2html --strip-comments --halt warning --stylesheet=my.css my.rst my.html
于 2014-04-05T19:42:59.027 に答える
14

Sphinx では、カスタム ロールを介してこれが可能です。css でスタイルを作成し、そのスタイルを指すロールを作成します。以下は、下線付きテキストの完全な動作例です: sphinx-dev thread。

編集：

良い例を次に示します: ReST 取り消し線

編集2：

その sphinx-dev リンクはもう利用できません。要点は次のとおりです。上記の取り消し線リンクと非常によく似ています。

CSS:

span.underlined {
  text-decoration: underline;
}

RST にロールを登録します。

.. role:: underlined
   :class: underlined

後でそれを使用する

:underlined:`test`

これらすべてを 1 つの RST ドキュメントに含めることができます。

.. raw:: html

   <style type="text/css">
     span.underlined {
       text-decoration: underline;
     }
   </style>

.. role:: underlined
   :class: underlined

:underlined:`test`

でテストしてください::

rst2html5.py test01.rst test01.html
于 2012-10-10T08:44:05.980 に答える