Отказ от ответственности: я технический писатель (не разработчик, поэтому KIS и будьте добры, пожалуйста).
Я пишу в Markdown.Каждый файл MD связан с файлом RST, который служит либо индексом для раздела (перечисляющего несколько файлов), либо, для темы, просто обеспечивает путь к MD.Например:
.. markdown-ingest ::: filename: ./users-guide/deploy/inventory.md
В конечном итоге мы используем Sphinx для генерации документации.Я пытаюсь найти способ повторного использования некоторого содержимого уценки, чтобы я мог создавать уникальные документы для определенной аудитории.На мой взгляд, документ может выглядеть так:
Гауда баварская моцарелла из бергказы ...
<include dairy-free-content>
Чизкейк, сыр моцарелла, цветная капуста ...
Кто-нибудь знает способ сделать это?Моя книга становится сильно раздутой.Спасибо ...