Python sphinx Sphinx替换包含命令

Python sphinx Sphinx替换包含命令,python-sphinx,Python Sphinx,我正在努力解决这个问题: 我必须记录一个相当大的项目,该项目由一个C核心引擎和基于该引擎构建的不同API组成,比如Java、Python C# 每个API(即每种语言)的文档必须单独部署,但99%的文档是相同的,只是代码片段和示例主要需要更改 我通过定义一个全局变量来设置conf.py文件中的语言类型 我使用了primary_domain和highlight_语言来设置正确的语法突出显示 对于每个示例,我都有一个同名但扩展名不同的源文件 现在,我想包括一个使用literalinclude指令

我正在努力解决这个问题:

  • 我必须记录一个相当大的项目,该项目由一个C核心引擎和基于该引擎构建的不同API组成,比如Java、Python C#

  • 每个API(即每种语言)的文档必须单独部署,但99%的文档是相同的,只是代码片段和示例主要需要更改

  • 我通过定义一个全局变量来设置conf.py文件中的语言类型

  • 我使用了primary_domain和highlight_语言来设置正确的语法突出显示

  • 对于每个示例,我都有一个同名但扩展名不同的源文件

现在,我想包括一个使用literalinclude指令指定文件名的示例,并让其扩展名根据使用的语言进行更改。我天真地尝试使用replace宏,但没有成功:

rst_prolog = ".. |ext| replace:: .%s\n" % primary_domain
正确替换文档周围的
| ext |
,但不在命令中

.. literalinclude: filename|ext|
除了使用sed或类似工具解析
rst
文件之外,我还有其他方法可以做到这一点吗