我可以使用Sphinx获得rst文件的模板吗?

时间:2016-02-04 11:55:07

标签: jinja2 python-sphinx restructuredtext

我有几个rST页面遵循相同的骨架,但在某些地方有不同的值和段落。

理想情况下,我会想象这样的事情(简化示例):

page-model.rst

 Feature {% block title %}Index{% endblock %}
 ============================================     
 {% block description %}
 Not available.
 {% endblock %} 

然后:

page-1.rst

 {% extends "page-model.rst" %}

 {% block title %}Load{% endblock %}

 {% block description %}
 Load data from hard disk.
 {% endblock %} 

开箱即可吗?

在生成文档之前,我是否应该自行修改Jinja?或者定义我自己的指令?

这是个坏主意吗? :)

感谢您的见解!

0 个答案:

没有答案