Есть хорошая таблица стилей XSL для рендеринга DocBook на стороне клиента?

Question

Я хочу, чтобы документы DocBook в моем SVN-хранилище выглядели красиво, если кто-то просматривает их в веб-браузере. Я начал писать таблицу стилей CSS, но думаю, что у нее будут существенные ограничения - особенно те, которые касаются гиперссылок.

На сайте DocBook имеется большое количество таблиц стилей DocBook XSL, но они не подходят для отображения в браузере. Я не хочу генерировать статические документы и помещать их в SVN. Я хочу, чтобы они были в основном читаемыми для других разработчиков без особых хлопот.

Я мог бы написать свою собственную таблицу стилей XSL, подходящую для браузера, чтобы конвертировать DocBook в HTML, но, похоже, кто-то другой уже сделал это. Я просто не знаю, где его найти.

Answer 1

В прошлой жизни я использовал wysiwygdocbook: http://www.cs.hs -rm.de / ~ werntges / proj / wysiwyg-dbk01.html

Answer 2

Я сделал несколько базовых и неполных реализаций XSLT + CSS для стилей DocBook в браузерах. Вы можете проверить это здесь http://github.com/arsi/db2xhtml

Но я бы хотел увидеть более продвинутый проект, если он есть где-то!

Answer 3

Вы правы, таблицы стилей DocBook XSL очень тяжелые и не очень подходят для работы в браузере. В DocBook Wiki перечислены некоторые таблицы стилей CSS , возможно, одна из них может работать для вас?

У меня есть только один опыт, который XMLMind XML Editor , очевидно, использует для представления документов DocBook.

Answer 4

После долгих поисков, я считаю, что ответ «нет хорошей таблицы стилей XSL для рендеринга DocBook на стороне клиента», кроме сделанных на заказ, подобных той, которую я реализовал.

Answer 5

[Отредактировано, потому что я неправильно прочитал вопрос]

Вы, конечно, не захотите запускать таблицы стилей через браузер и PI, но тогда вы не захотите делать это для любого достаточно сложного контента. Делайте это на стороне сервера, если вы работаете через веб-сервер или как пакетное задание. Есть ли способ, которым вы можете вставить серверный процесс в SVN?

DocBook - сложный «язык», и захватить даже большую часть возможностей DocBook очень сложно. Использование DocBook XSL совсем не сложно, и я действительно рекомендую вам пойти в этом направлении, если сможете. Таблицы стилей разработаны с учетом индивидуальных особенностей и чрезвычайно хорошо задокументированы Бобом Стейтоном в DocBook XSL: Полное руководство .

Answer 6

Как правило, вы производите «представление» для чтения / отображения. Представление может быть либо PDF, одной страницей HTML, либо набором страниц HTML. Редко вы доставляете документацию прямо в Интернет.

• Могу я спросить, чего вы пытаетесь достичь и почему?
• Это для внутренней доставки или для внешней?

Я ненавижу задавать вопрос "Может ли ваша технология сделать X?" Он предполагает много знаний о продукте (плюс, обычно ответ «да», но это не отвечает на настоящий вопрос). Всегда лучше, когда я спрашиваю - «чего ты пытаешься достичь» - так что я могу сказать тебе, подходит ли какой-нибудь элемент технологии (или я могу указать тебе на другой элемент, который гораздо лучше подходит, или лучший способ сделать это).