cvs: phpdoc /fr/functions xslt.xml
| From: | Damien Seguy | Date: | Thu, 30 Nov 2000 10:58:35 +0000 |
| Subject: | cvs: phpdoc /fr/functions xslt.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969333126@lists.php.net to get a copy of this message | ||
dams Thu Nov 30 02:58:35 2000 EDT
Modified files:
/phpdoc/fr/functions xslt.xml
Log:
Transalation.
Index: phpdoc/fr/functions/xslt.xml diff -u phpdoc/fr/functions/xslt.xml:1.1 phpdoc/fr/functions/xslt.xml:1.2 --- phpdoc/fr/functions/xslt.xml:1.1 Mon Nov 13 02:39:35 2000 +++ phpdoc/fr/functions/xslt.xml Thu Nov 30 02:58:34 2000 @@ -1,63 +1,53 @@ <reference id="ref.xslt"> - <title>Fonctions XSLT</title> + <title>XSLT</title> <titleabbrev>XSLT</titleabbrev> - <partintro> <sect1 id="xslt.partintro"> <title>Introduction</title> - <sect2 id="xslt.intro"> - <title>About XSLT and Sablotron</title> + <title>A propos de XSLT et Sablotron</title> <para> - Ce chapitre est toujours en cours de rédaction. - Nous attendons sa stabilisation pour la traduction. XSLT (Extensible Stylesheet Language (XSL) - Transformations) is a language for transforming XML - documents into other XML documents. It is a standard - defined by The World Wide Web consortium (W3C). - Information about XSLT and related technologies can be - found at <ulink url="&url.xslt;">&url.xslt;</ulink>. + Transformations) est un langage de transformation des documents + XML en d'autres documents XML. C'est un standard défini par le + consortium World Wide Web (W3C). Les informations sur le + XLST et ses technologies sont disponibles à + <ulink url="&url.xslt;">&url.xslt;</ulink>. </para> </sect2> - <sect2 id="xslt.install"> <title>Installation</title> <para> - This extension uses <productname>Sabloton</productname> - and <productname>expat</productname>, which can both be - found at <ulink - url="&url.sablotron;">&url.sablotron;</ulink>. Binaries - are provided as well as source. + Cette extension utilise <productname>Sabloton</productname> + et <productname>expat</productname>, qui sont toutes les deux + disponibles à <ulink url="&url.sablotron;">&url.sablotron;</ulink>. + Les sources comme les exécutables sont proposés. </para> <para> - On UNIX, run <command>configure</command> with the <option - role="configure">--with-sablot</option> and <option - role="configure">--enable-sablot-errors-descriptive</option> - options. The <productname>Sablotron</productname> library - should be installed somewhere your compiler can find it. + Sous UNIX, lancez <command>configure</command> avec l'option <option + role="configure">--with-sablot</option>. + La librairie <productname>Sablotron</productname> doit être installée + là où le compilateur peut la trouver. </para> </sect2> - <sect2 id="xslt.about"> - <title>About This Extension</title> + <title>A propos de Sablotron</title> <para> - This PHP extension implements support - <productname>Sablotron</productname> from Ginger Alliance - in PHP. This toolkit lets you transform - XML documents into other documents, including new XML - documents, but also into HTML or other target formats. It - basically provides a standardized and portable template - mechanism, separating content and design of a website. + Cette extension PHP implémente le support de + <productname>Sablotron</productname>, par Ginger Alliance. + Cette librairie vous permet de transformer des documents + XML en d'autres documents XML, mais aussi en HTML ou encore + n'importe quel format à balise. Elle fournit un mécanisme + basique et portable de templates, séparant le contenu + de l'interface d'un site web. </para> </sect2> - </sect1> </partintro> - <refentry id="function.xslt-closelog"> <refnamediv> <refname>xslt_closelog</refname> - <refpurpose>Clear the logfile for a given instance of Sablotron</refpurpose> + <refpurpose>Efface le fichier d'historique</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -73,19 +63,19 @@ <term><parameter>xh</parameter></term> <listitem> <simpara> - A reference to the XSLT parser. + Une référence valide sur un analyseur XSLT. </simpara> </listitem> </varlistentry> </variablelist></para> <para> - This function returns false if <parameter>parser</parameter> does - not refer to a valid parser, or if the closing of the logfile - fails. Otherwise it returns true. + <function>xslt_closelog</function> retourne FALSE si + <parameter>xh</parameter> n'est pas un analyse XSLT valide, ou bien + si la fermeture du fichier d'historique a échoué. Sinon, retourne + TRUE. </para> </refsect1> </refentry> - <refentry id="function.xslt-create"> <refnamediv> <refname>xslt_create</refname> @@ -100,16 +90,15 @@ </funcprototype> </funcsynopsis> <para> - This function returns a handle for a new XSL processor. This handle - is needed in all subsequent calls to XSL functions. + <function>xslt_create</function> retourne un identifiant d'analyseur + XSLT. Il sera nécessaire pour les appels ultérieurs aux fonctions. </para> </refsect1> </refentry> - <refentry id="function.xslt-errno"> <refnamediv> <refname>xslt_errno</refname> - <refpurpose>Return the current error number</refpurpose> + <refpurpose>Retourne le numérod d'erreur courant</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -122,17 +111,16 @@ </funcprototype> </funcsynopsis> <para> - Return the current error number of the given XSL processor. If - no handle is given, the last error number that occured anywhere - is returned. + <function>xslt_errno</function> le numéro courant d'erreur, pour l'analyseur + <parameter>xh</parameter>. Si <parameter>xh</parameter> n'est pas + fourni, le dernier numéro d'erreur est retourné. </para> </refsect1> </refentry> - <refentry id="function.xslt-error"> <refnamediv> <refname>xslt_error</refname> - <refpurpose>Return the current error string</refpurpose> + <refpurpose>Retourne le message d'erreur couran</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -145,17 +133,16 @@ </funcprototype> </funcsynopsis> <para> - Return the current error string of the given XSL processor. If - no handle is given, the last error string that occured anywhere - is returned. + <function>xslt_errno</function> le message d'erreur courant, pour l'analyseur + <parameter>xh</parameter>. Si <parameter>xh</parameter> n'est pas + fourni, le dernier numéro d'erreur est retourné. </para> </refsect1> </refentry> - <refentry id="function.xslt-fetch-result"> <refnamediv> <refname>xslt_fetch_result</refname> - <refpurpose>Fetch a (named) result buffer</refpurpose> + <refpurpose>Lit un résultat</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -169,17 +156,17 @@ </funcprototype> </funcsynopsis> <para> - Fetch a result buffer from the XSLT processor identified by - the given handle. If no result name is given, the - buffer named "/_result" is fetched. + <function>xslt_fetch_result</function> lit le résultat disponible + dans le buffer de l'analyseur <parameter>xh</parameter>. Si + <parameter>result_name</parameter> n'est pas fourni, le résultat + "/_result" sera lu. </para> </refsect1> </refentry> - <refentry id="function.xslt-free"> <refnamediv> <refname>xslt_free</refname> - <refpurpose>Free XSLT processor</refpurpose> + <refpurpose>Détruit un analyseur XSLT</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -192,15 +179,15 @@ </funcprototype> </funcsynopsis> <para> - Free the XSLT processor identified by the given handle. + <function>xslt_free</function> détruit l'analyseur XSLT + <parameter>resource xh</parameter>. </para> </refsect1> </refentry> - <refentry id="function.xslt-openlog"> <refnamediv> <refname>xslt_openlog</refname> - <refpurpose>Set a logfile for XSLT processor messages</refpurpose> + <refpurpose>Modifie le fichier d'historique</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -215,79 +202,171 @@ </funcprototype> </funcsynopsis> <para> - Set a logfile for the XSLT processor to place all of its error - messages. + <function>xslt_openlog</function> remplace le fichier d'historique + courant par <parameter>logfile</parameter>, pour l'analyseur + XSLT <parameter>xh</parameter>. </para> </refsect1> </refentry> - <refentry id="function.xslt-output-begintransform"> <refnamediv> <refname>xslt_output_begintransform</refname> - <refpurpose>unknown</refpurpose> + <refpurpose>Commence la transformation XSLT</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>unknown <function>xslt_output_begintransform</function></funcdef> + <funcdef>void + <function>xslt_output_begintransform</function> + </funcdef> <paramdef> - <parameter>unknown</parameter> + <parameter>string xslt_filename</parameter> </paramdef> </funcprototype> </funcsynopsis> <para> - This function lacks a prototype definition. + <function>xslt_output_begintransform</function> commence à retourner la + transformée de vos données. En l'appel de + <function>xslt_output_begintransform</function> et celui de + <function>xslt_output_endtransform</function>, toutes les données + seront transformées par la feuille de style XSLT <parameter>string xslt_filename</parameter>. </para> + <para> + <example> + <title>Transformation avec une feuille de style XSLT (avec DOM-XML)</title> + <programlisting role="php"> +<?php +$xsl_file = "article.xsl"; +xslt_output_begintransform($xsl_file); +$doc = new_xmldoc('1.0'); +$article = $doc->new_root('article'); +$article->new_child('title', 'Histoire du Tyrol méridional'); +$article->new_child('author', 'Sterling Hughes'); +$article->new_child('body', 'Juste après la première guerre mondiale, l'Italie + obtiend le Tyrol méridional aux dépends de l'Autriche. + Et depuis cette époque, rien d'interessant n'est arrivé.'); +echo $doc->dumpmem(); +xslt_output_endtransform(); + </programlisting> + </example> + </para> </refsect1> </refentry> - <refentry id="function.xslt-output-endtransform"> <refnamediv> <refname>xslt_output_endtransform</refname> - <refpurpose>unknown</refpurpose> + <refpurpose>Termine une transformation</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>unknown <function>xslt_output_endtransform</function></funcdef> - <paramdef> - <parameter>unknown</parameter> - </paramdef> + <funcdef>void + <function>xslt_output_endtransform</function> + </funcdef> + <void/> </funcprototype> </funcsynopsis> <para> - This function lacks a prototype definition. + <function>xslt_output_endtransform</function> termine la transformation + commencée avec <function>xslt_output_begintransform</function>. Vous devez + appeler cette fonction pour pouvoir accéder aux résultats. </para> </refsect1> </refentry> - <refentry id="function.xslt-process"> <refnamediv> - <refname>xslt_output_process</refname> - <refpurpose>unknown</refpurpose> + <refname>xslt_process</refname> + <refpurpose>Transforme des données XML</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>unknown <function>xslt_process</function></funcdef> - <paramdef> - <parameter>unknown</parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - This function lacks a prototype definition. + <funcdef>bool + <function>xslt_process</function> + </funcdef> + <paramdef> + <parameter>string xsl_data</parameter> + <parameter>string xml_data</parameter> + <parameter>string result</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>xslt_process</function> prend la chaîne + <parameter>string xsl_data</parameter> comme feuille de style XSLT, et + des données XML dans <parameter>xml_data</parameter>. Le résultat + de la transformation sera placé dans <parameter>result</parameter>. + <function>xslt_process</function> retourne TRUE en cas de succès, et + FALSE sinon. Vous pourrez lire les erreurs survenues grâce aux + fonctions <function>xslt_errno</function> et + <function>xslt_error</function> functions. + </para> + <para> + <example> + <title>Utilisation de <function>xslt_process</function> pour transformer trois</title> + <programlisting role="php"> +<?php +$xslData = ' +<xsl:stylesheet + version="1.0" + xmlns:xsl="http://www.w3.org/1999/XSL/Transform"> +<xsl:template match="article"> + <table border="1" cellpadding="2" cellspacing="1"> + <tr> + <td width="20%"> + + </title> + <td width="80%"> + <h2><xsl:value-of select="title"></h2> + <h3><xsl:value-of select="author"></h3> + <br> + <xsl:value-of select="body"> + </td> + </tr> + </table> +</xsl:template> +</xsl:stylesheet>'; +$xmlData = ' +<?xml version="1.0"?> +<article> + <title>Learning German</title> + <author>Sterling Hughes</author> + <body> + Essential phrases: + <br> + <br> + Komme sie mir sagen, woe die toilette es?<br> + Eine grande beer bitte!<br> + Noch einem bitte.<br> + </body> +</article>'; +if (xslt_process($xslData, $xmlData, $result)) +{ + echo "Voici un brillant article sur l'apprentissage du " + echo " français: "; + echo "<br>\n<br>"; + echo $result; +} +else +{ + echo "Une erreur est survenue durant le traitement XSL...\n"; + echo "\tErreur numéro : " . xslt_errno() . "\n"; + echo "\tMessage d'erreur : " . xslt_error() . "\n"; + exit; +} +?> + </programlisting> + </example> </para> </refsect1> </refentry> - <refentry id="function.xslt-run"> <refnamediv> <refname>xslt_run</refname> - <refpurpose>Apply a XSLT stylesheet to a file.</refpurpose> + <refpurpose>Applique une feuille de style à un fichier</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -305,18 +384,21 @@ </funcprototype> </funcsynopsis> <para> - Process the xml_data_file by applying the xslt_file stylesheet to - it. The stylesheet has access to xslt_params and the processor - is started with xslt_args. The result of the XSLT transformation - is placed in the named buffer (default is "/_result"). + <function>xslt_run</function> appliqu e au fichier + <parameter>xml_data_file</parameter> la feuille de style + <parameter>string xslt_file</parameter>. La feuille de style + peut utiliser les paramètres optionnels + <parameter>xslt_params</parameter> et l'analyseur XSLT est + démarré avec <parameter>array xslt_args</parameter>. Le + résultat est placé dans le buffer nommé <parameter>result</parameter> + (par défaut, dans "/_result"). </para> </refsect1> </refentry> - <refentry id="function.xslt-set-sax-handler"> <refnamediv> <refname>xslt_set_sax_handler</refname> - <refpurpose>Set SAX handlers for a XSLT processor</refpurpose> + <refpurpose>Modifie les gestionnaires SAX de l'analyseur XSLT</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -330,34 +412,42 @@ </funcprototype> </funcsynopsis> <para> - Set SAX handlers on the ressource handle given by xh. + <function>xslt_set_sax_handler</function> remplace les gestionnaires SAX + de l'analyseur XSLT <parameter>xh</parameter> par + <parameter>handlers</parameter>. </para> </refsect1> </refentry> - <refentry id="function.xslt-transform"> <refnamediv> <refname>xslt_transform</refname> - <refpurpose>unknown</refpurpose> + <refpurpose>Exécute une transformation XSLT</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>unknown <function>xslt_transform</function></funcdef> - <paramdef> - <parameter>unknown</parameter> + <funcdef>bool + <function>xslt_transform</function> + </funcdef> + <paramdef> + <parameter>string xsl</parameter> + <parameter>string xml</parameter> + <parameter>string result</parameter> + <parameter>string params</parameter> + <parameter>string args</parameter> + <parameter>string resultBuffer</parameter> </paramdef> </funcprototype> </funcsynopsis> <para> - This function lacks a prototype definition. + <function>xslt_transform</function> fourni une interface avec les + API avancées de sablotron, sans vous obliger à utiliser les + ressources. </para> </refsect1> </refentry> - </reference> - <!-- Keep this comment at the end of the file Local variables: mode: sgml
Index: phpdoc/fr/functions/xslt.xml diff -u phpdoc/fr/functions/xslt.xml:1.1 phpdoc/fr/functions/xslt.xml:1.2 --- phpdoc/fr/functions/xslt.xml:1.1 Mon Nov 13 02:39:35 2000 +++ phpdoc/fr/functions/xslt.xml Thu Nov 30 02:58:34 2000 @@ -1,63 +1,53 @@ <reference id="ref.xslt"> - <title>Fonctions XSLT</title> + <title>XSLT</title> <titleabbrev>XSLT</titleabbrev> - <partintro> <sect1 id="xslt.partintro"> <title>Introduction</title> - <sect2 id="xslt.intro"> - <title>About XSLT and Sablotron</title> + <title>A propos de XSLT et Sablotron</title> <para> - Ce chapitre est toujours en cours de rédaction. - Nous attendons sa stabilisation pour la traduction. XSLT (Extensible Stylesheet Language (XSL) - Transformations) is a language for transforming XML - documents into other XML documents. It is a standard - defined by The World Wide Web consortium (W3C). - Information about XSLT and related technologies can be - found at <ulink url="&url.xslt;">&url.xslt;</ulink>. + Transformations) est un langage de transformation des documents + XML en d'autres documents XML. C'est un standard défini par le + consortium World Wide Web (W3C). Les informations sur le + XLST et ses technologies sont disponibles à + <ulink url="&url.xslt;">&url.xslt;</ulink>. </para> </sect2> - <sect2 id="xslt.install"> <title>Installation</title> <para> - This extension uses <productname>Sabloton</productname> - and <productname>expat</productname>, which can both be - found at <ulink - url="&url.sablotron;">&url.sablotron;</ulink>. Binaries - are provided as well as source. + Cette extension utilise <productname>Sabloton</productname> + et <productname>expat</productname>, qui sont toutes les deux + disponibles à <ulink url="&url.sablotron;">&url.sablotron;</ulink>. + Les sources comme les exécutables sont proposés. </para> <para> - On UNIX, run <command>configure</command> with the <option - role="configure">--with-sablot</option> and <option - role="configure">--enable-sablot-errors-descriptive</option> - options. The <productname>Sablotron</productname> library - should be installed somewhere your compiler can find it. + Sous UNIX, lancez <command>configure</command> avec l'option <option + role="configure">--with-sablot</option>. + La librairie <productname>Sablotron</productname> doit être installée + là où le compilateur peut la trouver. </para> </sect2> - <sect2 id="xslt.about"> - <title>About This Extension</title> + <title>A propos de Sablotron</title> <para> - This PHP extension implements support - <productname>Sablotron</productname> from Ginger Alliance - in PHP. This toolkit lets you transform - XML documents into other documents, including new XML - documents, but also into HTML or other target formats. It - basically provides a standardized and portable template - mechanism, separating content and design of a website. + Cette extension PHP implémente le support de + <productname>Sablotron</productname>, par Ginger Alliance. + Cette librairie vous permet de transformer des documents + XML en d'autres documents XML, mais aussi en HTML ou encore + n'importe quel format à balise. Elle fournit un mécanisme + basique et portable de templates, séparant le contenu + de l'interface d'un site web. </para> </sect2> - </sect1> </partintro> - <refentry id="function.xslt-closelog"> <refnamediv> <refname>xslt_closelog</refname> - <refpurpose>Clear the logfile for a given instance of Sablotron</refpurpose> + <refpurpose>Efface le fichier d'historique</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -73,19 +63,19 @@ <term><parameter>xh</parameter></term> <listitem> <simpara> - A reference to the XSLT parser. + Une référence valide sur un analyseur XSLT. </simpara> </listitem> </varlistentry> </variablelist></para> <para> - This function returns false if <parameter>parser</parameter> does - not refer to a valid parser, or if the closing of the logfile - fails. Otherwise it returns true. + <function>xslt_closelog</function> retourne FALSE si + <parameter>xh</parameter> n'est pas un analyse XSLT valide, ou bien + si la fermeture du fichier d'historique a échoué. Sinon, retourne + TRUE. </para> </refsect1> </refentry> - <refentry id="function.xslt-create"> <refnamediv> <refname>xslt_create</refname> @@ -100,16 +90,15 @@ </funcprototype> </funcsynopsis> <para> - This function returns a handle for a new XSL processor. This handle - is needed in all subsequent calls to XSL functions. + <function>xslt_create</function> retourne un identifiant d'analyseur + XSLT. Il sera nécessaire pour les appels ultérieurs aux fonctions. </para> </refsect1> </refentry> - <refentry id="function.xslt-errno"> <refnamediv> <refname>xslt_errno</refname> - <refpurpose>Return the current error number</refpurpose> + <refpurpose>Retourne le numérod d'erreur courant</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -122,17 +111,16 @@ </funcprototype> </funcsynopsis> <para> - Return the current error number of the given XSL processor. If - no handle is given, the last error number that occured anywhere - is returned. + <function>xslt_errno</function> le numéro courant d'erreur, pour l'analyseur + <parameter>xh</parameter>. Si <parameter>xh</parameter> n'est pas + fourni, le dernier numéro d'erreur est retourné. </para> </refsect1> </refentry> - <refentry id="function.xslt-error"> <refnamediv> <refname>xslt_error</refname> - <refpurpose>Return the current error string</refpurpose> + <refpurpose>Retourne le message d'erreur couran</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -145,17 +133,16 @@ </funcprototype> </funcsynopsis> <para> - Return the current error string of the given XSL processor. If - no handle is given, the last error string that occured anywhere - is returned. + <function>xslt_errno</function> le message d'erreur courant, pour l'analyseur + <parameter>xh</parameter>. Si <parameter>xh</parameter> n'est pas + fourni, le dernier numéro d'erreur est retourné. </para> </refsect1> </refentry> - <refentry id="function.xslt-fetch-result"> <refnamediv> <refname>xslt_fetch_result</refname> - <refpurpose>Fetch a (named) result buffer</refpurpose> + <refpurpose>Lit un résultat</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -169,17 +156,17 @@ </funcprototype> </funcsynopsis> <para> - Fetch a result buffer from the XSLT processor identified by - the given handle. If no result name is given, the - buffer named "/_result" is fetched. + <function>xslt_fetch_result</function> lit le résultat disponible + dans le buffer de l'analyseur <parameter>xh</parameter>. Si + <parameter>result_name</parameter> n'est pas fourni, le résultat + "/_result" sera lu. </para> </refsect1> </refentry> - <refentry id="function.xslt-free"> <refnamediv> <refname>xslt_free</refname> - <refpurpose>Free XSLT processor</refpurpose> + <refpurpose>Détruit un analyseur XSLT</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -192,15 +179,15 @@ </funcprototype> </funcsynopsis> <para> - Free the XSLT processor identified by the given handle. + <function>xslt_free</function> détruit l'analyseur XSLT + <parameter>resource xh</parameter>. </para> </refsect1> </refentry> - <refentry id="function.xslt-openlog"> <refnamediv> <refname>xslt_openlog</refname> - <refpurpose>Set a logfile for XSLT processor messages</refpurpose> + <refpurpose>Modifie le fichier d'historique</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -215,79 +202,171 @@ </funcprototype> </funcsynopsis> <para> - Set a logfile for the XSLT processor to place all of its error - messages. + <function>xslt_openlog</function> remplace le fichier d'historique + courant par <parameter>logfile</parameter>, pour l'analyseur + XSLT <parameter>xh</parameter>. </para> </refsect1> </refentry> - <refentry id="function.xslt-output-begintransform"> <refnamediv> <refname>xslt_output_begintransform</refname> - <refpurpose>unknown</refpurpose> + <refpurpose>Commence la transformation XSLT</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>unknown <function>xslt_output_begintransform</function></funcdef> + <funcdef>void + <function>xslt_output_begintransform</function> + </funcdef> <paramdef> - <parameter>unknown</parameter> + <parameter>string xslt_filename</parameter> </paramdef> </funcprototype> </funcsynopsis> <para> - This function lacks a prototype definition. + <function>xslt_output_begintransform</function> commence à retourner la + transformée de vos données. En l'appel de + <function>xslt_output_begintransform</function> et celui de + <function>xslt_output_endtransform</function>, toutes les données + seront transformées par la feuille de style XSLT <parameter>string xslt_filename</parameter>. </para> + <para> + <example> + <title>Transformation avec une feuille de style XSLT (avec DOM-XML)</title> + <programlisting role="php"> +<?php +$xsl_file = "article.xsl"; +xslt_output_begintransform($xsl_file); +$doc = new_xmldoc('1.0'); +$article = $doc->new_root('article'); +$article->new_child('title', 'Histoire du Tyrol méridional'); +$article->new_child('author', 'Sterling Hughes'); +$article->new_child('body', 'Juste après la première guerre mondiale, l'Italie + obtiend le Tyrol méridional aux dépends de l'Autriche. + Et depuis cette époque, rien d'interessant n'est arrivé.'); +echo $doc->dumpmem(); +xslt_output_endtransform(); + </programlisting> + </example> + </para> </refsect1> </refentry> - <refentry id="function.xslt-output-endtransform"> <refnamediv> <refname>xslt_output_endtransform</refname> - <refpurpose>unknown</refpurpose> + <refpurpose>Termine une transformation</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>unknown <function>xslt_output_endtransform</function></funcdef> - <paramdef> - <parameter>unknown</parameter> - </paramdef> + <funcdef>void + <function>xslt_output_endtransform</function> + </funcdef> + <void/> </funcprototype> </funcsynopsis> <para> - This function lacks a prototype definition. + <function>xslt_output_endtransform</function> termine la transformation + commencée avec <function>xslt_output_begintransform</function>. Vous devez + appeler cette fonction pour pouvoir accéder aux résultats. </para> </refsect1> </refentry> - <refentry id="function.xslt-process"> <refnamediv> - <refname>xslt_output_process</refname> - <refpurpose>unknown</refpurpose> + <refname>xslt_process</refname> + <refpurpose>Transforme des données XML</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>unknown <function>xslt_process</function></funcdef> - <paramdef> - <parameter>unknown</parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - This function lacks a prototype definition. + <funcdef>bool + <function>xslt_process</function> + </funcdef> + <paramdef> + <parameter>string xsl_data</parameter> + <parameter>string xml_data</parameter> + <parameter>string result</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>xslt_process</function> prend la chaîne + <parameter>string xsl_data</parameter> comme feuille de style XSLT, et + des données XML dans <parameter>xml_data</parameter>. Le résultat + de la transformation sera placé dans <parameter>result</parameter>. + <function>xslt_process</function> retourne TRUE en cas de succès, et + FALSE sinon. Vous pourrez lire les erreurs survenues grâce aux + fonctions <function>xslt_errno</function> et + <function>xslt_error</function> functions. + </para> + <para> + <example> + <title>Utilisation de <function>xslt_process</function> pour transformer trois</title> + <programlisting role="php"> +<?php +$xslData = ' +<xsl:stylesheet + version="1.0" + xmlns:xsl="http://www.w3.org/1999/XSL/Transform"> +<xsl:template match="article"> + <table border="1" cellpadding="2" cellspacing="1"> + <tr> + <td width="20%"> + + </title> + <td width="80%"> + <h2><xsl:value-of select="title"></h2> + <h3><xsl:value-of select="author"></h3> + <br> + <xsl:value-of select="body"> + </td> + </tr> + </table> +</xsl:template> +</xsl:stylesheet>'; +$xmlData = ' +<?xml version="1.0"?> +<article> + <title>Learning German</title> + <author>Sterling Hughes</author> + <body> + Essential phrases: + <br> + <br> + Komme sie mir sagen, woe die toilette es?<br> + Eine grande beer bitte!<br> + Noch einem bitte.<br> + </body> +</article>'; +if (xslt_process($xslData, $xmlData, $result)) +{ + echo "Voici un brillant article sur l'apprentissage du " + echo " français: "; + echo "<br>\n<br>"; + echo $result; +} +else +{ + echo "Une erreur est survenue durant le traitement XSL...\n"; + echo "\tErreur numéro : " . xslt_errno() . "\n"; + echo "\tMessage d'erreur : " . xslt_error() . "\n"; + exit; +} +?> + </programlisting> + </example> </para> </refsect1> </refentry> - <refentry id="function.xslt-run"> <refnamediv> <refname>xslt_run</refname> - <refpurpose>Apply a XSLT stylesheet to a file.</refpurpose> + <refpurpose>Applique une feuille de style à un fichier</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -305,18 +384,21 @@ </funcprototype> </funcsynopsis> <para> - Process the xml_data_file by applying the xslt_file stylesheet to - it. The stylesheet has access to xslt_params and the processor - is started with xslt_args. The result of the XSLT transformation - is placed in the named buffer (default is "/_result"). + <function>xslt_run</function> appliqu e au fichier + <parameter>xml_data_file</parameter> la feuille de style + <parameter>string xslt_file</parameter>. La feuille de style + peut utiliser les paramètres optionnels + <parameter>xslt_params</parameter> et l'analyseur XSLT est + démarré avec <parameter>array xslt_args</parameter>. Le + résultat est placé dans le buffer nommé <parameter>result</parameter> + (par défaut, dans "/_result"). </para> </refsect1> </refentry> - <refentry id="function.xslt-set-sax-handler"> <refnamediv> <refname>xslt_set_sax_handler</refname> - <refpurpose>Set SAX handlers for a XSLT processor</refpurpose> + <refpurpose>Modifie les gestionnaires SAX de l'analyseur XSLT</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -330,34 +412,42 @@ </funcprototype> </funcsynopsis> <para> - Set SAX handlers on the ressource handle given by xh. + <function>xslt_set_sax_handler</function> remplace les gestionnaires SAX + de l'analyseur XSLT <parameter>xh</parameter> par + <parameter>handlers</parameter>. </para> </refsect1> </refentry> - <refentry id="function.xslt-transform"> <refnamediv> <refname>xslt_transform</refname> - <refpurpose>unknown</refpurpose> + <refpurpose>Exécute une transformation XSLT</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>unknown <function>xslt_transform</function></funcdef> - <paramdef> - <parameter>unknown</parameter> + <funcdef>bool + <function>xslt_transform</function> + </funcdef> + <paramdef> + <parameter>string xsl</parameter> + <parameter>string xml</parameter> + <parameter>string result</parameter> + <parameter>string params</parameter> + <parameter>string args</parameter> + <parameter>string resultBuffer</parameter> </paramdef> </funcprototype> </funcsynopsis> <para> - This function lacks a prototype definition. + <function>xslt_transform</function> fourni une interface avec les + API avancées de sablotron, sans vous obliger à utiliser les + ressources. </para> </refsect1> </refentry> - </reference> - <!-- Keep this comment at the end of the file Local variables: mode: sgml