cvs: phpdoc /cs/functions xslt.xml

From: Date: Fri, 26 Jan 2001 10:21:04 +0000
Subject: cvs: phpdoc /cs/functions xslt.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969333966@lists.php.net to get a copy of this message
cynic Fri Jan 26 02:21:04 2001 EDT Added files: /phpdoc/cs/functions xslt.xml Log: translated

Index: phpdoc/cs/functions/xslt.xml +++ phpdoc/cs/functions/xslt.xml <reference id="ref.xslt"> <title>XSLT funkce</title> <titleabbrev>XSLT</titleabbrev> <partintro> <sect1 id="xslt.partintro"> <title>Úvod</title> <sect2 id="xslt.intro"> <title>O XSLT and Sablotronu</title> <para> XSLT (Extensible Stylesheet Language (XSL) Transformations) je jazyk pro transformaci XML dokumentù do jiných XML dokumentù. Je to standard definovaný The World Wide Web konsorciem (W3C). Imformace o XSLT a souvisejících technologiích jsou dostupné na <ulink url="&url.xslt;">&url.xslt;</ulink>. </para> </sect2> <sect2 id="xslt.install"> <title>Instalace</title> <para> Tato extenze vyu¾ívá <productname>Sabloton</productname> a <productname>expat</productname>, které jsou dostupné na <ulink url="&url.sablotron;">&url.sablotron;</ulink>, a to jak binární soubory tak zdrojové kódy. </para> <para> Na UNIXu spus»te <command>configure</command> s <option role="configure">--with-sablot</option>. <productname>Sablotron</productname> knihovna by mìla být nainstalována na nìjakém místì, kde ji vá¹ kompilátor mù¾e najít. </para> </sect2> <sect2 id="xslt.about"> <title>O této extenzi</title> <para> Tato PHP extenze implementuje podporu <productname>Sablotron</productname> od Ginger Alliance v PHP. Tato nástrojù vám umo¾òuje transformovat XML dokumenty na jiné dokumenty, vèetnì nových XML dokumentù, ale také do XML a jiných cílových formátù. V podstatì poskytuje standardizovaný a pøenosný systém ¹ablon oddìlující obsah a design websajty. </para> </sect2> </sect1> </partintro> <refentry id="function.xslt-closelog"> <refnamediv> <refname>xslt_closelog</refname> <refpurpose>Smazat log dané instance Sablotronu</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>bool <function>xslt_closelog</function></funcdef> <paramdef>resource <parameter>xh</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <variablelist> <varlistentry> <term><parameter>xh</parameter></term> <listitem> <simpara> Reference na XSLT parser. </simpara> </listitem> </varlistentry> </variablelist></para> <para> Pokud <parameter>parser</parameter> neodkazuje na platný parser, nebo pokud zavøení logu sel¾e, vrací <literal>false</literal>, jinak vrací <literal>true</literal> </para> </refsect1> </refentry> <refentry id="function.xslt-create"> <refnamediv> <refname>xslt_create</refname> <refpurpose>Vytvoøit nový XSL procesor</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>resource <function>xslt_create</function></funcdef> <void/> </funcprototype> </funcsynopsis> <para> Tato funkce vrací handle nového XSL procesoru. Tento handle je potøeba ve v¹ech následných voláních XSL funkcí. </para> </refsect1> </refentry> <refentry id="function.xslt-errno"> <refnamediv> <refname>xslt_errno</refname> <refpurpose>Vrátit èíslo souèasné chyby</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>int <function>xslt_errno</function></funcdef> <paramdef> <parameter><optional>int xh</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> Vrací èíslo souèasné chyby daného XSL procesoru. Pokud nedostane handle, vrací èíslo poslední chyby bez ohledu na její výskyt. </para> </refsect1> </refentry> <refentry id="function.xslt-error"> <refnamediv> <refname>xslt_error</refname> <refpurpose>Vrátit text poslední chyby</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>mixed <function>xslt_error</function></funcdef> <paramdef> <parameter><optional>int xh</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> Vrací text souèasné chyby daného XSL procesoru. Pokud nedostane handle, vrací text poslední chyby bez ohledu na její výskyt. </para> </refsect1> </refentry> <refentry id="function.xslt-fetch-result"> <refnamediv> <refname>xslt_fetch_result</refname> <refpurpose>Získat (pojmenovaný) výstupní buffer</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>string <function>xslt_fetch_result</function></funcdef> <paramdef> <parameter>int xh</parameter> <parameter><optional>string result_name</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> Vrací výstupní buffer XSLT procesoru identifikovaného pøedaným handle. Pokud nedostane jméno výstupního bufferu, vrací buffer pojmenovaný &quot;/_result&quot;. </para> </refsect1> </refentry> <refentry id="function.xslt-free"> <refnamediv> <refname>xslt_free</refname> <refpurpose>Uvolnit XSLT procesor</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>void <function>xslt_free</function></funcdef> <paramdef> <parameter>resource xh</parameter> </paramdef> </funcprototype> </funcsynopsis> <para> Uvolní XSLT procesor identifikovaný pøedaným handle. </para> </refsect1> </refentry> <refentry id="function.xslt-openlog"> <refnamediv> <refname>xslt_openlog</refname> <refpurpose>Urèit log pro zprávy XSLT procesoru</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>bool <function>xslt_openlog</function></funcdef> <paramdef> <parameter>resource xh</parameter> <parameter>string logfile</parameter> <parameter><optional>int loglevel</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> Urèí log soubor, do kterého má XSLT procesor umis»ovat v¹echny chybové zprávy. </para> </refsect1> </refentry> <refentry id="function.xslt-output-begintransform"> <refnamediv> <refname>xslt_output_begintransform</refname> <refpurpose>Zaèít XSLT transformaci výstupu</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>void <function>xslt_output_begintransform</function> </funcdef> <paramdef> <parameter>string xslt_filename</parameter> </paramdef> </funcprototype> </funcsynopsis> <para> Tato funkce zaène výstupní transformaci va¹ich dat. Od okam¾iku, kdy zavoláte <function>xslt_output_begintransform</function> a¾ do chvíle kdy zavoláte <function>xslt_output_endtransform</function> bude v¹echen výstup transformován XSLT stylesheetem udaným v prvním argumentu. </para> <para> <example> <title> Transformace výstupu XSLT stylesheetem pomocí DOM-XML funkcí pro generování 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', 'The History of South Tyrol'); $article->new_child('author', 'Sterling Hughes'); $article->new_child('body', 'Back after WWI, Italy gained South Tyrol from Austria. Since that point nothing interesting has happened'); echo $doc->dumpmem(); xslt_output_endtransform(); </programlisting> </example> </para> </refsect1> </refentry> <refentry id="function.xslt-output-endtransform"> <refnamediv> <refname>xslt_output_endtransform</refname> <refpurpose>Ukonèit výstupní transformaci zaèatou pomocí xslt_output_begintransform</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>void <function>xslt_output_endtransform</function> </funcdef> <void/> </funcprototype> </funcsynopsis> <para> <function>xslt_output_endtransform</function> ukonèí výstupní transformaci zaèatou funkcí <function>xslt_output_begintransform</function>. Pokud chcete vidìt výsledky výstupní transformace, musíte tuto funkci zavolat. </para> </refsect1> </refentry> <refentry id="function.xslt-process"> <refnamediv> <refname>xslt_process</refname> <refpurpose>Transformovat XML data øetìzcem obsahujícím XSL data</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <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> pøijímá jako první argument øetìzec obsahující XSLT stylesheet, jako druhý argument øetìzec obsahující XML data, která chcete transformovat, a jako tøetí argument øetìzec obsahujícící výsledky transformace. <function>xslt_process</function> vrací <literal>true</literal> pøi úspìchu a <literal>false</literal> pøi selhání. Èíslo a text chyby pøípadnì vzniklé pøi transformaci mù¾ete získat pomocí <function>xslt_errno</function> a <function>xslt_error</function> funkcí. </para> <para> <example> <title> Pou¾ití <function>xslt_process</function> k transformaci tøí øetìzcù </title> <programlisting role="php"> &lt;?php $xslData = ' &lt;xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"&gt; &lt;xsl:template match="article"&gt; &lt;table border="1" cellpadding="2" cellspacing="1"&gt; &lt;tr&gt; &lt;td width="20%"&gt; &nbsp; &lt;/title&gt; &lt;td width="80%"&gt; &lt;h2&gt;&lt;xsl:value-of select="title"&gt;&lt;/h2&gt; &lt;h3&gt;&lt;xsl:value-of select="author"&gt;&lt;/h3&gt; &lt;br&gt; &lt;xsl:value-of select="body"&gt; &lt;/td&gt; &lt;/tr&gt; &lt;/table&gt; &lt;/xsl:template&gt; &lt;/xsl:stylesheet&gt;'; $xmlData = ' &lt;?xml version="1.0"?&gt; &lt;article&gt; &lt;title&gt;Learning German&lt;/title&gt; &lt;author&gt;Sterling Hughes&lt;/author&gt; &lt;body&gt; Essential phrases: &lt;br&gt; &lt;br&gt; Komme sie mir sagen, woe die toilette es?&lt;br&gt; Eine grande beer bitte!&lt;br&gt; Noch einem bitte.&lt;br&gt; &lt;/body&gt; &lt;/article&gt;'; if (xslt_process($xslData, $xmlData, $result)) { echo "Here is the brilliant in-depth article on learning"; echo " German: "; echo "&lt;br&gt;\n&lt;br&gt;"; echo $result; } else { echo "There was an error that occurred in the XSL transformace...\n"; echo "\tError number: " . xslt_errno() . "\n"; echo "\tError string: " . xslt_error() . "\n"; exit; } ?> </programlisting> </example> </para> </refsect1> </refentry> <refentry id="function.xslt-run"> <refnamediv> <refname>xslt_run</refname> <refpurpose>Aplikovat na soubor XSLT stylesheet</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>bool <function>xslt_run</function></funcdef> <paramdef> <parameter>resource xh</parameter> <parameter>string xslt_file</parameter> <parameter>string xml_data_file</parameter> <parameter><optional>string result</optional></parameter> <parameter><optional>array xslt_params</optional></parameter> <parameter><optional>array xslt_args</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> Zpracuje Process the <parameter>string xml_data_file</parameter> aplikací <parameter>string xslt_file</parameter> stylesheetu. Tento stylesheet má pøístup ke <parameter>xslt_params</parameter> a nastartuje se procesor s <parameter>xslt_args</parameter>. Výsledek XSLT transformace se umístí do pojmenovaného bufferu (defaultnì &quot;/_result&quot;). </para> </refsect1> </refentry> <refentry id="function.xslt-set-sax-handler"> <refnamediv> <refname>xslt_set_sax_handler</refname> <refpurpose>Urèit SAX handlery XSLT procesoru</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>bool <function>xslt_set_sax_handler</function></funcdef> <paramdef> <parameter>resource xh</parameter> <parameter>array handlers</parameter> </paramdef> </funcprototype> </funcsynopsis> <para> Urèit SAX handlery pro handle urèený v <parameter>xh</parameter>. </para> </refsect1> </refentry> <refentry id="function.xslt-transform"> <refnamediv> <refname>xslt_transform</refname> <refpurpose>Provést XSLT transformaci</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <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> <function>xslt_transform</function> poskytuje interface k pokroèilej¹ím vlastnostem Sablotronu bez nutnosti pou¾ít resource API. </para> </refsect1> </refentry> </reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: -->
« previous php.doc (#969333966) next »