Forum général.général quels outils pour de la doc au format docbook

Posté par  .
Étiquettes : aucune
0
13
juil.
2004
bonjour,

je dois faire de la doc sur un projet, et j'envisage d'utiliser docbook. Je suis allé voir sur le site de référence, et c'est moins simple que ce que je ne pensais. M'enfin je vais faire un effort, cela n'en sera que mieux pour la suite.
Pourtant, une question me taraude: quel outil utiliser? Il semblerait que openjade soit pas mal utilisé, mais je n'en avait jamais entendu parler avant. En plus il semble qu'il y ait pas mal de dépendances (xml, xslt, tetex, et encore d'autres...) , et l'administrateur d'où je suis n'a pas jugé bon d'installer un certain nombre de packages...

Donc pour ceux qui écrivent des howto, des bouquins, etc.: quels outils utilisez vous?

merci

  • # ma contrib'

    Posté par  . Évalué à 2.

    J'utilise pas pour l'instant le docbook, mais voici les liens que j'ai amassé pour une utilisation future :

    Sur la fedora y a un outil très bien qui s'appelle xmlto "man xmlto", mais il exporte le docbook vers "dvi html html-nochunks man ps xhtml fo htmlhelp javahelp pdf txt xhtml-nochunks"

    d'autres lien utilies (liens surtout pris sur http://weblogs.goshaky.com/(...)):

    - http://www.conglomerate.org/(...)
    "Conglomerate aims to be an XML editor that everyone can use.
    In particular, our primary goal is to create the ultimate editor for DocBook and similar formats."

    -http://jroller.com/page/eu/20040712#eclipse_version_of_the_visual(...)
    "WYSIWYG XML Editor for Eclipse
    I have come through this posting by Euxx. John Krasnay, the developer of VEX - Visual Editor for XML is going to release a Eclipse-Plugin-Version of his WYSIWYG-XML editor soon. What I can see from the screenshot is looking very good and I'm looking forward to see a visual XML editor for Eclipse to do my DocBook editing. VEX support Simplified DocBook and XHTML...."

    -http://qdk.sourceforge.net/(...)
    "Quick DocBook (DocBook without all the tags)

    QDK (Quick DocbooK) is a little utility designed to simplify the creation of DocBook documentation in a very quick way from a text file. It's user-extensible, and has built-in support for bibliographical references.

    QDK Version 1.19 was relaesed two days ago and it look like a good solution for those who fear < and >. The new version requires the command line version of PHP...."

    - http://www.goshaky.com/docbook-online-tool/(...)
    Outils en ligne de transformation vers html et pdf.

    Voila j'espère que ça peut aider.

    • [^] # Re: ma contrib'

      Posté par  . Évalué à 2.

      merci pour les liens. Comme il dit dans http://weblogs.goshaky.com(...) :

      The point of conversion is harder.
      At this point, thirteen years into its lifetime, I was hoping for a plethora of tools that I could download that would offer me a number of conversion options, and a wide array of 'themes' that can be applied to get a different look to the semantics I've defined.

      je suis d'accord. rien n'est vraiment clair et il semble ne pas vraiment y avoir d'outil de référence. Mais peut être certains points m'ont ils échappés, et je vais me documenter un peu avant de mettre plus les mains dedans. J'ai essayé d'utiliser des modèles de documents sgml et de les transformer (howto linux, etc.) mais j'ai toujours des erreurs (avec xmlto html). Donc <= RTFM d'abord :(

      • [^] # Re: ma contrib'

        Posté par  . Évalué à 1.

        Sinon,

        pour de la doc sur un projet ce qui est bien aussi, c'est forrest.
        Je l'avais essayé et c'est pas mal pour te générer tout le bordel en html et pdf aussi.

        Forrest is an XML standards-oriented documentation framework based on Apache Cocoon, providing XSLT stylesheets and schemas, images and other resources. Forrest uses these to render the XML source content into a website via command-line, robot, or a dynamic web application.

        C'est plutot bien foutu. T'as une arborescence dans laquelle tu places tes documents xml (docbook ou autres). Ces documents seront tous traités à la chaine et peuvent être à la base d'un site complexe complet. C'est un bon moyen de bien centralisé la documentation d'un ensemble de projets. Il génère aussi bien du pdf.

        Tu tires parti de tout le framework en terme de xsp, stylesheets existant, etc . De plus tu peux utiliser des skins, et des skins préexistent.

        Valà
        Le site
        http://forrest.apache.org/(...)

        PS : regarde Lenya aussi ;)
        http://cocoon.apache.org/lenya/(...) ça va dans ton sens.

  • # nXML

    Posté par  . Évalué à 1.

    Pour les utilisateurs d'emacs, nXML est un mode pour l'édition des documents XML http://www.xmlhack.com/read.php?item=2061(...) .
    Il gère la validation et est capable d'utiliser les schémas XML.
    Pour info, James Clark en est à l'origine.

  • # si ca peut t'aider

    Posté par  (site web personnel) . Évalué à 2.

    J'utilise docman comme outil à tout faire, tu peux le trouver ici :
    http://www.goshaky.com/docman-distfiles/DocMan/(...)
    - c'est un zip qui marche sous linux et windows (java)
    - contient les DTD, parsers, etc. rien à configurer ou installer, tout est près !
    - contient une interface graphique où tu sélectionnes ton document xml et le rendu (pdf, xhtml, etc.)
    - la même chose en ligne de commande

    inconvénient : il faut que ton document soit en utf-8 si tu utilises des accents et que ton document soit parfaitement valide (sinon le soft plante sans prévenir)

  • # XXE

    Posté par  . Évalué à 1.

    C'est pas libre mais ca fonctionne pas trop mal :
    http://www.xmlmind.com/xmleditor/(...)

    Perso, j'ai écris celui la : http://gendiapo.sourceforge.net(...) en GPL. Pour l'instant, il n'y a pas le support des XML Schema, ca bouffe de la RAM mais je suis en train de faire une version qui marchera beaucoup mieux. (Toute aide est la bien venue)

Suivre le flux des commentaires

Note : les commentaires appartiennent à celles et ceux qui les ont postés. Nous n’en sommes pas responsables.