Bonjour,
C'est exactement l'objectif du projet schemadoc,
avec un modèle qui mixe le modèle de docbook et
celui des schémas en inter-reliant le deux par
son propre espace de noms assurant les liens.
L'information est extraite des schémas pour être
réintégrée dans la documentation elle-même ; les
graphiques sont issus automatiquement d'XMLSpy.
Un exemple ? La documentation de schemadoc lui même :
http://www.tireme.fr/XMLSchema/documentation/V2/out/html/index.html
L'état du projet ? Il me sert en interne, lorsque
je fait des schémas ou des DTD avec mes clients.
Il a déjà servi pour une dizaine de projets, pour
des docs conséquentes de plusieurs centaines de
pages corresponondant à des schémas de plus de
deux ou trois cent éléments. Il est aussi utilisé
par bruno chatel, présent sur cette liste.
Ma politique sur l'outil est la suivante : un
jour, ce sera dan le domaine du logiciel libre.
Il faut toutefois arriver à une maturation un peu
plus importante pour en assurer son debugging, sa
documentation, bref son utlisabilité.
En attendant, je fonctionne sur la base du
partage : ca t'intéresse, tu peux l'utiliser et
il faut voir ensemble comment tu le fais évoluer, en échange.
Certains participent à son développement (bruno
chatel, xerox), d'autres paticipent à sa
documentation (un éditeur de logicile enFrance),
d'autres fournissent des outils d'édition
(Arbortext), d'autres enfin le teste et font des
rapports de tests et de bugs (EDF).
Voilà, pour de plus amples discussions, tu peux
prendre contact avec moi : on peut aussi en
parler plus en profondeur sur cette liste.
Avant tout, les bons pointeurs,
- l'introduction :
http://www.tireme.fr/XMLSchema/documentation/V2/out/html/introSect.html
- le getting started :
http://www.tireme.fr/XMLSchema/documentation/V2/out/html/startSect.html
- le how-to :
http://www.tireme.fr/XMLSchema/documentation/V2/out/html/createDoc.html
Ce dernier pointeur a l'avantage de montrer
schemaDoc en action, dans des contextes de pure
documentation opérationnelle, en y faisant le
lien examples et documentation des objets.
Bonnes lectures, Pierre
At 17:35 21/09/2005, you wrote:
>Bonjour,
>pensez-vous qu'il soit possible d'inclure dans un document docbook une
>représentation (lisible) d'un schéma xml?
>Je dois créer une documentation, mais je veux éviter de dupliquer des
>informations. Donc je voudrais créer un document (docbook), mais ne pas y
>dupliquer les informations sur la structure de mes données, qui sont déjà
>decrites dans un schéma. Je voudrais donc que ma documentation docbook
>inclue le résultat d'une transformation de mon schéma. (puisque le shèma en
>lui-même doit être traité pour être lisible dans une documentation). Le tout
>dynamiquement, évidement, pour que toute modification du shèma soit
>directement traduite...
>Une idée?
>Est-que quelqu'un à déjà fait ou trouvé une transformation xslt qui rende un
>schéma xml en texte lisible (une sorte d'arbre serait génial)
>Gilles VANDAELE
>
>
>
>-----Disclaimer-----
>
>This message may contain confidential
>information intended solely for the use of the
>named addressee. If you are not the intended
>recipient, you should not read, use, disclose or
>reproduce the content of this message. If you
>have received this message by mistake, please
>notify the sender immediately. Any views or
>opinions presented in this message are solely
>those of the author and do not necessarily
>represent those of AXA Belgium, AXA Bank
>Belgium, AXA Tech Belgium GIE - ESV or any other
>entity of the AXA Group, unless otherwise stated
>by the sender and duly authorized by the said companies.
>
>---------------------
>
>
>
>--
>Devenez redacteur <XML>fr et contribuez au developpement du
>xml francophone (http://xmlfr.org/infos/redacteurs/) !
>
>Liste de diffusion "xml-tech@xmlfr.org" (http://xmlfr.org).
>
>Cette liste est a votre disposition pour discuter en francais de
>tout sujet technique lie a XML.
>
>Pour resilier votre abonnement, envoyez un message contenant
>la commande "unsubscribe" a xml-tech-request@xmlfr.org
>(mailto:xml-tech-request@xmlfr.org?Subject=unsubscribe)
Pierre Attar (mailto:pat@tireme.fr)
Consultant en informatique documentaire XML
Consultant in Structured Document engineering
Tirème SARL (http://www.tireme.fr)
Projet "Mutualiser l'effort de montée en compétences sur XML"
http://www.mutu-xml.org/index.html
--
Devenez redacteur <XML>fr et contribuez au developpement du
xml francophone (http://xmlfr.org/infos/redacteurs/) !
Liste de diffusion "xml-tech@xmlfr.org" (http://xmlfr.org).
Cette liste est a votre disposition pour discuter en francais de
tout sujet technique lie a XML.
Pour resilier votre abonnement, envoyez un message contenant
la commande "unsubscribe" a xml-tech-request@xmlfr.org
(mailto:xml-tech-request@xmlfr.org?Subject=unsubscribe)
Received on Wed Sep 21 22:25:25 2005
