3

実行環境

  • Python 3.9.6
  • sphinx 4.4.0

やりたいこと

code-blockディレクティブのハイライトを無効にしたいです。

.. code-block:: 

   list set dict ...

デフォルトの言語はpython3に近いものなので、下図のようにハイライトされてしまいます。

https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-highlight_language

画像の説明をここに入力

質問

code-blockの言語にnonetextpygments.lexers.special.TextLexer)を指定すれば、ハイライトが無効化されることが分かりました。
この2つには違いがあるのでしょうか?違いがあるのなら、どちらを指定するのがよいのでしょうか?

.. code-block:: text

   list set dict ...
.. code-block:: none

   list set dict ...
0

1 件の回答 1

3

明示的に「無効」を表現したいのであれば none を指定するのが良さそうです。

none はSphinxがPygmentsのTextLexerにマッピングしています。
text はSphinxがPygmentsのlexer取得を行い、TextLexerが取得されます。

どちらの場合でもPygmentsのTextLexerが使用されます。


PygmentsのLexer一覧は以下で確認できます。
https://pygments.org/docs/lexers/

Sphinxが none を受け付けることについては以下のドキュメントで確認できます。
https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#showing-code-examples

SphinxでnoneTextLexerにマッピングする処理は以下のコードで確認できます。
https://github.com/sphinx-doc/sphinx/blob/f38bd8e9529d50e5cceffe3ca55be4b758529ff7/sphinx/highlighting.py#L36

1
  • 1
    noneだけでなくpythoncも、SphinxがPygmentsのlexerにマッピングしているんですね。参考になりました。
    – yuji38kwmt
    Commented 2022年1月25日 2:22

この質問に回答するには、ログインする必要があります。

求めていた回答ではありませんか? のタグが付いた他の質問を参照する。