Какой документации системы использовать для руководства пользователя

Question

Я в настоящее время пытаюсь найти систему документации (руководство пользователя), который будет иметь следующие характеристики:

• файлы документов в текстовом режиме (так СВН может дифф/объединить его)
• возможности использовать изображения, таблицы, перекрестные ссылки и таблицы из содержания
• экспорта в PDF (или .doc/ODT), которые поддерживают перекрестные ссылки

Я пытался м arkdown для исходных файлов документации и pandoc для экспорта pdf, но уценка не поддерживает таблицы.

Я очень ценю любую помощь, которую вы можете предоставить.

Answer 1

Для этого сценария используется Sphinx.

Он может генерировать html, pdf и некоторые другие форматы из файлов reStructuredText.

Ищите list-table, если вы хотите добавить сложные таблицы.

Answer 2

Я использую TeX для Electonic и печатной документации

https://tex.stackexchange.com/

https://en.wikipedia.org/wiki/TeX

Answer 3

Вероятно, наиболее часто используемый набор решений для документации XML в Docbook или DITA. Вы, безусловно, можете управлять теми, кто в SVN, а также выполнять различия. Оба они обеспечивают обработку цепей с множеством типов вывода, включая PDF через XSL FO.