Esiste un bel foglio di stile XSL per il rendering di DocBook sul lato client?

Question

Voglio che i documenti DocBook nel mio repository SVN siano belli se qualcuno li guarda in un browser web. Ho iniziato a scrivere un foglio di stile CSS, ma penso che avrà limiti significativi, in particolare quelli relativi ai collegamenti ipertestuali.

Esiste un'ampia gamma di fogli di stile XSL per DocBook nel sito DocBook , ma non sembrano essere appropriati per il rendering del browser. Non voglio generare documenti statici e inserirli in SVN. Voglio che siano sostanzialmente leggibili per altri sviluppatori senza troppi problemi.

Potrei scrivere il mio foglio di stile XSL adatto al browser per convertire DocBook in HTML, ma sembra che qualcun altro debba averlo già fatto. Non so proprio dove trovarlo.

Answer 1

In una vita passata ho usato wysiwygdocbook: http: / /www.cs.hs-rm.de/~werntges/proj/wysiwyg-dbk01.html

Answer 2

Hai ragione, i fogli di stile DocBook XSL sono molto pesanti e non sono adatti per l'esecuzione in un browser. Il Wiki di DocBook elenca alcuni fogli di stile CSS , forse uno di questi potrebbe funzionare per te?

L'unico che ho esperienza è quello che XMLMind XML Editor apparentemente usa per presentare Documenti DocBook.

Answer 3

Ho fatto alcune implementazioni XSLT + CSS molto basilari e incomplete per lo stile DocBook sul lato browser. Puoi verificarlo qui http://github.com/arsi/db2xhtml

Ma vorrei vedere un progetto più avanzato se disponibile da qualche parte!

Answer 4

[Modificato perché ho letto male la domanda]

Sicuramente non vorrai eseguire i fogli di stile tramite un browser e il PI, ma non vorrai farlo per qualsiasi contenuto ragionevolmente complesso. Fallo sul lato server se stai eseguendo un server Web o come attività batch. Esiste un modo per interporre un processo lato server in svn?

DocBook è un "linguaggio" complesso e catturare anche la maggior parte delle sottigliezze di DocBook è molto difficile. L'uso del DocBook XSL non è affatto complesso e ti consiglierei davvero di andare in quella direzione se puoi. I fogli di stile sono progettati per essere personalizzati e sono estremamente ben documentati da Bob Stayton in DocBook XSL: The Complete Guide .

Answer 5

Dopo un bel po 'di ricerche, credo che la risposta sia "non esiste un bel foglio di stile XSL per il rendering di DocBook sul lato client", oltre a quelli personalizzati come quello che ho implementato.

Answer 6

In genere si produceva una "rappresentazione" per la lettura / visualizzazione. Il rendering può essere PDF, una singola pagina HTML o un insieme di pagine HTML. È raro che tu distribuisca docbook direttamente sul Web.

• Posso chiedere cosa stai cercando di realizzare e perché?
• È per consegna interna o esterna?

Odio ricevere la domanda che fa "la tua tecnologia può fare X?" Presuppone molta conoscenza del prodotto (in più, di solito la risposta è "sì", ma ciò non risponde alla vera domanda). È sempre meglio quando chiedo: "cosa stai cercando di realizzare" - così posso dirti se qualsiasi tecnologia è adatta o meno (o posso indicarti un altro pezzo che è molto più adatto o un modo migliore per farlo).