[xml-tech] Re: Documentation de DTD et/ou XML Schema

Merci à tous pour vos remarques éclairées.

Je creuse le sujet avec l'ensemble des liens que
vous m'avez fourni.

Cordialement

Hervé

> -----Original Message-----
> From: xml-tech-bounce@xmlfr.org [mailto:xml-tech-bounce@xmlfr.org]On
> Behalf Of Frédéric Glorieux
> Sent: vendredi 15 octobre 2004 00:30
> To: xml-tech@xmlfr.org
> Subject: [xml-tech] Re: Documentation de DTD et/ou XML Schema
>
>
> COLLET Herve wrote:
>
> > Bonjour à tous,
> >
> > j'ai écrit des DTDs pour un ensemble de documents
> > XML et je souhaiterais fournir une documentation
> > sur cette DTD afin que des personnes non initiés
> > puissent facilement écrire les dits documents.
> >
> > Existe-t-il des outils (freeware peut-être) qui
> > permette de générer des documentations de DTD et/ou
> > XML Schéma ?
> > Documentations sous forme HTML (Javadoc like) ou
> > tout autre format m'iront très bien :)
> >
> > Merci d'avance pour votre aide.
>
> Si votre source est une DTD, je vous conseille le bon vieux DTDParse
> <http://dtdparse.sourceforge.net/> maintenu par Norman Walsh,
> que nous
> avons utilisé ici
> <http://www.ajlsm.com/artistes/2004/dtd/html/index.html> ou là
> <http://www.biblioml.org/dtds/biblioml_030/html/elements.html>. J'ai
> fait ceci
> <http://www.ajlsm.com/projets/sdapa/schema/indexes/elements.html> qui
> imite le principe mais en XSL sur XMLSchéma.
>
> Ces deux exemples ne sont pas seulement gratuits, ils sont sources
> libres (donc adaptables à vos besoins).
>
> Je peux en tous cas vous dire que le plus important, ce n'est pas
> seulement d'avoir la liste des éléments et attributs, mais
> surtout d'en
> avoir une définition. DTDParse se fonde sur un bon usage du
> commentaire
> <!-- -->, pour les XMLSchéma,
> <xs:annotation><xs:documentation/><xs:annotation> ont une sémantique
> pauvre qu'il faut nécessairement compléter un peu (HTML ? Docbook ?).
> Pour ce cas ci
> <http://www.ajlsm.com/projets/sdapa/schema/sdapa.xsd>, le
> schéma est documenté dans son propre schéma, ce qui était un bon test
> pour les transformations.
>
> Les outils que j'ai habituellement vu pour documenter un
> schéma produise
> tout en un fichier, en général assez peu commode. Ils essaient de
> remplacer du texte intelligent par des graphiques générés
> automatiquement, en général difficile à comprendre. Tout dépends de
> votre optique commerciale, mais s'il s'agit de faire masse,
> XMLSpy est
> impressionnant.
>
>
>
> --
> Frédéric Glorieux (ingénieur documentaire, AJLSM)
> <http://www.ajlsm.com>
>
> --
> 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)
>
>

--
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)