rst2html.pyに構文の強調表示にCSSを含めるにはどうすればよいですか？

Question

ReStructured Textソースに対してコードブロックディレクティブを使用してrst2html.pyを実行すると、すべてのスパンとクラスがHTMLのコードのビットに追加されますが、実際にそれらのスパンをカラー化するCSSは存在しません。 RSTにCSSリンクを追加したり、CSSをHTMLファイルに埋め込んだりすることは可能ですか？

Answer 1

Docutils 0.9では、code directiveを使用できます。このページの例：

.. code:: python 

def my_function(): 
    "just a test" 
    print 8/2 

また、構文強調表示にPygmentsを使用することもできます。 Using Pygments in ReST documentsおよびthis SO答えを参照してください。

最後に、thisまたはthis blogpostのコードを使用することもできます。 Pygmentsが使用するスタイルファイルを取得する

更新コメントで述べたように、Pygments CSSスタイルファイルstyle.cssを生成するコマンド

pygmentize -S default -f html -a .highlight > style.css 

を使用しています。

Answer 2

docutils 0.9と0.10では、コード、コードブロック、ソースコードのどちらを使用しても問題ありません。すべての指令はcode roleとみなされます。

このコマンドは、rst2html.pyによってhtmlに埋め込むことのできるCSSを生成します。

デフォルトで

rst2html.py --stylesheet=syntax.css in.txt > out.html 

、rst2html.py出力はcomment、number、integer、およびoperatorようなクラス名でまたがる：

pygmentize -S default -f html -a .code > syntax.css 

このコマンドは、HTMLを生成します。あなたがソースと同じディレクトリに、または/etc、または

[parsers] 
[restructuredtext parser] 
syntax_highlight=short 

と~/.docutilsのいずれかdocutils.confを持っている場合は...その後、クラス名はc、m、mi、およびによって生成されたsyntax.cssと一致するoなりますpygmentize。

See syntax-highlight in docutils documentation