Sphinx静态文档生成器中的包含/包含?

时间:2018-09-26 21:19:15

标签: python-sphinx

我正在为一系列产品编写文档。对于某些不同的产品,某些小节是相同的。我希望能够一次编写文本,然后将相同的文本“包含”在各个页面中,这样我就不必通过跳到其他地方然后找到返回的方式来中断读者的学习。

如果包含的文本可以带有“参数”,则奖励积分。

示例文档层次结构和文本:

  • 如何用成人牙刷刷牙

    Go to the a drug store and buy an adult toothbrush. #include('common', 'adult toothbrush') Brush for 3 minutes.

  • 如何用儿童牙刷刷牙

    Ask your parent to go to the drug store and buy a kid toothbrush. #include('common', 'kid toothbrush') Brush until your parent says you are done.

常见之处如下:

Put some toothpaste on your $arg1.

据我所知,这不是内置功能。可以使用扩展程序吗?

0 个答案:

没有答案