让我们说,我想要一个允许执行代码的Sphinx指令。
在构建文档时,应该运行代码(某处,不介意)和打印到文档中。对于打印代码,code-block
指令几乎是我需要的一切。但是因为我想运行它,我需要自定义属性,例如:execute:
我在构建过程中需要访问者。一个想法是code-block
的访问者完成它的工作,剥离所有自定义属性并将其传递回Sphinx。
实现这一目标的最佳方法是什么?有一个tutorial解释了如何获得“我的”指令,但是一旦我完成了我的工作,我希望sphinx能够像对待code-block
那样对待它。
任何提示或想法?
背景:我想使用Sphinx进行文字编程,并提取code-block
来分隔Python文件。我找到this snippet here,但首先,我不能将自定义属性引入code-block
,其次,我遇到了math
指令的问题,我认为因为它无法了解已安装的扩展等等。< / p>