cvs: smarty /docs/ru/designers chapter-debugging-console.xml /docs/ru/programmers/caching caching-groups.xml /docs/ru/programmers/plugins plugins-block-functions.xml

http://cvs.php.net/diff.php/smarty/docs/ru/designers/chapter-debugging-console.xml?r1=1.4&r2=1.5&ty=u
Index: smarty/docs/ru/designers/chapter-debugging-console.xml
diff -u smarty/docs/ru/designers/chapter-debugging-console.xml:1.4 smarty/docs/ru/designers/chapter-debugging-console.xml:1.5
--- smarty/docs/ru/designers/chapter-debugging-console.xml:1.4	Mon Jul 19 09:11:23 2004
+++ smarty/docs/ru/designers/chapter-debugging-console.xml	Wed Sep  8 17:49:09 2004
@@ -1,13 +1,13 @@
 <?xml version="1.0" encoding="windows-1251"?>
-<!-- $Revision: 1.4 $ -->
-<!-- EN-Revision: 1.3 Maintainer: tony2001 Status: ready -->
+<!-- $Revision: 1.5 $ -->
+<!-- EN-Revision: 1.5 Maintainer: tony2001 Status: ready -->
 <chapter id="chapter.debugging.console">
  <title>Îòëàäî÷íàÿ êîíñîëü</title>
  <para>
    Smarty âêëþ÷åíà êîíñîëü äëÿ îòëàäêè. Êîíñîëü ïîçâîëÿåò óçíàòü âñå âêëþ÷åííûå
-  ôàéëû, ïðèñâîåííûå ïåðåìåííûå è íàñòðîéêè èç êîíôèãóðàöèîííûõ ôàéëîâ. 
-  Øàáëîí "debug.tpl", ïîñòàâëÿåìûé âìåñòå ñî Smarty, óïðàâëÿåò âèäîì êîíñîëè. 
-  Óñòàíîâèòå îïöèþ Smarty $debugging â true è, åñëè íàäî, óêàæèòå â $debug_tpl ïóòü 
+  ôàéëû, ïðèñâîåííûå ïåðåìåííûå è íàñòðîéêè èç êîíôèãóðàöèîííûõ ôàéëîâ.
+  Øàáëîí "debug.tpl", ïîñòàâëÿåìûé âìåñòå ñî Smarty, óïðàâëÿåò âèäîì êîíñîëè.
+  Óñòàíîâèòå îïöèþ Smarty $debugging â true è, åñëè íàäî, óêàæèòå â $debug_tpl ïóòü
   ê øàáëîíó debug.tpl (ïî óìîë÷àíèþ ýòî SMARTY_DIR).
   Êîãäà âû çàãðóæàåòå ñòðàíèöó, äîëæíî ïîÿâèòüñÿ âñïëûâàþùèå îêíî è âûâåñòè êîíñîëü
   îòëàäêè. Äëÿ âûâîäà äîñòóïíûõ ïåðåìåííûõ èç êîíêðåòíîãî øàáëîíà, ñì. ôóíêöèþ
@@ -18,10 +18,10 @@
  </para>
 <note>
  <para>
-  Êîíñîëü îòëàäêè íå ðàáîòàåò, êîãäà èñïîëüçóåòñÿ ôóíêöèÿ API fetch(). 
-  Íåîáõîäèìî èñïîëüçîâàòü òîëüêî ôóíêöèþ display(). Îíà ãåíåðèðóåò 
-  javascript êîä âíà÷àëå êàæäîé ñãåíåðèðîâàííîé ñòðàíèöû. Åñëè âàì íå 
-  íðàâèòñÿ javascript, ìîæíî îòðåäàòèðîâàòü debug.tpl äëÿ èçìåíåíèÿ 
+  Êîíñîëü îòëàäêè íå ðàáîòàåò, êîãäà èñïîëüçóåòñÿ ôóíêöèÿ API fetch().
+  Íåîáõîäèìî èñïîëüçîâàòü òîëüêî ôóíêöèþ display(). Îíà ãåíåðèðóåò
+  javascript êîä âíà÷àëå êàæäîé ñãåíåðèðîâàííîé ñòðàíèöû. Åñëè âàì íå
+  íðàâèòñÿ javascript, ìîæíî îòðåäàòèðîâàòü debug.tpl äëÿ èçìåíåíèÿ
   ñïîñîáà îòîáðàæåíèÿ ïî âàøåìó âêóñó. Îòëàäî÷íàÿ èíôîðìàöèÿ íå êýøèðóåòñÿ
   è â îòëàäî÷íóþ èíôîðìàöèþ íå âêëþ÷àåòñÿ èíôîðìàöèÿ î debug.tpl.
  </para>
http://cvs.php.net/diff.php/smarty/docs/ru/programmers/caching/caching-groups.xml?r1=1.3&r2=1.4&ty=u
Index: smarty/docs/ru/programmers/caching/caching-groups.xml
diff -u smarty/docs/ru/programmers/caching/caching-groups.xml:1.3 smarty/docs/ru/programmers/caching/caching-groups.xml:1.4
--- smarty/docs/ru/programmers/caching/caching-groups.xml:1.3	Mon Jul 19 09:11:35 2004
+++ smarty/docs/ru/programmers/caching/caching-groups.xml	Wed Sep  8 17:49:09 2004
@@ -1,13 +1,38 @@
 <?xml version="1.0" encoding="windows-1251"?>
-<!-- $Revision: 1.3 $ -->
-<!-- EN-Revision: 1.2 Maintainer: tony2001 Status: ready -->
+<!-- $Revision: 1.4 $ -->
+<!-- EN-Revision: 1.3 Maintainer: tony2001 Status: ready -->
 <sect1 id="caching.groups">
  <title>Ãðóïïîâîå êýøèðîâàíèå</title>
  <para>
   Âû ìîæåòå ñäåëàòü ãðóïïèðîâêó áîëåå ïðîäóìàííîé, èñïîëüçóÿ ãðóïïîâûå çíà÷åíèÿ cache_id.
-   òàêîì ñëó÷àå, êàæäàÿ ïîäãðóïïà îòäåëÿåòñÿ çíàêîì âåðòèêàëüíîé ÷åðòû  "|" â 
+   òàêîì ñëó÷àå, êàæäàÿ ïîäãðóïïà îòäåëÿåòñÿ çíàêîì âåðòèêàëüíîé ÷åðòû  "|" â
   çíà÷åíèè cache_id. Âîçìîæíî ñîçäàâàòü ëþáîå êîëè÷åñòâî ïîäãðóïï.
  </para>
+     <para>
+      Âû ìîæåòå ïðåäñòàâèòü ñåáå ãðóïïû êýøèðîâàíèÿ â âèäå èåðàðõèè êàòàëîãîâ.
+      Ê ïðèìåðó, ãðóïïà êýøèðîâàíèÿ "a|b|c" ñîîòâåòñòâóåò ñòðóêòóðå êàòàëîãîâ
+      "/a/b/c/". clear_cache(null,"a|b|c") - ýòî âñ¸ ðàâíî, ÷òî óäàëèòü ôàéëû èç
+      "/a/b/c/*". clear_cache(null,"a|b") ñîîòâåòñòâóåò óäàëåíèþ ôàéëîâ
+      "/a/b/*". Åñëè âû óêàæåòå compile_id, íàïðèìåð
+      clear_cache(null,"a|b","foo"), îí äîáàâëÿåòñÿ â êîíåö ãðóïïû êýøèðîâàíèÿ:
+      "/a/b/c/foo/". Åñëè âû óêàæåòå èìÿ øàáëîíà, íàïðèìåð
+      clear_cache("foo.tpl","a|b|c"), òî Smarty ïîïûòàåòñÿ óäàëèòü
+      "/a/b/c/foo.tpl". Âû ÍÅ ìîæåòå óäàëèòü îïðåäåëåííûé øàáëîí èç
+      íåñêîëüêèõ ãðóïï êýøèðîâàíèÿ, íàïîäîáèå "/a/b/*/foo.tpl" - ãðóïïû êýøèðîâàíèÿ
+      ðàáîòàþò ÒÎËÜÊÎ ñëåâà íàïðàâî. Âàì íóæíî áóäåò ñãðóïïèðîâàòü øàáëîíû
+      ïîä åäèíîé èåðàðõèåé ãðóïï êýøèðîâàíèÿ, ÷òîáû èìåòü âîçìîæíîñòü î÷èñòèòü
+      èõ êàê ãðóïïó.
+     </para>
+     <para>
+      Ãðóïïîâîå êýøèðîâàíèå íå ñëåäóåò ïóòàòü ñ èåðàðõèåé äèðåêòîðèé øàáëîíîâ.
+      Ãðóïïîâîå êýøèðîâàíèå íå èìååò ïðåäñòàâëåíèÿ î òîì, êàê ñòðóêòóðèðîâàíû
+      âàøè øàáëîíû. Ê ïðèìåðó, åñëè ñòðóêòóðà âàøèõ øàáëîíîâ âûãëÿäèò êàê
+      "themes/blue/index.tpl" è âû õîòèòå èìåòü âîçìîæíîñòü î÷èñòèòü âñå ôàéëû êýøà
+      äëÿ òåìû "blue", âàì íóæíî ñîçäàòü òàêóþ ñòðóêòóðó ãðóïï êýøèðîâàíèÿ, êîòîðàÿ
+      áû ïîâòîðÿëà ôàéëîâóþ ñòðóêòóðó âàøèõ øàáëîíîâ, íàïðèìåð
+      display("themes/blue/index.tpl","themes|blue"), à çàòåì î÷èñòèòü èõ âîò òàê:
+      clear_cache(null,"themes|blue").
+     </para>
  <example>
   <title>Ãðóïïû â cache_id</title>
   <programlisting>
@@ -20,7 +45,7 @@
 // Óäàëèòü âñå êýøèðîâàííûå êîïèè ïîäãðóïïû "sports|basketball"
 $smarty->clear_cache(null,"sports|basketball");
 
-// Óäàëèòü âñå êýøèðîâàííûå êîïèè ãðóïïû "sports", 
+// Óäàëèòü âñå êýøèðîâàííûå êîïèè ãðóïïû "sports",
 // âêëþ÷àÿ "sports|basketball", èëè "sports|(anything)|(anything)|(anything)|..."
 $smarty->clear_cache(null,"sports");
 
@@ -28,17 +53,6 @@
 ]]>
   </programlisting>
  </example>
- <note>
-  <title>Òåõíè÷åñêîå çàìå÷àíèå</title>
-  <para>
-   Ïðè ãðóïïîâîì  êýøèðîâàíèè, ïóòü ê øàáëîíó ÍÅ èñïîëüçóåòñÿ êàê ÷àñòü
-   cache_id. Ê ïðèìåðó, åñëè ïðîèçâîäèòñÿ âûçîâ display('themes/blue/index.tpl'), âû
-   íå ìîæåòå î÷èñòèòü êýø äëÿ âñåõ ôàéëîâ, íàõîäÿùèõñÿ â äèðåêòîðèè "themes/blue". Åñëè
-   ó âàñ âîçíèêëà òàêàÿ íåîáõîäèìîñòü, íóæíî ñãðóïïèðîâàòü èõ â cache_id, íàïðèìåð òàê - 
-   display('themes/blue/index.tpl','themes|blue'); È òåïåðü âû ìîæåòå î÷èñòèòü êýø
-   òåìû blue, èñïîëüçóÿ clear_cache(null,'themes|blue');
-  </para>
- </note>
 </sect1>
 <!-- Keep this comment at the end of the file
 Local variables:
http://cvs.php.net/diff.php/smarty/docs/ru/programmers/plugins/plugins-block-functions.xml?r1=1.4&r2=1.5&ty=u
Index: smarty/docs/ru/programmers/plugins/plugins-block-functions.xml
diff -u smarty/docs/ru/programmers/plugins/plugins-block-functions.xml:1.4 smarty/docs/ru/programmers/plugins/plugins-block-functions.xml:1.5
--- smarty/docs/ru/programmers/plugins/plugins-block-functions.xml:1.4	Mon Aug  2 02:46:02 2004
+++ smarty/docs/ru/programmers/plugins/plugins-block-functions.xml	Wed Sep  8 17:49:10 2004
@@ -1,6 +1,6 @@
 <?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: tony2001 Status: ready -->
 <sect1 id="plugins.block.functions">
  <title>Áëîêîâûå ôóíêöèè</title>
  <funcsynopsis>
@@ -9,6 +9,7 @@
    <paramdef>array <parameter>$params</parameter></paramdef>
    <paramdef>mixed <parameter>$content</parameter></paramdef>
    <paramdef>object <parameter>&amp;$smarty</parameter></paramdef>
+   <paramdef>boolean <parameter>&amp;$repeat</parameter></paramdef>
   </funcprototype>
  </funcsynopsis>
  <para>
@@ -41,6 +42,21 @@
   Smarty è íà âûâîäå âû ïîëó÷èòå ðåçóëüòàò îáðàáîòêè, à íå
   èñõîäíûé êîä øàáëîíà.
  </para>
+
+	<para>
+     Ïàðàìåòð <parameter>&amp;$repeat</parameter> ïåðåäàåòñÿ ïî
+     ññûëêå â ôóíêöèþ è äàåò åé âîçìîæíîñòü êîíòðîëèðîâàòü
+     êîëè÷åñòâî îòîáðàæåíèé áëîêà.
+     Ïî óìîë÷àíèþ <parameter>$repeat</parameter> ðàâåí <literal>true</literal>
+     âî âðåìÿ ïåðâîãî âûçîâà áëîêîâîé ôóíêöèè (îòêðûâàþùèé òýã áëîêà)
+     è <literal>false</literal> ïðè âñåõ ïîñëåäóþùèõ âûçîâàõ áëîêîâîé ôóíêöèè
+     (çàêðûâàþùèé òýã áëîêà).
+     Êàæäûé ðàç, êîãäà âàøà ôóíêöèÿ âîçâðàùàåò ïàðàìåòð <parameter>&amp;$repeat</parameter>
+     ðàâíûé <literal>true</literal>, ñîäåðæèìîå ìåæäó
+     {func} .. {/func} îáðàáàòûâàåòñÿ è âàøà ôóíêöèÿ âíîâü âûçûâàåòñÿ, ïðè÷åì íîâîå ñîäåðæèìîå
+     áëîêà ïåðåäàåòñÿ â ïàðàìåòðå <parameter>$content</parameter>.
+	</para>
+
  <para>
   Åñëè âû èñïîëüçóåòå âëîæåííûå áëîêîâûå ôóíêöèè, åñòü âîçìîæíîñòü îïðåäåëÿòü ðîäèòåëüñêèå
   áëîêîâûå ôóíêöèè. Äîñòàòî÷íî ïîëó÷èòü çíà÷åíèå ïåðåìåííîé