Вывод не-Java DocBook WebHelp

Question

Кому-нибудь удалось получить вывод содержимого DocBook в веб-справку, в которой не используется Java-апплет? В настоящее время мы разрабатываем веб-приложение, использующее Ext JS, и хотим вывести содержимое DocBook XML в формат, который можно использовать параллельно с нашим приложением (то есть без апплетов Java).

Мы хотим, чтобы наше руководство придерживалось DocBook, но нам нужен независимый от платформы интегрированный вывод справки (не .chm), который можно интегрировать с нашим веб-приложением.

Буду признателен за любые рекомендации, предложения и советы.

Laurie.

Answer 1

Я отвечаю на это спустя более года, но некоторые могут найти это полезным.

В рамках программы Google Summer of Code мы создали формат вывода WebHelp для DocBook. Он не зависит ни от java-апплетов, ни от подхода на основе фреймов. Это чистый CSS, основанный на JavaScript, поэтому он, скорее всего, будет отвечать вашим требованиям. Это более удобно для поисковых систем, так как не зависит от наборов фреймов. Это доступно с DocBook XSL начиная с версии 1.76.0.

Следующие ссылки дадут вам представление.

Демо доступно здесь: http://snapshots.docbook.org/xsl/webhelp/docs/content/ch01.html Документация для WebHelp включена в демо.

Примечания к выпуску для 1.76.1 находятся по адресу: DocBook WebHelp Project

Местоположение SVN: http://docbook.svn.sourceforge.net/viewvc/docbook/trunk/xsl/webhelp/

Предложение по адресу: Предложение по выводу WebHelp для DocBook .

Извините за огромное нет. ссылок. Свяжитесь с нами в списке рассылки DocBook, если вам нужна дополнительная помощь. Это активно поддерживается.

Answer 2

Adobe RoboHelp использует фреймы для визуализации веб-справки. Настройка самого CSS - огромная боль. Добавьте к этому неотзывчивую поддержку Adobe. Кроме того, весь внешний вид вашего веб-сайта будет очень похож на 1990-е годы.

Answer 3

Я так рад, что мы перешли на Docbook. Сейчас мы используем проект DocBook WebHelp, разработанный Дэвидом Краммером и KasunBG.

Это решает все наши технические проблемы.

• Наши документы теперь привязаны к исходному коду в git
• Команды разработчиков могут предлагать патчи для документов
• Теперь мы можем автоматически генерировать документы, используя непрерывную интеграцию
• Не говоря уже о внешнем виде сайта.
• Наши проблемы с мультиформатной публикацией и публикацией нескольких устройств устранены!

Answer 4

Вы смотрели на Adobe RoboHelp ? Довольно уверенно, что платформа не зависит.