cvs: smarty /docs/ru/appendixes tips.xml /docs/ru/designers/language-custom-functions language-function-html-table.xml language-function-mailto.xml

http://cvs.php.net/diff.php/smarty/docs/ru/appendixes/tips.xml?r1=1.7&r2=1.8&ty=u
Index: smarty/docs/ru/appendixes/tips.xml
diff -u smarty/docs/ru/appendixes/tips.xml:1.7 smarty/docs/ru/appendixes/tips.xml:1.8
--- smarty/docs/ru/appendixes/tips.xml:1.7	Tue Jul 27 02:34:53 2004
+++ smarty/docs/ru/appendixes/tips.xml	Tue Sep 28 07:49:26 2004
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="windows-1251"?>
-<!-- $Revision: 1.7 $ -->
-<!-- EN-Revision: 1.4 Maintainer: tony2001 Status: in-progress -->
+<!-- $Revision: 1.8 $ -->
+<!-- EN-Revision: 1.4 Maintainer: freespace Status: ready -->
 <chapter id="tips">
  <title>Ñîâåòû</title>
   <sect1 id="tips.blank.var.handling">
@@ -112,34 +112,48 @@
   äëÿ ïîëíîãî êîíòðîëÿ íàä ôîðìàòèðîâàíèåì äàòû è òàêæå äåëàåò ëåãêèì 
 		ñðàâíåíèå äàò òàì, ãäå ýòî íåîáõîäèìî.
  </para>
- <para>
-  ÇÀÌÅ×ÀÍÈÅ: Íà÷èíàÿ ñ âåðñèè Smarty 1.4.0 âû ìîæåòå ïåðåäàâàòü äàòó â âèäå
-  âðåìåííîé ìåòêè Unix (Unix timestamp), âðåìåííîé ìåòêè MySQL èëè â ëþáîì
-  äðóãîì âèäå, êîòîðûé ïîäåðæèâàåòñÿ ôóíêöèåé PHP strtotime().
- </para>
-<example>
- <title>Èñïîëüçîâàíèå date_format</title>
-<programlisting>
+   <note>
+    <para>
+     Íà÷èíàÿ ñ âåðñèè Smarty 1.4.0, âû ìîæåòå ïåðåäàâàòü äàòû â Smarty â âèäå
+     ìåòîê âðåìåíè Unix (unix timestamps), mysql, èëè â ëþáîì äðóãîì âèäå, êîòîðûé ïðèíèìàåò strtotime().
+    </para>
+   </note>
+   <example>
+    <title>using date_format</title>
+    <programlisting>
 <![CDATA[
 {$startDate|date_format}
-
-ÂÛÂÎÄ:
-
+]]>
+    </programlisting>
+    <para>
+     Ðåçóëüòàò ðàáîòû:
+    </para>
+    <screen>
+<![CDATA[
 Jan 4, 2001
-
-
+]]>
+    </screen>
+    <programlisting>
+<![CDATA[
 {$startDate|date_format:"%Y/%m/%d"}
-
-ÂÛÂÎÄ:
-
+]]>
+    </programlisting>
+    <para>
+     Ðåçóëüòàò ðàáîòû:
+    </para>
+    <screen>
+<![CDATA[
 2001/01/04
-
-
+]]>
+    </screen>
+    <programlisting>
+<![CDATA[
 {if $date1 < $date2}
-	...
+   ...
 {/if}
-]]></programlisting>
-</example>
+]]>
+    </programlisting>
+   </example>
 <para>
  Êîãäà {html_select_date} èñïîëüçóåòñÿ â øàáëîíå, ïðîãðàììèñòàì ìîæåò
  ïîíàäîáèòüñÿ ïîëó÷èòü äàòó âèäå âðåìåííîé ìåòêè. Âîò ôóíêöèÿ, êîòîðàÿ ïîìîæåò ýòî
@@ -147,26 +161,32 @@
 </para>
 <example>
 <title>Ïðåîáðàçîâàíèå ýëåìåíòîâ ôîðìû ââîäà äàòû íàçàä ê âðåìåííîé ìåòêå</title>
-<programlisting>
+    <programlisting role="php">
 <![CDATA[
+<?php
+
 // Ïðåäïîëàãàåòñÿ, ÷òî âàøè ýëåìåíòû ôîðìû íàçâàíû
 // startDate_Day, startDate_Month, startDate_Year
 
-$startDate = makeTimeStamp($startDate_Year,$startDate_Month,$startDate_Day);
+$startDate = makeTimeStamp($startDate_Year, $startDate_Month, $startDate_Day);
 
-function makeTimeStamp($year="",$month="",$day="")
+function makeTimeStamp($year="", $month="", $day="")
 {
-	if(empty($year))
-		$year = strftime("%Y");
-	if(empty($month))
-		$month = strftime("%m");
-	if(empty($day))
-		$day = strftime("%d");
+   if(empty($year)) {
+       $year = strftime("%Y");
+   }
+   if(empty($month)) {
+       $month = strftime("%m");
+   }
+   if(empty($day)) {
+       $day = strftime("%d");
+   }
 
-	return mktime(0,0,0,$month,$day,$year);
- }
+   return mktime(0, 0, 0, $month, $day, $year);
+}
+?>
 ]]>
-</programlisting>
+    </programlisting>
 </example>
 </sect1>
 <sect1 id="tips.wap">
@@ -181,19 +201,30 @@
  </para>
 <example>
  <title>Èñïîëüçîâàíèå insert äëÿ çàïèñè WML Content-Type çàãîëîâêîâ</title>
-<programlisting>
+    <programlisting role="php">
 <![CDATA[
-// ïîìåñòèòå ýòó ôóíêöèþ â ïðèëîæåíèå, èëè â  Smarty.addons.php
-function insert_header() {
-    // this function expects $content argument
-    extract(func_get_arg(0));
-    if(empty($content))
-        return;
-    header($content);
-    return;
+<?php
+
+// óáåäèòåñü, ÷òî apache íàñòðîåí íà îáðàáîòêó ðàñøèðåíèé .wml!                                    
+// äîáàâüòå ýòó ôóíêöèþ â ñâî¸ ïðèëîæåíèå èëè â Smarty.addons.php
+function insert_header($params) 
+{
+   // ýòà ôóíêöèÿ îæèäàåò àðãóìåíò $content
+   if (empty($params['content'])) {
+       return;
+   }
+   header($params['content']);
+   return;
 }
 
-// øàáëîí ÄÎËÆÅÍ íà÷èíàòüñÿ ñ òýãà insert. Ïðèìåð:
+?>
+]]>
+    </programlisting>
+    <para>
+     âàø øàáëîí Smarty <emphasis>äîëæåí</emphasis> íà÷èíàòüñÿ ñ òýãà insert:
+    </para>
+    <programlisting>
+<![CDATA[
 {insert name=header content="Content-Type: text/vnd.wap.wml"}
 
 <?xml version="1.0"?>  
@@ -219,130 +250,101 @@
 </card> 
 </wml>
 ]]>
-</programlisting>
+    </programlisting>
 </example>
 </sect1>
-<sect1 id="tips.componentized.templates">
- <title>Ñîñòàâíûå øàáëîíû</title>
- <para>
-  This tip is a bit of a hack, but still a neat idea. Use at your own
-  risk. ;-)
- </para>
- <para>
-  Traditionally, programming templates into your applications goes as
-  follows: First, you accumulate your variables within your PHP
-  application, (maybe with database queries.) Then, you instantiate your
-  Smarty object, assign the variables and display the template. So lets
-  say for example we have a stock ticker on our template. We would
-  collect the stock data in our application, then assign these variables
-  in the template and display it. Now wouldn't it be nice if you could
-  add this stock ticker to any application by merely including the
-  template, and not worry about fetching the data up front?
- </para>
- <para>
-  You can embed PHP into your templates with the {php}{/php} tags.
-  With this, you can setup self contained templates with their own
-  data structures for assigning their own variables. With the logic
-  embedded like this, you can keep the template &amp; logic together. This
-  way no matter where the template source is coming from, it is always
-  together as one component.
- </para>
-<example>
-<title>componentized template</title>
-<programlisting>
+  <sect1 id="tips.componentized.templates">
+   <title>Ñîñòàâíûå øàáëîíû</title>
+   <para>
+    Ïî òðàäèöèè, ïðîãðàììèðîâàíèå øàáëîíîâ â âàøåì ïðèëîæåíèè èä¸ò ñëåäóþùèì
+    ïóò¸ì: Ñíà÷àëà âû ôîðìèðóåòå ïåðåìåííûå âíóòðè âàøåãî ïðèëîæåíèÿ PHP
+    (âîçìîæíî èñïîëüçóÿ çàïðîñû ê áàçå äàííûõ). Çàòåì âû ñîçäà¸òå ýêçåìïëÿð
+    îáúåêòà Smarty, íàçíà÷àåòå ïåðåìåííûå è îòîáðàæàåòå øàáëîí.
+    Äàâàéòå ïðåäñòàâèì ñåáå òàêóþ ñèòóàöèþ: Ê ïðèìåðó, ó íàñ åñòü êîòèðîâùèê
+    öåííûõ áóìàã â íàøåì øàáëîíå. Ìû ñîáèðàåì äàííûå î êîòèðîâêàõ öåííûõ áóìàã
+    â íàøåì ïðèëîæåíèè, çàòåì ïåðåäà¸ì ýòè ïåðåìåííûå â øàáëîí è îòîáðàæàåì
+    åãî. Ïðàâäà, áûëî áû çäîðîâî, åñëè áû ýòîò êîòèðîâùèê ìîæíî áûëî ïåðåíåñòè
+    â äðóãîå ïðèëîæåíèå, ïðîñòî ïîäêëþ÷èâ ê íåìó øàáëîí, íå áåñïîêîÿñü îá
+    èñòî÷íèêå äàííûõ.
+   </para>
+   <para>
+    Âû ìîæåòå ñäåëàòü ýòî, íàïèñàâ ñîáñòâåííûé ïëàãèí äëÿ ïîëó÷åíèÿ äàííûõ è
+    ïðèñâàèâàíèÿ èõ ïåðåìåííîé øàáëîíà.
+   </para>
+   <example>
+    <title>ñîñòàâíîé øàáëîí</title>
+    <programlisting role="php">
 <![CDATA[
-{* Smarty *}
+<?php
 
-{php}
+// ïîìåñòèòå ôàéë "function.load_ticker.php" â äèðåêòîðèþ ïëàãèíîâ
 
-	// setup our function for fetching stock data
-	function fetch_ticker($symbol,&$ticker_name,&$ticker_price) {
-		// put logic here that fetches $ticker_name
-		// and $ticker_price from some resource
-	}
-
-	// call the function
-	fetch_ticker("YHOO",$ticker_name,$ticker_price);
-	
-	// assign template variables
-    $this->assign("ticker_name",$ticker_name);
-    $this->assign("ticker_price",$ticker_price);
-
-{/php}
+// íàñòðàèâàåì íàøó ôóíêöèþ äëÿ ïîëó÷åíèÿ èíôîðìàöèè î öåííûõ áóìàãàõ
+function fetch_ticker($symbol) 
+{
+   // çäåñü íàõîäèòñÿ ëîãèêà ôîðìèðîâàíèÿ $ticker_info
+   // èç êàêîãî-òî èñòî÷íèêà
+   return $ticker_info;
+}
 
-Stock Name: {$ticker_name} Stock Price: {$ticker_price}
-]]></programlisting>
-</example>
- <para>
-  As of Smarty 1.5.0, there is even a cleaner way. You can include php in
-  your templates with the {include_php ...} tag. This way you can keep
-  your PHP logic separated from the template logic. See the <link
-  linkend="language.function.include.php">include_php</link> function for
-  more information.
- </para>
-<example>
-<title>componentized template with include_php</title>
-<programlisting>
+function smarty_function_load_ticker($params, &$smarty) 
+{
+   // âûçûâàåì ôóíêöèþ
+   $ticker_info = fetch_ticker($params['symbol']);
+   
+   // ïðèñâàèâàåì ïåðåìåííóþ øàáëîíà
+   $smarty->assign($params['assign'], $ticker_info);
+}
+?>
+]]>
+    </programlisting>
+    <programlisting>
 <![CDATA[
-load_ticker.php
----------------
-
-&lt;?php
-	// setup our function for fetching stock data
-	function fetch_ticker($symbol,&$ticker_name,&$ticker_price) {
-		// put logic here that fetches $ticker_name
-		// and $ticker_price from some resource
-	}
-
-	// call the function
-	fetch_ticker("YHOO",$ticker_name,$ticker_price);
-	
-	// assign template variables
-    $this->assign("ticker_name",$ticker_name);
-    $this->assign("ticker_price",$ticker_price);
-?&gt;
-
-
 index.tpl
 ---------
 
 {* Smarty *}
 
-{include_php file="load_ticker.php"}
+{load_ticker symbol="YHOO" assign="ticker"}
 
-Stock Name: {$ticker_name} Stock Price: {$ticker_price}
-]]></programlisting>
-</example>
-</sect1>
-<sect1 id="tips.obfuscating.email">
- <title>Obfuscating E-mail Addresses</title>
- <para>
-  Do you ever wonder how your E-mail address gets on so many spam mailing
-  lists? One way spammers collect E-mail addresses is from web pages. To
-  help combat this problem, you can make your E-mail address show up in
-  scrambled javascript in the HTML source, yet it it will look and work
-  correctly in the browser. This is done with the mailto plugin.
- </para>
-<example>
-<title>Example of Obfuscating an E-mail Address</title>
-<programlisting>
+Íàçâàíèå öåííîé áóìàãè: {$ticker.name} Öåíà öåííîé áóìàãè: {$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>
 <![CDATA[
 index.tpl
 ---------
 
-Send inquiries to
+Ïî âîïðîñàì îáðàùàéòåñü íà
 {mailto address=$EmailAddress encode="javascript" subject="Hello"}
 ]]>
-</programlisting>
-</example>
-<note>
- <title>Technical Note</title>
- <para>
- This method isn't 100% foolproof. A spammer could conceivably program his
- e-mail collector to decode these values, but not likely.
- </para>
-</note>
-</sect1>
+    </programlisting>
+   </example>
+   <note>
+    <title>Òåõíè÷åñêîå Çàìå÷àíèå</title>
+    <para>
+     Ýòîò ìåòîä íå ìîæåò ãàðàíòèðîâàòü 100% çàùèòû.
+     Ñóùåñòâóåò âåðîÿòíîñòü, ÷òî ñïàìåð çàïðîãðàììèðóåò ñâîé
+     ñáîðùèê e-mail àäðåñîâ íà ðàñêîäèðîâàíèå ýòèõ çíà÷åíèé,
+     íî ýòî ìàëîâåðîÿòíî.
+    </para>
+   </note>
+  </sect1>
 </chapter>
 <!-- Keep this comment at the end of the file
 Local variables:
@@ -364,4 +366,3 @@
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
 -->
-
http://cvs.php.net/diff.php/smarty/docs/ru/designers/language-custom-functions/language-function-html-table.xml?r1=1.4&r2=1.5&ty=u
Index: smarty/docs/ru/designers/language-custom-functions/language-function-html-table.xml
diff -u smarty/docs/ru/designers/language-custom-functions/language-function-html-table.xml:1.4 smarty/docs/ru/designers/language-custom-functions/language-function-html-table.xml:1.5
--- smarty/docs/ru/designers/language-custom-functions/language-function-html-table.xml:1.4	Mon Sep 20 17:19:31 2004
+++ smarty/docs/ru/designers/language-custom-functions/language-function-html-table.xml	Tue Sep 28 07:49:27 2004
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="windows-1251"?>
-<!-- $Revision: 1.4 $ -->
-<!-- EN-Revision: 1.3 Maintainer: freespace Status: ready -->
+<!-- $Revision: 1.5 $ -->
+<!-- EN-Revision: 1.4 Maintainer: freespace Status: ready -->
 <sect1 id="language.function.html.table">
  <title>html_table</title>
  <informaltable frame="all">
@@ -32,26 +32,24 @@
     <entry>integer</entry>
     <entry>Íåò</entry>
     <entry><emphasis>3</emphasis></entry>
-    <entry>êîëè÷åñòâî êîëîíîê òàáëèöû</entry>
-   </row>
-   <row>
-    <entry>cols</entry>
-    <entry>integer</entry>
-    <entry>Íåò</entry>
-    <entry><emphasis>3</emphasis></entry>
-    <entry>êîëè÷åñòâî êîëîíîê òàáëèöû,
-    äàííûå çàïîëíÿþò ÿ÷åöêè ñëåâà íàïðàâî,
-    ñâåðõó âíèç.</entry>
+                    <entry>êîëè÷åñòâî êîëîíîê â òàáëèöå. åñëè àòòðèáóò cols íå óêàçàí, íî óêàçàí rows, òîãäà êîë-âî êîëîíîê âû÷èñëÿåòñÿ èñõîäÿ èç êîë-âà ñòðîê è êîë-âà ýëåìåíòîâ, êîòîðûå íåîáõîäèìî îòîáðàçèòü. åñëè îáà àòòðèáóòà, rows è cols, íå óêàçàíû, cols ïî óìîë÷àíèþ ðàâåí 3.</entry>
    </row>
    <row>
     <entry>rows</entry>
     <entry>integer</entry>
     <entry>Íåò</entry>
     <entry><emphasis>empty</emphasis></entry>
-    <entry>êîëè÷åñòâî ðÿäîâ òàáëèöû, äàííûå çàïîëíÿþò
-    ÿ÷åöêè ñëåâà íàïðàâî, ñâåðõó âíèç. Ýòîò àòòðèáóò -
-    âçàèìîèñêëþ÷àþùèéñÿ ñ àòòðèáóòîì "cols".</entry>
+                    <entry>êîëè÷åñòâî ñòðîê â òàáëèöå. åñëè àòòðèáóò rows íå óêàçàí, íî óêàçàí cols, òîãäà êîë-âî ñòðîê â³÷èñëÿåòñÿ èñõîäÿ èç êîë-âà êîëîíîê è êîë-âà ýëåìåíòîâ, êîòîðûå íåîáõîäèìî îòîáðàçèòü.</entry>
    </row>
+
+                    <row>
+                        <entry>inner</entry>
+                        <entry>string</entry>
+                        <entry>No</entry>
+                        <entry><emphasis>cols</emphasis></entry>
+                        <entry>direction of consecutive elements in the loop-array to be rendered. <emphasis>cols</emphasis> means elements are displayed col-by-col. <emphasis>rows</emphasis> means elements are displayed row-by-row.</entry>
+                    </row>
+
    <row>
     <entry>table_attr</entry>
     <entry>string</entry>
http://cvs.php.net/diff.php/smarty/docs/ru/designers/language-custom-functions/language-function-mailto.xml?r1=1.3&r2=1.4&ty=u
Index: smarty/docs/ru/designers/language-custom-functions/language-function-mailto.xml
diff -u smarty/docs/ru/designers/language-custom-functions/language-function-mailto.xml:1.3 smarty/docs/ru/designers/language-custom-functions/language-function-mailto.xml:1.4
--- smarty/docs/ru/designers/language-custom-functions/language-function-mailto.xml:1.3	Mon Jul 19 09:11:28 2004
+++ smarty/docs/ru/designers/language-custom-functions/language-function-mailto.xml	Tue Sep 28 07:49:27 2004
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="windows-1251"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
 <!-- EN-Revision: 1.1 Maintainer: tony2001 Status: ready -->
 <sect1 id="language.function.mailto">
  <title>mailto</title>
@@ -80,7 +80,7 @@
     <entry>ñòðîêà (string)</entry>
     <entry>Íåò</entry>
     <entry><emphasis>n/a</emphasis></entry>
-    <entry>addresses to follow up to.
+    <entry>àäðåñà äëÿ äàëüíåéøåãî ïåðåíàïðàâëåíèÿ.
     Àäðåñà ðàçäåëÿþòñÿ çàïÿòûìè.</entry>
    </row>
    <row>