Journal Meilleurs outils pour docbook

Posté par Epsos le 03 décembre 2003 à 11:21.

Étiquettes : aucune

déc.

2003

Mon cher journal, je me suis decide a utiliser docbook pour ecrire toutes les specifications et autre documentations relatives a un projet.

Actuellement, j'utilise JEdit pour l'edition, et je viens de regarder xmlmind qui est pas mal. (si tu as d'autres editeurs orientes XML en general, ou docbook plus particulierement, je suis preneur)

Par contre, je me demande quelle chaine de transformation employer pour avoir en sortie un joli document :

xsl :
- rendu html : moche
- rendu xhtml : moche
- rendu pdf via fo : fop sort en erreur : impossible de lui faire cracher un pdf

Donc est ce que tu as des conseils, d'autres outils, d'autres processeurs, peut etre essayer en SGML/DSSSL ?

Merci de ton retour d'experience cher journal.

# FOP

Posté par Alexis Agahi le 03 décembre 2003 à 12:05. Évalué à 1.

J'utilise FOP 0.25 et cela fonctionne bien (même si c'est lent). Quel est l'erreur?
- [^] # Re: FOP
  
  Posté par Epsos le 03 décembre 2003 à 13:14. Évalué à 1.
  
  OK, j'utilise FOP 0.20.5, je vais upgrader ...
  Le probleme etait que certains attributs generes par XSL-FO n'etaient pas pris en charge.
  - [^] # Re: FOP
    
    Posté par Epsos le 03 décembre 2003 à 13:33. Évalué à 1.
    
    Heuh, j'ai beau chercher je ne vois pas de version 0.25 : tu n'as pas confondu ?
    
    Sinon, le petit truc qui fait que ca marche mal, c'est que j'ai fait un test depuis le boulot, et on se trouve derriere un proxy. Donc comme certains outils que j'utilisais n'arrivait pas a traverser le proxy, j'ai modifie l'URL de la DTD pour qu'il aille choper la DTD Docbook sur le disque et pas sur le net : j'obtiens l'erreur suivante :
    [ERROR] no protocol: dbnotnx.mod
    
    Si j'utilise d'abord XSL pour transformer mon document en XSL-FO, j'obtiens une liste d'erreur du style :
    [ERROR] property - "background-position-horizontal" is not implemented yet.
    Error creating background image: Error while recovering Image Informations (http
    ://docbook.sourceforge.net/release/images/draft.png) : docbook.sourceforge.net
    [ERROR] Error in relative-align property value 'baseline': org.apache.fop.fo.exp
    r.PropertyException: No conversion defined
    [ERROR] Unknown enumerated value for property 'relative-align': baseline
    [ERROR] file:/C:/Documents and Settings/djobet/My Documents/docbook/test/nosicabook.fo:1:48052 inline formatting objects cannot be directly under flow
    
    Il y a t'il un moyen de specifier a fop des parametres de connection reseau ?
    - [^] # Re: FOP
      
      Posté par TSelek le 03 décembre 2003 à 13:49. Évalué à 1.
      
      Rôh !
      
      en fait ce ne sont pas des URL mais des URI (qui ressemblent à des urls, clair non ? non je sais...), donc en fait tu as beau avoir une url, c'est le plus souvent codé en "dur" dans les moteurs qui ne font pas de GET de la DTD à chaque fois.... ça répond pas vraiment à ta question, mais bon...
# Re: Meilleurs outils pour docbook

Posté par TImaniac (site web personnel) le 03 décembre 2003 à 12:42. Évalué à 1.

Utilise DocMan pour transformer ton docbook en HTML, CHM, XHTML ou PDF :
http://trieloff.net/docbook/archive/cat_docman2.html(...)
C'est un utilitaire en ligne de commande associé à un GUI vraiment pratique.
Il utilise et install FOP ainsi que les DTD et XSL de DocBook (comme ça tout est fourni, tout marche, aucun problème).
Franchement, après mainte galère en ligne de commande avec fop ou jade, c'est que du bonheur, 2 boutons à cliquer et pif paf poum t'as le resultat.
Si tu trouve le rendu moche, suffit de modifier les feuilles XSL ;-)
- [^] # Re: Meilleurs outils pour docbook
  
  Posté par Epsos le 03 décembre 2003 à 13:14. Évalué à 1.
  
  Connaissais pas, je vais essayer merci.
  - [^] # Re: Meilleurs outils pour docbook
    
    Posté par Epsos le 03 décembre 2003 à 14:17. Évalué à 1.
    
    Bon, ca a l'air sympa, mais decidemment, je dois avoir un truc pas clair : j'ai installe les fonts pour la generation de pdf, il me genere effectivement un pdf. Mais impossible de l'ouvrir. (file is damaged and could not be repaired)
    
    Je me demande si finalement mon document ne serait pas invalide.
    
    Vous connaissez de bons validateur ?
    - [^] # Re: Meilleurs outils pour docbook
      
      Posté par TImaniac (site web personnel) le 03 décembre 2003 à 17:59. Évalué à 1.
      
      euh, DocMan valide normalement ton document...
      si ton pdf est foiré, t'es sûr d'avoir attendu le temps qu'il fallait pour l'ouvrir ? (attendu que DocMan est fini, il est plutôt lent et le fichier output.pdf est impossible à ouvrir avant d'avoir terminé l'opération)
      - [^] # Re: Meilleurs outils pour docbook
        
        Posté par Epsos le 04 décembre 2003 à 10:24. Évalué à 1.
        
        Et ben non, Docman ne valide pas le document.
        Il me generer des fichiers a partir d'une source invalide.
        Du coup le rendu etait pas terrible et le fichier pdf corrompu.
        
        Une fois que le document est valide par contre, c'est nickel.
        Je ne m'explique toujours pas pourquoi je n'arrive pas a faire la meme chose avec fop.
# Re: Meilleurs outils pour docbook

Posté par Rhaaalex le 03 décembre 2003 à 12:58. Évalué à 1.

Votre fichier xml est-il bien conforme à Docbook ? XMLMind, même dans sa version gratuite, permet de créer facilement des documents Docbook valides. Si vous avez des erreurs de traitement avec fop, ou des problèmes avec le format Docbook, vous pouvez vous adressez à la liste de diffusion technique de XMLfr ( http://xmlfr.org(...) ), il y aura sûrement quelqu'un pour vous aider.
- [^] # Re: Meilleurs outils pour docbook
  
  Posté par Epsos le 03 décembre 2003 à 13:16. Évalué à 1.
  
  Oui, la validation a ete faite et tout est OK.
  Je pensais avoir recuperer la derniere version stable de fop, mais apparemment ce n'est pas le cas, je vais essayer d'apprendre a lire !! :-)
  
  Merci pour le lien, je ne connaissais pas !
# Re: Meilleurs outils pour docbook

Posté par Brice Carpentier le 03 décembre 2003 à 13:07. Évalué à 1.

euh...si tu trouves un rendu (x)html moche, ne suffit-il pas d'y adjoindre une simple feuille de style CSS ?
- [^] # Re: Meilleurs outils pour docbook
  
  Posté par Epsos le 03 décembre 2003 à 13:23. Évalué à 1.
  Vi tout a fait, mais ca veut dire qu'il va falloir que j'aille tripatouiller le fichier xhtml genere. A moins qu'il n'y ait un moyen de specifier pendant la generation quelle feuille de style utiliser ?
  
  Sinon, le code suivant :
```
<para>

  <funcsynopsis>

    <funcprototype>

      <funcdef>boolean 

        <function>isArray</function>

      </funcdef>

      <paramdef></paramdef>

    </funcprototype>

  </funcsynopsis>

</para>
```
  apres generation html ou xhtml affiche le resultat suivant :
```
boolean isArray();

;
```
  Tu noteras la presence de _deux_ ';'
  
  Ce qui est marrant c'est que le rendu avec xmlmind par contre est lui nickel : il y a un seul ';' : je ne comprend pas.
  
  Il a t'il un moyen de specifier du xhtml stricte ?
  Je viens de jeter un coup d'oeil et il genere un DOCTYPE avec une DTD transitional
  - [^] # Re: Meilleurs outils pour docbook
    
    Posté par Florent Zara (site web personnel, Mastodon) le 03 décembre 2003 à 15:50. Évalué à 1.
    
    A moins qu'il n'y ait un moyen de specifier pendant la generation quelle feuille de style utiliser ?
    
    Bien sur, et pas que ca d'ailleurs, tout un tas d'autres paramètres dispos ici (pour le HTML):
    http://docbook.sourceforge.net/release/xsl/current/doc/html/index.h(...)
    
    Celui qui t'interesse plus particulièrement est "html.stylesheet"
    
    Ce qui te donne grosso modo pour ta xsl qqch du style:
    
    <?xml version="1.0" encoding="iso-8859-1"?>
    <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform(...)"
    version="1.0">
    
    
    <xsl:import href="path/to/docbook/xsl/html/chunk.xsl"/>
    
    
    <xsl:param name="chunker.output.indent" select="'yes'"/>
    <xsl:param name="chunker.output.doctype-public" select="'-//W3C//DTD HTML 4.01 Transitional//EN'"/>
    
    
    <xsl:param name="html.stylesheet" select="'styles.css'"/>
    
    BLA BLA BLA...
    
    </xsl:stylesheet>
    - [^] # Re: Meilleurs outils pour docbook
      
      Posté par Epsos le 03 décembre 2003 à 16:07. Évalué à 1.
      
      Cool ca !
      
      Va falloir que je me paluche une doc xsl un de ces 4 pour etre un peu plus carre.
      
      Merci pour le lien, je note tout ca.
      
      Tu connais un bon validateur ?
      - [^] # Re: Meilleurs outils pour docbook
        
        Posté par Florent Zara (site web personnel, Mastodon) le 03 décembre 2003 à 16:33. Évalué à 1.
        
        Tu connais un bon validateur ?
        
        J'édite mes fichiers xml avec au choix Jext ou Eclipse+plugin xml (ou encore Vim pour une petite modif rapide) et je valide/transforme avec xsltproc (libxsl) ou XercesJ/XalanJ. Je me sers aussi d'Ant pour automatiser le tout.
        
        [^] # Re: Meilleurs outils pour docbook
        
        Posté par Epsos le 04 décembre 2003 à 10:22. Évalué à 1.
        
        Oui, j'essaierai chez moi. Ici (au boulot), la version pour windows plante lamentablement ... :-(
# Re: Meilleurs outils pour docbook

Posté par djapat le 03 décembre 2003 à 16:54. Évalué à 1.

Morphon pourrait t'intéresser:
http://www.morphon.com/(...)
- [^] # Re: Meilleurs outils pour docbook
  
  Posté par Epsos le 04 décembre 2003 à 10:22. Évalué à 1.
  
  Excellent ! Et adopte !

Suivre le flux des commentaires

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