我可以在降价中重复使用内容(单一来源)吗?

时间:2018-05-18 15:35:47

标签: markdown python-sphinx documentation-generation

免责声明:我是一名科技作家(不是开发人员,所以KIS,请善待)。

我在Markdown写道。每个MD文件都与一个RST文件配对,该文件用作该部分的索引(列出多个文件),或者对于一个主题,只提供MD的路径。例如:

.. markdown-ingest ::     :filename:./ users-guide / deploy / inforyory.md

最终我们使用Sphinx生成文档。我正在尝试找到一种方法来重用一些降价内容,以便我可以为特定的受众创建独特的文档。在我看来,文档可能如下所示:

Gouda bavarian bergkase mozzarella ...

<include dairy-free-content>

芝士蛋糕莫扎里拉花椰菜奶酪......

有人知道这样做的方法吗?我的书变得非常臃肿。感谢...

1 个答案:

答案 0 :(得分:0)

通过mkdocspython-markdown,您可以使用snippets扩展名来包含降价内容。