lincludeを使います。rstファイルや.pyファイルを読み込んだ場合は、きちんと判断してハイライト表示などをしてくれます。
課題
ちゃんと書く。literalincludeとincludeの使い分けは?
.. include:: 読み込むファイル
注意点として、literalincludeはSphinxの拡張であり、reSTではincludeを使います。includeではファイルがないとエラーになりますが、literalincludeは警告となります。
orphan: |
---|
これは読み込まれるためのファイルです。literarlincludeを使って読み込まれます。例としてあるだけなので、先頭でorphanを設定しています。
ソースコードもちゃんと判断してくれます。
import this