В прошлом я использовал DocBook, и мне нравится идея отделения контента от презентации. Мне очень удобно редактировать XML напрямую. В моем обширном поиске, чтобы найти лучшее решение для документирования для моих нужд, я всегда возвращаюсь к этому единственному решению:
DocBook -> Сборка системы (муравей, сборщик и т. Д.) -> Вывод
Я видел много информации о лучших WYSIWYG, XML, текстовых редакторах для написания DocBook, включая альтернативные языки разметки, такие как asciidoc. Все эти решения направлены на создание DocBook или кошмарной цепочки инструментов DocBook. Никто никогда не обращается к стороне вывода, кроме как сказать «Просто используйте XSL» или «Пользовательские сценарии»
Когда мне поручено сделать документ или руководство, я не хочу беспокоиться о том, чтобы тратить бесчисленные часы на попытки перепрограммировать, настраивать и изменять скрипты XSL, CSS и оболочки (т.е. книги O'Riely). Это очень трудная задача.
Мой запрос: есть ли инструмент, облегчающий настройку? И есть ли что-то похожее на страницы или Word, когда пользователь создает шаблон, а цепочка инструментов делает все остальное? Попытка выполнить визуальную задачу, такую как красивые логотипы, и исправить все разбитые макеты, которые предлагает XSL по умолчанию (разбивка на страницы - беспорядок), очень трудно из текстового редактора. Содержание легко. Редактирование DocBook XSL было настоящим кошмаром, когда я делал это в прошлом. Я искал и нахожу много информации о редакторах XML, но ничего о редакторах XSL.
Или мне не хватает ключевого понимания процесса. Спасибо.