Salut à tous !
 
Tiens, il n'y a pas de topic consacré à docbook...
 
Je viens juste de découvrir et ça m'interesse pas mal, pour taper mes cours et apprendre par la même le XML.
 
J'ai bien trouvé "the definitive guide", disponible sur internet et qui parait très complet. C'est déjà une vraie aubaine de disposer gratuitement de ce document, mais je cherche quand même la traduction en français de ce livre. Elle existe à la vente en version papier mais c'est un peu cher pour moi et je ne l'ai pas trouvé sur internet... Aurais-je mal cherché ?  
 
Accessoirement, existe t'il une version imprimable de ce guide, en anglais ou en francais ? En pdf par exemple...
 
Quel editeur me conseillerez vous pour commencer en docbook ?
 
Pour l'instant j'hesite entre emacs que je connais deja un peu (avec le mode nxml ? il n'y en a pas un spécialisé dans docbook ? ca sert peutetre a rien ?), openoffice.org (est on obligé d'editer en wysiwyg ?) et conglomerate qui a l'air sympa comme tout...  
 
 
Merci !

J'ai choisi emacs + nxml : validation en temps réel du document, autocomplétion balises/parametres, soulignage des erreurs instantannée... bref que du bonheur
 
Autre question sur le xml / docbook : est-on obligé de mettre des <para> partout, en particulier à l'intérieur d'un <listitem> ? Purée c'est vraiment enervant... Ca compile quand je les met pas mais nxml dit qu'il y a une erreur.
 
Le xml est le premier language que je vois ou y'a plus de balises que d'informations, et encore je me suis pas encore mis à mathml, ouf !

 
Une balise est une information aussi : c'est une information de structuration et/ou sémantique.

Hello,
 
Je me permet d'exhumer ce topic    ... car je vais peut-être me lancer dans docbook et je voudrais avoir un feed-back d'utilisateurs pour savoir si c'est bien adapté à ce que je dois faire !
 
Je bosse actuellement sur un travail de diplôme (un programme de gestion de projet en EJB3) et je galère à mort à faire le rapport avec m$Word (faut dire que j'ai actuellement 30 pages bien garnies d'images etc... et que je compte produire une 100ène de page). Je pète les plombs avec cet office de m       **** car j'ai plein de problème de mise en page et le correcteur de grammaire qui veut plus fonctionner à cause du nombre de page etc...
 
On m'a conseillé InDesign, mais perso je n’aime pas du tout car on mélange complètement la présentation et le contenu (enfin il me semble) ... et en plus je ne connais pas du tout se soft ! Avec Word j'ose plus taper une ligne, car j'ai peur de foudre le bordel dans ma mise en page ...  
 
Je me suis donc mis à docbook, j'ai pu générer quelques petits exemples en PDF (j'utilise la version XSL) et le résultat me paraît assez propre pour un travail de diplôme ! Mais je n'ai pas encore essayé d'y intégrer des images/annotationc/... enfin les joyeusetés que doit habituellement contenir ce genre de document ! Donc si quelqu'un pouvait me balancer un feed-back (c'est supergigatropbien adapté ou tuvatefairetropchier utilise InDesign ...)
 
P.S.
Je suis également à la recherche d'exemples en docbook, du genre les source docbook d'un livre ou qqch du genre

Salut ! Moi je me suis servi de docbook ponctuellement pour faire quelques petits trucs mais j'y ai pas retouché depuis. Je ne saurai trop te conseiller mais d'après ce que j'ai lu docbook serait spécialement adapté pour faire de la doc concernant les applications informatiques... c'est donc assez proche de ce que tu souhaites faire non ? Par contre le résultat PDF d'un document docbook que j'avais eu était correct mais tu sens quand même la différence avec latex qui est vraiment fait pour l'impression (papier ou pdf) alors qu'un document docbook a une meilleur sortie sur page(s) web.
 
Ce qui est sympa avec docbook c'est que tu as vraiment l'impression de définir ton document à fond... ça se transforme en inconvénient lorsque tu es trop pointilleux et tu perds du temps à changer de balise pour décrire ton information au mieux, alors qu'à l'écran il n'y aura aucune différence... Il ne faut pas se soucier que du rendu final c'est sur, ce serait completement contraire à l'esprit docbook, mais lorsque tu as fait un travail correct il faut arreter de vouloir le rendre parfait sinon tu n'en finis plus. Enfin c'est ce que je pense.
 
Enfin pour faire du docbook il faut s'accompagner d'un bon éditeur qui te facilite les choses ! A l'époque j'utilisais emacs avec le mode nxml. Mais comme dit mon expérience de docbook n'a pas durée longtemps.
 
Voilà, je pense que tu savais déjà un peu tout ça mais je suis désolé je ne pourrais pas t'aider davantage

bon, docbook c'est très bien ! Vraiement super bien pensé. Par contre j'ai des soucis avec la sortie pdf !
 
La qualité c'est pas ça, par exemple je n'ai pas trouvé de moyen de gérer les lignes orphelines. J'ai une Section est un prit screen droit dessous la section et je trouve pas le moyen de forcer le titre de la section à rester sur la même page que le print ... assez moche. Si quelqu'un à des infos, je suis preneur !
 
Sinon j'ai trouvé un moyen (DB2Pdf) de générer un fichier .tex (LaTeX) à partir du document docbook ! super intéressant, car après on peut utiliser les possibilités de LaTex pour améliorer la qualité du pdf. Mais au niveau du maintien c'est la galère ...
 
Je me demandais s'il existant un formu spécialisé pour docbook (Rien trouvé ) ou un bon livre en français ..? Parce que passer à LaTeX je sais pas si c'est la bonne solution ... y doit avoir un monstre temps d'apprentissage, c'est ENORME çe machin. En plus la notation latex est assez moche.

J'utilise FOP pour générer du pdf et j'ai aussi constaté ce problème de lignes orphelines... il est probable que docBook utilise également FOP.

ben dans mon cas c'est ce qui se passe, puise j'utilise la version "xsl" de docbook (le dsssmachin je sais même pas c'est quoi)
 
donc du xml -> vers un .fo à l'aide d'une transformation xsl, puis après j'utilse le moribond apache fop (zavé vu la date de dernère modification ! ça fait depuis 2003 qu'il n'y a pas eu de mise à jour ...) pour faire du pdf.
 
Par contre si le problème est connu, il doit bien exister un moyen d'y remédier ...?

Le moribond FOP comme tu dis est en réécriture complète si j'ai bien compris... la 0.20.xx est sensé tenir jusqu'à la sortie de ce qu'ils appellent FOP 2.

Office n'est de la merde uniquement si on maîtrise pas

 
ça c'est une bonne nouvelle ! Mais y'a un calendrier en quelque part, parce que actuellement quand je compile du fop, j'ai toujours des centains d'avertissement comme quoi j'utilise des fonction (de la norme) pas implémentée ... (au boulot on fait tous les outputs avec FOP...)
 

 
Bon, j'admets ne pas maîtriser m$office.. mais t'a déjà essayé de faire un rapport d'une centaine de pages bourré de graphiques et de lignes de codes    ?

Ouais j'ai déjà fait Faut bien maîtriser tout ce qui est styles

Office c'est caca. Avec le concurrent OpenOffice j'ai toujours pu formatter mes textes comme je le voulais et facilement. Il faut dire que je suis très pointilleux sur un espace en trop ou en moins etc. Et avec Office il se comporte bizarrement lorsqu'on fait un retour à la ligne au milieu d'une "puce" ou truc de ce genre. On arrive à obtenir finalement ce qu'on veut après moult suppression copier/coller retour à la ligne etc.
 
C'est peut-etre gérable avec les styles mais tu parles d'une facilité d'utilisation. Si le logiciel est mal configuré par défaut pour avoir un comportement "naturel", je considère ça comme une faute.
 
Sinon je me rappelle d'un test que j'avais fait, c'était de coller sur des centaines de pages du texte tapé au hasard avec le correcteur orthographique activé (et le soulignement des mots non reconnus). Office est très vite arrivé à saturation, je me rappelle plus s'il avait vraiment planté ou pas mais c'était tout comme. Openoffice n'a pas bronché.
 
Enfin je trouve les menus d'openoffice mieux rangés et l'interface en général beaucoup plus intuitive.

En ce qui me concerne, j'ai vite abandonné Docbook au profit de latex à cause de la verbosité des balises XML (y en a partout!) et du rendu PDF plutôt mauvais (j'avais l'impression de ne rien contrôler )
De plus, Latex est tout aussi simple à apprendre que Docbook, il suffit d'apprendre les quelques balises de base et ça va. Après on apprend au cas par cas

MS Word? C'est bon pour faire des lettres ( avec pas trop de pages), par contre si tu veux pondre une doc de plusieurs centaines de pages tu va t'arracher les cheveux et passer plus de temps à te battre avec Word que d'écrire ta doc.
 
Faire une lettre OpenOffice le fait aussi bien et pour nettement moins cher...  
 
 

Non. Si t'appuyes juste sur entrée, alors il insert un "nouveau paragraphe". Si tu veux un vrai retour à la ligne dans un puce, faut faire Shift + Entrée

 
Ouais, c'est le pied ce machin (enfin fo quand même être un peu sado-maso    ) mais les sortie pdf sont fantabuleuse !!
J'ai vite commandé le LaTeX par la pratique d'O'Reilly histoire d'approfondire un peu.
 
Par contre au niveau structure c'est quand même bien mieu docbook, car c'est en xml, mais les feuilles de style docbook->latex sont assez correctes, donc je me tappe le docbook pour la structure+la production de .chm/html et le fichier .tex, ensuite quelques petites retouches avec LEd et hop, un beau pdf...  
 
Enfin c'est "presque" parfait, car y'a quand même un chti problème avec LaTeX et les .gif, mais ca demande pas des masses de travail à convertir...

Bonjour à tous,
Pour ceux que ça interresse j'ai rédigé un petit tutorial sur le docbook.
Il n'a pas pour vocation d'etre complet, mais permet de se familariser au docbook sans passer des heures a rechercher les logiciels et les techniques nécéssaires. Les logiciels fournis sont gratuits et open source, ils sont aussi compatibles windows et unix puisque développés en Java.
 
Vous trouverez ce Tutorial sur le docbook à l'adresse suivante: http://www.stephane-arnault.net/pr [...] cbook.html

 
Merci pour le tuto, tres stabilisant pour un neuneu comme moi
 
J'ai un leger pb concernant les feuilles de style : J'arrive a generer N fichiers HTML correspondant aux titres principaux de mon docbook (un fichier par titre principal) mais celui-ci etant particulierement volumineux (images, tableaux, ...), je me retrouve avec des fichiers HTML de grosse taille et j'aimerai que le decoupage en fichier soit effectué plus finement (un fichier par titre secondaire). Est-ce possible et comment dois je m'y prendre ?
 
Merci pour votre aide  

Je relance ce post car je compte me mettre à DocBook pour mettre en place un système de gestion de documentation.
Je cherche un éditeur xml avec une interface WYSIWYG, pour les utilisateurs mais je ne trouve pas grand.
 
d'a^rés le post emacs à l'air pas mal mais est-ce que les choses ont changés depuis ? y-a-t-il un soft qui serait mieux pour mon utilisation ?

 
Perso, je ne suis pas un pro de Word, mais dans le cadre de mon travail, j'ai été amené à rédigé un MUT (manuel utilisateur) pour une appli web. Ce doc est truffé d'imprim-écrans et fait plus de 550 pages aujourd'hui! Ben j'ai pas de pb si ce n'est qq lenteur à l'ouverture et l'enregistrement car mon pc de bureau n'a que 512 Mo de ram et en +, je travaille à partir du lecteur réseau ...