Sphinxでコードブロック内を置換させたいと考えて調べていたところ、issueとして回避策が上がっていたので備忘録
以下を見てconf.pyに追加すればOK
https://github.com/sphinx-doc/sphinx/issues/4054
置換対象は{}で囲む。
なぜ探したか
- sphinxのreplaceを使うと用語定義ができ、可変な用語や本文中のバージョン表記を置換できる
- replaceをそのまま使ってもコードブロック内は置換できない
- コードブロック内を置換する場合はparsed-literalを使わなければできないという記事が見つかる参考
- 試してみると置換はできるが、レンダリングがうまくいかない