cvs: smarty /docs/ru getting-started.xml language-snippets.ent preface.xml /docs/ru/appendixes tips.xml troubleshooting.xml /docs/ru/designers chapter-debugging-console.xml config-files.xml language-combining-modifiers.xml language-modifiers.xml language-variables.xml /docs/ru/designers/language-basic-syntax language-escaping.xml language-math.xml language-syntax-attributes.xml language-syntax-comments.xml language-syntax-functions.xml language-syntax-quotes.xml language-syntax-variables.xml /docs/ru/programmers plugins.xml

http://cvs.php.net/diff.php/smarty/docs/ru/appendixes/tips.xml?r1=1.10&r2=1.11&ty=u
Index: smarty/docs/ru/appendixes/tips.xml
diff -u smarty/docs/ru/appendixes/tips.xml:1.10 smarty/docs/ru/appendixes/tips.xml:1.11
--- smarty/docs/ru/appendixes/tips.xml:1.10	Thu Nov 25 18:26:12 2004
+++ smarty/docs/ru/appendixes/tips.xml	Sun Aug 28 12:51:12 2005
@@ -1,20 +1,23 @@
 <?xml version="1.0" encoding="windows-1251"?>
-<!-- $Revision: 1.10 $ -->
-<!-- EN-Revision: 1.5 Maintainer: freespace Status: ready -->
+<!-- $Revision: 1.11 $ -->
+<!-- EN-Revision: 1.9 Maintainer: freespace Status: ready -->
 <chapter id="tips">
  <title>Ñîâåòû</title>
-  <sect1 id="tips.blank.var.handling">
+ <para></para>
+ <sect1 id="tips.blank.var.handling">
   <title>Îáðàáîòêà ïóñòûõ ïåðåìåííûõ</title>
   <para>
    Èíîãäà, íàïðèìåð, äëÿ òîãî ÷òîáû ôîí òàáëèöû ðàáîòàë êîððåêòíî,
    íåîáõîäèìî âûâåñòè âìåñòî ïóñòîãî çíà÷åíèÿ ïåðåìåííîé, çíà÷åíèå
-   ïî óìîë÷àíèþ "&amp;nbsp;". Ìíîãèå áû èñïîëüçîâàëè êîíñòðóêöèþ {if},
-   íî åñòü áîëåå êîðîòêèé ïóòü â Smatry èñïîëüçóÿ <emphasis>default</emphasis>
-   ìîäèôèêàòîð ïåðåìåííîé.
-  </para>
-<example>
-<title>Âûâîä &amp;nbsp;, åñëè ïåðåìåííàÿ ïóñòà</title>
-<programlisting>
+   ïî óìîë÷àíèþ "&amp;nbsp;". Ìíîãèå áû èñïîëüçîâàëè êîíñòðóêöèþ
+   <link linkend="language.function.if">{if}</link>,
+   íî â Smatry åñòü áîëåå êîðîòêèé ïóòü - èñïîëüçóÿ ìîäèôèêàòîð ïåðåìåííîé
+   <link
+   linkend="language.modifier.default"><emphasis>default</emphasis></link>.
+  </para>
+  <example>
+   <title>Âûâîä &amp;nbsp;, åñëè ïåðåìåííàÿ ïóñòà</title>
+   <programlisting>
 <![CDATA[
 {* äëèííûé ïóòü *}
 
@@ -29,139 +32,172 @@
 
 {$title|default:"&nbsp;"}
 ]]>
-</programlisting>
-</example>
-</sect1>
-<sect1 id="tips.default.var.handling">
- <title>Îáðàáîòêà ïåðåìåííûõ ïî óìîë÷àíèþ</title>
- <para>
-  Åñëè ïåðåìåííàÿ âñòðå÷àåòñÿ ÷àñòî, òî èñïîëüçîâàíèå ìîäèôèêàòîðà
-  default êàæäûé ðàç ìîæíî èçáåæàòü, èñïîëüçóÿ ôóíêöèþ
-  <link linkend="language.function.assign">assign</link>.
- </para>
-<example>
-<title>Íàçíà÷åíèå ïåðåìåííîé øàáëîíà çíà÷åíèÿ ïî óìîë÷àíèþ</title>
-<programlisting>
+   </programlisting>
+  </example>
+  <para>
+   Ñì. òàêæå <link linkend="language.modifier.default">default</link> è
+   <link linkend="tips.default.var.handling">Îáðàáîòêà ïåðåìåííûõ ïî óìîë÷àíèþ</link>.
+  </para>
+ </sect1>
+
+ <sect1 id="tips.default.var.handling">
+  <title>Îáðàáîòêà ïåðåìåííûõ ïî óìîë÷àíèþ</title>
+  <para>
+   Åñëè ïåðåìåííàÿ âñòðå÷àåòñÿ ÷àñòî, òî èñïîëüçîâàíèå ìîäèôèêàòîðà
+   default êàæäûé ðàç ìîæíî èçáåæàòü, èñïîëüçóÿ ôóíêöèþ
+   <link linkend="language.function.assign">{assign}</link>.
+  </para>
+  <example>
+   <title>Íàçíà÷åíèå ïåðåìåííîé øàáëîíà çíà÷åíèÿ ïî óìîë÷àíèþ</title>
+   <programlisting>
 <![CDATA[
-{* ââåðõó øàáëîíà *}
+{* ãäå-òî â íà÷àëå øàáëîíà *}
 {assign var="title" value=$title|default:"no title"}
 
 {* åñëè ïåðåìåííàÿ $title áûëà ïóñòîé, òî ñåé÷àñ îíà ñîäåðæèò "no title" *}
 {$title}
 ]]>
-</programlisting>
-</example>
-</sect1>
-<sect1 id="tips.passing.vars">
- <title>Ïðèñâîåíèå ïåðåìåííîé çàãîëîâêà (title) çàãîëîâêó øàáëîíà.</title>
+   </programlisting>
+  </example>
+  <para>
+   Ñì. òàêæå <link linkend="language.modifier.default">default</link> è
+   <link linkend="tips.blank.var.handling">Îáðàáîòêà ïóñòûõ ïåðåìåííûõ</link>.
+  </para>
+ </sect1>
+ 
+ <sect1 id="tips.passing.vars">
+  <title>Ïðèñâîåíèå ïåðåìåííîé çàãîëîâêà (title) øàáëîíó-øàïêå</title>
   <para>
    Åñëè áîëüøèíñòâî âàøèõ øàáëîíîâ èìåþò ïîõîæèå âåðõíèå è íèæíèå
-   ÷àñòè, òî èìååò ñìûñë âûíåñòè èõ â îòäåëüíûå ôàéëû. Íî åñëè
+   ÷àñòè, òî èìååò ñìûñë âûíåñòè èõ â îòäåëüíûå ôàéëû. Íî êàê áûòü, åñëè
    øàïêà äîëæíà èìåòü ðàçëè÷íûå çàãîëîâêè íà ðàçëè÷íûõ ñòðàíèöàõ?
-   Ñìîòðèòå ïðèìåð íèæå.
+   Âû ìîæåòå ïåðåäàâàòü òåêñò çàãîëîâêà øàïêå â ìîìåíò å¸ âêëþ÷åíèÿ.
   </para>
-<example>
-<title>Ïðèñâîåíèå ïåðåìåííîé çàãîëîâêà (title) çàãîëîâêó øàáëîíà.</title>
-<programlisting>
+  <example>
+   <title>Ïðèñâîåíèå ïåðåìåííîé çàãîëîâêà (title) øàáëîíó-øàïêå</title>
+   <para>
+    <filename>mainpage.tpl</filename>
+   </para>
+   <programlisting>
 <![CDATA[
-mainpage.tpl
-------------
-
 {include file="header.tpl" title="Main Page"}
-{* òåëî øàáëîíà *}
+{* òóò íàõîäèòñÿ òåëî øàáëîíà *}
 {include file="footer.tpl"}
+]]>
+   </programlisting>
 
-
-archives.tpl
-------------
-
+   <para>
+    <filename>archives.tpl</filename>
+   </para>
+   <programlisting>
+<![CDATA[
 {config_load file="archive_page.conf"}
 {include file="header.tpl" title=#archivePageTitle#}
-{* òåëî øàáëîíàe *}
+{* òóò íàõîäèòñÿ òåëî øàáëîíà *}
 {include file="footer.tpl"}
+]]>
+   </programlisting>
+
+   <para>
+    <filename>header.tpl</filename>
+   </para>
+   <programlisting>
+<![CDATA[
+<html>
+ <head>
+  <title>{$title|default:"BC News"}</title>
+ </head>
+ <body>
+]]>
+   </programlisting>
 
+   <para>
+    <filename>footer.tpl</filename>
+   </para>
+   <programlisting>
+<![CDATA[
+ </body>
+</html>
+]]>
+   </programlisting>
+  </example>
 
-header.tpl
-----------
-<HTML>
- <HEAD>
-  <TITLE>{$title|default:"BC News"}</TITLE>
-  </HEAD>
-  <BODY>
-
-
-footer.tpl
-----------
-</BODY>
-</HTML>
-]]>
-</programlisting>
-</example>
- <para>
-  Åñëè âûâîäèòñÿ ãëàâíàÿ ñòðàíèöà, òî çàãîëîâîê áóäåò "Main Page",
-  åñëè àðõèâû, òî çàãîëîâê áåðåòñÿ èç ôàéëà êîíôèãóðàöèè. Åñëè
-  çàãîëîâîê áóäåò ïóñòîé, òî âûâåäåòñÿ çíà÷åíèå ïî óìîë÷àíèþ "BC News".
- </para>
-</sect1>
-<sect1 id="tips.dates">
-<title>Äàòû</title>
- <para>
-  Îáû÷íî äàòû â Smarty âñåãäà ïåðåäàþòñÿ êàê âðåìåííûå ìåòêè, ÷òî
-  ïîçâîëÿåò ïðîåêòèðîâùèêàì øàáëîíîâ èñïîëüçîâàòü <link
-		linkend="language.modifier.date.format">date_format</link>
-  äëÿ ïîëíîãî êîíòðîëÿ íàä ôîðìàòèðîâàíèåì äàòû è òàêæå äåëàåò ëåãêèì
-		ñðàâíåíèå äàò òàì, ãäå ýòî íåîáõîäèìî.
- </para>
-   <note>
-    <para>
-     Íà÷èíàÿ ñ âåðñèè Smarty 1.4.0, âû ìîæåòå ïåðåäàâàòü äàòû â Smarty â âèäå
-     ìåòîê âðåìåíè Unix (unix timestamps), mysql, èëè â ëþáîì äðóãîì âèäå, êîòîðûé ïðèíèìàåò strtotime().
-    </para>
-   </note>
-   <example>
-    <title>using date_format</title>
-    <programlisting>
+  <para>
+   Ïðè îòîáðàæåíèè ãëàâíîé ñòðàíèö, ñòðîêà "Main Page" ïåðåäà¸òñÿ â
+   <filename>header.tpl</filename> è â ïîñëåäñòâèè èñïîëüçóåòñÿ êàê çàãîëîâîê.
+   Ïðè îòîáðàæåíèè ñòðàíèöû àðõèâà, çàãîëîâêîì áóäåò "Archives".
+   Îáðàòèòå âíèìàíèå, ÷òî â ïðèìåðå ñ àðõèâîì ìû èñïîëüçóåì ïåðåìåííóþ èç
+   ôàéëà <filename>archives_page.conf</filename>, âìåñòî òîãî, ÷òîáû æ¸ñòêî
+   çàäàòü å¸ â øàáëîíå. Òàêæå îáðàòèòå âíèìàíèå, ÷òî â ñëó÷àå, åñëè
+   ïåðåìåííàÿ $title íå çàäàíà, ïðè ïîìîùè ìîäèôèêàòîðà ïåðåìåííîé
+   <link linkend="language.modifier.default">default</link>
+   çàãîëîâêîì áóäåò "BC News".
+  </para>
+ </sect1>
+ 
+ <sect1 id="tips.dates">
+  <title>Äàòû</title>
+  <para>
+   Îáû÷íî äàòû â Smarty âñåãäà ïåðåäàþòñÿ êàê âðåìåííûå ìåòêè, ÷òî
+   ïîçâîëÿåò ïðîåêòèðîâùèêàì øàáëîíîâ èñïîëüçîâàòü <link
+ 		linkend="language.modifier.date.format">date_format</link>
+   äëÿ ïîëíîãî êîíòðîëÿ íàä ôîðìàòèðîâàíèåì äàòû è òàêæå äåëàåò ëåãêèì
+ 		ñðàâíåíèå äàò òàì, ãäå ýòî íåîáõîäèìî.
+  </para>
+  <note>
+   <para>
+    Íà÷èíàÿ ñ âåðñèè Smarty 1.4.0, âû ìîæåòå ïåðåäàâàòü äàòû â Smarty â âèäå
+    ìåòîê âðåìåíè Unix (unix timestamps), mysql, èëè â ëþáîì äðóãîì âèäå,
+    êîòîðûé ïîíèìàåò ôóíêöèÿ
+    <ulink url="&url.php-manual;strtotime">strtotime()</ulink>.
+   </para>
+  </note>
+  <example>
+   <title>using date_format</title>
+   <programlisting>
 <![CDATA[
 {$startDate|date_format}
 ]]>
-    </programlisting>
-    <para>
-     Ðåçóëüòàò ðàáîòû:
-    </para>
-    <screen>
+   </programlisting>
+   <para>
+    Ðåçóëüòàò ðàáîòû:
+   </para>
+   <screen>
 <![CDATA[
 Jan 4, 2001
 ]]>
-    </screen>
-    <programlisting>
+   </screen>
+   <programlisting>
 <![CDATA[
 {$startDate|date_format:"%Y/%m/%d"}
 ]]>
-    </programlisting>
-    <para>
-     Ðåçóëüòàò ðàáîòû:
-    </para>
-    <screen>
+   </programlisting>
+   <para>
+    Ðåçóëüòàò ðàáîòû:
+   </para>
+   <screen>
 <![CDATA[
 2001/01/04
 ]]>
-    </screen>
-    <programlisting>
+   </screen>
+   <programlisting>
 <![CDATA[
 {if $date1 < $date2}
-   ...
+    ...
 {/if}
 ]]>
-    </programlisting>
-   </example>
-<para>
- Êîãäà {html_select_date} èñïîëüçóåòñÿ â øàáëîíå, ïðîãðàììèñòàì ìîæåò
- ïîíàäîáèòüñÿ ïîëó÷èòü äàòó âèäå âðåìåííîé ìåòêè. Âîò ôóíêöèÿ, êîòîðàÿ ïîìîæåò ýòî
- ñäåëàòü.
-</para>
-<example>
-<title>Ïðåîáðàçîâàíèå ýëåìåíòîâ ôîðìû ââîäà äàòû íàçàä ê âðåìåííîé ìåòêå</title>
-    <programlisting role="php">
+   </programlisting>
+  </example>
+  <para>
+   Êîãäà <link
+   linkend="language.function.html.select.date">{html_select_date}</link>
+   èñïîëüçóåòñÿ â øàáëîíå, ïðîãðàììèñò íàâåðíÿêà çàõî÷åò ïðåîáðàçîâàòü
+   äàííûå èç ôîðìû íàçàä â ôîðìàò ìåòêè âðåìåíè. Âîò ôóíêöèÿ, êîòîðàÿ
+   ïîìîæåò âàì ñäåëàòü ýòî.
+  </para>
+  <example>
+   <title>Ïðåîáðàçîâàíèå ýëåìåíòîâ ôîðìû ââîäà äàòû íàçàä ê ìåòêå âðåìåíè</title>
+   <programlisting role="php">
 <![CDATA[
 <?php
 
@@ -170,7 +206,7 @@
 
 $startDate = makeTimeStamp($startDate_Year, $startDate_Month, $startDate_Day);
 
-function makeTimeStamp($year="", $month="", $day="")
+function makeTimeStamp($year='', $month='', $day='')
 {
    if(empty($year)) {
        $year = strftime("%Y");
@@ -186,22 +222,34 @@
 }
 ?>
 ]]>
-    </programlisting>
-</example>
-</sect1>
-<sect1 id="tips.wap">
- <title>WAP/WML</title>
- <para>
-  WAP/WML øàáëîíû òðåáóþò, ÷òîáû çàãîëîâîê Content-type áûë
-  ïåðåäàí âìåñòå ñ øàáëîíîì. Ïðîñòåéøèé ïóòü - íàïèñàòü
-  ïîëüçîâàòåëüñêóþ ôóíêöèþ, êîòîðàÿ áóäåò âûâîäèòü çàãîëîâêè.
-  Òàê êàê ìû áóäåì ïîëüçîâàòüñÿ òýãàìè insert, òî çàãîëîâêè íå áóäóò
-  êýøèðîâàòüñÿ. Òàê æå íè÷åãî íå äîëæíî âûâîäèòüñÿ â áðàóçåð äî
-  øàáëîíà, èíà÷å çàãîëîâêè ìîãóò áûòü íåïðàâèëüíî âîñïðèíÿòû.
- </para>
-<example>
- <title>Èñïîëüçîâàíèå insert äëÿ çàïèñè WML Content-Type çàãîëîâêîâ</title>
-    <programlisting role="php">
+   </programlisting>
+  </example>
+  <para>
+   Ñì. òàêæå
+   <link linkend="language.function.html.select.date">{html_select_date}</link>,
+   <link linkend="language.function.html.select.time">{html_select_time}</link>,
+   <link linkend="language.modifier.date.format">date_format</link> è
+   <link linkend="language.variables.smarty.now">$smarty.now</link>
+  </para>
+ </sect1>
+
+ <sect1 id="tips.wap">
+  <title>WAP/WML</title>
+  <para>
+   WAP/WML øàáëîíû òðåáóþò, ÷òîáû
+   <ulink url="&url.php-manual;header">çàãîëîâîê Content-type</ulink>
+   áûë ïåðåäàí âìåñòå ñ øàáëîíîì. Ïðîñòåéøèé ïóòü - íàïèñàòü
+   ïîëüçîâàòåëüñêóþ ôóíêöèþ, êîòîðàÿ áóäåò âûâîäèòü çàãîëîâêè.
+   Åñëè âû èñïîëüçóåòå <link linkend="caching">êýøèðîâàíèå</link>,
+   ýòî íå ñðàáîòàåò, òàê ÷òî ìû ñäåëàåì ýòî ñ ïîìîùüþ òåãà
+   <link linkend="language.function.insert">{insert}</link>;
+   íå çàáûâàéòå, ÷òî òåãè {insert} íå êýøèðóþòñÿ!
+   Óáåäèòåñü, ÷òî ïåðåä øàáëîíîì â áðàóçåð íè÷åãî íå âûâîäèòñÿ,
+   èíà÷å îòïðàâèòü çàãîëîâîê íå ïîëó÷èòñÿ.
+  </para>
+  <example>
+   <title>Èñïîëüçîâàíèå {insert} äëÿ çàïèñè çàãîëîâêà Content-Type äëÿ WML</title>
+   <programlisting role="php">
 <![CDATA[
 <?php
 
@@ -219,11 +267,11 @@
 
 ?>
 ]]>
-    </programlisting>
-    <para>
-     âàø øàáëîí Smarty <emphasis>äîëæåí</emphasis> íà÷èíàòüñÿ ñ òýãà insert:
-    </para>
-    <programlisting>
+   </programlisting>
+   <para>
+    âàø øàáëîí Smarty <emphasis>äîëæåí</emphasis> íà÷èíàòüñÿ ñ òýãà insert:
+   </para>
+   <programlisting>
 <![CDATA[
 {insert name=header content="Content-Type: text/vnd.wap.wml"}
 
@@ -250,35 +298,39 @@
  </card>
 </wml>
 ]]>
-    </programlisting>
-</example>
-</sect1>
-  <sect1 id="tips.componentized.templates">
-   <title>Ñîñòàâíûå øàáëîíû</title>
-   <para>
-    Ïî òðàäèöèè, ïðîãðàììèðîâàíèå øàáëîíîâ â âàøåì ïðèëîæåíèè èä¸ò ñëåäóþùèì
-    ïóò¸ì: Ñíà÷àëà âû ôîðìèðóåòå ïåðåìåííûå âíóòðè âàøåãî ïðèëîæåíèÿ PHP
-    (âîçìîæíî èñïîëüçóÿ çàïðîñû ê áàçå äàííûõ). Çàòåì âû ñîçäà¸òå ýêçåìïëÿð
-    îáúåêòà Smarty, íàçíà÷àåòå ïåðåìåííûå è îòîáðàæàåòå øàáëîí.
-    Äàâàéòå ïðåäñòàâèì ñåáå òàêóþ ñèòóàöèþ: Ê ïðèìåðó, ó íàñ åñòü êîòèðîâùèê
-    öåííûõ áóìàã â íàøåì øàáëîíå. Ìû ñîáèðàåì äàííûå î êîòèðîâêàõ öåííûõ áóìàã
-    â íàøåì ïðèëîæåíèè, çàòåì ïåðåäà¸ì ýòè ïåðåìåííûå â øàáëîí è îòîáðàæàåì
-    åãî. Ïðàâäà, áûëî áû çäîðîâî, åñëè áû ýòîò êîòèðîâùèê ìîæíî áûëî ïåðåíåñòè
-    â äðóãîå ïðèëîæåíèå, ïðîñòî ïîäêëþ÷èâ ê íåìó øàáëîí, íå áåñïîêîÿñü îá
-    èñòî÷íèêå äàííûõ.
-   </para>
-   <para>
-    Âû ìîæåòå ñäåëàòü ýòî, íàïèñàâ ñîáñòâåííûé ïëàãèí äëÿ ïîëó÷åíèÿ äàííûõ è
-    ïðèñâàèâàíèÿ èõ ïåðåìåííîé øàáëîíà.
-   </para>
-   <example>
-    <title>ñîñòàâíîé øàáëîí</title>
-    <programlisting role="php">
+   </programlisting>
+  </example>
+ </sect1>
+ 
+ <sect1 id="tips.componentized.templates">
+  <title>Ñîñòàâíûå øàáëîíû</title>
+  <para>
+   Ïî òðàäèöèè, ïðîãðàììèðîâàíèå øàáëîíîâ â âàøåì ïðèëîæåíèè èä¸ò ñëåäóþùèì
+   ïóò¸ì: Ñíà÷àëà âû ôîðìèðóåòå ïåðåìåííûå âíóòðè âàøåãî ïðèëîæåíèÿ PHP
+   (âîçìîæíî, èñïîëüçóÿ çàïðîñû ê áàçå äàííûõ). Çàòåì âû ñîçäà¸òå ýêçåìïëÿð
+   îáúåêòà Smarty, íàçíà÷àåòå ïåðåìåííûå è îòîáðàæàåòå øàáëîí.
+   Äàâàéòå ïðåäñòàâèì ñåáå òàêóþ ñèòóàöèþ: Ê ïðèìåðó, ó íàñ åñòü êîòèðîâùèê
+   öåííûõ áóìàã â íàøåì øàáëîíå. Ìû ñîáèðàåì äàííûå î êîòèðîâêàõ öåííûõ áóìàã
+   â íàøåì ïðèëîæåíèè, çàòåì ïåðåäà¸ì ýòè ïåðåìåííûå â øàáëîí è îòîáðàæàåì
+   åãî. Ïðàâäà, áûëî áû çäîðîâî, åñëè áû ýòîò êîòèðîâùèê ìîæíî áûëî ïåðåíåñòè
+   â äðóãîå ïðèëîæåíèå, ïðîñòî ïîäêëþ÷èâ ê íåìó øàáëîí, íå áåñïîêîÿñü îá
+   èñòî÷íèêå äàííûõ.
+  </para>
+  <para>
+   Âû ìîæåòå ñäåëàòü ýòî, íàïèñàâ ñîáñòâåííîå ðàñøèðåíèå äëÿ ïîëó÷åíèÿ
+   äàííûõ è ïðèñâàèâàíèÿ èõ ïåðåìåííîé øàáëîíà.
+  </para>
+  <example>
+   <title>ñîñòàâíîé øàáëîí</title>
+   <para>
+     <filename>function.load_ticker.php</filename> -
+     ïîìåñòèòå ôàéë â
+     <link linkend="variable.plugins.dir">äèðåêòîðèþ $plugins</link>
+   </para>
+   <programlisting role="php">
 <![CDATA[
 <?php
 
-// ïîìåñòèòå ôàéë "function.load_ticker.php" â äèðåêòîðèþ ïëàãèíîâ
-
 // íàñòðàèâàåì íàøó ôóíêöèþ äëÿ ïîëó÷åíèÿ èíôîðìàöèè î öåííûõ áóìàãàõ
 function fetch_ticker($symbol)
 {
@@ -297,50 +349,63 @@
 }
 ?>
 ]]>
-    </programlisting>
-    <programlisting>
+   </programlisting>
+   <para>
+    <filename>index.tpl</filename>
+   </para>
+   <programlisting>
 <![CDATA[
-{* in index.tpl *}
-
 {load_ticker symbol="YHOO" assign="ticker"}
 
-Íàçâàíèå öåííîé áóìàãè: {$ticker.name} Öåíà öåííîé áóìàãè: {$ticker.price}
+Stock Name: {$ticker.name} Stock Price: {$ticker.price}
 ]]>
-    </programlisting>
-   </example>
-  </sect1>
-  <sect1 id="tips.obfuscating.email">
-   <title>Ñîêðûòèå E-mail àäðåñà</title>
-   <para>
-    Âû êîãäà-íèáóäü óäèâëÿëèñü, êàê âàø e-mail àäðåñ ïîïàäàåò â òàêîå
-    êîëè÷åñòâî ñïàìåðñêèõ ðàññûëîê? Îäèí èç ñïîñîáîâ ñáîðà e-mail àäðåñîâ
-    çàêëþ÷àåòñÿ â ïðîñìîòðå âåá-ñòðàíèö. ×òîáû ïîìî÷ü ïðåäîòâðàòèòü ýòó
-    ïðîáëåìó, âû ìîæåòå ñäåëàòü òàê, ÷îòáû âàø e-mail àäðåñ îòîáðàæàëñÿ
-    â ñêðûòîì çà javascript'îì âèäå â HTML-èñõîäíèêàõ, â òî æå âðåìÿ
-    âûãëÿäÿ è ðàáîòàÿ êîððåêòíî â áðàóçåðå. Ýòî ìîæíî ñîâåðøèòü ïðè ïîìîùè
-    ïëàãèíà mailto.
-   </para>
-   <example>
-    <title>Ïðèìåð ñîêðûòèÿ e-mail àäðåñà</title>
-    <programlisting>
+   </programlisting>
+  </example>
+  <para>
+   Ñì. òàêæå
+   <link linkend="language.function.include.php">{include_php}</link>,
+   <link linkend="language.function.include">{include}</link> è
+   <link linkend="language.function.php">{php}</link>.
+  </para>
+ </sect1>
+ 
+ <sect1 id="tips.obfuscating.email">
+  <title>Ñîêðûòèå E-mail àäðåñà</title>
+  <para>
+   Âû êîãäà-íèáóäü óäèâëÿëèñü, êàê âàø e-mail àäðåñ ïîïàäàåò â òàêîå
+   êîëè÷åñòâî ñïàìåðñêèõ ðàññûëîê? Îäèí èç ñïîñîáîâ ñáîðà e-mail àäðåñîâ
+   çàêëþ÷àåòñÿ â ïðîñìîòðå âåá-ñòðàíèö. ×òîáû ïîìî÷ü ïðåäîòâðàòèòü ýòó
+   ïðîáëåìó, âû ìîæåòå ñäåëàòü òàê, ÷îòáû âàø e-mail àäðåñ îòîáðàæàëñÿ
+   â ñêðûòîì çà javascript'îì âèäå â HTML-èñõîäíèêàõ, â òî æå âðåìÿ
+   âûãëÿäÿ è ðàáîòàÿ êîððåêòíî â áðàóçåðå. Ýòî ìîæíî ñîâåðøèòü ïðè ïîìîùè
+   ðàñøèðåíèÿ <link linkend="language.function.mailto">{mailto}</link>.
+  </para>
+  <example>
+   <title>Ïðèìåð ñîêðûòèÿ e-mail àäðåñà</title>
+   <programlisting>
 <![CDATA[
-{* in index.tpl *}
+{* â index.tpl *}
 
 Ïî âîïðîñàì îáðàùàéòåñü íà
 {mailto address=$EmailAddress encode="javascript" subject="Hello"}
 ]]>
-    </programlisting>
-   </example>
-   <note>
-    <title>Òåõíè÷åñêîå Çàìå÷àíèå</title>
-    <para>
-     Ýòîò ìåòîä íå ìîæåò ãàðàíòèðîâàòü 100% çàùèòû.
-     Ñóùåñòâóåò âåðîÿòíîñòü, ÷òî ñïàìåð çàïðîãðàììèðóåò ñâîé
-     ñáîðùèê e-mail àäðåñîâ íà ðàñêîäèðîâàíèå ýòèõ çíà÷åíèé,
-     íî ýòî ìàëîâåðîÿòíî.
-    </para>
-   </note>
-  </sect1>
+   </programlisting>
+  </example>
+  <note>
+   <title>Òåõíè÷åñêîå Çàìå÷àíèå</title>
+   <para>
+    Ýòîò ìåòîä íå ìîæåò ãàðàíòèðîâàòü 100% çàùèòû.
+    Ñóùåñòâóåò âåðîÿòíîñòü, ÷òî ñïàìåð çàïðîãðàììèðóåò ñâîé
+    ñáîðùèê e-mail àäðåñîâ íà ðàñêîäèðîâàíèå ýòèõ çíà÷åíèé,
+    íî ýòî ìàëîâåðîÿòíî... áóäåì íàäåÿòüñÿ.
+   </para>
+  </note>
+  <para>
+   Ñì. òàêæå
+   <link linkend="language.modifier.escape">escape</link> è
+   <link linkend="language.function.mailto">{mailto}</link>.
+  </para>
+ </sect1>
 </chapter>
 <!-- Keep this comment at the end of the file
 Local variables:
http://cvs.php.net/diff.php/smarty/docs/ru/appendixes/troubleshooting.xml?r1=1.6&r2=1.7&ty=u
Index: smarty/docs/ru/appendixes/troubleshooting.xml
diff -u smarty/docs/ru/appendixes/troubleshooting.xml:1.6 smarty/docs/ru/appendixes/troubleshooting.xml:1.7
--- smarty/docs/ru/appendixes/troubleshooting.xml:1.6	Tue Oct  5 08:26:17 2004
+++ smarty/docs/ru/appendixes/troubleshooting.xml	Sun Aug 28 12:51:12 2005
@@ -1,19 +1,19 @@
 <?xml version="1.0" encoding="windows-1251"?>
-<!-- $Revision: 1.6 $ -->
-<!-- EN-Revision: 1.2 Maintainer: freespace Status: ready -->
- <chapter id="troubleshooting">
-  <title>Ðåøåíèå ïðîáëåì</title>
-  <para></para>
-  <sect1 id="smarty.php.errors">
-   <title>Îøèáêè Smarty/PHP</title>
-   <para>
-    Smarty ìîæåò ëîâèòü ìíîãèå îøèáêè, íàïðèìåð îòñóòñòâóþùèå àòðèáóòû
-    òýãîâ èëè íåäîïóñòèìûå èìåíà ïåðåìåííûõ. Åñëè ýòî ïðîèçîéäåò, âû óâèäèòå
-    îøèáêó íàïîäîáèå ñëåäóþùåé:
-   </para>
-   <example>
-    <title>Îøèáêà Smarty</title>
-    <screen>
+<!-- $Revision: 1.7 $ -->
+<!-- EN-Revision: 1.4 Maintainer: freespace Status: ready -->
+<chapter id="troubleshooting">
+ <title>Ðåøåíèå ïðîáëåì</title>
+ <para></para>
+ <sect1 id="smarty.php.errors">
+  <title>Îøèáêè Smarty/PHP</title>
+  <para>
+   Smarty ìîæåò ëîâèòü ìíîãèå îøèáêè, íàïðèìåð îòñóòñòâóþùèå àòðèáóòû
+   òýãîâ èëè íåäîïóñòèìûå èìåíà ïåðåìåííûõ. Åñëè ýòî ïðîèçîéäåò, âû óâèäèòå
+   îøèáêó íàïîäîáèå ñëåäóþùåé:
+  </para>
+  <example>
+   <title>Îøèáêà Smarty</title>
+   <screen>
 <![CDATA[
 Warning: Smarty: [in index.tpl line 4]: syntax error: unknown tag - '%blah'
        in /path/to/smarty/Smarty.class.php on line 1041
@@ -21,40 +21,152 @@
 Fatal error: Smarty: [in index.tpl line 28]: syntax error: missing section name
        in /path/to/smarty/Smarty.class.php on line 1041
 ]]>
-    </screen>
-   </example>
-   <para>
-    Smarty ïîêàæåò âàì èìÿ øàáëîíà, íîìåð ñòðîêè è îøèáêó.
-    Äàëåå ñîîáùåíèå îá îøèáêå ñîñòîèò èç ôàêòè÷åñêîãî íîìåðà ñòðîêè â êëàññå
-    Smarty, ãäå âîçíèêëà îøèáêà.
-   </para>
-
-   <para>
-    Åñòü îïðåäåëåííûå îøèáêè, êîòîðûå íå ìîæåò ïîéìàòü Smarty, íàïðèìåð
-    îòñóòñòâóþùèå çàêðûâàþùèå òýãè. Òàêèå îøèáêè îáû÷íî ïðèâîäÿò ê îøèáêàì
-    ðàçáîðà PHP íà ýòàïå êîìïèëÿöèè.
-   </para>
-
-   <example>
-    <title>Îøèáêè ðàçáîðà PHP</title>
-    <screen>
+   </screen>
+  </example>
+  <para>
+   Smarty ïîêàæåò âàì èìÿ øàáëîíà, íîìåð ñòðîêè è îøèáêó.
+   Äàëåå ñîîáùåíèå îá îøèáêå ñîñòîèò èç ôàêòè÷åñêîãî íîìåðà ñòðîêè â êëàññå
+   Smarty, ãäå âîçíèêëà îøèáêà.
+  </para>
+
+  <para>
+   Åñòü îïðåäåëåííûå îøèáêè, êîòîðûå íå ìîæåò ïîéìàòü Smarty, íàïðèìåð
+   îòñóòñòâóþùèå çàêðûâàþùèå òýãè. Òàêèå îøèáêè îáû÷íî ïðèâîäÿò ê îøèáêàì
+   ðàçáîðà PHP íà ýòàïå êîìïèëÿöèè.
+  </para>
+
+  <example>
+   <title>Îøèáêè ðàçáîðà PHP</title>
+   <screen>
 <![CDATA[
 Parse error: parse error in /path/to/smarty/templates_c/index.tpl.php on line 75
 ]]>
-    </screen>
-   </example>
+   </screen>
+  </example>
+
+  <para>
+   Êîãäà âû âñòðå÷àåòåñü ñ îøèáêîé ðàçáîðà PHP, íîìåð ñòðîêè, â êîòîðîé
+   äîïóùåíà îøèáêà, áóäåò ñîîòâåòñòâîâàòü ñêîìïèëèðîâàííîìó PHP-ñêðèïòó,
+   à íå ñàìîìó øàáëîíó. Îáû÷íî âû ìîæåòå ïîñìîòðåòü íà øàáëîí è óâèäèòü
+   ñèíòàêñè÷åñêóþ îøèáêó. Òèïè÷íûå îøèáêè: îòñóòñòâóþùèå çàêðûâàþùèå òýãè
+   äëÿ
+   <link linkend="language.function.if">{if}{/if}</link> èëè
+   <link linkend="language.function.if">{section}{/section}</link>,
+   èëè ñèíòàêñèñ ëîãèêè âíóòðè òýãà {if}.
+   Åñëè âû íå ìîæåòå íàéòè îøèáêó, âàì ìîæåò ïîíàäîáèòüñÿ îòêðûòü
+   ñêîìïèëèðîâàííûé PHP-ôàéë è ïåðåéòè ê íîìåðó ñòðîêè ÷òîáû âûÿñíèòü,
+   â ÷¸ì çàêëþ÷àåòñÿ îøèáêà â øàáëîíå.
+  </para>
+
+  <example>
+   <title>Other common errors</title>
 
-   <para>
-    Êîãäà âû âñòðå÷àåòåñü ñ îøèáêîé ðàçáîðà PHP, íîìåð ñòðîêè, â êîòîðîé
-    äîïóùåíà îøèáêà, áóäåò ñîîòâåòñòâîâàòü ñêîìïèëèðîâàííîìó PHP-ñêðèïòó,
-    à íå ñàìîìó øàáëîíó. Îáû÷íî âû ìîæåòå ïîñìîòðåòü íà øàáëîí è óâèäèòü
-    ñèíòàêñè÷åñêóþ îøèáêó. Òèïè÷íûå îøèáêè: îòñóòñòâóþùèå çàêðûâàþùèå òýãè
-    äëÿ {if}{/if} èëè {section}{/section}, èëè ñèíòàêñèñ ëîãèêè âíóòðè òýãà {if}.
-    Åñëè âû íå ìîæåòå íàéòè îøèáêó, âàì ìîæåò ïîíàäîáèòüñÿ îòêðûòü ñêîìïèëèðîâàííûé
-    PHP-ôàéë è ïåðåéòè ê íîìåðó ñòðîêè ÷òîáû âûÿñíèòü, â ÷¸ì çàêëþ÷àåòñÿ îøèáêà
-    â øàáëîíå.
-   </para>
-  </sect1>
+   <itemizedlist>
+    <listitem>
+     <screen>
+<![CDATA[
+Warning: Smarty error: unable to read resource: "index.tpl" in...
+or
+Warning: Smarty error: unable to read resource: "site.conf" in...
+]]>
+     </screen>
+     <para>
+      <itemizedlist>
+       <listitem>
+        <para>
+         Çíà÷åíèå <link
+         linkend="variable.template.dir">$template_dir</link>
+         íåâåðíî, ýòà äèðåêòîðèÿ íå ñóùåñòâóåò èëè ôàéë
+         <filename>index.tpl</filename> íàõîäèòñÿ çà ïðåäåëàìè äèðåêòîðèè
+         <filename class="directory">templates/</filename>
+        </para>
+       </listitem>
+       <listitem>
+        <para>
+         Â øàáëîíå ïðèñóòñòâóåò ôóíêöèÿ <link
+         linkend="language.function.config.load">{config_load}</link>
+         (ëèáî áûëà âûçâàíà ôóíêöèÿ
+         <link linkend="api.config.load">config_load()</link>)
+         è çíà÷åíèå
+         <link linkend="variable.config.dir">$config_dir</link>
+         íåâåðíî, ýòà äèðåêòîðèÿ íå ñóùåñòâóåò èëè ôàéë
+         <filename>site.conf</filename> íàõîäèòñÿ çà ïðåäåëàìè ýòîé
+         äèðåêòîðèè.
+        </para>
+       </listitem>
+      </itemizedlist>
+     </para>
+    </listitem>
+    <listitem>
+     <screen>
+<![CDATA[
+Fatal error: Smarty error: the $compile_dir 'templates_c' does not exist,
+or is not a directory...
+]]>
+     </screen>
+     <para>
+      Ïåðåìåííàÿ
+      <link linkend="variable.compile.dir">$compile_dir</link>
+      óñòàíîâëåíà íåâåðíî, ýòà äèðåêòîðèÿ íå ñóùåñòâóåò
+      èëè <filename>templates_c</filename> ÿâëÿåòñÿ ôàéëîì, à íå
+      äèðåêòîðèåé.
+     </para>
+    </listitem>
+    <listitem>
+     <screen>
+<![CDATA[
+Fatal error: Smarty error: unable to write to $compile_dir '....
+]]>
+     </screen>
+     <para>
+      Ó âåá ñåðâåðà íåò ïðàâ íà çàïèñü â äèðåêòîðèþ
+      <link linkend="variable.compile.dir">$compile_dir</link>.
+      Ñìîòðèòå êîíåö ñòðàíèöû
+      <link linkend="installing.smarty.basic">Áàçîâàÿ óñòàíîâêà</link>
+      äëÿ ïîëó÷åíèÿ èíôîðìàöèè î ïðàâàõ äîñòóïà.
+     </para>
+    </listitem>
+    <listitem>
+     <screen>
+<![CDATA[
+Fatal error: Smarty error: the $cache_dir 'cache' does not exist,
+or is not a directory. in /..
+]]>
+     </screen>
+     <para>
+      Ýòî îçíà÷àåò, ÷òî
+      <link linkend="variable.caching">$caching</link> âêëþ÷åíî è
+      <link linkend="variable.cache.dir">$cache_dir</link>
+      óñòàíîâëåíà íåïðàâèëüíî, äèðåêòîðèÿ íå ñóùåñòâóåò
+      èëè <filename>cache</filename> ÿâëÿåòñÿ ôàéëîì, à íå
+      äèðåêòîðèåé.
+     </para>
+    </listitem>
+    <listitem>
+     <screen>
+<![CDATA[
+Fatal error: Smarty error: unable to write to $cache_dir '/...
+]]>
+     </screen>
+     <para>
+      Ýòî îçíà÷àåò, ÷òî
+      <link linkend="variable.caching">$caching</link> âêëþ÷åíî è
+      ó âåá ñåðâåðà íåò ïðàâ íà çàïèñü â äèðåêòîðèþ
+      <link linkend="variable.cache.dir">$cache_dir</link>.
+      Ñìîòðèòå êîíåö ñòðàíèöû
+      <link linkend="installing.smarty.basic">Áàçîâàÿ óñòàíîâêà</link>
+      äëÿ ïîëó÷åíèÿ èíôîðìàöèè î ïðàâàõ äîñòóïà.
+     </para>
+    </listitem>
+   </itemizedlist>
+  </example>
+  <para>
+   Ñì. òàêæå
+   <link linkend="chapter.debugging.console">debugging</link>,
+   <link linkend="variable.error.reporting">$error_reporting</link> è
+   <link linkend="api.trigger.error">trigger_error()</link>.
+  </para>
+ </sect1>
 </chapter>
 <!-- Keep this comment at the end of the file
 Local variables:
http://cvs.php.net/diff.php/smarty/docs/ru/designers/chapter-debugging-console.xml?r1=1.5&r2=1.6&ty=u
Index: smarty/docs/ru/designers/chapter-debugging-console.xml
diff -u smarty/docs/ru/designers/chapter-debugging-console.xml:1.5 smarty/docs/ru/designers/chapter-debugging-console.xml:1.6
--- smarty/docs/ru/designers/chapter-debugging-console.xml:1.5	Wed Sep  8 17:49:09 2004
+++ smarty/docs/ru/designers/chapter-debugging-console.xml	Sun Aug 28 12:51:14 2005
@@ -1,29 +1,42 @@
 <?xml version="1.0" encoding="windows-1251"?>
-<!-- $Revision: 1.5 $ -->
-<!-- EN-Revision: 1.5 Maintainer: tony2001 Status: ready -->
+<!-- $Revision: 1.6 $ -->
+<!-- EN-Revision: 1.7 Maintainer: freespace Status: ready -->
 <chapter id="chapter.debugging.console">
  <title>Îòëàäî÷íàÿ êîíñîëü</title>
  <para>
-   Smarty âêëþ÷åíà êîíñîëü äëÿ îòëàäêè. Êîíñîëü ïîçâîëÿåò óçíàòü âñå âêëþ÷åííûå
-  ôàéëû, ïðèñâîåííûå ïåðåìåííûå è íàñòðîéêè èç êîíôèãóðàöèîííûõ ôàéëîâ.
+   Smarty âêëþ÷åíà êîíñîëü äëÿ îòëàäêè. Êîíñîëü ïîçâîëÿåò óçíàòü âñå
+  <link linkend="language.function.include">âêëþ÷åííûå</link> øàáëîíû,
+  <link linkend="api.assign">ïðèñâîåííûå</link> ïåðåìåííûå è íàñòðîéêè èç
+  <link linkend="language.config.variables">êîíôèíóðàöèîííûõ ôàéëîâ</link>
+  äëÿ òåêóùåãî ýêçåìïëÿðà Smarty.
   Øàáëîí "debug.tpl", ïîñòàâëÿåìûé âìåñòå ñî Smarty, óïðàâëÿåò âèäîì êîíñîëè.
-  Óñòàíîâèòå îïöèþ Smarty $debugging â true è, åñëè íàäî, óêàæèòå â $debug_tpl ïóòü
-  ê øàáëîíó debug.tpl (ïî óìîë÷àíèþ ýòî SMARTY_DIR).
-  Êîãäà âû çàãðóæàåòå ñòðàíèöó, äîëæíî ïîÿâèòüñÿ âñïëûâàþùèå îêíî è âûâåñòè êîíñîëü
-  îòëàäêè. Äëÿ âûâîäà äîñòóïíûõ ïåðåìåííûõ èç êîíêðåòíîãî øàáëîíà, ñì. ôóíêöèþ
-  <link linkend="language.function.debug">{debug}</link>. Äëÿ îòêëþ÷åíèÿ êîíñîëè
-  îòëàäêè, óñòàíîâèòå $debugging â false. Ìîæíî òàêæå îïöèîíàëüíî âêëþ÷èòü êîíñîëü
-  îòëàäêè, äîáàâèâ SMARTY_DEBUG â URL, åñëè âêëþ÷åíà îïöèÿ <link
-  linkend="variable.debugging.ctrl">$debugging_ctrl</link>.
+  Óñòàíîâèòå îïöèþ Smarty
+  <link linkend="variable.debugging">$debugging</link> â true è, åñëè
+  íåîáõîäèìî, óêàæèòå â
+  <link linkend="variable.debug.tpl">$debug_tpl</link> ïóòü ê øàáëîíó
+  debug.tpl (ïî óìîë÷àíèþ ýòî
+  <link linkend="constant.smarty.dir">SMARTY_DIR</link>).
+  Êîãäà âû çàãðóæàåòå ñòðàíèöó, äîëæíî ïîÿâèòüñÿ âñïëûâàþùèå îêíî è âûâåñòè
+  êîíñîëü îòëàäêè. Äëÿ âûâîäà äîñòóïíûõ ïåðåìåííûõ èç êîíêðåòíîãî øàáëîíà,
+  ñì. ôóíêöèþ <link linkend="language.function.debug">{debug}</link>.
+  Äëÿ îòêëþ÷åíèÿ êîíñîëè îòëàäêè, óñòàíîâèòå
+  <link linkend="variable.debugging">$debugging</link> â false.
+  Ìîæíî òàêæå îïöèîíàëüíî âêëþ÷èòü êîíñîëü îòëàäêè, äîáàâèâ SMARTY_DEBUG â
+  URL, åñëè âêëþ÷åíà îïöèÿ
+  <link linkend="variable.debugging.ctrl">$debugging_ctrl</link>.
  </para>
 <note>
+ <title>Òåõíè÷åñêîå Ïðèìå÷àíèå</title>
  <para>
-  Êîíñîëü îòëàäêè íå ðàáîòàåò, êîãäà èñïîëüçóåòñÿ ôóíêöèÿ API fetch().
-  Íåîáõîäèìî èñïîëüçîâàòü òîëüêî ôóíêöèþ display(). Îíà ãåíåðèðóåò
-  javascript êîä âíà÷àëå êàæäîé ñãåíåðèðîâàííîé ñòðàíèöû. Åñëè âàì íå
-  íðàâèòñÿ javascript, ìîæíî îòðåäàòèðîâàòü debug.tpl äëÿ èçìåíåíèÿ
-  ñïîñîáà îòîáðàæåíèÿ ïî âàøåìó âêóñó. Îòëàäî÷íàÿ èíôîðìàöèÿ íå êýøèðóåòñÿ
-  è â îòëàäî÷íóþ èíôîðìàöèþ íå âêëþ÷àåòñÿ èíôîðìàöèÿ î debug.tpl.
+  Êîíñîëü îòëàäêè íå ðàáîòàåò, êîãäà èñïîëüçóåòñÿ ôóíêöèÿ API
+  <link linkend="api.fetch">fetch()</link>.
+  Íåîáõîäèìî èñïîëüçîâàòü òîëüêî ôóíêöèþ
+  <link linkend="api.display">display()</link>.
+  Îíà ãåíåðèðóåò javascript êîä âíà÷àëå êàæäîé ñãåíåðèðîâàííîé ñòðàíèöû.
+  Åñëè âàì íå íðàâèòñÿ javascript, ìîæíî îòðåäàòèðîâàòü debug.tpl äëÿ
+  èçìåíåíèÿ ñïîñîáà îòîáðàæåíèÿ ïî âàøåìó âêóñó.
+  Îòëàäî÷íàÿ èíôîðìàöèÿ íå êýøèðóåòñÿ è â îòëàäî÷íóþ èíôîðìàöèþ íå
+  âêëþ÷àåòñÿ èíôîðìàöèÿ î debug.tpl.
  </para>
 </note>
 <note>
@@ -32,6 +45,13 @@
   â ìèëëèñåêóíäàõ.
  </para>
 </note>
+<para>
+ Ñì. òàêæå
+ <link linkend="troubleshooting">Ðåøåíèå ïðîáëåì</link>,
+ <link linkend="variable.error.reporting">$error_reporting</link>
+ è
+ <link linkend="api.trigger.error">trigger_error()</link>.
+</para>
 </chapter>
 <!-- Keep this comment at the end of the file
 Local variables:
http://cvs.php.net/diff.php/smarty/docs/ru/designers/config-files.xml?r1=1.6&r2=1.7&ty=u
Index: smarty/docs/ru/designers/config-files.xml
diff -u smarty/docs/ru/designers/config-files.xml:1.6 smarty/docs/ru/designers/config-files.xml:1.7
--- smarty/docs/ru/designers/config-files.xml:1.6	Thu Nov 25 18:26:12 2004
+++ smarty/docs/ru/designers/config-files.xml	Sun Aug 28 12:51:14 2005
@@ -1,14 +1,14 @@
 <?xml version="1.0" encoding="windows-1251"?>
-<!-- $Revision: 1.6 $ -->
-<!-- EN-Revision: 1.4 Maintainer: freespace Status: ready -->
+<!-- $Revision: 1.7 $ -->
+<!-- EN-Revision: 1.7 Maintainer: freespace Status: ready -->
 <chapter id="config.files">
  <title>Êîíôèãóðàöèîííûå ôàéëû</title>
  <para>
   Ñ ïîìîùüþ êîíôèãóðàöèîííûõ ôàéëîâ äèçàéíåðó óäîáíî óïðàâëÿòü ãëîáàëüíûìè
   ïåðåìåííûìè èç îäíîãî ôàéëà. Íàïðèìåð, öâåòàìè â øàáëîíàõ. Îáû÷íî, åñëè
   âû õîòèòå ñìåíèòü öâåòóâóþ ñõåìó, òî íåîáõîäèìî ïðîñìîòðåòü êàæäûé øàáëîí
-  è â êàæäîì èçìåíèòü öâåòà. Ñ ïîìîùüþ ôàéëà êîíôèãóðàöèè âñå öâåòà ìîãóò áûòü
-  âûíåñåíû â îòäåëüíûé ôàéë è òîëüêî îäèí ôàéë íàäî áóäåò èñïðàâëÿòü.
+  è â êàæäîì èçìåíèòü öâåòà. Ñ ïîìîùüþ ôàéëà êîíôèãóðàöèè âñå öâåòà ìîãóò
+  áûòü âûíåñåíû â îòäåëüíûé ôàéë è òîëüêî îäèí ôàéë íàäî áóäåò èñïðàâëÿòü.
  </para>
  <example>
   <title>Ïðèìåð ôàéëà êîíôèãóðàöèè</title>
@@ -37,15 +37,17 @@
 user=php-user
 pass=foobar
 ]]>
-</programlisting>
+  </programlisting>
  </example>
  <para>
-  Çíà÷åíèÿ ïåðåìåííûõ ìîãóò çàêëþ÷àòüñÿ â êàâû÷êè, íî ýòî íå îáÿçàòåëüíî.
-  Ìîæíî èñïîëüçîâàòü êàê äâîéíûå, òàê è îäèíàðíûå êàâû÷êè. Åñëè ó âàñ åñòü
-  çíà÷åíèå, êîòîðîå çàíèìàåò áîëüøå, ÷åì îäíó ñòðîêó, íåîáõîäèìî çàêëþ÷èòü
-  åãî â òðîéíûå êàâû÷êè ("""). Ìîæíî âêëþ÷àòü êîììåíòàðèè â ôàéë êîíôèãóðàöèè
-  èñïîëüçóÿ ëþáîé ñèíòàêèñ, êîòîðûé íå ÿâëÿåòñÿ äîïóñòèìûì ñèíòàêñèñîì
-  ôàéëîâ êîíôèãóðàöèè. Ðåêîìåíäóåòñÿ èñïîëüçîâàòü ñèìâîë <literal>#</literal>
+  Çíà÷åíèÿ <link linkend="language.config.variables">ïåðåìåííûõ â
+  êîíôèãóðàöèîííûõ ôàéëàõ</link> ìîãóò çàêëþ÷àòüñÿ â êàâû÷êè, íî ýòî íå
+  îáÿçàòåëüíî. Ìîæíî èñïîëüçîâàòü êàê äâîéíûå, òàê è îäèíàðíûå êàâû÷êè.
+  Åñëè ó âàñ åñòü çíà÷åíèå, êîòîðîå çàíèìàåò áîëüøå, ÷åì îäíó ñòðîêó,
+  íåîáõîäèìî çàêëþ÷èòü åãî â òðîéíûå êàâû÷êè (""").
+  Ìîæíî âêëþ÷àòü êîììåíòàðèè â ôàéë êîíôèãóðàöèè èñïîëüçóÿ ëþáîé ñèíòàêèñ,
+  êîòîðûé íå ÿâëÿåòñÿ äîïóñòèìûì ñèíòàêñèñîì ôàéëîâ êîíôèãóðàöèè.
+  Äëÿ ýòèõ öåëåé ðåêîìåíäóåòñÿ èñïîëüçîâàòü ñèìâîë <literal>#</literal>
   (hash) â íà÷àëå ñòðîêè.
  </para>
  <para>
@@ -62,7 +64,9 @@
  </para>
  <para>
   Ôàéëû êîíôèãóðàöèè çàãðóæàþòñÿ â øàáëîí â ïîìîùüþ ôóíêöèè
-  <command>config_load</command>.
+  <link linkend="language.function.config.load"><command>
+  {config_load}</command></link> (ñì. òàêæå <link
+  linkend="api.config.load"><command>config_load()</command></link>).
  </para>
  <para>
   Ìîæíî ñïðÿòàòü îòäåëüíûå ïåðåìåííûå èëè öåëûå ñåêöèè, äîáàâèâ ê íàçâàíèþ
@@ -71,6 +75,14 @@
   ðåäàêòèðîâàòü òðåòüè ëèöà, òî âû ìîæåòå áûòü ñïîêîéíû çà öåííóþ èíôîðìàöèþ
   èç ôàéëîâ êîíôèãóðàöèé: îíè íå ñìîãóò åå çàãðóçèòü â øàáëîí.
  </para>
+ <para>
+  Ñì. òàêæå <link
+  linkend="language.function.config.load">{config_load}</link>, <link
+  linkend="variable.config.overwrite">$config_overwrite</link>, <link
+  linkend="api.get.config.vars">get_config_vars()</link>, <link
+  linkend="api.clear.config">clear_config()</link> è <link
+  linkend="api.config.load">config_load()</link>
+ </para>
 </chapter>
 <!-- Keep this comment at the end of the file
 Local variables:
http://cvs.php.net/diff.php/smarty/docs/ru/designers/language-combining-modifiers.xml?r1=1.6&r2=1.7&ty=u
Index: smarty/docs/ru/designers/language-combining-modifiers.xml
diff -u smarty/docs/ru/designers/language-combining-modifiers.xml:1.6 smarty/docs/ru/designers/language-combining-modifiers.xml:1.7
--- smarty/docs/ru/designers/language-combining-modifiers.xml:1.6	Thu Nov 25 18:26:12 2004
+++ smarty/docs/ru/designers/language-combining-modifiers.xml	Sun Aug 28 12:51:14 2005
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="windows-1251"?>
-<!-- $Revision: 1.6 $ -->
-<!-- EN-Revision: 1.4 Maintainer: tony2001 Status: ready -->
+<!-- $Revision: 1.7 $ -->
+<!-- EN-Revision: 1.6 Maintainer: freespace Status: ready -->
 <chapter id="language.combining.modifiers">
  <title>Êîìáèíèðîâàíèå ìîäèôèêàòîðîâ</title>
  <para>
@@ -12,15 +12,18 @@
   <title>Êîìáèíèðîâàíèå ìîäèôèêàòîðîâ</title>
   <programlisting role="php">
 <![CDATA[
-index.php:
 <?php
-$smarty = new Smarty;
-$smarty->assign('articleTitle', 'Smokers are Productive, but Death Cuts Efficiency.');
-$smarty->display('index.tpl');
-?>
 
-index.tpl:
+$smarty->assign('articleTitle', 'Êàïëÿ íèêîòèíà óáèâàåò ëîøàäü, õîìÿ÷êà ðàçðûâàåò íà êóñêè.');
 
+?>
+]]>
+  </programlisting>
+  <para>
+   Ñîäåðæèìîå øàáëîíà:
+  </para>
+  <programlisting>
+<![CDATA[
 {$articleTitle}
 {$articleTitle|upper|spacify}
 {$articleTitle|lower|spacify|truncate}
@@ -33,11 +36,11 @@
  </para>
  <screen>
 <![CDATA[
-Smokers are Productive, but Death Cuts Efficiency.
-S M O K E R S   A R E   P R O D U C T I V E ,   B U T   D E A T H   C U T S   E F F I C I E N C Y .
-s m o k e r s   a r e   p r o d u c t i v e ,   b u t   d e a t h   c u t s...
-s m o k e r s   a r e   p r o d u c t i v e ,   b u t . . .
-s m o k e r s   a r e   p. . .
+Êàïëÿ íèêîòèíà óáèâàåò ëîøàäü, õîìÿ÷êà ðàçðûâàåò íà êóñêè.
+Ê À Ï Ë ß   Í È Ê Î Ò È Í À ...âûðåçàíî... Â À Å Ò   Í À   Ê Ó Ñ Ê È .
+ê à ï ë ÿ   í è ê î ò è í à ...âûðåçàíî... õ î ì ÿ ÷ ê à...
+ê à ï ë ÿ   í è ê î ò è í à   ó á è â à å ò   ë î ø à ä ü . . .
+ê à ï ë ÿ   í è ê î ò è í. . .
 ]]>
   </screen>
  </example>
http://cvs.php.net/diff.php/smarty/docs/ru/designers/language-modifiers.xml?r1=1.7&r2=1.8&ty=u
Index: smarty/docs/ru/designers/language-modifiers.xml
diff -u smarty/docs/ru/designers/language-modifiers.xml:1.7 smarty/docs/ru/designers/language-modifiers.xml:1.8
--- smarty/docs/ru/designers/language-modifiers.xml:1.7	Mon May  9 13:34:35 2005
+++ smarty/docs/ru/designers/language-modifiers.xml	Sun Aug 28 12:51:14 2005
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="windows-1251"?>
-<!-- $Revision: 1.7 $ -->
-<!-- EN-Revision: 1.16 Maintainer: freespace Status: ready -->
+<!-- $Revision: 1.8 $ -->
+<!-- EN-Revision: 1.18 Maintainer: freespace Status: ready -->
 <chapter id="language.modifiers">
  <title>Ìîäèôèêàòîðû ïåðåìåííûõ</title>
  <para>
@@ -44,27 +44,36 @@
   êîëè÷åñòâî åëåìåíòîâ â ìàññèâå $articleTitle.
  </para>
 
-&designers.language-modifiers.language-modifier-cat;
-&designers.language-modifiers.language-modifier-capitalize;
-&designers.language-modifiers.language-modifier-count-characters;
-&designers.language-modifiers.language-modifier-count-paragraphs;
-&designers.language-modifiers.language-modifier-count-sentences;
-&designers.language-modifiers.language-modifier-count-words;
-&designers.language-modifiers.language-modifier-date-format;
-&designers.language-modifiers.language-modifier-default;
-&designers.language-modifiers.language-modifier-escape;
-&designers.language-modifiers.language-modifier-indent;
-&designers.language-modifiers.language-modifier-lower;
-&designers.language-modifiers.language-modifier-nl2br;
-&designers.language-modifiers.language-modifier-regex-replace;
-&designers.language-modifiers.language-modifier-replace;
-&designers.language-modifiers.language-modifier-spacify;
-&designers.language-modifiers.language-modifier-string-format;
-&designers.language-modifiers.language-modifier-strip;
-&designers.language-modifiers.language-modifier-strip-tags;
-&designers.language-modifiers.language-modifier-truncate;
-&designers.language-modifiers.language-modifier-upper;
-&designers.language-modifiers.language-modifier-wordwrap;
+ <para>
+  Ñì. òàêæå
+  <link linkend="api.register.modifier">register_modifier()</link>,
+  <link linkend="api.register.function">register_function()</link>,
+  <link linkend="plugins">Ïëàãèíû - ðàñøèðåíèå ôóíêöèîíàëüíîñòè Smarty</link>
+  è
+  <link linkend="plugins.modifiers">ìîäèôèêàòîðû</link>,
+ </para>
+
+ &designers.language-modifiers.language-modifier-capitalize;
+ &designers.language-modifiers.language-modifier-cat;
+ &designers.language-modifiers.language-modifier-count-characters;
+ &designers.language-modifiers.language-modifier-count-paragraphs;
+ &designers.language-modifiers.language-modifier-count-sentences;
+ &designers.language-modifiers.language-modifier-count-words;
+ &designers.language-modifiers.language-modifier-date-format;
+ &designers.language-modifiers.language-modifier-default;
+ &designers.language-modifiers.language-modifier-escape;
+ &designers.language-modifiers.language-modifier-indent;
+ &designers.language-modifiers.language-modifier-lower;
+ &designers.language-modifiers.language-modifier-nl2br;
+ &designers.language-modifiers.language-modifier-regex-replace;
+ &designers.language-modifiers.language-modifier-replace;
+ &designers.language-modifiers.language-modifier-spacify;
+ &designers.language-modifiers.language-modifier-string-format;
+ &designers.language-modifiers.language-modifier-strip;
+ &designers.language-modifiers.language-modifier-strip-tags;
+ &designers.language-modifiers.language-modifier-truncate;
+ &designers.language-modifiers.language-modifier-upper;
+ &designers.language-modifiers.language-modifier-wordwrap;
 
 </chapter>
 <!-- Keep this comment at the end of the file
http://cvs.php.net/diff.php/smarty/docs/ru/designers/language-variables.xml?r1=1.5&r2=1.6&ty=u
Index: smarty/docs/ru/designers/language-variables.xml
diff -u smarty/docs/ru/designers/language-variables.xml:1.5 smarty/docs/ru/designers/language-variables.xml:1.6
--- smarty/docs/ru/designers/language-variables.xml:1.5	Thu Nov 25 18:26:12 2004
+++ smarty/docs/ru/designers/language-variables.xml	Sun Aug 28 12:51:14 2005
@@ -1,18 +1,30 @@
 <?xml version="1.0" encoding="windows-1251"?>
-<!-- $Revision: 1.5 $ -->
-<!-- EN-Revision: 1.5 Maintainer: tony2001 Status: ready -->
+<!-- $Revision: 1.6 $ -->
+<!-- EN-Revision: 1.6 Maintainer: freespace Status: ready -->
 <chapter id="language.variables">
  <title>Ïåðåìåííûå</title>
  <para>
   Smarty èìååò íåñêîëüêî ðàçëè÷íûõ òèïîâ ïåðåìåííûõ. Îí çàâèñèò îò
   ñèìâîëà, ñ êîòîðîãî íà÷èíàåòñÿ, èëè â êàêîé çàêëþ÷åíà ïåðåìåííàÿ.
  </para>
-
  <para>
-  Ïåðåìåííûå â Smarty ìîãóò áûòü îòîáðàæåíû èëè èñïîëüçîâàíû êàê àðãóìåíòû
-  ôóíêöèé è ìîäèôèêàòîðîâ, âíóòðè âûðàæåíèé óñëîâíûõ îïåðàòîðîâ è ò.ä. Äëÿ
-  âûâîäà çíà÷åíèÿ ïåðåìåííîé íàäî ïðîñòî óêàçàòü ìåæäó ðàçäåëèòåëÿìè èìÿ
-  ïåðåìåííîé.
+  Variables in Smarty can be either displayed directly or used as arguments
+  for <link linkend="language.syntax.functions">function</link>
+  <link linkend="language.syntax.attributes">attributes</link> and
+  <link linkend="language.modifiers">modifiers</link>, inside conditional expressions,
+  etc. To print a variable, simply enclose it in the
+  <link linkend="variable.left.delimiter">delimiters</link> so that it
+  is the only thing contained between them. Examples:
+ 
+ 
+  Ïåðåìåííûå â Smarty ìîãóò áûòü îòîáðàæåíû èëè èñïîëüçîâàíû êàê
+  <link linkend="language.syntax.attributes">àðãóìåíòû</link>
+  <link linkend="language.syntax.functions">ôóíêöèé</link> è
+  <link linkend="language.modifiers">ìîäèôèêàòîðîâ</link>,
+  âíóòðè âûðàæåíèé óñëîâíûõ îïåðàòîðîâ è ò.ä. Äëÿ
+  âûâîäà çíà÷åíèÿ ïåðåìåííîé íåîáõîäèìî óêàçàòü èìÿ ïåðåìåííîé
+  ìåæäó <link linkend="variable.left.delimiter">ðàçäåëèòåëÿìè</link>.
+  Ïðèìåðû:
   <programlisting>
 <![CDATA[[
 {$Name}
@@ -24,9 +36,9 @@
   </programlisting>
  </para>
 
-&designers.language-variables.language-assigned-variables;
-&designers.language-variables.language-config-variables;
-&designers.language-variables.language-variables-smarty;
+ &designers.language-variables.language-assigned-variables;
+ &designers.language-variables.language-config-variables;
+ &designers.language-variables.language-variables-smarty;
 
 </chapter>
 <!-- Keep this comment at the end of the file
http://cvs.php.net/diff.php/smarty/docs/ru/designers/language-basic-syntax/language-escaping.xml?r1=1.2&r2=1.3&ty=u
Index: smarty/docs/ru/designers/language-basic-syntax/language-escaping.xml
diff -u smarty/docs/ru/designers/language-basic-syntax/language-escaping.xml:1.2 smarty/docs/ru/designers/language-basic-syntax/language-escaping.xml:1.3
--- smarty/docs/ru/designers/language-basic-syntax/language-escaping.xml:1.2	Fri Sep  3 14:34:19 2004
+++ smarty/docs/ru/designers/language-basic-syntax/language-escaping.xml	Sun Aug 28 12:51:14 2005
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="windows-1251"?>
-<!-- $Revision: 1.2 $ -->
-<!-- EN-Revision: 1.3 Maintainer: tony2001 Status: ready -->
+<!-- $Revision: 1.3 $ -->
+<!-- EN-Revision: 1.6 Maintainer: freespace Status: ready -->
 <sect1 id="language.escaping">
  <title>Ïðåäîòâðàùåíèå îáðàáîòêè Smarty</title>
  <para>
@@ -8,7 +8,8 @@
   êîòîðàÿ äîëæíà ïî óìîë÷àíèþ îáðàáàòûâàòüñÿ. Êëàññè÷åñêèì ïðèìåðîì
   òàêîé ñèòóàöèè ÿâëÿåòñÿ âñòðàèâàíèå Javascript èëè CSS-êîäà â
   øàáëîí. Ïðîáëåìà ïîÿâëÿåòñÿ èç-çà òîãî, ÷òî ýòè ÿçûêè èñïîëüçóþò
-  ñèìâîëû { è }, êîòîðûå òàê æå èñïîëüçóþòñÿ â êà÷åñòâå ðàçäåëèòåëåé
+  ñèìâîëû { è }, êîòîðûå òàê æå èñïîëüçóþòñÿ â êà÷åñòâå
+  <link linkend="language.function.ldelim">ðàçäåëèòåëåé</link>
   äëÿ Smarty.
  </para>
 
@@ -23,9 +24,8 @@
   Ïîäîáíî òîìó, êàê âû èñïîëüçóåòå HTML-ñóùíîñòè (&amp;nbsp; è ò.ï.), âû ìîæåòå
   èñïîëüçîâàòü <link
   linkend="language.function.ldelim">{ldelim}</link>,<link
-  linkend="language.function.ldelim">{rdelim}</link> èäè <link
-  linkend="language.variables.smarty.ldelim">{$smarty.ldelim}</link>,<link
-  linkend="language.variables.smarty.rdelim">{$smarty.rdelim}</link>
+  linkend="language.function.ldelim">{rdelim}</link> èëè <link
+  linkend="language.variables.smarty.ldelim">{$smarty.ldelim}</link>
   äëÿ îòîáðàæåíèÿ òåêóùèõ ðàçäåëèòåëåé.
  </para>
 
@@ -56,15 +56,18 @@
   <programlisting>
 <![CDATA[
 <script language="javascript">
-var foo = <!--{$foo}-->;
-function dosomething() {
+  var foo = <!--{$foo}-->;
+  function dosomething() {
     alert("foo is " + foo);
-}
-dosomething();
+  }
+  dosomething();
 </script>
 ]]>
   </programlisting>
  </example>
+ <para>
+  Ñì. òàêæå <link linkend="language.modifier.escape">ìîäèôèêàòîð escape</link>
+ </para>
 </sect1>
 <!-- Keep this comment at the end of the file
 Local variables:
http://cvs.php.net/diff.php/smarty/docs/ru/designers/language-basic-syntax/language-math.xml?r1=1.1&r2=1.2&ty=u
Index: smarty/docs/ru/designers/language-basic-syntax/language-math.xml
diff -u smarty/docs/ru/designers/language-basic-syntax/language-math.xml:1.1 smarty/docs/ru/designers/language-basic-syntax/language-math.xml:1.2
--- smarty/docs/ru/designers/language-basic-syntax/language-math.xml:1.1	Tue Jul 27 02:34:53 2004
+++ smarty/docs/ru/designers/language-basic-syntax/language-math.xml	Sun Aug 28 12:51:14 2005
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="windows-1251"?>
-<!-- $Revision: 1.1 $ -->
-<!-- EN-Revision: 1.2 Maintainer: tony2001 Status: ready -->
+<!-- $Revision: 1.2 $ -->
+<!-- EN-Revision: 1.3 Maintainer: freespace Status: ready -->
 <sect1 id="language.math">
  <title>Àðèôìåòè÷åñêèå îïåðàöèè</title>
  <para>
@@ -26,6 +26,9 @@
 ]]>
   </programlisting>
  </example>
+ <para>
+  Ñì. òàêæå ôóíêöèþ <link linkend="language.function.math">{math}</link>.
+ </para>
 </sect1>
 <!-- Keep this comment at the end of the file
 Local variables:
http://cvs.php.net/diff.php/smarty/docs/ru/designers/language-basic-syntax/language-syntax-attributes.xml?r1=1.4&r2=1.5&ty=u
Index: smarty/docs/ru/designers/language-basic-syntax/language-syntax-attributes.xml
diff -u smarty/docs/ru/designers/language-basic-syntax/language-syntax-attributes.xml:1.4 smarty/docs/ru/designers/language-basic-syntax/language-syntax-attributes.xml:1.5
--- smarty/docs/ru/designers/language-basic-syntax/language-syntax-attributes.xml:1.4	Thu Nov 25 18:26:12 2004
+++ smarty/docs/ru/designers/language-basic-syntax/language-syntax-attributes.xml	Sun Aug 28 12:51:14 2005
@@ -1,38 +1,42 @@
 <?xml version="1.0" encoding="windows-1251"?>
-<!-- $Revision: 1.4 $ -->
-<!-- EN-Revision: 1.2 Maintainer: tony2001 Status: ready -->
+<!-- $Revision: 1.5 $ -->
+<!-- EN-Revision: 1.3 Maintainer: freespace Status: ready -->
 <sect1 id="language.syntax.attributes">
  <title>Ïàðàìåòðû</title>
  <para>
-  Áîëüøèíñòâî ôóíêöèé ïðèíèìàåò ïàðàìåòðû, êîòîðûå óòî÷íÿþò èëè
-  èçìåíÿþò åå ïîâåäåíèå. Ïàðàìåòðû â Smarty î÷åíü ïîõîæè íà
-  ïàðàìåòðû â HTML. Íå îáÿçàòåëüíî çàêëþ÷àòü ñòàòè÷åñêèå çíà÷åíèÿ
-  â êàâû÷êè, õîòÿ òåêñò ðåêîìåíäóåòñÿ çàêëþ÷àòü â êàâû÷êè. Ïåðåìåííûå
+  Áîëüøèíñòâî
+  <link linkend="language.syntax.functions">ôóíêöèé</link>
+  ïðèíèìàþò àðãóìåíòû, êîòîðûå óòî÷íÿþò èëè
+  èçìåíÿþò åå ïîâåäåíèå. Àðãóìåíòû â Smarty î÷åíü ïîõîæè íà
+  ïàðàìåòðû â HTML. Ñòàòè÷åñêèå çíà÷åíèÿ íå îáÿçàòåëüíî çàêëþ÷àòü
+  â êàâû÷êè, íî ýòî ðåêîìåíäóåòñÿ äëÿ òåêñòîâûõ ñòðîê. Ïåðåìåííûå
   òàêæå ìîãóò áûòü èñïîëüçîâàíû â êà÷åñòâå ïàðàìåòðîâ, è íå äîëæíû
   çàêëþ÷àòüñÿ â êàâû÷êè.
  </para>
  <para>
-  Íåêîòîðûå ïàðàìåòðû ïðèíèìàþò ëîãè÷åñêèå çíà÷åíèÿ (ïðàâäà èëè ëîæü).
+  Íåêîòîðûå ïàðàìåòðû ïðèíèìàþò ëîãè÷åñêèå çíà÷åíèÿ (true èëè false).
   Îíè ìîãóò áûòü óêàçàíû ñëîâàìè <literal>true</literal>,
-  <literal>on</literal>, è <literal>yes</literal>, èëè
-  <literal>false</literal>, <literal>off</literal>, è
+  <literal>on</literal> è <literal>yes</literal>, èëè
+  <literal>false</literal>, <literal>off</literal> è
   <literal>no</literal> áåç êàâû÷åê.
  </para>
  <example>
-  <title>Ñèíòàêñèñ ïàðàìåòðîâ ôóíêöèè</title>
+  <title>ñèíòàêñèñ ïàðàìåòðîâ ôóíêöèè</title>
   <programlisting>
 <![CDATA[
 {include file="header.tpl"}
 
+{include file="header.tpl" attrib_name="attrib value"}
+
 {include file=$includeFile}
 
-{include file=#includeFile#}
+{include file=#includeFile# title="Smarty is cool"}
 
 {html_select_date display_days=yes}
 
-<SELECT name=company>
-{html_options values=$vals selected=$selected output=$output}
-</SELECT>
+<select name="company">
+  {html_options options=$choices selected=$selected}
+</select>
 ]]>
   </programlisting>
  </example>
http://cvs.php.net/diff.php/smarty/docs/ru/designers/language-basic-syntax/language-syntax-comments.xml?r1=1.5&r2=1.6&ty=u
Index: smarty/docs/ru/designers/language-basic-syntax/language-syntax-comments.xml
diff -u smarty/docs/ru/designers/language-basic-syntax/language-syntax-comments.xml:1.5 smarty/docs/ru/designers/language-basic-syntax/language-syntax-comments.xml:1.6
--- smarty/docs/ru/designers/language-basic-syntax/language-syntax-comments.xml:1.5	Thu Nov 25 18:26:12 2004
+++ smarty/docs/ru/designers/language-basic-syntax/language-syntax-comments.xml	Sun Aug 28 12:51:14 2005
@@ -1,31 +1,40 @@
 <?xml version="1.0" encoding="windows-1251"?>
-<!-- $Revision: 1.5 $ -->
-<!-- EN-Revision: 1.2 Maintainer: tony2001 Status: ready -->
+<!-- $Revision: 1.6 $ -->
+<!-- EN-Revision: 1.3 Maintainer: freespace Status: ready -->
 <sect1 id="language.syntax.comments">
  <title>Êîììåíòàðèè</title>
  <para>
-  Êîììåíòàðèè â øàáëîíàõ çàêëþ÷àþòñÿ â çâåçäî÷êè(*) îêðóæåííûå .
-  ðàçäåëèòåëÿìè, íàïðèìåð: {* ýòî êîììåíòàðèé *}. Êîììåíòàðèè íå
-  îòîáðàæàþòñÿ â âûâîäå øàáëîíà. Îíè èñïîëüçóþòñÿ äëÿ âíóòðåííèõ
-  ïðèìå÷àíèé â øàáëîíàõ.
+  Êîììåíòàðèè â øàáëîíàõ çàêëþ÷àþòñÿ â çâåçäî÷êè (*) îêðóæåííûå
+  <link linkend="variable.left.delimiter">ðàçäåëèòåëÿìè</link>,
+  íàïðèìåð: {* ýòî êîììåíòàðèé *}.
+  Êîììåíòàðèè íå îòîáðàæàþòñÿ â âûâîäå øàáëîíà, â îòëè÷èå
+  îò &lt;!-- êîììåíòàðèåâ HTML --&gt;.
+  Îíè èñïîëüçóþòñÿ äëÿ âíóòðåííèõ ïðèìå÷àíèé â øàáëîíàõ.
  </para>
  <example>
   <title>Êîììåíòàðèè</title>
   <programlisting>
 <![CDATA[
-{* øàáëîí Smarty *}
+<body>
+{* ýòîò ìíîãîñòðî÷íûé êîììåíòàðèé
+   íå îòïðàâëÿåòñÿ â áðàçóåð
+*}
 
-{* ïîäêëþ÷àåì øàïêó øàáëîíà *}
+{* çäåñü âêëþ÷àåì çàãîëîâîê *}
 {include file="header.tpl"}
 
+
+{* Ïðèìå÷àíèå ðàçðàáîò÷èêà:  $includeFile íàçíà÷àåòñÿ â ñêðèïòå foo.php *}
+<!-- ýòîò html-êîììåíòàðèé áóäåò îòïðàâëåí áðàóçåðó -->
 {include file=$includeFile}
 
 {include file=#includeFile#}
 
-{* âûïàäàþùèé ñïèñîê *}
-<SELECT name=company>
-{html_options values=$vals selected=$selected output=$output}
-</SELECT>
+{* îòîáðàæàåì âûïàäàþùåå ìåíþ *}
+<select name="company">
+  {html_options options=$vals selected=$selected_id}
+</select>
+</body>
 ]]>
   </programlisting>
  </example>
http://cvs.php.net/diff.php/smarty/docs/ru/designers/language-basic-syntax/language-syntax-functions.xml?r1=1.6&r2=1.7&ty=u
Index: smarty/docs/ru/designers/language-basic-syntax/language-syntax-functions.xml
diff -u smarty/docs/ru/designers/language-basic-syntax/language-syntax-functions.xml:1.6 smarty/docs/ru/designers/language-basic-syntax/language-syntax-functions.xml:1.7
--- smarty/docs/ru/designers/language-basic-syntax/language-syntax-functions.xml:1.6	Mon May  9 13:34:37 2005
+++ smarty/docs/ru/designers/language-basic-syntax/language-syntax-functions.xml	Sun Aug 28 12:51:14 2005
@@ -1,13 +1,15 @@
 <?xml version="1.0" encoding="windows-1251"?>
-<!-- $Revision: 1.6 $ -->
-<!-- EN-Revision: 1.3 Maintainer: freespace Status: ready -->
+<!-- $Revision: 1.7 $ -->
+<!-- EN-Revision: 1.6 Maintainer: freespace Status: ready -->
 <sect1 id="language.syntax.functions">
  <title>Ôóíêöèè</title>
  <para>
   Êàæäûé òýã Smarty ëèáî âûâîäèò çíà÷åíèå <link
   linkend="language.variables">ïåðåìåííîé</link>, ëèáî âûçûâàåò
   íåêîòîðóþ ôóíêöèþ. Äëÿ âûçîâà ôóíêöèè íàäî çàêëþ÷èòü â ðàçäåëèòåëè
-  íàçâàíèå ôóíêöèè è åå ïàðàìåòðû, íàïðèìåð:
+  íàçâàíèå ôóíêöèè è åå
+  <link linkend="language.syntax.attributes">ïàðàìåòðû</link>,
+  íàïðèìåð:
   {funcname attr1="val" attr2="val"}.
  </para>
  <example>
@@ -29,17 +31,27 @@
    </programlisting>
  </example>
  <para>
-  È âñòðîåííûå, è ïîëüçîâàòåëüñêèå ôóíêöèè èñïîëüçóþòñÿ ñ îäèíàêîâûì
-  ñèíòàêñèñîì. Âñòðîåííûå ôóíêöèè ðåàëèçîâàíû âíóòðè Smarty è íå
-  ìîãóò áûòü èçìåíåíû èëè ïåðåîïðåäåëåíû. Ýòî òàêèå ôóíêöèè, êàê
-  <link linkend="language.function.if"><command>if</command></link>,
-  <link linkend="language.function.section"><command>section</command></link> è
-  <link linkend="language.function.strip"><command>strip</command></link>.
-  Ïîëüçîâàòåëüñêèå ôóíêöèè ðåàëèçóþòñÿ ÷åðåç
-  ïëàãèíû. Îíè ìîãóò áûòü èçìåíåíû ïî âàøåìó æåëàíèþ, òàêæå âû ìîæåòå
-  íàïèñàòü íîâûå. Ïðèìåðû ïîëüçîâàòåëüñêèõ ôóíêöèé:
-  <link linkend="language.function.html.options"><command>html_options</command></link> è
-  <link linkend="language.function.html.select.date"><command>html_select_date</command></link>.
+  È <link linkend="language.builtin.functions">âñòðîåííûå</link>,
+  è <link linkend="language.custom.functions">ïîëüçîâàòåëüñêèå ôóíêöèè</link>
+  èñïîëüçóþòñÿ ñ îäèíàêîâûì ñèíòàêñèñîì.
+ </para>
+ <para>
+  Âñòðîåííûå ôóíêöèè îáåñïå÷èâàþò
+  <emphasis role="bold">âíóòðåííþþ</emphasis> ðàáîòó Smarty, íàïðèìåð
+  <link linkend="language.function.if">{if}</link>,
+  <link linkend="language.function.section">{section}</link> è
+  <link linkend="language.function.strip">{strip}</link>.
+  Îíè íå ìîãóò áûòü ìîäèôèöèðîâàíû.
+ </para>
+ <para>
+  Ïîëüçîâàòåëüñêèå ôóíêöèè ÿâëÿþòñÿ
+  <emphasis role="bold">äîïîëíèòåëüíûìè</emphasis> è ðåàëèçóþòñÿ ÷åðåç
+  <link linkend="plugins">ïëàãèíû</link>.
+  Îíè ìîãóò áûòü èçìåíåíû ïî âàøåìó æåëàíèþ, òàêæå âû ìîæåòå
+  äîáàâèòü íîâûå.
+  Ïðèìåðàìè ïîëüçîâàòåëüñêèõ ôóíêöèé ìîãóò áûòü
+  <link linkend="language.function.html.options">{html_options}</link> è
+  <link linkend="language.function.popup">{popup}</link>.
  </para>
 </sect1>
 <!-- Keep this comment at the end of the file
http://cvs.php.net/diff.php/smarty/docs/ru/designers/language-basic-syntax/language-syntax-quotes.xml?r1=1.6&r2=1.7&ty=u
Index: smarty/docs/ru/designers/language-basic-syntax/language-syntax-quotes.xml
diff -u smarty/docs/ru/designers/language-basic-syntax/language-syntax-quotes.xml:1.6 smarty/docs/ru/designers/language-basic-syntax/language-syntax-quotes.xml:1.7
--- smarty/docs/ru/designers/language-basic-syntax/language-syntax-quotes.xml:1.6	Mon Dec 20 16:50:05 2004
+++ smarty/docs/ru/designers/language-basic-syntax/language-syntax-quotes.xml	Sun Aug 28 12:51:14 2005
@@ -1,15 +1,21 @@
 <?xml version="1.0" encoding="windows-1251"?>
-<!-- $Revision: 1.6 $ -->
-<!-- EN-Revision: 1.3 Maintainer: freespace Status: ready -->
+<!-- $Revision: 1.7 $ -->
+<!-- EN-Revision: 1.6 Maintainer: freespace Status: ready -->
 <sect1 id="language.syntax.quotes">
  <title>Âíåäðåííûå ïåðåìåííûå â äâîéíûõ êàâû÷êàõ</title>
  <para>
-  Smarty ðàñïîçíàåò ïåðåìåííûå, åñëè îíè âñòðå÷àþòñÿ â ñòðîêàõ, çàêëþ÷åííûõ â
-  äâîéíûå êàâû÷êè. Ðàñïîçíàþòñÿ ïåðåìåííûå, ñîñòîÿùèå èç ÷èñåë, áóêâ, ñèìâîëîâ
-  ïîä÷åðêèâàíèÿ è êâàäðàòíûõ êàâû÷åê. Åñëè íàäî èñïîëüçîâàòü äðóãèå ñèìâîëû
-  äëÿ îáîçíà÷åíèÿ ïåðåìåííîé (òî÷êà, óêàçàòåëü îáúåêòà è ò.ä.), òî ïåðåìåííóþ
-  íåîáõîäèìî çàêëþ÷èòü â îáðàòíûå êàâû÷êè.  äàííîì ñëó÷àå âû íå ìîæåòå
-  èñïîëüçîâàòü ìîäèôèêàòîðû, èõ ñëåäóåò ïðèìåíÿòü âíå êàâû÷åê.
+  Smarty ðàñïîçíàåò
+  <link linkend="api.assign">ïðèñâîåííûå</link>
+  <link linkend="language.syntax.variables">ïåðåìåííûå</link>,
+  åñëè îíè âñòðå÷àþòñÿ â ñòðîêàõ, çàêëþ÷åííûõ â äâîéíûå êàâû÷êè,
+  åñëè ïåðåìåííûå ñîñòîÿò èç öèôð, áóêâ, çíàêà ïîä÷¸ðêèâàíèÿ è
+  êâàäðàòíûõ ñêîáîê.
+   ñëó÷àå, åñëè ïåðåìåííàÿ ñîäåðæèò äðóãèå ñèìâîëû
+  (òî÷êè, ññûêè íà îáúåêòû è ò.ä.), ïåðåìåííóþ íåîáõîäèìî çàêëþ÷èòü
+  â îáðàòíûå êàâû÷êè.
+   äàííîì ñëó÷àå âû íå ìîæåòå èñïîëüçîâàòü
+  <link linkend="language.modifiers">ìîäèôèêàòîðû</link>,
+  èõ ñëåäóåò ïðèìåíÿòü âíå êàâû÷åê.
  </para>
  <example>
   <title>Ñèíòàêñèñ âíåäðåííûõ ïåðåìåííûõ</title>
@@ -30,6 +36,9 @@
 ]]>
   </programlisting>
  </example>
+ <para>
+  Ñì. òàêæå <link linkend="language.modifier.escape">escape</link>.
+ </para>
 </sect1>
 <!-- Keep this comment at the end of the file
 Local variables:
http://cvs.php.net/diff.php/smarty/docs/ru/designers/language-basic-syntax/language-syntax-variables.xml?r1=1.2&r2=1.3&ty=u
Index: smarty/docs/ru/designers/language-basic-syntax/language-syntax-variables.xml
diff -u smarty/docs/ru/designers/language-basic-syntax/language-syntax-variables.xml:1.2 smarty/docs/ru/designers/language-basic-syntax/language-syntax-variables.xml:1.3
--- smarty/docs/ru/designers/language-basic-syntax/language-syntax-variables.xml:1.2	Tue Dec 14 18:44:02 2004
+++ smarty/docs/ru/designers/language-basic-syntax/language-syntax-variables.xml	Sun Aug 28 12:51:14 2005
@@ -1,15 +1,18 @@
 <?xml version="1.0" encoding="windows-1251"?>
-<!-- $Revision: 1.2 $ -->
-<!-- EN-Revision: 1.3 Maintainer: freespace Status: ready -->
+<!-- $Revision: 1.3 $ -->
+<!-- EN-Revision: 1.7 Maintainer: freespace Status: ready -->
 <sect1 id="language.syntax.variables">
  <title>Ïåðåìåííûå</title>
  <para>
-  Ïåðåìåííûå øàáëîíà íà÷èíàþòñÿ ñî çíàêà äîëëàðà. Îíè ìîãóò ñîñòîÿòü èç öèôð,
-  áóêâ, çíàêîâ ïîä÷¸ðêèâàíèÿ - êàê è îáû÷íûå ïåðåìåííûå PHP. Âû ìîæåòå
-  îáðàùàòüñÿ ê ìàññèâàì, èìåþùèì ÷èñëîâûå è íå÷èñëîâûå èíäåêñû. Âû òàêæå ìîæåòå
-  îáðàùàòüñÿ ê ñâîéñòâàì è ìåòîäàì îáúåêòîâ. Ïåðåìåííûå êîíôèãóðàöèîííîãî ôàéëà
+  Ïåðåìåííûå øàáëîíà íà÷èíàþòñÿ ñî çíàêà $äîëëàðà. Îíè ìîãóò ñîñòîÿòü èç öèôð,
+  áóêâ, çíàêîâ ïîä÷¸ðêèâàíèÿ - êàê è îáû÷íûå
+  <ulink url="&url.php-manual;language.variables">PHP variable</ulink>.
+  Âû ìîæåòå îáðàùàòüñÿ ê ìàññèâàì, èìåþùèì ÷èñëîâûå è íå÷èñëîâûå èíäåêñû.
+  Âû òàêæå ìîæåòå îáðàùàòüñÿ ê ñâîéñòâàì è ìåòîäàì îáúåêòîâ.
+  <link linkend="language.config.variables">Ïåðåìåííûå êîíôèãóðàöèîííîãî ôàéëà</link>
   - ýòî èñêëþ÷åíèÿ èç äîëëàðîâîãî ñèíòàêñèñà. Ê íèì ìîæíî îáðàùàòüñÿ, îêðóæèâ
-  èõ ðåøåòêàìè èëè âîñïîëüçîâàâøèñü ñïåöèàëüíîé ïåðåìåííîé $smarty.config.
+  èõ #ðåøåòêàìè# èëè âîñïîëüçîâàâøèñü ñïåöèàëüíîé ïåðåìåííîé
+  <link linkend="language.variables.smarty.config">$smarty.config</link>.
  </para>
  <example>
   <title>Ïåðåìåííûå</title>
@@ -24,6 +27,7 @@
 {#foo#}       <-- îòîáðàæàåò ïåðåìåííóþ "foo" êîíôèãóðàöèîííîãî ôàéëà
 {$smarty.config.foo} <-- ñèíîíèì äëÿ {#foo#}
 {$foo[bar]}   <-- ñèíòàêñèñ äîñòóïåí òîëüêî â öèêëå section, ñì. {section}
+{assign var=foo value="baa"}{$foo} <--  îòîáðàæàåò "baa", ñì. {assign}
 
 Òàêæå äîñòóïíî ìíîæåñòâî äðóãèõ êîìáèíàöèé
 
@@ -37,6 +41,10 @@
 ]]>
   </programlisting>
  </example>
+ <para>
+  Ñì. òàêæå <link linkend="language.variables.smarty">Çàðåçåðâèðîâàííàÿ ïåðåìåííàÿ $smarty</link>
+  è <link linkend="language.config.variables">Ïåðåìåííûå ôàéëîâ êîíôèãóðàöèè</link>.
+ </para>
 </sect1>
 <!-- Keep this comment at the end of the file
 Local variables:
http://cvs.php.net/diff.php/smarty/docs/ru/getting-started.xml?r1=1.11&r2=1.12&ty=u
Index: smarty/docs/ru/getting-started.xml
diff -u smarty/docs/ru/getting-started.xml:1.11 smarty/docs/ru/getting-started.xml:1.12
--- smarty/docs/ru/getting-started.xml:1.11	Thu Nov 25 18:26:12 2004
+++ smarty/docs/ru/getting-started.xml	Sun Aug 28 12:51:14 2005
@@ -1,13 +1,13 @@
 <?xml version="1.0" encoding="windows-1251"?>
-<!-- $Revision: 1.11 $ -->
-<!-- EN-Revision: 1.7 Maintainer: freespace Status: ready -->
+<!-- $Revision: 1.12 $ -->
+<!-- EN-Revision: 1.10 Maintainer: freespace Status: ready -->
 <part id="getting.started">
  <title>Ïðèñòóïàÿ ê ðàáîòå</title>
 
  <chapter id="what.is.smarty">
    <title>×òî òàêîå Smarty?</title>
    <para>
-    Smarty - ýòî êîìïèëèðóþùèé îáðàáîò÷èê øàáëîíîâ äëÿ PHP è íà PHP.
+    Smarty - ýòî êîìïèëèðóþùèé îáðàáîò÷èê øàáëîíîâ äëÿ PHP.
     Ãîâîðÿ áîëåå ÷åòêî, îí ïðåäîñòàâëÿåò îäèí èç èíñòðóìåíòîâ, êîòîðûå
     ïîçâîëÿåò äîáèòüñÿ îòäåëåíèÿ ïðèêëàäíîé ëîãèêè è äàííûõ îò
     ïðåäñòàâëåíèÿ. Ýòî î÷åíü óäîáíî â ñèòóàöèÿõ, êîãäà ïðîãðàììèñò è
@@ -78,55 +78,62 @@
     <listitem>
      <para>
       Âû ìîæåòå ñîçäàâàòü ïîëüçîâàòåëüñêèå <link
-      linkend="language.custom.functions">ôóíêöèè</link>
-      è <link
-      linkend="language.modifiers">ìîäèôèêàòîðû</link>, ÷òî äåëàåò ÿçûê
-      øàáëîíîâ ÷ðåçâû÷àéíî ðàñøèðÿåìûì.
+      linkend="language.custom.functions">ôóíêöèè</link> è
+      <link linkend="language.modifiers">ìîäèôèêàòîðû</link>,
+      ÷òî äåëàåò ÿçûê øàáëîíîâ ÷ðåçâû÷àéíî ðàñøèðÿåìûì.
      </para>
     </listitem>
     <listitem>
      <para>
-      Íàñòðàèâàåìûå ðàçäåëèòåëè òýãîâ øàáëîíà, òî åñòü âû ìîæåòå
-      èñïîëüçîâàòü {}, {{}}, &lt;!--{}--&gt;, è ò.ä.
+      Íàñòðàèâàåìûå
+      <link linkend="variable.left.delimiter">ðàçäåëèòåëè òýãîâ</link>
+      øàáëîíà, òî åñòü âû ìîæåòå èñïîëüçîâàòü {}, {{}}, &lt;!--{}--&gt;
+      è ò.ä.
      </para>
     </listitem>
     <listitem>
      <para>
-      Êîíñòðóêöèè if/elseif/else/endif êîíñòðóêöèè ïåðåäàþòñÿ îáðàáîò÷èêó PHP,
-      òàê ÷òî ñèíòàêñèñ âûðàæåíèÿ {if ...} ìîæåò áûòü íàñòîëüêî ïðîñòûì èëè
-      ñëîæíûì, íàñêîëüêî âàì óãîäíî.
+      Êîíñòðóêöèè
+      <link linkend="language.function.if">if/elseif/else/endif</link>
+      ïåðåäàþòñÿ îáðàáîò÷èêó PHP, òàê ÷òî ñèíòàêñèñ âûðàæåíèÿ {if ...} ìîæåò
+      áûòü íàñòîëüêî ïðîñòûì èëè ñëîæíûì, íàñêîëüêî âàì óãîäíî.
      </para>
     </listitem>
     <listitem>
      <para>
-      Äîïóñòèìî íåîãðàíè÷åííîå âëîæåíèå ñåêöèé, óñëîâèé è ò.ä.
+      Äîïóñòèìî íåîãðàíè÷åííîå âëîæåíèå
+      <link linkend="language.function.section">ñåêöèé</link>,
+      óñëîâèé è ò.ä.
      </para>
     </listitem>
     <listitem>
      <para>
-      Ñóùåñòâóåò âîçìîæíîñòü âêëþ÷åíèÿ PHP-êîäà ïðÿìî â âàø øàáëîí, îäíàêî
-      îáû÷íî â ýòîì íåò íåîáõîäèìîñòè (è ýòî íå ðåêîììåíäóåòñÿ), òàê êàê
-      äâèæîê âåñüìà ãèáîê è ðàñøèðÿåì.
+      Ñóùåñòâóåò âîçìîæíîñòü
+      <link linkend="language.function.php">âêëþ÷åíèÿ PHP-êîäà</link>
+      ïðÿìî â âàø øàáëîí, îäíàêî îáû÷íî â ýòîì íåò íåîáõîäèìîñòè
+      (è ýòî íå ðåêîììåíäóåòñÿ), òàê êàê äâèæîê âåñüìà ãèáîê è ðàñøèðÿåì.
      </para>
     </listitem>
     <listitem>
      <para>
-      Âñòðîåííûé ìåõàíèçì êýøèðîâàíèÿ.
+      Âñòðîåííûé ìåõàíèçì <link linkend="caching">êýøèðîâàíèÿ</link>.
      </para>
     </listitem>
     <listitem>
      <para>
-      Ïðîèçâîëüíûå èñòî÷íèêè øàáëîíîâ.
+      Ïðîèçâîëüíûå èñòî÷íèêè
+      <link linkend="template.resources">øàáëîíîâ</link>.
      </para>
     </listitem>
     <listitem>
      <para>
-      Ïîëüçîâàòåëüñêèå ôóíêöèè êýøèðîâàíèÿ.
+      Ïîëüçîâàòåëüñêèå ôóíêöèè
+      <link linkend="section.template.cache.handler.func">êýøèðîâàíèÿ</link>.
      </para>
     </listitem>
     <listitem>
      <para>
-      Êîìïîíåíòíàÿ àðõèòåêòóðà.
+      <link linkend="plugins">Êîìïîíåíòíàÿ</link> àðõèòåêòóðà.
      </para>
     </listitem>
    </itemizedlist>
@@ -151,24 +158,25 @@
      Smarty äî íîâîé âåðñèè.
     </para>
     <example>
-     <title>Ôàéëû áèáëèîòåêè Smarty</title>
+     <title>Íåîáõîäèìûå ôàéëû áèáëèîòåêè Smarty</title>
      <screen>
 <![CDATA[
 Smarty.class.php
 Smarty_Compiler.class.php
 Config_File.class.php
 debug.tpl
-/plugins/*.php (âñå ôàéëû)
 /internals/*.php (âñå ôàéëû)
+/plugins/*.php (âñå ôàéëû, íî îòäåëüíîìó ñàéòó ìîãóò ïîíàäîáèòüñÿ íå âñå)
 ]]>
      </screen>
     </example>
     <para>
-     Smarty èñïîëüçóåò êîíñòàíòó PHP <link
-     linkend="constant.smarty.dir">SMARTY_DIR</link>, êîòîðàÿ óêàçûâàåò ïóòü ê
-     äèðåêòîðèè áèáëèîòåêè Smarty. Îáû÷íî, åñëè ïðèëîæåíèå ìîæåò íàéòè ôàéë
-     <filename>Smarty.class.php</filename>, òî íåò íåîáõîäèìîñòè óñòàíàâëèâàòü
-     SMARTY_DIR. Îäíàêî, åñëè <filename>Smarty.class.php</filename> íå ìîæåò
+     Smarty èñïîëüçóåò êîíñòàíòó PHP
+     <link linkend="constant.smarty.dir">SMARTY_DIR</link>, êîòîðàÿ óêàçûâàåò
+     ïóòü ê äèðåêòîðèè 'libs/' Smarty. Îáû÷íî, åñëè âàøå ïðèëîæåíèå ìîæåò
+     íàéòè ôàéë <filename>Smarty.class.php</filename>, òî íåò íåîáõîäèìîñòè
+     óñòàíàâëèâàòü SMARTY_DIR - Smarty ñàì âî âñ¸ì ðàçáåð¸òñÿ. Îäíàêî, åñëè
+     <filename>Smarty.class.php</filename> íå ìîæåò
      áûòü íàéäåí â âàøåì include_path èëè âû íå óêàçûâàëè àáñîëþòíûé ïóòü ê
      íåìó â ïðèëîæåíèè, òî âû äîëæíû îïðåäåëèòü SMARTY_DIR âðó÷íóþ.
      SMARTY_DIR <emphasis>äîëæåí</emphasis> âêëþ÷àòü çàâåðøàþùèé ñëýø.
@@ -238,14 +246,20 @@
      Òåïåðü, êîãäà âñå ôàéëû íàõîäÿòñÿ íà ñâîèõ ìåñòàõ, ïðèøëî âðåìÿ
      óñòàíîâêè äèðåêòîðèé Smarty â âàøåì ïðèëîæåíèè. Smarty òðåáóåò
      ÷åòûðå äèðåêòîðèè, êîòîðûå (ïî óìîë÷àíèþ) íàçûâàþòñÿ
-     <filename class="directory">templates</filename>,
-     <filename class="directory">templates_c</filename>,
-     <filename class="directory">configs</filename> è
-     <filename class="directory">cache</filename>. Êàæäàÿ èç
+      <filename class="directory">'templates/'</filename>,
+     <filename class="directory">'templates_c/'</filename>,
+     <filename class="directory">'configs/'</filename> è
+     <filename class="directory">'cache/'</filename>. Êàæäàÿ èç
      íèõ îïðåäåëÿåòñÿ ñâîéñòâàìè êëàññà Smarty:
-     <varname>$template_dir</varname>, <varname>$compile_dir</varname>,
-     <varname>$config_dir</varname> è <varname>$cache_dir</varname>
-     ñîîòâåòñòâåííî. Íàñòîé÷èâî ðåêîìåíäóåòñÿ èñïîëüçîâàòü ðàçíûå íàáîðû
+     <link linkend="variable.template.dir">
+     <varname>$template_dir</varname></link>,
+     <link linkend="variable.compile.dir">
+     <varname>$compile_dir</varname></link>,
+     <link linkend="variable.config.dir">
+     <varname>$config_dir</varname></link> è
+     <link linkend="variable.cache.dir">
+     <varname>$cache_dir</varname></link> ñîîòâåòñòâåííî.
+     Íàñòîé÷èâî ðåêîìåíäóåòñÿ èñïîëüçîâàòü ðàçíûå íàáîðû
      ýòèõ äèðåêòîðèé äëÿ êàæäîãî ïðèëîæåíèÿ, èñïîëüçóþùåãî Smarty.
     </para>
     <para>
@@ -270,7 +284,7 @@
    <para>
     Âàì ïîíàäîáèòñÿ êàê ìèíèìóì îäèí ôàéë â êîðíåâîé äèðåêòîðèè äëÿ äîêóìåíòîâ
     - ýòî ñêðèïò, ê êîòîðîìó îáðàùàåòñÿ âåá-áðàóçåð. Ìû íàçîâ¸ì íàø ñêðèïò
-    <filename>index.php</filename> è ïîìåñòèì åãî â ïîääèðåêòîðèþ
+    <emphasis>'index.php'</emphasis> è ïîìåñòèì åãî â ïîääèðåêòîðèþ
     <filename class="directory">/guestbook/</filename> êîðíåâîé äèðåêòîðèè
     äëÿ äîêóìåíòîâ.
    </para>
@@ -278,12 +292,18 @@
    <note>
     <title>Òåõíè÷åñêîå çàìå÷àíèå</title>
     <para>
-     Áûâàåò óäîáíî íàñòðîèòü âåá-ñåðâåð òàê, ÷òîáû "index.php" ðàñöåíèâàëñÿ
+     Áûâàåò óäîáíî íàñòðîèòü âåá-ñåðâåð òàê, ÷òîáû 'index.php' ðàñöåíèâàëñÿ
      êàê èíäåêñíûé ôàéë äèðåêîòðèè ïî óìîë÷àíèþ, ÷òîáû ïðè çàïðîñå ñòðàíèöû
-     "http://www.example.com/guestbook/", âûçûâàëñÿ ñêðèïò index.php áåç
-     "index.php" â êîíöå àäðåñíîé ñòðîêè. Â âåá-ñåðâåðå Apache âû ìîæåòå
-     íàñòðîèòü ýòî, äîáàâèâ "index.php" â êîíåö äèðåêòèâû DirectoryIndex
-     (çàïèñè ðàçäåëÿþòñÿ ïðîáåëàìè).
+     http://www.example.com/guestbook/, âûçûâàëñÿ ñêðèïò 'index.php' áåç
+     'index.php' â êîíöå àäðåñíîé ñòðîêè. Â âåá-ñåðâåðå Apache âû ìîæåòå
+     íàñòðîèòü ýòî, äîáàâèâ "index.php" â êîíåö äèðåêòèâû
+     <emphasis>DirectoryIndex</emphasis> (çàïèñè ðàçäåëÿþòñÿ ïðîáåëàìè),
+     êàê â ïðèìåðå èç httpd.conf
+    </para>
+    <para>
+    <emphasis>DirectoryIndex
+    index.htm index.html index.php index.php3 default.html index.cgi
+    </emphasis>
     </para>
    </note>
 
@@ -313,10 +333,15 @@
    </example>
 
    <para>
-    Smarty ïîíàäîáÿòñÿ ïðàâà íà çàïèñü â <emphasis>$compile_dir</emphasis> è
-    <emphasis>$cache_dir</emphasis>, òàê ÷òî óáåäèòåñü, ÷òî ó âåá-ñåðâåðà
-    åñòü ýòè ïðàâà. Îáû÷íî ñåðâåð çàïóùåí îò èìåíè ïîëüçîâàòåëÿ "nobody" ãðóïïû
-    "nobody". Äëÿ ïîëüçîâàòåëåé OS X ïîëüçîâàòåëåì ïî óìîë÷àíèþ ÿâëÿåòñÿ "www"
+    Smarty ïîíàäîáÿòñÿ <emphasis role="bold">ïðàâà íà çàïèñü</emphasis>
+    (ïîëüçîâàòåëåé Windows ýòî íå êàñàåòñÿ) â
+    <link linkend="variable.compile.dir">
+    <emphasis>$compile_dir</emphasis></link> è
+    <link linkend="variable.cache.dir">
+    <emphasis>$cache_dir</emphasis></link>,
+    òàê ÷òî óáåäèòåñü, ÷òî ó âåá-ñåðâåðà åñòü ýòè ïðàâà.
+    Îáû÷íî ñåðâåð çàïóùåí îò èìåíè ïîëüçîâàòåëÿ "nobody" ãðóïïû "nobody".
+    Äëÿ ïîëüçîâàòåëåé OS X ïîëüçîâàòåëåì ïî óìîë÷àíèþ ÿâëÿåòñÿ "www"
     ãðóïïû "www". Åñëè âû èñïîëüçóåòå Apache, âû ìîæåòå çàãëÿíóòü â âàø ôàéë
     httpd.conf (êîòîðûé îáû÷íî ðàñïîëîæåí â "/usr/local/apache/conf/") ÷òîáû
     óçíàòü, êàêîé ïîëüçîâàòåëü è ãðóïïà èñïîëüçóþòñÿ.
@@ -346,8 +371,9 @@
    </note>
 
    <para>
-    Íàì íåîáõîäèìî ñîçäàòü ôàéë index.tpl, êîòîðû áóäåò çàãðóæàòüñÿ Smarty.
-    Îí áóäåò ðàñïîëîæåí â âàøåé $template_dir.
+    Íàì íåîáõîäèìî ñîçäàòü ôàéë 'index.tpl', êîòîðû áóäåò çàãðóæàòüñÿ Smarty.
+    Îí áóäåò ðàñïîëîæåí â âàøåé
+    <link linkend="variable.template.dir">$template_dir</link>.
    </para>
 
    <example>
@@ -365,17 +391,18 @@
    <note>
     <title>Òåõíè÷åñêîå çàìå÷àíèå</title>
     <para>
-     {* Smarty *} - ýòî êîììåíòàðèé øàáëîíà. Îí íå ÿâëÿåòñÿ îáÿçàòåëüíûì, íî
-     åãî ðàçìåùåíèå â íà÷àëå êàæäîãî øàáëîíà ÿâëÿåòñÿ õîðîøèì òîíîì.
-     Ýòî ïîçâîëÿåò ïðîùå ðàçëè÷àòü ôàéëû íåçàâèñèìî îò èõ ðàñøèðåíèÿ.
-     Ê ïðèìåðó, òåêñòîâûå ðåäàêòîðû ìîãóò óçíàâàòü ôàéë è âêëþ÷àòü îñîáåííóþ
-     ïîäñâåòêó ñèíòàêñèñà.
+     {* Smarty *} - ýòî
+     <link linkend="language.syntax.comments">êîììåíòàðèé</link> øàáëîíà.
+     Îí íå ÿâëÿåòñÿ îáÿçàòåëüíûì, íî åãî ðàçìåùåíèå â íà÷àëå êàæäîãî øàáëîíà
+     ÿâëÿåòñÿ õîðîøèì òîíîì. Ýòî ïîçâîëÿåò ïðîùå ðàçëè÷àòü ôàéëû íåçàâèñèìî
+     îò èõ ðàñøèðåíèÿ. Ê ïðèìåðó, òåêñòîâûå ðåäàêòîðû ìîãóò óçíàâàòü ýòîò
+     ôàéë è âêëþ÷àòü îñîáåííóþ ïîäñâåòêó ñèíòàêñèñà.
     </para>
    </note>
 
    <para>
-    Òåïåðü äàâàéòå îòðåäàêòèðóåì index.php. Ìû ñîçäàäèì ýêçåìïëÿð Smarty,
-    ïðèñâîèì çíà÷åíèå ïåðåìåííîé øàáëîíà è îòîáðàçèì ôàéë index.tpl.
+    Òåïåðü äàâàéòå îòðåäàêòèðóåì 'index.php'. Ìû ñîçäàäèì ýêçåìïëÿð Smarty,
+    ïðèñâîèì çíà÷åíèå ïåðåìåííîé øàáëîíà è îòîáðàçèì ôàéë 'index.tpl'.
     Â óñëîâèÿõ íàøåãî ïðèìåðà, ìû ïîìåñòèëè "/usr/local/lib/php/Smarty" â
     include_path. Óáåäèòåñü, ÷òî âû ñäåëàëè òî æå ñàìîå èëè èñïîëüçóåòå
     àáñîëþòíûå ïóòè.
http://cvs.php.net/diff.php/smarty/docs/ru/language-snippets.ent?r1=1.6&r2=1.7&ty=u
Index: smarty/docs/ru/language-snippets.ent
diff -u smarty/docs/ru/language-snippets.ent:1.6 smarty/docs/ru/language-snippets.ent:1.7
--- smarty/docs/ru/language-snippets.ent:1.6	Sat Nov  6 06:05:22 2004
+++ smarty/docs/ru/language-snippets.ent	Sun Aug 28 12:51:15 2005
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="windows-1251"?>
-<!-- $Revision: 1.6 $ -->
-<!-- EN-Revision: 1.2 Maintainer: freespace Status: ready -->
+<!-- $Revision: 1.7 $ -->
+<!-- EN-Revision: 1.5 Maintainer: freespace Status: ready -->
 
 <!ENTITY note.parameter.merge '<note>
  <title>Òåõíè÷åñêîå çàìå÷àíèå</title>
@@ -8,21 +8,28 @@
   Ïåðàìåòð <parameter>merge</parameter> ó÷èòûâàåò êëþ÷è ìàññèâà,
   ïîýòîìó åñëè âû îáúåäèíÿåòå ìàññèâû ñ ÷èñëîâûìè èíäåêñàìè, òî îíè ìîãóò
   íàëîæèòüñÿ äðóã íà äðóãà èëè ïðèâåñòè ê íåïîñëåäîâàòåëüíîìó ïîðÿäêó êëþ÷åé.
-  Ðåçóëüòàò îòëè÷àåòñÿ îò äåéñòâèÿ ôóíêöèè PHP array_merge(), êîòîðàÿ
-  çàíîâî íóìåðóåò ýëåìåíòû â ìàññèâå ñ ÷èñëîâîìè êëþ÷àìè.
+  Ðåçóëüòàò îòëè÷àåòñÿ îò äåéñòâèÿ ôóíêöèè PHP
+  <ulink url="&url.php-manual;array_merge">array_merge()</ulink>,
+  êîòîðàÿ çàíîâî íóìåðóåò ýëåìåíòû â ìàññèâå ñ ÷èñëîâîìè êëþ÷àìè.
  </para>
 </note>'>
 
 <!ENTITY parameter.compileid '<para>
   êà÷åñòâå íåîáÿçàòåëüíîãî òðåòüåãî àðãóìåíòà âû ìîæåòå ïåðåäàòü
- <parameter>compile_id</parameter>. Ýòî ïîëåçíî â ñëó÷àå, åñëè âû õîòèòå
+ <parameter>$compile_id</parameter>.
+ Ýòî ïîëåçíî â ñëó÷àå, åñëè âû õîòèòå
  ñêîìïèëèðîâàòü íåñêîëüêî ðàçëè÷íûõ âåðñèé îäíîãî øàáëîíà, íàïðèìåð
  íåñêîëüêî âåðñèé îäíîãî øàáëîíà íà ðàçíûõ ÿçûêàõ.
- Äðóãîå ïðèìåíåíèå compile_id ìîæíî íàéòè, åñëè âû èñïîëüçóåòå
- íåñêîëüêî $template_dir, íî òîëüêî îäíó $compile_dir.
+ Äðóãîå ïðèìåíåíèå
+ <parameter>$compile_id</parameter> ìîæíî íàéòè,
+ åñëè âû èñïîëüçóåòå íåñêîëüêî
+ <link linkend="variable.template.dir">$template_dir</link>,
+ íî òîëüêî îäíó
+ <link linkend="variable.compile.dir">$compile_dir</link>.
  Óñòàíàâëèâàéòå ñâîé <parameter>compile_id</parameter> äëÿ êàæäîé
- $template_dir, èíà÷å øàáëîíû ñ îäèíàêîâûìè èìåíàìè áóäóò çàïèñûâàòüñÿ
- ïîâåðõ äðóã-äðóãà. Òàêæå âû ìîæåòå îäèí ðàç óêàçàòü <link
- linkend="variable.compile.id">$compile_id</link>, âìåñòî òîãî, ÷òîáû êàæäûé
- ðàç ïåðåäàâàòü åãî ïðè âûçîâå ýòîé ôóíêöèè.
+ <link linkend="variable.template.dir">$template_dir</link>,
+ èíà÷å øàáëîíû ñ îäèíàêîâûìè èìåíàìè áóäóò ñîõðàíÿòüñÿ ïîâåðõ äðóã äðóãà.
+ Òàêæå âû ìîæåòå îäèí ðàç óêàçàòü
+ <link linkend="variable.compile.id">$compile_id</link>,
+ âìåñòî òîãî, ÷òîáû êàæäûé ðàç ïåðåäàâàòü åãî ïðè âûçîâå ýòîé ôóíêöèè.
 </para>'>
http://cvs.php.net/diff.php/smarty/docs/ru/preface.xml?r1=1.5&r2=1.6&ty=u
Index: smarty/docs/ru/preface.xml
diff -u smarty/docs/ru/preface.xml:1.5 smarty/docs/ru/preface.xml:1.6
--- smarty/docs/ru/preface.xml:1.5	Sat Nov  6 06:05:22 2004
+++ smarty/docs/ru/preface.xml	Sun Aug 28 12:51:15 2005
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="windows-1251"?>
-<!-- $Revision: 1.5 $ -->
-<!-- EN-Revision: 1.2 Maintainer: freespace Status: ready -->
+<!-- $Revision: 1.6 $ -->
+<!-- EN-Revision: 1.3 Maintainer: freespace Status: ready -->
  <preface id="preface">
   <title>Ïðåäèñëîâèå</title>
   <para>
@@ -71,7 +71,7 @@
    Ìû òàêæå çíàëè, êàê âñåîáúåìëþùå è íåïîíÿòíî ìîæåò âûãëÿäèòü ÿçûê PHP
    äëÿ ñðåäíåñòàòèñòè÷åñêîãî äèçàéíåðà, è ÷òî ýòî ìîæíî çàìàñêèðîâàòü
    ïðè ïîìîùè áîëåå ïðîñòîãî ñèíòàêñèñà øàáëîíîâ. À ïî÷åìó áû íàì
-   íå îáúåäèíèòü äâå ýòè ñèëû? Òàê è ðîäèëñÿ Smarty...
+   íå îáúåäèíèòü äâå ýòè ñèëû? Òàê è ðîäèëñÿ Smarty... :-)
   </para>
  </preface>
 
http://cvs.php.net/diff.php/smarty/docs/ru/programmers/plugins.xml?r1=1.12&r2=1.13&ty=u
Index: smarty/docs/ru/programmers/plugins.xml
diff -u smarty/docs/ru/programmers/plugins.xml:1.12 smarty/docs/ru/programmers/plugins.xml:1.13
--- smarty/docs/ru/programmers/plugins.xml:1.12	Thu Nov 25 18:26:13 2004
+++ smarty/docs/ru/programmers/plugins.xml	Sun Aug 28 12:51:15 2005
@@ -1,8 +1,8 @@
 <?xml version="1.0" encoding="windows-1251"?>
-<!-- $Revision: 1.12 $ -->
-<!-- EN-Revision: 1.5 Maintainer: tony2001 Status: ready -->
+<!-- $Revision: 1.13 $ -->
+<!-- EN-Revision: 1.5 Maintainer: freespace Status: ready -->
 <chapter id="plugins">
- <title>Ïëàãèíû - ðàñøèðåíèå ôóíêöèîíàëà Smarty</title>
+ <title>Ïëàãèíû - ðàñøèðåíèå ôóíêöèîíàëüíîñòè Smarty</title>
 
  <para>
   Àðõèòåêòóðà âåðñèè 2.0 ïîçâîëÿåò âíåäðÿòü ïëàãèíû, êîòîðûìè ÿâëÿþòñÿ