--
Bonjour,
Je ne connais pas d'outils qui fassent ça "automatiquement". Par contre,
il est tout à fait possible d'écrire une feuille XSLT (doc.xsl) qui
prenne comme source une feuille XSLT (in.xsl); Dans ce cas, il est
impératif de faire attention à ne pas mélanger les préfixes et d'éviter
que la documentation ne soit instancier dans le document de sortie d'une
transformation par in.xsl (rôle du <xsl:fallback> vide). Dans la feuille
in.xsl, on peut insérer des balises de documentation. Un petit exemple
sans prétention :
in.xsl :
<?xml version="1.0"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:xdoc="http://www.jmg.com/xdoc" exclude-result-prefixes="xdoc"
extension-element-prefixes="xdoc">
<xsl:template match="/" name="ProcessRoot" >
<xdoc:description>Ce template traite la racine du document
<xsl:fallback/></xdoc:description>
<H1>This is the Root document </H1>
</xsl:template>
</xsl:stylesheet>
doc.xsl :
<?xml version="1.0"?>
<t:stylesheet version="1.0" xmlns:t="http://www.w3.org/1999/XSL/Transform"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:xdoc="http://www.jmg.com/xdoc">
<t:output method="html" />
<t:template match="/">
<html>
<title>
</title>
<body>
<t:apply-templates />
</body>
</html>
</t:template>
<t:template match="xsl:template">
<H1><CENTER>New Template </CENTER></H1>
<H2>Name : <t:value-of select="@name" /></H2>
<H2>Match condition : <t:value-of select="@match" /></H2>
<H2>Description : </H2>
<P><t:value-of select="xdoc:description" /></P>
</t:template>
</t:stylesheet>
output :
New Template
Name : ProcessRoot
Match condition : /
Description :
Ce template traite la racine du document
Noter que dans une récente discussion sur xml-dev J.Tennison propose
d'autres solutions que celle-ci :
We've discussed documentation work-arounds in XSLT 1.0 on and off for
years -- make the documentation elements extension elements and
include an empty xsl:fallback; run the stylesheet through a
de-documentation-izer before using it; use XML comments with XML
inside that you get out via disable-output-escaping.
Salutations,
--
Joël Martin-Gallausiaux, Sun Microsystems Educational Services, France.
Tel : 33 1 4143 1724 Mobile : 33 6 7468 8206
Benjamin MAGNAN wrote:
>Bonjour,
>J'aimerais savoir s'il existe déjà quelque chose permettant de générer une
>page XHTML, ou autre pdf, ... à partir d'un fichier XSL permettant de faire
>comprendre aux non initiés les changements opérés par ce fichier.
>
>Si cela n'existe pas déjà est t'il possible de faire un XSL qui prendrais
>comme source un XSL.
>
>Cordialement,
>MAGNAN Benjamin.
>
>--
>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)
Received on Tue Apr 8 16:20:00 2003