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)
Received on Fri Oct 15 00:29:48 2004
