Existe-t-il une belle feuille de style XSL pour le rendu DocBook côté client?

Question

Je souhaite que les documents DocBook de mon référentiel SVN soient agréables si quelqu'un les lit dans un navigateur Web. J'ai commencé à écrire une feuille de style CSS, mais je pense qu'elle aura d'importantes limites, notamment en ce qui concerne les hyperliens.

Le site DocBook contient un grand nombre de feuilles de style DocBook XSL. , mais ils ne semblent pas être appropriés pour le rendu du navigateur. Je ne veux pas générer de documents statiques et les mettre dans SVN. Je veux qu’ils soient fondamentalement lisibles par d’autres développeurs sans trop de tracas.

Je pourrais écrire ma propre feuille de style XSL adaptée au navigateur pour convertir DocBook en HTML, mais il me semble que quelqu'un d'autre doit déjà l'avoir déjà fait. Je ne sais tout simplement pas où le trouver.

Answer 1

Dans une vie antérieure, j'ai utilisé wysiwygdocbook: http: / /www.cs.hs-rm.de/~werntges/proj/wysiwyg-dbk01.html

Answer 2

Vous avez raison, les feuilles de style DocBook XSL sont très lourdes et ne conviennent pas vraiment pour être utilisées dans un navigateur. Le DocBook Wiki répertorie des feuilles de style CSS , peut-être qu'une de celles-ci pourrait vous convenir?

Le seul dont je connaisse l'expérience est celui que XMLMind XML Editor utilise apparemment pour présenter Documents DocBook.

Answer 3

J'ai effectué une implémentation très basique et incomplète de XSLT + CSS pour le style de DocBook pour les navigateurs. Vous pouvez le vérifier ici http://github.com/arsi/db2xhtml

Mais j'aimerais voir un projet plus avancé s'il est disponible quelque part!

Answer 4

[Modifié parce que j'ai mal interprété la question]

Vous ne voudriez certainement pas exécuter les feuilles de style via un navigateur et le PI, mais vous ne voudriez pas le faire pour un contenu raisonnablement complexe. Faites-le côté serveur si vous utilisez un serveur Web ou en tant que tâche batch. Existe-t-il un moyen d'interposer un processus côté serveur dans svn?

DocBook est un "langage" complexe et il est très difficile de capturer même la plupart des sous-fonctions de DocBook. L’utilisation du DocBook XSL n’est pas du tout complexe et je vous recommanderais vivement de suivre cette voie si vous le pouvez. Les feuilles de style sont conçues pour être personnalisées et sont extrêmement bien documentées par Bob Stayton dans DocBook XSL: le guide complet .

Answer 5

Après quelques recherches, je pense que la réponse est "il n’existe pas de belle feuille de style XSL pour le rendu DocBook côté client". en plus de ceux sur mesure comme celui que j’ai mis en place.

Answer 6

Généralement, vous produisez un "rendu" pour la lecture / l'affichage. Le rendu peut être un PDF, une page HTML unique ou un ensemble de pages HTML. Il est rare que vous livriez directement docbook sur le Web.

• Puis-je vous demander ce que vous essayez d'accomplir et pourquoi?
• S'agit-il d'une diffusion interne ou externe?

Je déteste avoir la question suivante: "votre technologie peut-elle utiliser X?" Cela suppose de nombreuses connaissances sur le produit (en plus, la réponse est généralement "oui" mais cela ne répond pas à la vraie question). C'est toujours mieux quand je demande - "qu'essayez-vous d'accomplir" - afin que je puisse vous dire si un élément de technologie convient ou non (ou je peux vous indiquer un autre élément beaucoup mieux adapté, ou une meilleure façon de procéder).