reStructuredText には次のディレクティブがあることは知っています:
.. code:: bash
gedit pohl.m
コード ブロックをレンダリングします。次のようなインライン スニペットの構文を強調表示する方法はありますか。
Do edit the file, type ``gedit pohl.m`` into a terminal.
バックティックはコードとしてマークしますが、ブロックのようにピグメントで強調表示したいと思います。これは可能ですか?
ベストアンサー1
これをさらに調べてみると、私は偶然この文書を見つけましたreStructuredText 解釈テキストロールこの文書から:
解釈されたテキストでは、テキストの前後にバッククォート (`) が使用されます。明示的なロール マーカーは、オプションでテキストの前または後にコロンで区切って表示できます。例:
This is `interpreted text` using the default role. This is :title:`interpreted text` using an explicit role.
どうやら、code
役割と入力するだけで
:code:`a = b + c`
インラインコードブロックをレンダリングします。構文の強調表示を取得するには、カスタムロールを定義します。たとえば
.. role:: bash(code)
:language: bash
これを次のように使用できます。
Here is some awesome bash code :bash:`a = b + c`.
ロール定義は、ロールへの参照の前に配置する必要があることに注意してください。
注意:私がリンクした文書では、参照しているdocutilsのバージョンについては何も言及されていません。コードの役割はないdocutils 0.8.1 で利用可能です (テストする必要がある唯一のバージョンです)。