cvs: phpdoc /fr/functions xslt.xml

From: 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&eacute;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&eacute;fini par le + consortium World Wide Web (W3C). Les informations sur le + XLST et ses technologies sont disponibles &agrave; + <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 &agrave; <ulink url="&url.sablotron;">&url.sablotron;</ulink>. + Les sources comme les ex&eacute;cutables sont propos&eacute;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 &ecirc;tre install&eacute;e + l&agrave; o&ugrave; 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&eacute;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 &agrave; balise. Elle fournit un m&eacute;canisme + basique et portable de templates, s&eacute;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&eacute;f&eacute;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 &eacute;chou&eacute;. 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&eacute;cessaire pour les appels ult&eacute;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&eacute;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&eacute;ro courant d'erreur, pour l'analyseur + <parameter>xh</parameter>. Si <parameter>xh</parameter> n'est pas + fourni, le dernier num&eacute;ro d'erreur est retourn&eacute;. </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&eacute;ro d'erreur est retourn&eacute;. </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&eacute;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 &quot;/_result&quot; is fetched. + <function>xslt_fetch_result</function> lit le r&eacute;sultat disponible + dans le buffer de l'analyseur <parameter>xh</parameter>. Si + <parameter>result_name</parameter> n'est pas fourni, le r&eacute;sultat + &quot;/_result&quot; sera lu. </para> </refsect1> </refentry> - <refentry id="function.xslt-free"> <refnamediv> <refname>xslt_free</refname> - <refpurpose>Free XSLT processor</refpurpose> + <refpurpose>D&eacute;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&eacute;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 &agrave; retourner la + transform&eacute;e de vos donn&eacute;es. En l'appel de + <function>xslt_output_begintransform</function> et celui de + <function>xslt_output_endtransform</function>, toutes les donn&eacute;es + seront transform&eacute;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"> +&lt;?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&eacute;ridional'); +$article->new_child('author', 'Sterling Hughes'); +$article->new_child('body', 'Juste apr&egrave;s la premi&egrave;re guerre mondiale, l'Italie + obtiend le Tyrol m&eacute;ridional aux d&eacute;pends de l'Autriche. + Et depuis cette &eacute;poque, rien d'interessant n'est arriv&eacute;.'); +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&eacute;e avec <function>xslt_output_begintransform</function>. Vous devez + appeler cette fonction pour pouvoir acc&eacute;der aux r&eacute;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&eacute;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&icirc;ne + <parameter>string xsl_data</parameter> comme feuille de style XSLT, et + des donn&eacute;es XML dans <parameter>xml_data</parameter>. Le r&eacute;sultat + de la transformation sera plac&eacute; dans <parameter>result</parameter>. + <function>xslt_process</function> retourne TRUE en cas de succ&egrave;s, et + FALSE sinon. Vous pourrez lire les erreurs survenues gr&acirc;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"> +&lt;?php +$xslData = ' +&lt;xsl:stylesheet + version="1.0" + xmlns:xsl="http://www.w3.org/1999/XSL/Transform"> +&lt;xsl:template match="article"> + &lt;table border="1" cellpadding="2" cellspacing="1"> + &lt;tr> + &lt;td width="20%"> + &nbsp; + &lt;/title> + &lt;td width="80%"> + &lt;h2>&lt;xsl:value-of select="title">&lt;/h2> + &lt;h3>&lt;xsl:value-of select="author">&lt;/h3> + &lt;br> + &lt;xsl:value-of select="body"> + &lt;/td> + &lt;/tr> + &lt;/table> +&lt;/xsl:template> +&lt;/xsl:stylesheet>'; +$xmlData = ' +&lt;?xml version="1.0"?> +&lt;article> + &lt;title>Learning German&lt;/title> + &lt;author>Sterling Hughes&lt;/author> + &lt;body> + Essential phrases: + &lt;br> + &lt;br> + Komme sie mir sagen, woe die toilette es?&lt;br> + Eine grande beer bitte!&lt;br> + Noch einem bitte.&lt;br> + &lt;/body> +&lt;/article>'; +if (xslt_process($xslData, $xmlData, $result)) +{ + echo "Voici un brillant article sur l'apprentissage du " + echo " fran&ccedil;ais: "; + echo "&lt;br>\n&lt;br>"; + echo $result; +} +else +{ + echo "Une erreur est survenue durant le traitement XSL...\n"; + echo "\tErreur num&eacute;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 &agrave; 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 &quot;/_result&quot;). + <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&egrave;tres optionnels + <parameter>xslt_params</parameter> et l'analyseur XSLT est + d&eacute;marr&eacute; avec <parameter>array xslt_args</parameter>. Le + r&eacute;sultat est plac&eacute; dans le buffer nomm&eacute; <parameter>result</parameter> + (par d&eacute;faut, dans &quot;/_result&quot;). </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&eacute;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&eacute;es de sablotron, sans vous obliger &agrave; utiliser les + ressources. </para> </refsect1> </refentry> - </reference> - <!-- Keep this comment at the end of the file Local variables: mode: sgml
« previous php.doc (#969333126) next »