Gibt es einen schönen XSL-Stylesheet für die clientseitige DocBook-Rendering?

Question

Ich mag die DocBook Dokumente in meinem SVN-Repository schön zu sehen, wenn jemand an sich in einem Web-Browser aussieht. Ich habe angefangen, einen CSS-Stylesheet zu schreiben, aber ich denke, dass es erhebliche Einschränkungen hat -. Insbesondere diejenigen in Bezug auf Hyperlinks

Es gibt eine große Anzahl von DocBook XSL Stylesheets auf der DocBook-Website , aber sie scheinen nicht für den Browser-Rendering für angemessen. Ich möchte nicht, statische Dokumente erzeugen und sie in SVN setzen. Ich möchte, dass sie im Grunde lesbar, ohne viel Aufwand für andere Entwickler sein.

Ich kann meinen eigenen Browser-entsprechende XSL-Stylesheet zu konvertieren DocBook zu HTML schreiben, aber es scheint, wie jemand anderes dies bereits getan haben muss. Ich weiß nur nicht, wo sie zu finden.

Answer 1

In einem früheren Leben habe ich wysiwygdocbook: http: / /www.cs.hs-rm.de/~werntges/proj/wysiwyg-dbk01.html

Answer 2

Sie haben Recht, sind die DocBook XSL Stylesheets sehr schwer, und sind nicht wirklich geeignet ist, in einem Browser ausgeführt wird. Die DocBook Wiki listet einige CSS-Stylesheets , vielleicht einer von denen könnte für Sie arbeiten?

Die einzige, die ich habe Erfahrung ist die, die XMLmind XML Editor anscheinend verwendet zu präsentieren DocBook Dokumenten.

Answer 3

Ich habe einige XSLT + CSS sehr einfach und unvollständige Umsetzung für browserside DocBook Styling getan. Sie können es hier ansehen http://github.com/arsi/db2xhtml

Aber ich mag fortgeschrittenere Projekt, wenn verfügbar irgendwo sehen!

Answer 4

[Bearbeitet, weil ich die Frage falsch verstanden]

Sie würden wollen, schon gar nicht die Stylesheets über einen Browser und das PI laufen, aber dann wollen Sie nicht, dass für jeden einigermaßen komplexen Inhalt zu tun. Tun Sie es Server-Seite, wenn Sie über einen Web-Server oder als Batch-Task ausführen. Gibt es eine Möglichkeit, dass Sie eine serverseitige Prozess in svn zwischenschalten kann?

DocBook ist eine komplexe ‚Sprache‘ und die Erfassung auch die meisten der Feinheit von DocBook sehr schwierig ist. die DocBook XSL ist überhaupt nicht kompliziert, und ich würde in dieser Richtung Sie gehen wirklich empfehlen, wenn Sie können. Die Stylesheets sind so konzipiert, die individuell gestaltet werden und sind sehr gut von Bob Stayton dokumentiert in DocBook XSL: The Complete Guide .

Answer 5

Nach einem recht bisschen suchen, glaube ich, die Antwort ist „es ist keine schöner XSL-Stylesheet für die clientseitige DocBook-Rendering“, neben den maßgeschneidert denjenigen, wie ich sich umgesetzt werden.

Answer 6

Normalerweise würde man eine ‚Überstellung‘ zum Lesen / Anzeige erzeugen. Die Wiedergabe kann entweder PDF sein, eine einzelne HTML-Seite oder von HTML-Seiten gesetzt. Es ist selten, dass Sie docbook direkt auf dem Web liefern.

• Darf ich fragen, was Sie versuchen zu erreichen, und warum?
• Ist das für die interne oder externe Lieferung?

Ich hasse es immer die Frage, die fragt: „Ihre Technologie zu tun X?“ Es nimmt eine Menge Wissen über das Produkt (plus, in der Regel die Antwort „ja“, aber das nicht die eigentliche Frage nicht beantwortet). Es ist immer am besten, wenn ich frage - „was Sie versuchen zu erreichen“ - so kann ich Ihnen sagen, ob irgendein Stück Technik eine gute Passform (oder kann ich Sie zu einem anderen Stück verweisen, die ein viel bessere Passform ist, oder ein besserer Weg, um darüber zu gehen).