cvs: peardoc /ru/packages/templates it.xml

kvn Mon Jan 28 14:14:49 2002 EDT Added files: /peardoc/ru/packages/templates it.xml Log: Finished.

Index: peardoc/ru/packages/templates/it.xml +++ peardoc/ru/packages/templates/it.xml <!-- it.it {{{ --> <refentry id="packages.templates.it"> <refnamediv> <refname><classname>IntegratedTemplate</classname></refname> <refpurpose> ïÂÌÅÇÞÅÎÎÁÑ ÓÉÓÔÅÍÁ ÕÐÒÁ×ÏÅÎÉÑ ÛÁÂÌÏÎÁÍÉ. </refpurpose> </refnamediv> <refsect1 id="packages.templates.it.placeholder"> <title>íÅÔËÁ-ÚÁÐÏÌÎÉÔÅÌØ</title> <para> æÏÒÍÁÔ ÍÅÔÏË-ÚÁÐÏÌÎÉÔÅÌÅÊ: <programlisting> {[0-9A-Za-z_-]+} </programlisting> üÔÏ ÏÚÎÁÞÁÅÔ, ÞÔÏ ÉÍÑ ÍÅÔÏË-ÚÁÐÏÌÎÉÔÅÌÅÊ ÍÏÖÅÔ ÓÏÄÅÒÖÁÔØ ÂÕË×Ù ×ÅÒÈÎÅÇÏ É ÎÉÖÎÅÇÏ ÒÅÇÉÓÔÒÁ, Á ÔÁË ÖÅ ÐÏÄÞÅÒÕÉ×ÁÎÉÅ É ÄÅÆÉÚ. éÍÑ ÄÏÌÖÎÏ ÂÙÔØ ÚÁËÌÀÞÅÎÏ × ÆÉÇÕÒÎÙÅ ÓËÏÂËÉ ÂÅÚ ÐÒÏÂÅÌÏ×. ðÒÁ×ÉÌØÎÙÅ ÉÍÅÎÁ: <simplelist> <member>{Placeholder}</member> <member>{place2_holder}</member> <member>{PLACEHOLDER1}</member> <member>{Place-Holder}</member> </simplelist> îÅÐÒÁ×ÉÌØÎÙÅ ÉÍÅÎÁ: <simplelist> <member>{ Placeholder 3 } (ÐÒÏÂÅÌÙ)</member> <member>{place*holder} (ÎÅÒÁÚÒÅÛÅÎÎÙÊ ÓÉÍ×ÏÌ)</member> </simplelist> </para> </refsect1> <refsect1 id="packages.templates.it.block"> <title>âÌÏËÉ</title> <para> æÏÒÍÁÔ ÂÌÏËÏ×: <programlisting> <![CDATA[ <!-- BEGIN [0-9A-Za-z_-]+ --> ... block content ... <!-- END [0-9A-Za-z_-]+ --> ]]> </programlisting> ðÒÁ×ÉÌÁ ÄÌÑ ÉÍÅÎ ÂÌÏËÏ× ÔÁËÉÅ ÖÅ, ËÁË É ÄÌÑ ÍÅÔÏË-ÚÁÐÏÌÎÉÔÅÌÅÊ. ÷ ÏÔÌÉÞÉÉ ÏÔ ÍÅÔÏË-ÚÁÐÏÌÎÉÔÅÌÅÊ ÉÍÅÎÁ × ÂÌÏËÁÈ ÐÏÍÅÞÅÎÙ ËÁË ÎÅÏÂÈÏÄÉÍÙÅ. </para> <para> ÷ÌÏÖÅÎÉÅ ÂÌÏËÏ× ÒÁÚÒÅÛÁÅÔÓÑ, ÎÏ ÂÕÄØÔÅ ÏÓÔÏÒÏÖÎÙ ÐÒÉ ÐÁÒÓÉÎÇÅ. ÷Ù ÄÏÌÖÎÙ ÕÓÔÁÎÏ×ÉÔØ É ÐÒÏÐÁÒÓÉÔØ ÓÁÍÙÊ ÇÌÕÂÏËÏ ×ÌÏÖÅÎÎÙÊ ÂÌÏË, ÐÅÒ×ÙÍ, Á ÐÏÔÏÍ ÕÓÔÁÎÁ×ÌÉ×ÁÔØ É ÐÁÒÓÉÔØ ÂÌÏËÉ, ÏÔ ÓÁÍÏÇÏ ×ÌÏÖÅÎÎÏÇÏ ÄÏ ÓÁÍÏÇÏ ×ÅÒÈÎÅÇÏ ÕÒÏ×ÎÑ ×ÌÏÖÅÎÎÏÓÔÉ. </para> </refsect1> <refsect1 id="packages.templates.it.example"> <title>ðÒÉÍÅÒ ÉÓÐÏÌØÚÏ×ÁÎÉÑ</title> <example> <title>ûÁÂÌÏÎ</title> <programlisting> <![CDATA[ <html> <table border> <!-- BEGIN row --> <tr> <!-- BEGIN cell --> <td> {DATA} </td> <!-- END cell --> </tr> <!-- END row --> </table> </html> ]]> </programlisting> </example> <example> <title>óËÒÉÐÔ</title> <programlisting role="php"> <![CDATA[ <?php require_once "HTML/IT.php"; $data = array ( "0" => array("Stig", "Bakken"), "1" => array("Martin", "Jansen"), "2" => array("Alexander", "Merz") ); $tpl = new IntegratedTemplate("./templates"); $tpl->loadTemplatefile("main.tpl.htm", true, true); foreach($data as $name) { foreach($name as $cell) { // Assign data to the inner block $tpl->setCurrentBlock("cell") ; $tpl->setVariable("DATA", $cell) ; $tpl->parseCurrentBlock("cell") ; } // éÎÔÅÒÐÏÌÑÃÉÑ ÂÌÏËÏ× ÏÔ ÓÁÍÏÇÏ ÎÉÖÎÅÇÏ ÄÏ ×ÅÒÈÎÅÇÏ $tpl->setCurrentBlock("row") ; $tpl->parseCurrentBlock("row") ; } // ×Ù×ÏÄ ÒÅÚÕÌØÔÁÔÁ ÎÁ ÜËÒÁÎ $tpl->show(); ?> ]]> </programlisting> </example> <example> <title>òÅÚÕÌØÔÁÔ</title> <programlisting> <![CDATA[ <html> <table border> <tr> <td> Stig </td> <td> Bakken </td> </tr> <tr> <td> Martin </td> <td> Jansen </td> </tr> <tr> <td> Alexander </td> <td> Merz </td> </tr> </table> </html> ]]> </programlisting> </example> </refsect1> <refsect1 id="packages.templates.it.integratedtemplate"> <title>IntegratedTemplate::IntegratedTemplate</title> <funcsynopsis> <funcprototype> <funcdef>void <function>IntegratedTemplate::IntegratedTemplate</function></funcdef> <paramdef>string <parameter><optional>$root</optional></parameter></paramdef> </funcprototype> </funcsynopsis> <para> óÔÒÏÉÔ ÎÅËÏÔÏÒÙÅ ÒÅÇÕÌÑÒÎÙÅ ×ÙÒÁÖÅÎÉÑ É ÕÓÔÁÎÁ×ÌÉ×ÁÅÔ ËÏÒÎÅ×ÕÀ ÄÉÒÅËÔÏÒÉÀ ÄÌÑ ÔÅÍÐÌÅÊÔÏ× (ÎÅÏÂÑÚÁÔÅÌØÎÙÊ ÐÁÒÁÍÅÔÒ). õÄÏÓÔÏ×ÅÒØÔÅÓØ, ÞÔÏ ×Ù ×ÙÚÙ×ÁÅÔÅ ËÏÎÓÔÒÕËÔÏÒ ÅÓÌÉ ×Ù ÎÁÓÌÅÄÕÅÔÅ ×ÁÛ ËÌÁÓÓ ÏÔ ÄÁÎÎÏÇÏ. </para> <para> ðÁÒÁÍÅÔÒ <itemizedlist> <listitem> <para> <parameter>$root</parameter> - ËÏÒÎÅ×ÁÑ ÄÉÒÅËÔÏÒÉÑ, ÐÒÅÆÉËÓ ÄÌÑ ×ÓÅÈ ÆÁÊÌÏ× ÉÓÐÏÌØÚÕÅÍÙÈ ÏÂßÅËÔÏÍ. </para> </listitem> </itemizedlist> </para> </refsect1> <refsect1 id="packages.templates.it.get"> <title>IntegratedTemplate::get</title> <funcsynopsis> <funcprototype> <funcdef>string <function>IntegratedTemplate::get</function></funcdef> <paramdef>string <parameter><optional>$block</optional></parameter></paramdef> </funcprototype> </funcsynopsis> <para> ÷ÏÚ×ÒÁÝÁÅÔ ÂÌÏË ×ÍÅÓÔÅ ÓÏ ×ÓÅÍÉ ÚÁÍÅÎÁÍÉ. </para> <para> ðÁÒÁÍÅÔÒ <itemizedlist> <listitem> <para> <parameter>$block</parameter> - ÉÍÑ ÂÌÏËÁ, ÄÌÑ ×ÏÚ×ÒÁÔÁ, ÅÓÌÉ ÎÅ ÚÁÄÁÎ, ÔÏ ×ÏÚ×ÒÁÝÁÅÔÓÑ ×ÅÓØ ÛÁÂÌÏÎ </para> </listitem> </itemizedlist> </para> </refsect1> <refsect1 id="packages.templates.it.parse"> <title>IntegratedTemplate::parse</title> <funcsynopsis> <funcprototype> <funcdef>void <function>IntegratedTemplate::parse</function></funcdef> <paramdef>string <parameter><optional>$block</optional></parameter></paramdef> <paramdef>boolean <parameter><optional>$flag_recursion</optional></parameter></paramdef> </funcprototype> </funcsynopsis> <para> ðÁÒÓÉÔ (ÏÂÒÁÂÁÔÙ×ÁÅÔ) ÄÁÎÎÙÊ ÂÌÏË. </para> <para> ðÁÒÁÍÅÔÒ <itemizedlist> <listitem> <para> <parameter>$block</parameter> - ÂÌÏË ÄÌÑ ÏÂÒÁÂÏÔËÉ, ÅÓÌÉ ÎÅ ÚÁÄÁÎ, ÔÏ ÐÒÏÉÓÈÏÄÉÔ ÐÁÒÓÉÎÇ ×ÓÅÇÏ ÛÁÂÌÏÎÁ. </para> </listitem> <listitem> <para> <parameter>$flag_recursion</parameter> - ÍÏÖÅÔ ÂÙÔØ ÉÇÎÏÒÉÒÏ×ÁÎ. </para> </listitem> </itemizedlist> </para> </refsect1> <refsect1 id="packages.templates.it.parsecurrentblock"> <title>IntegratedTemplate::parseCurrentBlock</title> <funcsynopsis> <funcprototype> <funcdef>void <function>IntegratedTemplate::parseCurrentBlock</function></funcdef> <paramdef></paramdef> </funcprototype> </funcsynopsis> <para> ðÁÒÓÉÔ ÔÅËÕÝÉÊ ÂÌÏË. </para> </refsect1> <refsect1 id="packages.templates.it.setvariable"> <title>IntegratedTemplate::setVariable</title> <funcsynopsis> <funcprototype> <funcdef>void <function>IntegratedTemplate::setVariable</function></funcdef> <paramdef>mixed <parameter>$placeholder</parameter></paramdef> <paramdef>string <parameter><optional>$variable</optional></parameter></paramdef> </funcprototype> </funcsynopsis> <para> õÓÔÁÎÁ×ÌÉ×ÁÅÔ ÚÎÁÞÅÎÉÅ ÐÅÒÅÍÅÎÎÏÊ. æÕÎËÃÉÑ ÍÏÖÅÔ ÉÓÐÏÌØÚÏ×ÁÔØÓÑ ËÁË setVariable( "varname", "value") ÉÌÉ Ó ÍÁÓÓÉ×ÏÍ $variables["varname"] = "value", ËÁË setVariable($variables). </para> <para> ðÁÒÁÍÅÔÒ <itemizedlist> <listitem> <para> <parameter>$placeholder</parameter> - éÍÑ ÍÅÔËÉ-ÚÁÐÏÌÎÉÔÅÌÑ ÄÌÑ ÐÏÄÓÔÁÎÏ×ËÉ ÉÌÉ ÍÁÓÓÉ× Ó ÍÅÔËÁÍÉ-ÚÁÐÏÌÎÉÔÅÌÑÍÉ - ËÌÀÞÁÍÉ ÍÁÓÓÉ×Á, É ÄÁÎÎÙÍÉ - ÚÎÁÞÅÎÉÑÍÉ ÜÔÉÈ ËÌÀÞÅÊ. </para> </listitem> <listitem> <para> <parameter>$variable</parameter> - when $placeholder isn't a array, the value to assign to the placeholder. </para> </listitem> </itemizedlist> </para> </refsect1> <refsect1 id="packages.templates.it.setCurrentBlock"> <title>IntegratedTemplate::setCurrentBlock</title> <funcsynopsis> <funcprototype> <funcdef>boolean <function>IntegratedTemplate::setCurrentBlock</function></funcdef> <paramdef>string <parameter><optional>$block</optional></parameter></paramdef> </funcprototype> </funcsynopsis> <para> õÓÔÁÎÁ×ÌÉ×ÁÅÔ ÉÍÑ ÔÅËÕÝÅÇÏ ÂÌÏËÁ, × ËÏÔÏÒÙÊ ÎÁ ÄÁÎÎÙÊ ÍÏÍÅÎÔ ÄÏÂÁ×ÌÑÀÔÓÑ ÐÅÒÅÍÅÎÎÙÅ. </para> <para> ðÁÒÁÍÅÔÒ <itemizedlist> <listitem> <para> <parameter>$block</parameter> - ÉÍÑ ÂÌÏËÁ ÄÌÑ ÕÓÔÁÎÏ×ËÉ, ÅÓÌÉ ÎÅ ÚÁÄÁÎ, ÔÏ ÃÅÌÙÊ ÛÁÂÌÏÎ ÂÕÄÅÔ ÕÓÔÁÎÏ×ÌÅÎ (ÐÏËÁÚÙ×ÁÅÔ ÍÅÔËÕ-ÚÁÐÏÌÎÉÔÅÌØ ×ÎÅ ×ÓÅÈ ÂÌÏËÏ×). </para> </listitem> </itemizedlist> </para> <para> ÷ÏÚ×ÒÁÝÁÅÔ <itemizedlist> <listitem> <para> <parameter>Boolean</parameter> - false ÐÒÉ ÏÛÉÂËÅ, × ÐÒÏÔÉ×ÎÏÍ ÓÌÕÞÁÅ - true </para> </listitem> </itemizedlist> </para> </refsect1> <refsect1 id="packages.templates.it.touchblock"> <title>IntegratedTemplate::touchBlock</title> <funcsynopsis> <funcprototype> <funcdef>boolean <function>IntegratedTemplate::touchBlock</function></funcdef> <paramdef> string <parameter>$block</parameter> </paramdef> </funcprototype> </funcsynopsis> <para> óÏÈÒÁÎÑÅÔ ÐÕÓÔÏÊ ÂÌÏË. ÅÓÌÉ removeEmptyBlocks = true. </para> <para> ðÁÒÁÍÅÔÒ <itemizedlist> <listitem> <para> <parameter>$block</parameter> - ÉÍÑ ÂÌÏËÁ ÄÌÑ ÓÏÈÒÁÎÅÎÉÑ. </para> </listitem> </itemizedlist> </para> <para> ÷ÏÚ×ÒÁÝÁÅÔ <itemizedlist> <listitem> <para> <parameter>Boolean</parameter> - false / true. </para> </listitem> </itemizedlist> </para> </refsect1> <refsect1 id="packages.templates.it.init"> <title>IntegratedTemplate::init</title> <funcsynopsis> <funcprototype> <funcdef>void <function>IntegratedTemplate::init</function></funcdef> <paramdef> </paramdef> </funcprototype> </funcsynopsis> <para> ïÞÉÝÁÅÔ ×ÓÅ ÐÏÌÑ ÄÁÎÎÙÈ ÏÂßÅËÔÁ É ÐÅÒÅÓÔÒÁÉ×ÁÅÔ ×ÎÕÔÒÅÎÎÉÊ ÓÐÉÓÏË ÂÌÏËÏ×. LoadTemplatefile() É setTemplate() Á×ÔÏÍÁÔÉÞÅÓËÉ ×ÙÚÙ×ÁÀÔ ÜÔÕ ÆÕÎËÃÉÀ, ËÏÇÄÁ ÄÁÎ ÎÏ×ÙÊ ÛÁÂÌÏÎ. îÅ ÉÓÐÏÌØÚÕÊÔÅ ÜÔÕ ÆÕÎËÃÉÀ ÐÏËÁ ÔÏÞÎÏ ÎÅ ÂÕÄÅÔÅ ÚÎÁÔØ, ÞÔÏ ×Ù ÄÅÌÁÅÔÅ. </para> </refsect1> <refsect1 id="packages.templates.it.free"> <title>IntegratedTemplate::free</title> <funcsynopsis> <funcprototype> <funcdef>void <function>IntegratedTemplate::free</function></funcdef> <paramdef> </paramdef> </funcprototype> </funcsynopsis> <para> ïÞÉÝÁÅÔ ×ÓÅ ÐÏÌÑ ÄÁÎÎÙÈ ÏÂßÅËÔÁ. îÅ ÉÓÐÏÌØÚÕÊÔÅ ÜÔÕ ÆÕÎËÃÉÀ ÐÏËÁ ÔÏÞÎÏ ÎÅ ÂÕÄÅÔÅ ÚÎÁÔØ, ÞÔÏ ×Ù ÄÅÌÁÅÔÅ. </para> </refsect1> <refsect1 id="packages.templates.it.setTemplate"> <title>IntegratedTemplate::setTemplate</title> <funcsynopsis> <funcprototype> <funcdef>void <function>IntegratedTemplate::setTemplate</function></funcdef> <paramdef> string <parameter>$template</parameter> </paramdef> </funcprototype> </funcsynopsis> <para> õÓÔÁÎÁ×ÌÉ×ÁÅÔ ÛÁÂÌÏÎ. ÷Ù ÍÏÖÅÔÅ ÚÁÇÒÕÚÉÔØ ÆÁÊÌ ÛÁÂÌÏÎÁ Ó ÄÉÓËÁ ÆÕÎËÃÉÅÊ LoadTemplatefile() ÉÌÉ ÕÓÔÁÎÏ×ÉÔØ ÛÁÂÌÏÎ ×ÒÕÞÎÕÀ ÉÓÐÏÌØÚÕÑ ÄÁÎÎÕÀ ÆÕÎËÃÉÀ. </para> <para> ðÁÒÁÍÅÔÒ <itemizedlist> <listitem> <para> <parameter>$template</parameter> - ÓÏÄÅÒÖÁÎÉÅ (ËÏÎÔÅÎÔ). </para> </listitem> </itemizedlist> </para> </refsect1> <refsect1 id="packages.templates.it.loadTemplatefile"> <title>IntegratedTemplate::loadTemplatefile</title> <funcsynopsis> <funcprototype> <funcdef>boolean <function>IntegratedTemplate::loadTemplatefile</function></funcdef> <paramdef>string <parameter>$filename</parameter></paramdef> <paramdef>boolean <parameter><optional>$removeUnknownVariables</optional></parameter></paramdef> <paramdef>boolean <parameter><optional>$removeEmptyBlocks</optional></parameter></paramdef> </funcprototype> </funcsynopsis> <para> þÉÔÁÅÔ ÆÁÊÌ ÛÁÂÌÏÎÁ Ó ÄÉÓËÁ. </para> <para> ðÁÒÁÍÅÔÒ <itemizedlist> <listitem> <para> <parameter>$filename</parameter> - ÉÍÑ ÆÁÊÌÁ ÛÁÂÌÏÎÁ. </para> </listitem> <listitem> <para> <parameter>$removeUnknownVariables</parameter> - ÅÓÌÉ true, ÔÏ ÎÅ ÕÓÔÁÎÏ×ÌÅÎÎÙÅ (ÐÕÓÔÙÅ) ÍÅÔËÉ-ÚÁÐÏÌÎÉÔÅÌÉ ÂÕÄÕÔ ÕÄÁÌÅÎÙ. </para> </listitem> <listitem> <para> <parameter>$removeEmptyBlocks</parameter> - ÅÓÌÉ true, ÎÅÉÓÐÏÌØÚÏ×ÁÎÎÙÅ ÂÌÏËÉ ÂÕÄÕÔ ÕÄÁÌÅÎÙ. </para> </listitem> </itemizedlist> </para> <para> ÷ÏÚ×ÒÁÝÁÅÔ <itemizedlist> <listitem> <para> <parameter>Boolean</parameter> - false / true </para> </listitem> </itemizedlist> </para> </refsect1> <refsect1 id="packages.templates.it.setRoot"> <title>IntegratedTemplate::setRoot</title> <funcsynopsis> <funcprototype> <funcdef>void <function>IntegratedTemplate::setRoot</function></funcdef> <paramdef> string <parameter>$root</parameter> </paramdef> </funcprototype> </funcsynopsis> <para> õÓÔÁÎÁ×ÌÉ×ÁÅÔ ËÏÒÎÅ×ÕÀ ÄÉÒÅËÔÏÒÉÀ ÄÌÑ ÆÁÌÏ× ÛÁÂÌÏÎÏ×. ëÏÒÎÅ×ÁÑ ÄÉÒÅËÔÏÒÉÑ Ñ×ÌÑÅÔÓÑ ÐÒÅÆÉËÓÏÍ ÄÌÑ ×ÓÅÈ ÆÁÊÌÏ× × ÏÂßÅËÔÅ. </para> <para> ðÁÒÁÍÅÔÒ <itemizedlist> <listitem> <para> <parameter>$root</parameter> - root directory for the templates </para> </listitem> <listitem> <para> <parameter>$removeUnknownVariables</parameter> - ÅÓÌÉ true, ÔÏ ÎÅ ÕÓÔÁÎÏ×ÌÅÎÎÙÅ (ÐÕÓÔÙÅ) ÍÅÔËÉ-ÚÁÐÏÌÎÉÔÅÌÉ ÂÕÄÕÔ ÕÄÁÌÅÎÙ. </para> </listitem> <listitem> <para> <parameter>$removeEmptyBlocks</parameter> - ÅÓÌÉ true, ÎÅÉÓÐÏÌØÚÏ×ÁÎÎÙÅ ÂÌÏËÉ ÂÕÄÕÔ ÕÄÁÌÅÎÙ. </para> </listitem> </itemizedlist> </para> </refsect1> <refsect1 id="packages.templates.it.show"> <title>IntegratedTemplate::show</title> <funcsynopsis> <funcprototype> <funcdef>void <function>IntegratedTemplate::show</function></funcdef> <paramdef> string <parameter><optional>$block</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> ðÅÞÁÔÁÅÔ ÄÁÎÎÙÊ ÂÌÏË, ÓÏ ×ÓÅÍÉ ÚÁÍÅÎÁÍÉ. </para> <para> ðÁÒÁÍÅÔÒ <itemizedlist> <listitem> <para> <parameter>$block</parameter> - ÅÓÌÉ ÎÅ ÚÁÄÁÎ, ÔÏ ×ÓÅ ÓÏÄÅÒÖÉÍÏÅ (ËÏÎÔÅÎÔ) ÂÕÄÅÔ ÎÁÐÅÞÁÔÁÎÏ. </para> </listitem> </itemizedlist> </para> </refsect1> </refentry> <!-- }}} it.it -->