Lordneo
@Lordneo

Есть ли онлайн сервисы для составления документации с возможность вкрапления частей других документов?

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

Чаще всего это разные документы, что приводит к тому, что разработчик должен "прыгать" по нескольким документам, опираясь на ссылки в документе.

Задача:
При написании документа, требуется такое добавления текста из документов доноров информации, чтобы:

  • Части (при том, что все параграфы в документах автоматически нумеруются) из других документов легко вкраплялись в текст, с указание ссылки на документ из которого взят текст.
  • Изменения в документе доноре сразу отображались в месте вкрапления.
  • При удалении документа донора, вкрапленный текст остается с соответствующим признаком.


Может у кого есть какие решения на примите?
  • Вопрос задан
  • 336 просмотров
Пригласить эксперта
Ответы на вопрос 1
eduardtibet
@eduardtibet
Technical Writer / Documentation Engineer
Вам надо (одновременно):
1. single sourcing technical documentation - Docbook или DITA.
2. включение частей - xinclude.
3. обработка на уровне xslt.
Ответ написан
Комментировать
Ваш ответ на вопрос

Войдите, чтобы написать ответ

Похожие вопросы