Re: [Dolibarr-dev] Documentation utilisateur à compiler etc... comment fait-on?

[Yannick Warnier]

Le lundi 06 août 2007 à 15:37 -0500, Yannick Warnier a écrit :
> Le lundi 06 août 2007 à 20:54 +0200, Laurent Destailleur (Eldy) a
> écrit :
> > En fait je disais qu'il y avait une tentative de faire une doc au format 
> > SGML.
> > Mais elle n'a jamais vécu.
> > 
> > La doc utilisateur la plus a jour est la doc HTML du wiki qui a le 
> > mérite d'etre a jour bien que super incomplète.
> > Si il existe des outils pour genérer des doc depuis un mediawiki, c'est 
> > la piste a suivre.
> > Via un export du wiki en xml qui est le format de sauvegarde mediawiki 
> > peut-etre.
> 
> En attendant je viens de constater que OpenOffice permet un export
> DocBook, et je potasse un petit livre sur DocBook a l'occasion. Vu que
> SGML est un ensemble contenant XML, et vu que la plupart des outils de
> documentation multi-formats de sortie utilisent DocBook (et
> qu'apparemment le SGML de la doc est un peu trop "hors" DocBook pour
> être compris par des lecteurs DocBook), je crois effectivement que
> l'esport XML de MediaWiki est la meilleure solution, quitte à faire un
> schéma XSLT qui le transforme en DocBook avant de lui-même le
> transformer en RTF, PDF, ou que sais-je.
> 
> Cela dit, même si la documentation du Wiki est à jour, je suis sceptique
> quant à sa hiérarchie et à l'export éventuel de captures d'écran, mais
> ça peut s'arranger à la base (sur le wiki) avant l'export.

Pour l'export, il suffit de mettre la page qu'on veut dans l'URL comme
ceci:
http://www.dolibarr.com/wikidev/index.php/Special:Export/Documentation_utilisateur

Mais alors on n'a qu'une page. Pour de multiples pages il faut aller
dans les "Pages spéciales" -> "Exporter des pages" et y indiquer les
titres des pages à exporter.
http://www.dolibarr.com/wikidev/index.php/Special:Export

On peut donc y placer une liste comme ceci (plus ou moins):

Documentation_utilisateur
Pr%C3%A9requis
Installation_/_Mise_a_jour
Premiers_param%C3%A9trages
Soci%C3%A9t%C3%A9s
Produits
Services
Produits_associ%C3%A9s
Sous-Produits
Proposition_commerciale
Commande
Facturation
CommandeFournisseur
FactureFournisseur
Contrat
Projet
Comptabilit%C3%A9
Rapports_TVA
Mailing
Calendrier
Exports
Adherents
T%C3%A9l%C3%A9phonie
TelephonieProcedureFacturation
Stock
Glossaire

Ce qui nous donne un truc grosso-modo inutilisable, mais qui contient
les données, en effet. 

Bon allez, inutilisable c'est vide dit et c'est principalement parce
qu'il laisse le format texte du wiki, soit des == == pour les
sous-titres (ce qui sera difficile à filtrer si on a en même temps du
code source avec des comparaisons "==" sur cette page).
Cela dit, il rend tout en un seul fichier, ce qui est une bonne chose.

À priori il suffirait de modifier un peu le script d'export de MediaWiki
pour en faire un export DocBook (en transformant les = x = et les  == xx
== ) que l'on pourrait alors réutiliser directement.

Yannick