Par exemple faire une belle documentation pdf avec wiki est un défit. En général il peut faire un pdf par page wiki.
Autre problème, wiki n'est pas très adapté avec un gestionnaire de version. D'accord wiki a un gestionnaire de version. Mais c'est par page.
Autre problème, comment faire pour bien synchroniser une traduction (on veut faire une doc en français et une en anglais). Avec Docbook c'est possible et dans le même fichier (il faut que je valide la solution que j'envisage).
Ça donnera un truc dans ce goût : <section>
<title lang="fr">Amusant</title>
<title lang="en">Fun</title>
<para lang="fr">Je veux te tuer !</para>
<para lang="en">I want to kill you !</para>
</section>
Si on veut faire un fichier .chm pour Windows, ça se fait assez facilement avec Docbook.
Enfin, j'ai lu des longues discutions sur la mailing documentation de Fedora pour voir s'il y avait une alternative au "lourdingue" Docbook. Rien de sérieux a été trouvé.
Docbook n'est pas si compliqué que ça. Par contre sa mise en oeuvre (les divers bidules à installer) est assez pénible.
Eclipse (ou pgsml d'emacs) rend l'édition docbook assez simple (validation en un clique, format en un clique, convertit en entité xml automatiquement si c'est nécessaire, liste des balises ou attributs autorisés en fonction du contexte en un clique, une petite fenêtre qui indique la structure du document pour y naviguer rapidement, etc).
J'ai fait le choix Docbook, il y a du subjectif.
Wiki a des atouts indéniables. Par contre restructurer un document avec wiki est assez casse couille. La navigation dans le document aussi (au faut coder des trucs). Avec Docbook ça se fait les doigts dans le nez.
[^] # Re: Comprends pas
Posté par IsNotGood . En réponse au journal Eclipse & Docbook. Évalué à 2.
Mais il y a quelques problèmes.
Par exemple faire une belle documentation pdf avec wiki est un défit. En général il peut faire un pdf par page wiki.
Autre problème, wiki n'est pas très adapté avec un gestionnaire de version. D'accord wiki a un gestionnaire de version. Mais c'est par page.
Autre problème, comment faire pour bien synchroniser une traduction (on veut faire une doc en français et une en anglais). Avec Docbook c'est possible et dans le même fichier (il faut que je valide la solution que j'envisage).
Ça donnera un truc dans ce goût :
<section>
<title lang="fr">Amusant</title>
<title lang="en">Fun</title>
<para lang="fr">Je veux te tuer !</para>
<para lang="en">I want to kill you !</para>
</section>
Si on veut faire un fichier .chm pour Windows, ça se fait assez facilement avec Docbook.
Enfin, j'ai lu des longues discutions sur la mailing documentation de Fedora pour voir s'il y avait une alternative au "lourdingue" Docbook. Rien de sérieux a été trouvé.
Docbook n'est pas si compliqué que ça. Par contre sa mise en oeuvre (les divers bidules à installer) est assez pénible.
Eclipse (ou pgsml d'emacs) rend l'édition docbook assez simple (validation en un clique, format en un clique, convertit en entité xml automatiquement si c'est nécessaire, liste des balises ou attributs autorisés en fonction du contexte en un clique, une petite fenêtre qui indique la structure du document pour y naviguer rapidement, etc).
J'ai fait le choix Docbook, il y a du subjectif.
Wiki a des atouts indéniables. Par contre restructurer un document avec wiki est assez casse couille. La navigation dans le document aussi (au faut coder des trucs). Avec Docbook ça se fait les doigts dans le nez.