Могу ли я повторно использовать контент (из одного источника) в уценке? - PullRequest
0 голосов
/ 18 мая 2018

Отказ от ответственности: я технический писатель (не разработчик, поэтому KIS и будьте добры, пожалуйста).

Я пишу в Markdown.Каждый файл MD связан с файлом RST, который служит либо индексом для раздела (перечисляющего несколько файлов), либо, для темы, просто обеспечивает путь к MD.Например:

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

В конечном итоге мы используем Sphinx для генерации документации.Я пытаюсь найти способ повторного использования некоторого содержимого уценки, чтобы я мог создавать уникальные документы для определенной аудитории.На мой взгляд, документ может выглядеть так:

Гауда баварская моцарелла из бергказы ...

<include dairy-free-content>

Чизкейк, сыр моцарелла, цветная капуста ...

Кто-нибудь знает способ сделать это?Моя книга становится сильно раздутой.Спасибо ...

...