smarty-php/smarty
1
0
Fork 0
mirror of https://github.com/smarty-php/smarty.git synced 2026-04-21 00:48:47 +02:00
Code Issues Packages Projects Releases Wiki Activity

sync with EN

Browse Source
This commit is contained in:
freespace
2005-12-30 15:43:38 +00:00
parent cd9d1de27c
commit 4623c56762
28 changed files with 1794 additions and 1390 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
docs/ru/appendixes/tips.xml
View File

@@ -241,9 +241,9 @@ function makeTimeStamp($year='', $month='', $day='')
был передан вместе с шаблоном. Простейший путь - написать
пользовательскую функцию, которая будет выводить заголовки.
Если вы используете <link linkend="caching">кэширование</link>,
это не сработает, так что мы сделаем это с помощью тега
это не сработает, так что мы сделаем это с помощью тэга
<link linkend="language.function.insert">{insert}</link>;
не забывайте, что теги {insert} не кэшируются!
не забывайте, что тэги {insert} не кэшируются!
Убедитесь, что перед шаблоном в браузер ничего не выводится,
иначе отправить заголовок не получится.
</para>

2
docs/ru/designers/language-builtin-functions/language-function-foreach.xml
View File

@@ -13,7 +13,7 @@
<emphasis>{foreach}</emphasis> íàìíîãî ïðîùå ñèíòàêñèñà
<emphasis>{section}</emphasis>, íî ñ äðóãîé ñòîðîíû
<emphasis role="bold">åãî ìîæíî èñïîëüçîâàòü òîëüêî äëÿ îäíîãî ìàññèâà</emphasis>.
Êàæäûé òåã <emphasis>{foreach}</emphasis> äîëæåí èìåòü ïàðó
Êàæäûé òýã <emphasis>{foreach}</emphasis> äîëæåí èìåòü ïàðó
<emphasis>{/foreach}</emphasis>. Îáÿçàòåëüíûìè ïàðàìåòðàìè ÿâëÿþòñÿ
<emphasis>from</emphasis> è <emphasis>item</emphasis>.
Èìÿ öèêëà {foreach} ìîæåò áûòü ëþáûì, ñîñòîÿùèì èç áóêâ, öèôð è çíàêîâ

39
docs/ru/designers/language-builtin-functions/language-function-if.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="windows-1251"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.7 Maintainer: freespace Status: ready -->
<!-- EN-Revision: 1.8 Maintainer: freespace Status: ready -->
<sect1 id="language.function.if">
<title>{if},{elseif},{else}</title>
<para>
@@ -17,6 +17,12 @@
<emphasis>is_array()</emphasis> è ò.ä.
</para>
<para>
Åñëè <link linkend="variable.security">$security</link> âêëþ÷åíà,
òî ìàññèâ <emphasis>IF_FUNCS</emphasis> â ìàññèâå <link
linkend="variable.security.settings">$security_settings</link>.
</para>
<para>
Íèæå ñëåäóåò ñïèñîê ðàñïîçíàâàåìûõ êâàëèôèêàòîðîâ, êîòîðûå äîëæíû áûòü
îòäåëåíû îò îêðóæàþùèõ ýëåìåíòîâ ïðîáåëàìè. Îáðàòèòå âíèìàíèÿ, ÷òî
@@ -165,15 +171,6 @@
...
{/if}
{*
ñëåäóþùèé ïðèìåð ÍÅ áóäåò ðàáîòàòü, êâàëèôèêàòîðû óñëîâèé ñëåäóåò
îòäåëÿòü îò îêðóæàþùèõ ýëåìåíòîâ ïðîáåëàìè
*}
{if $name=="Fred" || $name=="Wilma"}
...
{/if}
{* ñêîáêè ðàçðåøåíû *}
{if ( $amount < 0 or $amount > 1000 ) and $volume >= #minVolAmt#}
...
@@ -184,6 +181,16 @@
...
{/if}
{* ïðîâåðêà íà ìàññèâ *}
{if is_array($foo) }
...
{/if}
{* ïðîâåðêà íà ñóùåñòâîâàíèå *}
{if isset($foo) }
...
{/if}
{* ïðîâåðÿåò ÷¸òíîñòü çíà÷åíèé *}
{if $var is even}
...
@@ -212,18 +219,6 @@
{if $var is even by 3}
...
{/if}
{* ------- if ñ ôóíêöèÿìè PHP ------- *}
{* check for array. *}
{if is_array($foo) }
.....
{/if}
{* ïðîâåðêà íà ñóùåñòâîâàíèå *}
{if isset($foo) }
.....
{/if}
]]>
</programlisting>
</example>

10
docs/ru/designers/language-builtin-functions/language-function-include.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="windows-1251"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.9 Maintainer: freespace Status: ready -->
<!-- EN-Revision: 1.10 Maintainer: freespace Status: ready -->
<sect1 id="language.function.include">
<title>{include}</title>
<para>
@@ -13,7 +13,13 @@
Îïöèîíàëüíûé àòðèáóò <emphasis>assign</emphasis> óêàçûâàåò, ÷òî
ðåçóëüòàò âûïîëíåíèÿ {include} áóäåò ïðèñâîåí ïåðåìåííîé âìåñòî îòîáðàæåíèÿ.
</para>
<para>
Âñå çíà÷åíèÿ ïðèñâîåííûõ ïåðåìåííûõ âîññòàíàâëèâàþòñÿ ïîñëå òîãî,
êàê ïîäêëþ÷àåìûé øàáëîí îòðàáîòàë. Ýòî çíà÷èò, ÷òî âû ìîæåòå èñïîëüçîâàòü
âñå ïåðåìåííûå èç ïîäêëþ÷àþùåãî øàáëîíà â ïîäêëþ÷àåìîì, íî èçìåíåíèÿ
ïåðåìåííûõ âíóòðè ïîäêëþ÷àåìîãî øàáëîíà íå áóäóò âèäíû âíóòðè ïîäêëþ÷àþùåãî
øàáëîíà ïîñëå êîìàíäû {include}.
</para>
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />

2
docs/ru/designers/language-builtin-functions/language-function-section.xml
View File

@@ -7,7 +7,7 @@
Ñåêöèè èñïîëüçóþòñÿ äëÿ îáõîäà
<emphasis role="bold">ìàññèâîâ äàííûõ</emphasis>
(òàê æå, êàê è <link linkend="language.function.foreach">{foreach}</link>).
Êàæäûé òåã <emphasis>{section}</emphasis> äîëæåí èìåòü ïàðó
Êàæäûé òýã <emphasis>{section}</emphasis> äîëæåí èìåòü ïàðó
<emphasis>{/section}</emphasis>. Îáÿçàòåëüíûìè ïàðàìåòðàìè ÿâëÿþòñÿ
<emphasis>name</emphasis> è <emphasis>loop</emphasis>. Èìÿ öèêëà
{section} ìîæåò áûòü ëþáûì, ñîñòîÿùèì èç áóêâ, öèôð è çíàêîâ

2
docs/ru/designers/language-builtin-functions/language-function-strip.xml
View File

@@ -6,7 +6,7 @@
<para>
Часто вебдизайнеры сталкиваются с проблемой, что пробелы и переносы
строк влияют на отображение HTML в броузере ("фишки" броузера), то
есть может понадобится склеить все теги в шаблоне вместе, чтобы получить
есть может понадобится склеить все тэги в шаблоне вместе, чтобы получить
желаемый результат. Но в результате получается нечитаемый или
трудноредактируемый шаблон.
</para>

88
docs/ru/designers/language-custom-functions/language-function-assign.xml
View File

@@ -1,8 +1,13 @@
<?xml version="1.0" encoding="windows-1251"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: freespace Status: ready -->
<!-- EN-Revision: 1.6 Maintainer: freespace Status: ready -->
<sect1 id="language.function.assign">
<title>assign</title>
<title>{assign}</title>
<para>
{assign} èñïîëüçóåòñÿ äëÿ óñòàíîâêè çíà÷åíèÿ ïåðåìåííîé
<emphasis role="bold">â ïðîöåññå âûïîëíåíèÿ øàáëîíà</emphasis>.
</para>
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
@@ -38,24 +43,87 @@
</tbody>
</tgroup>
</informaltable>
<para>
assign èñïîëüçóåòñÿ äëÿ óñòàíîâêè çíà÷åíèÿ ïåðåìåííîé â
ïðîöåññå âûïîëíåíèÿ øàáëîíà.
</para>
<example>
<title>assign</title>
<title>{assign}</title>
<programlisting>
<![CDATA[
{assign var="name" value="Bob"}
Çíà÷åíèå $name - {$name}.
OUTPUT:
]]>
</programlisting>
<para>
Ðåçóëüòàò âûïîëíåíèÿ äàííîãî ïðèìåðà:
</para>
<screen>
<![CDATA[
Çíà÷åíèå $name - Bob.
]]>
</screen>
</example>
<example>
<title>Äîñòóï ê ïåðåìåííûì {assign} èç PHP-ñêðèïòà.</title>
<para>
×òîáû ïîëó÷èòü äîñòóï ê ïåðåìåííûì {assign} èç PHP èñïîëüçóéòå ôóíêöèþ
<link linkend="api.get.template.vars">get_template_vars()</link>.
Îáðàòèòå âíèìàíèå, ÷òî ïåðåìåííûå äîñòóïíû òîëüêî âî âðåìÿ è ïîñëå
âûïîëíåíèÿ øàáëîíà, êàê âèäíî èç ñëåäóþùåãî ïðèìåðà:
</para>
<programlisting>
<![CDATA[
{* index.tpl *}
{assign var="foo" value="Smarty"}
]]>
</programlisting>
<programlisting role="php">
<![CDATA[
<?php
// ýòî íå âûâåäåò íè÷åãî, âåäü øàáëîí åù¸ íå áûë âûïîëíåí
echo $smarty->get_template_vars('foo');
// ïîëó÷àåì øàáëîí â ïåðåìåííóþ-ïóñòûøêó
$dead = $smarty->fetch('index.tpl');
// ýòî âûâåäåò 'smarty', òàê êàê øàáëîí óæå âûïîëíåí
echo $smarty->get_template_vars('foo');
$smarty->assign('foo','Even smarter');
// ýòî âûâåäåò 'Even smarter'
echo $smarty->get_template_vars('foo');
?>
]]>
</programlisting>
</example>
<para>
Ñëåäóþùèå ôóíêöèè òàêæå ìîãóò <emphasis>îïöèîíàëüíî</emphasis>
íàçíà÷àòü ïåðåìåííûå øàáëîíà.
</para>
<para>
<link linkend="language.function.capture">{capture}</link>,
<link linkend="language.function.include">{include}</link>,
<link linkend="language.function.include.php">{include_php}</link>,
<link linkend="language.function.insert">{insert}</link>,
<link linkend="language.function.counter">{counter}</link>,
<link linkend="language.function.cycle">{cycle}</link>,
<link linkend="language.function.eval">{eval}</link>,
<link linkend="language.function.fetch">{fetch}</link>,
<link linkend="language.function.math">{math}</link>,
<link linkend="language.function.textformat">{textformat}</link>
</para>
<para>
Ñì. òàêæå
<link linkend="api.assign">assign()</link>
è
<link linkend="api.get.template.vars">get_template_vars()</link>.
</para>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:

197
docs/ru/designers/language-custom-functions/language-function-counter.xml
View File

@@ -1,101 +1,106 @@
<?xml version="1.0" encoding="windows-1251"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.2 Maintainer: freespace Status: ready -->
<sect1 id="language.function.counter">
<title>counter</title>
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
<colspec colname="type" align="center" />
<colspec colname="required" align="center" />
<colspec colname="default" align="center" />
<colspec colname="desc" />
<thead>
<row>
<entry>Èìÿ àòðèáóòà</entry>
<entry>Òèï</entry>
<entry>Îáÿçàòåëåí</entry>
<entry>Ïî óìîë÷àíèþ</entry>
<entry>Îïèñàíèå</entry>
</row>
</thead>
<tbody>
<row>
<entry>name</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>default</emphasis></entry>
<entry>Èìÿ ñ÷åò÷èêà</entry>
</row>
<row>
<entry>start</entry>
<entry>number</entry>
<entry>Íåò</entry>
<entry><emphasis>1</emphasis></entry>
<entry>Íà÷àëüíîå çíà÷åíèå ñ÷åò÷èêà</entry>
</row>
<row>
<entry>skip</entry>
<entry>number</entry>
<entry>Íåò</entry>
<entry><emphasis>1</emphasis></entry>
<entry>Øàã ñ÷åò÷èêà</entry>
</row>
<row>
<entry>direction</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>up</emphasis></entry>
<entry>Íàïðàâëåíèå (ââåðõ - up/âíèç - down)</entry>
</row>
<row>
<entry>print</entry>
<entry>boolean</entry>
<entry>Íåò</entry>
<entry><emphasis>true</emphasis></entry>
<entry>âûâîäèòü çíà÷åíèå ñ÷åò÷èêà èëè íåò</entry>
</row>
<row>
<entry>assign</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Èìÿ ïåðåìåííîé, êîòîðîé áóäåò ïðèñâîåí
âûâîä</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para>
counter èñïîëüçóåòñÿ äëÿ óïðàâëåíèÿ ñ÷åò÷èêîì. counter çàïîìèíàåò
êîëè÷åñòâî èòåðàöèé. Ìîæíî ðåãóëèðîâàòü íà÷àëî, èíòåðâàë è
íàïðàâëåíèå îòñ÷åòà, à òàêæå óêàçàòü, âûâîäèòü èë çíà÷åíèå
ñ÷åò÷èêà èëè íåò. Ìîæíî çàïóñòèòü íåñêîëüêî ñ÷åò÷èêîâ îäíîâðåìåííî,
óêàçàâ óíèêàëüíîå èìÿ äëÿ êàæäîãî. Åñëè èìÿ ñ÷åò÷èêà íå óêàçàíî,
áóäåò èñïîëüçîâàíî ïî óìîë÷àíèþ 'default'.
</para>
<para>
Åñëè óêàçàí àòðèáóò "assign", òî âûâîä òýãà counter áóäåò ïðèñâîåí
ïåðåìåííîé øàáëîíà, âìåñòî îòîáðàæåíèÿ.
</para>
<example>
<title>counter</title>
<programlisting>
<!-- EN-Revision: 1.5 Maintainer: freespace Status: ready -->
<sect1 id="language.function.counter">
<title>{counter}</title>
<para>
{counter} èñïîëüçóåòñÿ äëÿ âûâîäà ñ÷åò÷èêà. {counter} çàïîìèíàåò çíà÷åíèå
ñ÷åò÷èêà íà êàæäîé èòåðàöèè. Âû ìîæåòå íàñòðîèòü çíà÷åíèå, èíòåðâàë
è íàïðàâëåíèå ñ÷åòà, à òàê æå îïðåäåëèòü, ñëåäóåò ëè ïå÷àòàòü ýòî çíà÷åíèå.
Âû ìîæåòå èñïîëüçîâàòü íåñêîëüêî ñ÷åò÷èêîâ îäíîâðåìåííî, íàçíà÷èâ êàæäîìó
óíèêàëüíîå èìÿ. Åñëè âû ÿâíî íå óêàçûâàåòå èìåíè, èñïîëüçóåòñÿ èìÿ 'default'.
</para>
<para>
Åñëè âû óêàæåòå ñïåöèàëüíûé àòðèáóò "assign", âûâîä ñ÷åò÷èêà áóäåò íàçíà÷åí
ñîîòâåòñòâóþùåé ïåðåìåííîé øàáëîíà âìåñòî ïå÷àòè â øàáëîí.
</para>
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
<colspec colname="type" align="center" />
<colspec colname="required" align="center" />
<colspec colname="default" align="center" />
<colspec colname="desc" />
<thead>
<row>
<entry>Èìÿ àòðèáóòà</entry>
<entry>Òèï</entry>
<entry>Îáÿçàòåëåí</entry>
<entry>Ïî óìîë÷àíèþ</entry>
<entry>Îïèñàíèå</entry>
</row>
</thead>
<tbody>
<row>
<entry>name</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>default</emphasis></entry>
<entry>Èìÿ ñ÷åò÷èêà</entry>
</row>
<row>
<entry>start</entry>
<entry>number</entry>
<entry>Íåò</entry>
<entry><emphasis>1</emphasis></entry>
<entry>Èçíà÷àëüíîå ÷èñëî, ñ êîòîðîãî íà÷èíàåòñÿ ñ÷åò</entry>
</row>
<row>
<entry>skip</entry>
<entry>number</entry>
<entry>Íåò</entry>
<entry><emphasis>1</emphasis></entry>
<entry>Èíòåðâàë óâåëè÷åíèÿ ñ÷åò÷èêà</entry>
</row>
<row>
<entry>direction</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>up</emphasis></entry>
<entry>Íàïðàâëåíèå ñ÷åòà (up/down)</entry>
</row>
<row>
<entry>print</entry>
<entry>boolean</entry>
<entry>Íåò</entry>
<entry><emphasis>true</emphasis></entry>
<entry>Ïå÷àòàòü ëè çíà÷åíèå ñ÷åò÷èêà</entry>
</row>
<row>
<entry>assign</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Èìÿ ïåðåìåííîé øàáëîíà äëÿ ñîõðàíåíèÿ çíà÷åíèÿ ñ÷åò÷èêà</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<example>
<title>{counter}</title>
<programlisting>
<![CDATA[
{* èíèöèàëèçèðóåì ñ÷åò÷èê *}
{counter start=0 skip=2 print=false}
{counter}&lt;br&gt;
{counter}&lt;br&gt;
{counter}&lt;br&gt;
{counter}&lt;br&gt;
OUTPUT:
2&lt;br&gt;
4&lt;br&gt;
6&lt;br&gt;
8&lt;br&gt;</programlisting>
</example>
{counter start=0 skip=2}<br />
{counter}<br />
{counter}<br />
{counter}<br />
]]>
</programlisting>
<para>
Ðåçóëüòàò âûïîëíåíèÿ äàííîãî ïðèìåðà:
</para>
<screen>
<![CDATA[
0<br />
2<br />
4<br />
6<br />
]]>
</screen>
</example>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
@@ -116,4 +121,4 @@ End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
-->

238
docs/ru/designers/language-custom-functions/language-function-cycle.xml
View File

@@ -1,117 +1,137 @@
<?xml version="1.0" encoding="windows-1251"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.2 Maintainer: freespace Status: ready -->
<sect1 id="language.function.cycle">
<title>cycle</title>
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
<colspec colname="type" align="center" />
<colspec colname="required" align="center" />
<colspec colname="default" align="center" />
<colspec colname="desc" />
<thead>
<row>
<entry>Èìÿ àòðèáóòà</entry>
<entry>Òèï</entry>
<entry>Îáÿçàòåëåí</entry>
<entry>Ïî óìîë÷àíèþ</entry>
<entry>Îïèñàíèå</entry>
</row>
</thead>
<tbody>
<row>
<entry>name</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>default</emphasis></entry>
<entry>Íàçâàíèå öèêëà</entry>
</row>
<row>
<entry>values</entry>
<entry>mixed</entry>
<entry>Äà</entry>
<entry><emphasis>N/A</emphasis></entry>
<entry>Çíà÷åíèÿ, ïî êîòîðûì áóäåò ïðîèçâîäèòüñÿ öèêë.
Ëèáî ñïèñîê, ðàçäåëåíûé çàïÿòûìè (ëèáî äðóãèì óêàçàííûì
ðàçäåëèòåëåì), ëèáî ìàññèâ çíà÷åíèé.</entry>
</row>
<row>
<entry>print</entry>
<entry>boolean</entry>
<entry>Íåò</entry>
<entry><emphasis>true</emphasis></entry>
<entry>Âûâîäèòü çíà÷åíèå, èëè íåò</entry>
</row>
<row>
<entry>advance</entry>
<entry>boolean</entry>
<entry>Íåò</entry>
<entry><emphasis>true</emphasis></entry>
<entry>Ïåðåêëþ÷àòüñÿ èëè íåò íà ñëåäóþùåå çíà÷åíèå</entry>
</row>
<row>
<entry>delimiter</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>,</emphasis></entry>
<entry>Ðàçäåëèòåëü, èñïîëüçóåìûé â àòðèáóòå values.</entry>
</row>
<row>
<entry>assign</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Èìÿ ïåðåìåííîé, êîòîðîé áóäåò ïðèñâîåí âûâîä òýãà</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para>
Cycle èñïîëüçóåòñÿ äëÿ ïðîõîäà ÷åðåç ìíîæåñòâî çíà÷åíèé.
Ñ åãî ïîìîùüþ ìîæíî ëåãêî ðåàëèçîâàòü ïåðåêëþ÷åíèå ìåæäó
äâóìÿ è áîëåå öâåòàìè â òàáëèöå, èëè ïðîéòè öèêë ÷åðåç
ìàññèâ.
</para>
<para>
Ìîæíî ïðîõîäèòü ÷åðåç íåñêîëüêî ìíîæåñòâ çíà÷åíèé îäíîâðåìåííî,
óêàçàâ àòðèáóò name. Èìåíà äîëæíû áûòü óíèêàëüíûìè.
</para>
<para>
Ìîæíî íå îòîáðàæàòü äàííûé ýëåìåíò, óñòàíîâèâ àòðèáóò print â
ëîæü (false). Óäîáíî äëÿ ïðîïóñêà çíà÷åíèÿ, áåç åãî âûâîäà.
</para>
<para>
Àòðèáóò advance èñïîëüçóåòñÿ äëÿ ïîâòîðà çíà÷åíèÿ. Åñëè
óñòàíîâëåí â èñòèíà (true), òî ïðè ñëåäóþùåì âûçîâå cycle
áóäåò âûâåäåíî òî æå çíà÷åíèå.
</para>
<para>
Åñëè óêàçàí ñïåöèàëüíûé àòðèáóò "assign", òî âûâîä cycle
ïðèñâàèâàåòñÿ ïåðåìåííîé, âìåñòî îòîáðàæåíèÿ.
</para>
<example>
<title>cycle</title>
<programlisting>
<!-- EN-Revision: 1.6 Maintainer: freespace Status: ready -->
<sect1 id="language.function.cycle">
<title>{cycle}</title>
<para>
{cycle} is used to cycle though a set of values. This makes it easy
to alternate for example between two or more colors in a table, or cycle
through an array of values.
</para>
<para>
{cycle} èñïîëüçóåòñÿ äëÿ ïðîõîäà ÷åðåç ìíîæåñòâî çíà÷åíèé.
Ñ åãî ïîìîùüþ ìîæíî ëåãêî ðåàëèçîâàòü ÷åðåäîâàíèå äâóõ èëè áîëåå öâåòîâ â
òàáëèöå èëè ïðîéòèñü öèêëîì ïî ìàññèâó.
</para>
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
<colspec colname="type" align="center" />
<colspec colname="required" align="center" />
<colspec colname="default" align="center" />
<colspec colname="desc" />
<thead>
<row>
<entry>Èìÿ àòðèáóòà</entry>
<entry>Òèï</entry>
<entry>Îáÿçàòåëåí</entry>
<entry>Ïî óìîë÷àíèþ</entry>
<entry>Îïèñàíèå</entry>
</row>
</thead>
<tbody>
<row>
<entry>name</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>default</emphasis></entry>
<entry>Íàçâàíèå öèêëà</entry>
</row>
<row>
<entry>values</entry>
<entry>mixed</entry>
<entry>Äà</entry>
<entry><emphasis>N/A</emphasis></entry>
<entry>
Çíà÷åíèÿ, ïî êîòîðûì áóäåò ïðîèçâîäèòüñÿ öèêë.
Ëèáî ñïèñîê, ðàçäåëåíûé çàïÿòûìè (ëèáî äðóãèì óêàçàííûì ðàçäåëèòåëåì),
ëèáî ìàññèâ çíà÷åíèé.
</entry>
</row>
<row>
<entry>print</entry>
<entry>boolean</entry>
<entry>Íåò</entry>
<entry><emphasis>true</emphasis></entry>
<entry>Âûâîäèòü çíà÷åíèå, èëè íåò</entry>
</row>
<row>
<entry>advance</entry>
<entry>boolean</entry>
<entry>Íåò</entry>
<entry><emphasis>true</emphasis></entry>
<entry>Ïåðåêëþ÷àòüñÿ èëè íåò íà ñëåäóþùåå çíà÷åíèå</entry>
</row>
<row>
<entry>delimiter</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>,</emphasis></entry>
<entry>Ðàçäåëèòåëü, èñïîëüçóåìûé â àòðèáóòå values.</entry>
</row>
<row>
<entry>assign</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Èìÿ ïåðåìåííîé, êîòîðîé áóäåò ïðèñâîåí âûâîä òýãà</entry>
</row>
<row>
<entry>reset</entry>
<entry>boolean</entry>
<entry>Íåò</entry>
<entry><emphasis>false</emphasis></entry>
<entry>Öèêë áóäåò óñòàíîâëåí â íà÷àëüíîå çíà÷åíèå è íå óâåëè÷åí</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para>
Ìîæíî ïðîõîäèòü ÷åðåç íåñêîëüêî ìíîæåñòâ çíà÷åíèé îäíîâðåìåííî,
óêàçàâ àòðèáóò name. Èìåíà äîëæíû áûòü óíèêàëüíûìè.
</para>
<para>
Ìîæíî íå îòîáðàæàòü äàííûé ýëåìåíò, óñòàíîâèâ àòðèáóò print â
false. Óäîáíî äëÿ ïðîïóñêà çíà÷åíèÿ, áåç åãî âûâîäà.
</para>
<para>
Àòðèáóò advance èñïîëüçóåòñÿ äëÿ ïîâòîðà çíà÷åíèÿ. Åñëè
óñòàíîâëåí â true, òî ïðè ñëåäóþùåì âûçîâå {cycle}
áóäåò âûâåäåíî òî æå çíà÷åíèå.
</para>
<para>
Åñëè óêàçàí ñïåöèàëüíûé àòðèáóò "assign", òî âûâîä {cycle}
ïðèñâàèâàåòñÿ ïåðåìåííîé, âìåñòî îòîáðàæåíèÿ.
</para>
<example>
<title>{cycle}</title>
<programlisting>
<![CDATA[
{section name=rows loop=$data}
&lt;tr bgcolor="{cycle values="#eeeeee,#d0d0d0"}"&gt;
&lt;td&gt;{$data[rows]}&lt;/td&gt;
&lt;/tr&gt;
<tr bgcolor="{cycle values="#eeeeee,#d0d0d0"}">
<td>{$data[rows]}</td>
</tr>
{/section}
]]>
</programlisting>
<screen>
<![CDATA[
<tr bgcolor="#eeeeee">
<td>1</td>
</tr>
<tr bgcolor="#d0d0d0">
<td>2</td>
</tr>
<tr bgcolor="#eeeeee">
<td>3</td>
</tr>
]]>
</screen>
</example>
OUTPUT:
&lt;tr bgcolor="#eeeeee"&gt;
&lt;td&gt;1&lt;/td&gt;
&lt;/tr&gt;
&lt;tr bgcolor="#d0d0d0"&gt;
&lt;td&gt;2&lt;/td&gt;
&lt;/tr&gt;
&lt;tr bgcolor="#eeeeee"&gt;
&lt;td&gt;3&lt;/td&gt;
&lt;/tr&gt;
</programlisting>
</example>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:

82
docs/ru/designers/language-custom-functions/language-function-debug.xml
View File

@@ -1,43 +1,49 @@
<?xml version="1.0" encoding="windows-1251"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.2 Maintainer: freespace Status: ready -->
<sect1 id="language.function.debug">
<title>debug</title>
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
<colspec colname="type" align="center" />
<colspec colname="required" align="center" />
<colspec colname="default" align="center" />
<colspec colname="desc" />
<thead>
<row>
<entry>Èìÿ àòðèáóòà</entry>
<entry>Òèï</entry>
<entry>Îáÿçàòåëåí</entry>
<entry>Ïî óìîë÷àíèþ</entry>
<entry>Îïèñàíèå</entry>
</row>
</thead>
<tbody>
<row>
<entry>output</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>html</emphasis></entry>
<entry>Òèï âûâîäà (html èëè javascript)</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para>
{debug} âûâîäèò êîíñîëü îòëàäêè. Ýòî ðàáîòàåò íåçàâèñèìî îò
çíà÷åíèÿ îïöèè <link linkend="chapter.debugging.console">debug</link>.
Òàê êàê ýòîò òýã îáðàáàòûâàåòñÿ â ïðîöåñå âûïîëíåíèÿ, òî âîçìîæíî
âûâåñòè òîëüêî ïðèñâîåííûå ïåðåìåííûå, íî íå èñïîëüçóåìûå øàáëîíû.
Íî âû âèäèòå âñå ïåðåìåííûå, äîñòóïíûå â îáëàñòè âèäèìîñòè òåêóùåãî
øàáëîíà.
</para>
<!-- EN-Revision: 1.6 Maintainer: freespace Status: ready -->
<sect1 id="language.function.debug">
<title>{debug}</title>
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
<colspec colname="type" align="center" />
<colspec colname="required" align="center" />
<colspec colname="default" align="center" />
<colspec colname="desc" />
<thead>
<row>
<entry>Èìÿ àòðèáóòà</entry>
<entry>Òèï</entry>
<entry>Îáÿçàòåëåí</entry>
<entry>Ïî óìîë÷àíèþ</entry>
<entry>Îïèñàíèå</entry>
</row>
</thead>
<tbody>
<row>
<entry>output</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>javascript</emphasis></entry>
<entry>Òèï âûâîäà (html èëè javascript)</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para>
{debug} âûâîäèò êîíñîëü îòëàäêè. Ýòî ðàáîòàåò íåçàâèñèìî îò
çíà÷åíèÿ îïöèè <link linkend="chapter.debugging.console">debug</link>.
Òàê êàê ýòîò òýã îáðàáàòûâàåòñÿ â ïðîöåñå âûïîëíåíèÿ, òî âîçìîæíî
âûâåñòè òîëüêî <link linkend="api.assign">ïðèñâîåííûå</link> ïåðåìåííûå,
íî íå èñïîëüçóåìûå øàáëîíû.
Íî âû âèäèòå âñå ïåðåìåííûå, äîñòóïíûå â îáëàñòè âèäèìîñòè òåêóùåãî
øàáëîíà.
</para>
<para>
Ñì. òàêæå
<link linkend="chapter.debugging.console">Îòëàäî÷íàÿ êîíñîëü</link>.
</para>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:

190
docs/ru/designers/language-custom-functions/language-function-eval.xml
View File

@@ -1,100 +1,110 @@
<?xml version="1.0" encoding="windows-1251"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: freespace Status: ready -->
<sect1 id="language.function.eval">
<title>eval</title>
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
<colspec colname="type" align="center" />
<colspec colname="required" align="center" />
<colspec colname="default" align="center" />
<colspec colname="desc" />
<thead>
<row>
<entry>Èìÿ àòðèáóòà</entry>
<entry>Òèï</entry>
<entry>Îáÿçàòåëåí</entry>
<entry>Ïî óìîë÷àíèþ</entry>
<entry>Îïèñàíèå</entry>
</row>
</thead>
<tbody>
<row>
<entry>var</entry>
<entry>mixed</entry>
<entry>Äà</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Ïåðåìåííàÿ (èëè ñòðîêà) äëÿ îáðàáîòêè</entry>
</row>
<row>
<entry>assign</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Èìÿ ïåðåìåííîé, êîòîðîé áóäåò ïðèñâîåí âûâîä</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para>
eval èñïîëüçóåòñÿ äëÿ îáðàáîòêè ïåðåìåííîé, êàê øàáëîíà. Ìîæíî
èñïîëüçîâàòü äëÿ òàêèõ âåùåé, êàê õðàíåíèå øàáëîííûõ
òýãîâ/ïåðåìåííûõ â ïåðåìåííîé èëè â ôàéëàõ êîíôèãðóàöèè.
</para>
<para>
Åñëè óêàçàí ñïåöèàëüíûé àòðèáóò "assign", òî âûâîä òýãà eval
ïðèñâàèâàåòñÿ ïåðåìåííîé, âìåñòî îòîáðàæåíèÿ.
</para>
<note>
<title>Òåõíè÷åñêîå Çàìå÷àíèå</title>
<para>
<!-- EN-Revision: 1.4 Maintainer: freespace Status: ready -->
<sect1 id="language.function.eval">
<title>{eval}</title>
<para>
{eval} èñïîëüçóåòñÿ äëÿ îáðàáîòêè ïåðåìåííîé, êàê øàáëîíà.
Ìîæíî èñïîëüçîâàòü äëÿ òàêèõ âåùåé, êàê õðàíåíèå øàáëîííûõ
òýãîâ/ïåðåìåííûõ â ïåðåìåííîé èëè â ôàéëàõ êîíôèãðóàöèè.
</para>
<para>
Åñëè óêàçàí ñïåöèàëüíûé àòðèáóò "assign", òî âûâîä òýãà eval
ïðèñâàèâàåòñÿ ïåðåìåííîé, âìåñòî îòîáðàæåíèÿ.
</para>
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
<colspec colname="type" align="center" />
<colspec colname="required" align="center" />
<colspec colname="default" align="center" />
<colspec colname="desc" />
<thead>
<row>
<entry>Èìÿ àòðèáóòà</entry>
<entry>Òèï</entry>
<entry>Îáÿçàòåëåí</entry>
<entry>Ïî óìîë÷àíèþ</entry>
<entry>Îïèñàíèå</entry>
</row>
</thead>
<tbody>
<row>
<entry>var</entry>
<entry>mixed</entry>
<entry>Äà</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Ïåðåìåííàÿ (èëè ñòðîêà) äëÿ îáðàáîòêè</entry>
</row>
<row>
<entry>assign</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Èìÿ ïåðåìåííîé, êîòîðîé áóäåò ïðèñâîåí âûâîä</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<note>
<title>Òåõíè÷åñêîå Çàìå÷àíèå</title>
<para>
Ïåðåìåííûå øàáëîíû îáðàáàòûâàþòñÿ òàê æå, êàê è îáû÷íûå øàáëîíû.
Îíè ïîäâëàñòíû òåì æå ïðàâèëàì è îãðàíè÷åíèÿì áåçîïàñíîñòè.
</para>
</note>
<note>
<title>Òåõíè÷åñêîå Çàìå÷àíèå</title>
<para>
Ïåðåìåííûå øàáëîíû êîìïèëèðóþòñÿ ïðè êàæäîì îáðàùåíèè.
Îòêîìïèëèðîâàííûå âåðñèè íå ñîõðàíÿþòñÿ! Îäíàêî, åñëè
êýøèðîâàíèå âêëþ÷åíî, òî âûâîä áóäåò çàêýøèðîâàí ñ
îñòàëüíîé ÷àñòüþ øàáëîíà.
</para>
</note>
<example>
<title>eval</title>
<programlisting>
setup.conf
----------
</para>
</note>
emphstart = &lt;b&gt;
emphend = &lt;/b&gt;
title = Welcome to {$company}'s home page!
ErrorCity = You must supply a {#emphstart#}city{#emphend#}.
ErrorState = You must supply a {#emphstart#}state{#emphend#}.
<note>
<title>Òåõíè÷åñêîå Çàìå÷àíèå</title>
<para>
Ïåðåìåííûå øàáëîíû êîìïèëèðóþòñÿ ïðè êàæäîì âûçîâå, ñêîìïèëèðîâàííûå âåðñèè
íå ñîõðàíÿþòñÿ!
Îäíàêî, åñëè <link linkend="caching">êýøèðîâàíèå</link> âêëþ÷åíî,
âûâîä áóäåò êýøèðîâàí âìåñòå ñ îñòàëüíîé ÷àñòüþ øàáëîíà.
</para>
</note>
<example>
<title>{eval}</title>
<programlisting>
<![CDATA[
setup.conf
----------
emphstart = <strong>
emphend = </strong>
title = Welcome to {$company}'s home page!
ErrorCity = You must supply a {#emphstart#}city{#emphend#}.
ErrorState = You must supply a {#emphstart#}state{#emphend#}.
]]>
</programlisting>
<para>
index.tpl:
</para>
<programlisting>
<![CDATA[
{config_load file="setup.conf"}
index.tpl
---------
{config_load file="setup.conf"}
{eval var=$foo}
{eval var=#title#}
{eval var=#ErrorCity#}
{eval var=#ErrorState# assign="state_error"}
{$state_error}
OUTPUT:
This is the contents of foo.
Welcome to Foobar Pub &amp; Grill's home page!
You must supply a &lt;b&gt;city&lt;/b&gt;.
You must supply a &lt;b&gt;state&lt;/b&gt;.
</programlisting>
</example>
{eval var=$foo}
{eval var=#title#}
{eval var=#ErrorCity#}
{eval var=#ErrorState# assign="state_error"}
{$state_error}
]]>
</programlisting>
<para>
Ðåçóëüòàò âûïîëíåíèÿ äàííîãî ïðèìåðà:
</para>
<screen>
<![CDATA[
This is the contents of foo.
Welcome to Foobar Pub & Grill's home page!
You must supply a <strong>city</strong>.
You must supply a <strong>state</strong>.
]]>
</screen>
</example>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:

48
docs/ru/designers/language-custom-functions/language-function-fetch.xml
View File

@@ -1,8 +1,23 @@
<?xml version="1.0" encoding="windows-1251"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.4 Maintainer: freespace Status: ready -->
<!-- EN-Revision: 1.9 Maintainer: freespace Status: ready -->
<sect1 id="language.function.fetch">
<title>fetch</title>
<title>{fetch}</title>
<para>
fetch èñïîëüçóåòñÿ äëÿ îòîáðàæåíèÿ ñîäåðæèìîãî ëîêàëüíûõ ôàéëîâ,
http- èëè ftp-ñòðàíèö.
Åñëè èìÿ ôàéëà íà÷èíàåòñÿ ñ "http://", òî âåá-ñòðàíèöà áóäåò ïîëó÷åíà è
âûâåäåíà.
Åñëè èìÿ ôàéëà íà÷èíàåòñÿ ñ "ftp://", òî ôàéë áóäåò ïîëó÷åí ñ ftp-ñåðâåðà è
âûâåäåí. Äëÿ ëîêàëüíûõ ôàéëîâ äîëæåí áûòü óêàçàí àáñîëþòíûé ïóòü,
ëèáî ïóòü îòíîñèòåëüíî âûïîëíÿåìîãî PHP-ôàéëà.
</para>
<para>
Åñëè óêàçàòü ñïåöèàëíüûé àòðèáóò "assign", òî âûâîä ôóíêöèè {fetch}
áóäåò ïðèñâîåí ïåðåìåííîé øàáëîíà, âìåñòî îòîáðàæåíèÿ. Äîáàâëåíî â
Smarty âåðñèè 1.5.0.
</para>
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
@@ -37,19 +52,7 @@
</tbody>
</tgroup>
</informaltable>
<para>
fetch èñïîëüçóåòñÿ äëÿ îòîáðàæåíèÿ ëîêàëüíûõ ôàéëîâ, http èëè ftp
ñòðàíèö. Åñëè ôàéë íà÷èíàåòñÿ ñ "http://", òî âåáñòðàíèöà áóäåò
ïîëó÷åíà è âûâåäåíà. Åñëè ôàéë íà÷èíàåòñÿ ñ "ftp://", òî ôàéë áóäåò
ïîëó÷åí ñ ftp ñåðâåðà è âûâåäåí. Äëÿ ëîêàëüíûõ ôàéëîâ äîëæåí áûòü
óêàçàí ëèáî àáñîëþòíûé ïóòü, ëèáî ïóòü îòíîñèòåëüíî âûïîëíÿåìîãî
php ôàéëà.
</para>
<para>
Åñëè óêàçàòü ñïåöèàëíüûé àòðèáóò "assign", òî âûâîä ôóíêöèè fetch
áóäåò ïðèñâîåí ïåðåìåííîé âìåñòî îòîáðàæåíèÿ. Äîáàâëåíî â
Smarty âåðñèè 1.5.0.
</para>
<note>
<title>Òåõíè÷åñêîå Çàìå÷àíèå</title>
<para>
@@ -62,11 +65,12 @@
<para>
Åñëè âêëþ÷åíà security è óêàçàí ôàéë èç ëîêàëüíîé ôàéëîâîé
ñèñòåìû, òî îòîáðàçÿòñÿ ëèøü ôàéëû, êîòîðûé íàõîäÿòñÿ â
óêàçàíûõ áåçîïàñíûõ ïàïêàõ ($secure_dir).
óêàçàíûõ áåçîïàñíûõ ïàïêàõ
(<link linkend="variable.secure.dir">$secure_dir</link>).
</para>
</note>
<example>
<title>fetch</title>
<title>{fetch}</title>
<programlisting>
<![CDATA[
{* âêëþ÷àåì javascript â øàáëîí *}
@@ -81,11 +85,19 @@
{* ïðèñâàèâàåì ïîëó÷åííûé ôàéë ïåðåìåííîé *}
{fetch file="http://www.myweather.com/68502/" assign="weather"}
{if $weather ne ""}
&lt;b&gt;{$weather}&lt;/b&gt;
<b>{$weather}</b>
{/if}
]]>
</programlisting>
</example>
<para>
Ñì. òàêæå
<link linkend="language.function.capture">{capture}</link>,
<link linkend="language.function.eval">{eval}</link>
è
<link linkend="api.fetch">fetch()</link>.
</para>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:

77
docs/ru/designers/language-custom-functions/language-function-html-checkboxes.xml
View File

@@ -1,8 +1,17 @@
<?xml version="1.0" encoding="windows-1251"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.7 Maintainer: freespace Status: ready -->
<!-- EN-Revision: 1.11 Maintainer: freespace Status: ready -->
<sect1 id="language.function.html.checkboxes">
<title>html_checkboxes</title>
<title>{html_checkboxes}</title>
<para>
{html_checkboxes} ÿâëÿåòñÿ
<link linkend="language.custom.functions">ïîëüçîâàòåëüñêîé ôóíêöèåé</link>,
êîòîðàÿ ñîçäàåò ãðóïïó ôëàæêîâ â HTML ïî óêàçàííîé èíôîðìàöèè.
Òàêæå îíà îáåñïå÷èâàåò îòìåòêó ôëàæêîâ ïî óìîë÷àíèþ.
Ïàðàìåòðû values è output ÿâëÿþòñÿ îáÿçàòåëüíûìè, åñëè íå óêàçàí àòðèáóò
options. Âåñü âûâîä ñîâìåñòèì ñ XHTML.
</para>
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
@@ -72,42 +81,36 @@
</tbody>
</tgroup>
</informaltable>
<para>
Ïîëüçîâàòåëüñêàÿ ôóíêöèÿ html_checkboxes ãåíåðèðóåò ãðóïïó
HTML ôëàæêîâ ïî óêàçàííîé èíôîðìàöèè. Òàêæå çàáîòèòñÿ î
ôëàæêàõ, êîòîðûå âûáðàíû ïî óìîë÷àíèþ. Ïàðàìåòðû values è output
ÿâëÿþòñÿ îáÿçàòåëüíûìè, åñëè íå óêàçàí àòðèáóò options. Âåñü âûâîä
ñîâìåñòèì ñ XHTML.
</para>
<para>
Âñå ïàðàìåòðû, êîòîðûå íå óêàçàíû â ñïèñêå, âûâîäÿòñÿ â âèäå
ïàð name/value â êàæäîì ñîçäàííîì òýãå &lt;input&gt;.
</para>
<example>
<title>html_checkboxes</title>
<para>
Ãäå PHP êîä:
</para>
<title>{html_checkboxes}</title>
<programlisting role="php">
<![CDATA[
<?php
require('Smarty.class.php');
$smarty = new Smarty;
$smarty->assign('cust_ids', array(1000,1001,1002,1003));
$smarty->assign('cust_names', array('Joe Schmoe','Jack Smith','Jane Johnson','Charlie Brown'));
$smarty->assign('cust_names', array(
'Joe Schmoe',
'Jack Smith',
'Jane Johnson',
'Charlie Brown')
);
$smarty->assign('customer_id', 1001);
$smarty->display('index.tpl');
?>
]]>
</programlisting>
<para>
è øàáëîí index.tpl:
øàáëîí:
</para>
<programlisting>
<![CDATA[
{html_checkboxes name="id" values=$cust_ids selected=$customer_id output=$cust_names separator="<br />"}
{html_checkboxes name="id" values=$cust_ids output=$cust_names
selected=$customer_id separator="<br />"}
]]>
</programlisting>
<para>
@@ -123,14 +126,15 @@ $smarty->assign('cust_checkboxes', array(
1000 => 'Joe Schmoe',
1001 => 'Jack Smith',
1002 => 'Jane Johnson',
1003 => 'Charlie Brown'));
1003 => 'Charlie Brown')
);
$smarty->assign('customer_id', 1001);
$smarty->display('index.tpl');
?>
]]>
</programlisting>
<para>
è øàáëîí index.tpl:
øàáëîí:
</para>
<programlisting>
<![CDATA[
@@ -149,6 +153,35 @@ $smarty->display('index.tpl');
]]>
</screen>
</example>
<example>
<title>
Ïðèìåð ñ áàçîé äàííûõ (ê ïðèìåðó, PEAR èëè ADODB):
</title>
<programlisting role="php">
<![CDATA[
<?php
$sql = 'select type_id, types from types order by type';
$smarty->assign('types',$db->getAssoc($sql));
$sql = 'select * from contacts where contact_id=12';
$smarty->assign('contact',$db->getRow($sql));
?>
]]>
</programlisting>
<programlisting>
<![CDATA[
{html_checkboxes name="type" options=$types selected=$contact.type_id separator="<br />"}
]]>
</programlisting>
</example>
<para>
Ñì. òàêæå
<link linkend="language.function.html.radios">{html_radios}</link>
è
<link linkend="language.function.html.options">{html_options}</link>
</para>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:

71
docs/ru/designers/language-custom-functions/language-function-html-image.xml
View File

@@ -1,8 +1,15 @@
<?xml version="1.0" encoding="windows-1251"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.3 Maintainer: freespace Status: ready -->
<!-- EN-Revision: 1.7 Maintainer: freespace Status: ready -->
<sect1 id="language.function.html.image">
<title>html_image</title>
<title>{html_image}</title>
<para>
{html_image} ÿâëÿåòñÿ
<link linkend="language.custom.functions">ïîëüçîâàòåëüñêîé ôóíêöèåé</link>,
êîòîðàÿ ñîçäàåò HTML-òýãè äëÿ èçîáðàæåíèé. Âûñîòà è øèðèíà àâòîìàòè÷åñêè
âû÷èñëàþòñÿ èç ôàéëà èçîáðàæåíèÿ, åñëè îíè íå óêàçàíû ÿâíî.
</para>
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
@@ -62,19 +69,23 @@
<entry><emphasis>n/a</emphasis></entry>
<entry>çíà÷åíèå href, êóäà ññûëàåòñÿ êàðòèíêà</entry>
</row>
<row>
<entry>path_prefix</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>ïðåôèêñ ïóòè ðåçóëüòàòà</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para>
Ïîëüçîâàòåëüñêàÿ ôóíêöèÿ html_image ãåíåðèðóåò HTML äëÿ èçîáðàæåíèÿ.
Øèðèíà è âûñîòà àâòîìàòè÷åñêè âû÷èñëÿþòñÿ èç ôàéëà èçîáðàæåíèÿ, åñëè
íå óêàçàíû ÿâíî.
</para>
<para>
basedir - áàçîâàÿ ïàïêà äëÿ îòíîñèòåëüíûõ ïóòåé. Åñëè íå óêàçàíà,
òî èñïîëüçóåòñÿ êîðåíü âåá ñåðâåð (ïåðåìåííàÿ îêðóæåíè DOCUMENT_ROOT).
Åñëè security âêëþ÷åíî, òî ïóòü ê èçîáðàæåíèÿ äîëæåí áûòü â ïðåäåëàõ
áåçîïàñíûõ ïàïîê.
òî èñïîëüçóåòñÿ êîðåíü âåá ñåðâåð
(<link linkend="language.variables.smarty">ïåðåìåííàÿ îêðóæåíèÿ</link> DOCUMENT_ROOT).
Åñëè <link linkend="variable.security">$security</link> âêëþ÷åíî, òî ïóòü ê
ôàéëó èçîáðàæåíèÿ äîëæåí áûòü â ïðåäåëàõ áåçîïàñíîé äèðåêòîðèè.
</para>
<para>
Àòðèáóò link óêàçûâàåò, êóäà ññûëàåòñÿ èçîáðàæåíèå. Àòðèáóò
@@ -82,28 +93,30 @@
àòðèáóò link, òî èçîáðàæåíèå îêðóæàåòñÿ âûðàæåíèÿìè &lt;a
href="LINKVALUE"&gt; è &lt;a&gt;.
</para>
<para>
<parameter>path_prefix</parameter> - ýòî íåîáÿçàòåëüíûé ïðåôèêñ, êîòîðûé
âû ìîæåòå äîáàâèòü ê ïóòè ðåçóëüòàòà
Ýòî óäîáíî â ñëó÷àå, åñëè âû õîòèòå ïåðåäàòü äðóãîå ñåðâåðíîå èìÿ äëÿ
èçîáðàæåíèÿ.
</para>
<para>
Âñå ïàðàìåòðû, êîòîðûå íå óêàçàíû â ñïèñêå, âûâîäÿòñÿ â âèäå
ïàð name/value â êàæäîì ñîçäàííîì òýãå &lt;input&gt;.
</para>
<note>
<title>Òåõíè÷åñêîå Çàìå÷àíèå</title>
<para>
html_image òðåáóåò îáðàùåíèå ê äèñêó äëÿ ÷òåíèÿ èçîáðàæåíèÿ
è âû÷èñëåíèÿ åãî ðàçìåðîâ. Åñëè íå èñïîëüçóåòñÿ êýøèðîâàíèå
øàáëîíîâ, òî òîãäà ëóø÷å íå ïîëüçîâàòüñÿ òýãîì html_image
è âñòàâëÿòü ñòàòè÷åñêèå òýãè èçîáðàæåíèé, äëÿ äîñòèæåíèÿ
îïòèìàëüíîãî áûñòðîäåéñòâèÿ.
{html_image} òðåáóåò îáðàùåíèå ê äèñêó äëÿ ÷òåíèÿ èçîáðàæåíèÿ
è âû÷èñëåíèÿ åãî ðàçìåðîâ. Åñëè íå èñïîëüçóåòñÿ
<link linkend="caching">êýøèðîâàíèå</link> øàáëîíîâ,
òî òýã {html_image} ëó÷øå íå èñïîëüçîâàòü, à âñòàâëÿòü ñòàòè÷íûå òýãè
èçîáðàæåíèé äëÿ äîñòèæåíèÿ îïòèìàëüíîãî áûñòðîäåéñòâèÿ.
</para>
</note>
<example>
<title>html_image</title>
<title>{html_image}</title>
<programlisting>
<![CDATA[
index.php:
require('Smarty.php.class');
$smarty = new Smarty;
$smarty->display('index.tpl');
index.tpl:
{html_image file="pumpkin.jpg"}
{html_image file="/path/from/docroot/pumpkin.jpg"}
{html_image file="../path/relative/to/currdir/pumpkin.jpg"}
@@ -115,6 +128,16 @@ OUTPUT: (possible)
<img src="../path/relative/to/currdir/pumpkin.jpg" width="44" height="68">
]]>
</programlisting>
<para>
âîçìîæíûé ðåçóëüòàò:
</para>
<screen>
<![CDATA[
<img src="pumpkin.jpg" alt="" width="44" height="68" />
<img src="/path/from/docroot/pumpkin.jpg" alt="" width="44" height="68" />
<img src="../path/relative/to/currdir/pumpkin.jpg" alt="" width="44" height="68" />
]]>
</screen>
</example>
</sect1>
<!-- Keep this comment at the end of the file

166
docs/ru/designers/language-custom-functions/language-function-html-options.xml
View File

@@ -1,8 +1,16 @@
<?xml version="1.0" encoding="windows-1251"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.5 Maintainer: freespace Status: ready -->
<!-- EN-Revision: 1.12 Maintainer: freespace Status: ready -->
<sect1 id="language.function.html.options">
<title>html_options</title>
<title>{html_options}</title>
<para>{html_options} ÿâëÿåòñÿ
<link linkend="language.custom.functions">ïîëüçîâàòåëüñêîé ôóíêöèåé</link>,
êîòîðàÿ ñîçäàåò ãðóïïó HTML-òýãîâ option ïî óêàçàííîé èíôîðìàöèè.
Òàêæå îíà îáåñïå÷èâàåò âûáîð ýëåìåíòà ïî óìîë÷àíèþ.
Ïàðàìåòðû values è output ÿâëÿþòñÿ îáÿçàòåëüíûìè, åñëè íå óêàçàí àòðèáóò
options.
</para>
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
@@ -58,86 +66,128 @@
</tbody>
</tgroup>
</informaltable>
<para>
ïîëüçîâàòåëüñêàÿ ôóíêöèÿ html_options ãåíåðèðóåò ãðóïïó html òýãîâ
option ïî óêàçàííîé èíôîðìàöèè. Òàêæå çàáîòèòñÿ î âûáðàííûõ ïî
óìîë÷àíèþ ýëåìåíòàõ. Àòðèáóòû values è output îáÿçàòåëüíû, åñëè íå
óêàçàí àòðèáóò options.
Åñëè ïåðåäàííîå çíà÷åíèå - ìàññèâ, îíî áóäåò ïðèíÿòî çà HTML-òýã &lt;optgroup&gt;
è îòîáðàæåíî â âèäå ãðóïï. Â ýëåìåíòå &lt;optgroup&gt; ïîääåðæèâàåòñÿ ðåêóðñèÿ.
Âåñü âûâîä ñîâìåñòèì ñ XHTML.
</para>
<para>
Åñëè äàííîå çíà÷åíèå - ìàññèâ, òî îíî áóäåò ïðåäñòàâëåíî â âèäå
html OPTGROUP. Ðåêóðñèÿ ñ OPTGROUP ïîääåðæèâàåòñÿ. Âåñü âûâîä
ñîâìåñòèì ñ XHTML.
</para>
<para>
Åñëè óêàçàí íåîáÿçàòåëüíûé àòðèáóò <emphasis>name</emphasis>,
òî ãðóïïà îïöèé çàêëþ÷èòñÿ â òýã &lt;select
name="groupname"&gt; è &lt;/select&gt;, èíà÷å ñãåíåðèðóåòñÿ òîëüêî
ãðóïïà îïöèé.
Åñëè óêàçàí íåîáÿçàòåëüíûé ïàðàìåòð <emphasis>name</emphasis>, ñïèñîê áóäåò
îêðóæåí òýãîì &lt;select name="groupname"&gt;&lt;/select&gt;.
 ïðîòèâíîì ñëó÷àå áóäóò ñãåíåðèðîâàíû ëèøü ýëåìåíòû &lt;option&gt;.
</para>
<para>
Âñå ïàðàìåòðû, êîòîðûå íå óêàçàíû âûøå, âûâîäÿòñÿ â âèäå
ïàðû name/value âíóòðè òýãà &lt;select&gt;. Îíè èãíîðèðóþòñÿ,
åñëè àòðèáóò <emphasis>name</emphasis> íå óêàçàí.
ïàð name/value â òýãå &lt;select&gt;. Åñëè íåîáÿçàòåëüíûé
ïàðàìåòð <emphasis>name</emphasis> íå óêàçàí, îíè èãíîðèðóþòñÿ.
</para>
<example>
<title>html_options</title>
<title>{html_options}</title>
<para>
<emphasis role="bold">Ïðèìåð ¹1:</emphasis>
</para>
<programlisting role="php">
<![CDATA[
<?php
$smarty->assign('cust_ids', array(1000,1001,1002,1003));
$smarty->assign('cust_names', array(
'Joe Schmoe',
'Jack Smith',
'Jane Johnson',
'Charlie Brown'));
$smarty->assign('customer_id', 1001);
?>
]]>
</programlisting>
<para>
Øàáëîí:
</para>
<programlisting>
<![CDATA[
ÏÐÈÌÅÐ 1
--------
index.php:
require('Smarty.php.class');
$smarty = new Smarty;
$smarty->assign('cust_ids', array(1000,1001,1002,1003));
$smarty->assign('cust_names', array('Joe Schmoe','Jack Smith','Jane
Johnson','Charlie Brown'));
$smarty->assign('customer_id', 1001);
$smarty->display('index.tpl');
index.tpl:
<select name=customer_id>
{html_options values=$cust_ids selected=$customer_id output=$cust_names}
<select name="customer_id">
{html_options values=$cust_ids output=$cust_names selected=$customer_id}
</select>
]]>
</programlisting>
<para>
<emphasis role="bold">Ïðèìåð ¹2:</emphasis>
</para>
<programlisting role="php">
<![CDATA[
<?php
ÏÐÈÌÅÐ 2
--------
index.php:
require('Smarty.php.class');
$smarty = new Smarty;
$smarty->assign('cust_options', array(
1001 => 'Joe Schmoe',
1002 => 'Jack Smith',
1003 => 'Jane Johnson',
1004 => 'Charlie Brown'));
1000 => 'Joe Schmoe',
1001 => 'Jack Smith',
1002 => 'Jane Johnson',
1003 => 'Charlie Brown')
);
$smarty->assign('customer_id', 1001);
$smarty->display('index.tpl');
index.tpl:
<select name=customer_id>
{html_options options=$cust_options selected=$customer_id}
?>
]]>
</programlisting>
<para>
Øàáëîí:
</para>
<programlisting>
<![CDATA[
{html_options name=customer_id options=$cust_options selected=$customer_id}
]]>
</programlisting>
<para>
Ðåçóëüòàò âûïîëíåíèÿ îáîèõ ïðèìåðîâ áóäåò ñëåäóþùèì:
</para>
<screen>
<![CDATA[
<select name="customer_id">
<option label="Joe Schmoe" value="1000">Joe Schmoe</option>
<option label="Jack Smith" value="1001" selected="selected">Jack Smith</option>
<option label="Jane Johnson" value="1002">Jane Johnson</option>
<option label="Charlie Brown" value="1003">Charlie Brown</option>
</select>
]]>
</screen>
</example>
<example>
<title>{html_options} - Ïðèìåð ñ áàçîé äàííûõ (ê ïðèìåðó, PEAR èëè ADODB):</title>
<programlisting role="php">
<![CDATA[
<?php
$sql = 'select type_id, types from types order by type';
$smarty->assign('types',$db->getAssoc($sql));
ÐÅÇÓËÜÒÀÒ: (îáà ïðèìåðà)
------------------------
$sql = 'select contact_id, name, email, type_id
from contacts where contact_id='.$contact_id;
$smarty->assign('contact',$db->getRow($sql));
<select name=customer_id>
<option label="Joe Schmoe" value="1000">Joe Schmoe</option>
<option label="Jack Smith" value="1001" selected="selected">Jack Smith</option>
<option label="Jane Johnson" value="1002">Jane Johnson</option>
<option label="Charlie Brown" value="1003">Charlie Brown</option>
?>
]]>
</programlisting>
<para>
Øàáëîí:
</para>
<programlisting>
<![CDATA[
<select name="type_id">
<option value='null'>-- none --</option>
{html_options name="type" options=$types selected=$contact.type_id}
</select>
]]>
</programlisting>
</example>
<para>
Ñì. òàêæå
<link linkend="language.function.html.checkboxes">{html_checkboxes}</link>
è
<link linkend="language.function.html.radios">{html_radios}</link>
</para>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

151
docs/ru/designers/language-custom-functions/language-function-html-radios.xml
View File

@@ -1,8 +1,16 @@
<?xml version="1.0" encoding="windows-1251"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.4 Maintainer: freespace Status: ready -->
<!-- EN-Revision: 1.11 Maintainer: freespace Status: ready -->
<sect1 id="language.function.html.radios">
<title>html_radios</title>
<title>{html_radios}</title>
<para>{html_radios} ÿâëÿåòñÿ
<link linkend="language.custom.functions">ïîëüçîâàòåëüñêîé ôóíêöèåé</link>,
êîòîðàÿ ñîçäàåò ãðóïïó ðàäèîêíîïîê â HTML ïî óêàçàííîé èíôîðìàöèè.
Òàêæå îíà îáåñïå÷èâàåò âûáîð ðàäèîêíîïêè ïî óìîë÷àíèþ.
Ïàðàìåòðû values è output ÿâëÿþòñÿ îáÿçàòåëüíûìè, åñëè íå óêàçàí àòðèáóò
options. Âåñü âûâîä ñîâìåñòèì ñ XHTML.
</para>
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
@@ -66,62 +74,108 @@
</tbody>
</tgroup>
</informaltable>
<para>
Ïîëüçîâàòåëüñÿêàÿ ôóíêöèÿ html_radios ãåíåðèðóåò HMTL êîä
ãðóïïû ýëåìåíòîâ âûáîðà (radio button group). Àâòîìàòè÷åñêè
óñòàíàâëèâàåò âûáðàííîå çíà÷åíèå, åñëè îíî óêçàíî. Òðåáóåò
íàëè÷èÿ àòðèáóòîâ values è output èëè àòðèáóòà options.
Ñãåíåðèðîâàííûé HMTL êîä ñîâìåñòèì ñ XHTML.
</para>
<para>
Âñå ïàðàìåòðû, êîòîðûå íå óêàçàíû â òàáëèöå âûøå, ïåðåäàþòñÿ
è âûâîäÿòñÿ âíóòðè êàæäîãî ñîçäàííîãî òýãà &lt;input&gt;.
Âñå ïàðàìåòðû, êîòîðûå íå óêàçàíû â ñïèñêå, âûâîäÿòñÿ â âèäå
ïàð name/value â êàæäîì ñîçäàííîì òýãå &lt;input&gt;.
</para>
<example>
<title>html_radios</title>
<title>{html_radios}: Ïðèìåð ¹1</title>
<programlisting role="php">
<![CDATA[
<?php
$smarty->assign('cust_ids', array(1000,1001,1002,1003));
$smarty->assign('cust_names', array(
'Joe Schmoe',
'Jack Smith',
'Jane Johnson',
'Charlie Brown')
);
$smarty->assign('customer_id', 1001);
?>
]]>
</programlisting>
<para>
Øàáëîí:
</para>
<programlisting>
index.php:
<![CDATA[
{html_radios name="id" values=$cust_ids output=$cust_names
selected=$customer_id separator="<br />"}
]]>
</programlisting>
</example>
<example>
<title>{html_radios}: Ïðèìåð ¹2</title>
<programlisting role="php">
<![CDATA[
<?php
require('Smarty.class.php');
$smarty = new Smarty;
$smarty-&gt;assign('cust_ids', array(1000,1001,1002,1003));
$smarty-&gt;assign('cust_names', array('Joe Schmoe','Jack Smith','Jane
Johnson','Charlie Brown'));
$smarty-&gt;assign('customer_id', 1001);
$smarty-&gt;display('index.tpl');
$smarty->assign('cust_radios', array(
1000 => 'Joe Schmoe',
1001 => 'Jack Smith',
1002 => 'Jane Johnson',
1003 => 'Charlie Brown'));
$smarty->assign('customer_id', 1001);
?>
]]>
</programlisting>
<para>
Øàáëîí:
</para>
<programlisting>
<![CDATA[
{html_radios name="id" options=$cust_radios selected=$customer_id separator="<br />"}
]]>
</programlisting>
<para>
Both examples will output:
</para>
<screen>
<![CDATA[
<label for="id_1000">
<input type="radio" name="id" value="1000" id="id_1000" />Joe Schmoe</label><br />
<label for="id_1001"><input type="radio" name="id" value="1001" id="id_1001" checked="checked" />Jack Smith</label><br />
<label for="id_1002"><input type="radio" name="id" value="1002" id="id_1002" />Jane Johnson</label><br />
<label for="id_1003"><input type="radio" name="id" value="1003" id="id_1003" />Charlie Brown</label><br />
]]>
</screen>
</example>
<example>
<title>{html_radios}- Ïðèìåð ñ áàçîé äàííûõ (ê ïðèìåðó, PEAR èëè ADODB):</title>
<programlisting role="php">
<![CDATA[
<?php
index.tpl:
$sql = 'select type_id, types from types order by type';
$smarty->assign('types',$db->getAssoc($sql));
{html_radios name="id" values=$cust_ids selected=$customer_id output=$cust_names separator="&lt;br /&gt;"}
$sql = 'select contact_id, name, email, type_id
from contacts where contact_id='.$contact_id;
$smarty->assign('contact',$db->getRow($sql));
index.php:
require('Smarty.class.php');
$smarty = new Smarty;
$smarty-&gt;assign('cust_radios', array(
1000 =&gt; 'Joe Schmoe',
1001 =&gt; 'Jack Smith',
1002 =&gt; 'Jane Johnson',
1003 =&gt; 'Charlie Brown'));
$smarty-&gt;assign('customer_id', 1001);
$smarty-&gt;display('index.tpl');
index.tpl:
{html_radios name="id" options=$cust_radios selected=$customer_id separator="&lt;br /&gt;"}
OUTPUT: (both examples)
&lt;label for="id_1000"&gt;&lt;input type="radio" name="id" value="1000" id="id_1000" /&gt;Joe Schmoe&lt;/label&gt;&lt;br /&gt;
&lt;label for="id_1001"&gt;&lt;input type="radio" name="id" value="1001" id="id_1001" checked="checked" /&gt;Jack Smith&lt;/label&gt;&lt;br /&gt;
&lt;label for="id_1002"&gt;&lt;input type="radio" name="id" value="1002" id="id_1002" /&gt;Jane Johnson&lt;/label&gt;&lt;br /&gt;
&lt;label for="id_1003"&gt;&lt;input type="radio" name="id" value="1003" id="id_1003" /&gt;Charlie Brown&lt;/label&gt;&lt;br /&gt;</programlisting>
</example>
?>
]]>
</programlisting>
<para>
Øàáëîí:
</para>
<programlisting>
<![CDATA[
{html_radios name="type" options=$types selected=$contact.type_id separator="<br />"}
]]>
</programlisting>
</example>
<para>
Ñì. òàêæå
<link linkend="language.function.html.checkboxes">{html_checkboxes}</link>
è
<link linkend="language.function.html.options">{html_options}</link>
</para>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
@@ -143,3 +197,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

128
docs/ru/designers/language-custom-functions/language-function-html-select-date.xml
View File

@@ -1,8 +1,15 @@
<?xml version="1.0" encoding="windows-1251"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.4 Maintainer: freespace Status: ready -->
<!-- EN-Revision: 1.10 Maintainer: freespace Status: ready -->
<sect1 id="language.function.html.select.date">
<title>html_select_date</title>
<title>{html_select_date}</title>
<para>
{html_select_date} ÿâëÿåòñÿ
<link linkend="language.custom.functions">ïîëüçîâàòåëüñêîé ôóíêöèåé</link>,
êîòîðàÿ ñîçäàåò âûïàäàþùåå ìåíþ äëÿ âûáîðà äàòû.
Îíà ìîæåò îòîáðàæàòü ïîëÿ äëÿ ãîäà, ìåñÿöà è äíÿ.
</para>
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
@@ -206,32 +213,70 @@
Ïî óìîë÷àíèþ - %m (íîìåð ìåñÿöà).
</entry>
</row>
<row>
<entry>year_empty</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry>null</entry>
<entry>
Åñëè óêàçàí, ïåðâûé ïóíêò ýëåìåíòà äëÿ âûáîðà ãîäà ñòàíåò òàêîé íàäïèñüþ
ñ ïóñòûì ("") çíà÷åíèåì.
Ýòî óäîáíî äëÿ ñîçäàíèÿ íàäïèñåé âðîäå "Ïîæàëóéñòà, âûáåðèòå ãîä" â
êà÷åñòâå ïåðâîãî ïóíêòà âûïàäàþùåãî ìåíþ.
Îáðàòèòå âíèìàíèå, ÷òî âû ìîæåòå èñïîëüçîâàòü çíà÷åíèÿ òèïà "-MM-DD"
äëÿ àòðèáóòà time, ÷òîáû íå âûáèðàòü ãîä çàðàíåå.
</entry>
</row>
<row>
<entry>month_empty</entry>
<entry>string</entry>
<entry>No</entry>
<entry>null</entry>
<entry>
Åñëè óêàçàí, ïåðâûé ïóíêò ýëåìåíòà äëÿ âûáîðà ìåñÿöà ñòàíåò òàêîé íàäïèñüþ
ñ ïóñòûì ("") çíà÷åíèåì.
Îáðàòèòå âíèìàíèå, ÷òî âû ìîæåòå èñïîëüçîâàòü çíà÷åíèÿ òèïà "YYYY--DD"
äëÿ àòðèáóòà time, ÷òîáû íå âûáèðàòü ìåñÿö çàðàíåå.
</entry>
</row>
<row>
<entry>day_empty</entry>
<entry>string</entry>
<entry>No</entry>
<entry>null</entry>
<entry>
Åñëè óêàçàí, ïåðâûé ïóíêò ýëåìåíòà äëÿ âûáîðà äíÿ ñòàíåò òàêîé íàäïèñüþ
ñ ïóñòûì ("") çíà÷åíèåì.
Îáðàòèòå âíèìàíèå, ÷òî âû ìîæåòå èñïîëüçîâàòü çíà÷åíèÿ òèïà "YYY-MM-"
äëÿ àòðèáóòà time, ÷òîáû íå âûáèðàòü äåíü çàðàíåå.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para>
ïîëüçîâàòåëüñêàÿ ôóíêöèÿ html_select_date ãåíåðèðóåò ïîëÿ âûáîðà
äàòû.
Âñå ïàðàìåòðû, êîòîðûå íå óêàçàíû â ñïèñêå, âûâîäÿòñÿ â âèäå
ïàð name/value â êàæäîì ñîçäàííîì òýãå &lt;select&gt; äëÿ äíÿ,
ìåñÿöà è ãîäà.
</para>
<example>
<title>html_select_date</title>
<title>{html_select_date}</title>
<para>Øàáëîí:</para>
<programlisting>
<![CDATA[
{html_select_date}
ÂÛÂÎÄ:
]]>
</programlisting>
<para>
Ðåçóëüòàò îáðàáîòêè øàáëîíà:
</para>
<screen>
<![CDATA[
<select name="Date_Month">
<option value="1">January</option>
<option value="2">February</option>
<option value="3">March</option>
<option value="4">April</option>
<option value="5">May</option>
<option value="6">June</option>
<option value="7">July</option>
<option value="8">August</option>
<option value="9">September</option>
..... snipped .....
<option value="10">October</option>
<option value="11">November</option>
<option value="12" selected="selected">December</option>
@@ -240,31 +285,13 @@
<option value="1">01</option>
<option value="2">02</option>
<option value="3">03</option>
<option value="4">04</option>
<option value="5">05</option>
<option value="6">06</option>
<option value="7">07</option>
<option value="8">08</option>
<option value="9">09</option>
<option value="10">10</option>
..... snipped .....
<option value="11">11</option>
<option value="12">12</option>
<option value="13" selected="selected">13</option>
<option value="14">14</option>
<option value="15">15</option>
<option value="16">16</option>
<option value="17">17</option>
<option value="18">18</option>
<option value="19">19</option>
<option value="20">20</option>
<option value="21">21</option>
<option value="22">22</option>
<option value="23">23</option>
<option value="24">24</option>
<option value="25">25</option>
<option value="26">26</option>
<option value="27">27</option>
<option value="28">28</option>
..... snipped .....
<option value="29">29</option>
<option value="30">30</option>
<option value="31">31</option>
@@ -273,18 +300,23 @@
<option value="2001" selected="selected">2001</option>
</select>
]]>
</programlisting>
</screen>
</example>
<example>
<title>html_select_date</title>
<title>{html_select_date}</title>
<programlisting>
<![CDATA[
{* ãîä íà÷àëà è êîíöà ìîãóò áûòü çàäàíû îòíîñèòåëüíî òåêóùåãî ãîäà *}
{html_select_date prefix="StartDate" time=$time start_year="-5" end_year="+1" display_days=false}
ÂÛÂÎÄ: (òåêóùèé ãîä - 2000)
{* ãîäà íà÷àëà è êîíöà ìîãóò áûòü çàäàíû îòíîñèòåëüíî òåêóùåãî ãîäà *}
{html_select_date prefix="StartDate" time=$time start_year="-5"
end_year="+1" display_days=false}
]]>
</programlisting>
<para>
Ðåçóëüòàòîì îáðàáîòêè øàáëîíà áóäåò: (òåêóùèé ãîä - 2000)
</para>
<screen>
<![CDATA[
<select name="StartDateMonth">
<option value="1">January</option>
<option value="2">February</option>
@@ -309,10 +341,18 @@
<option value="2001">2001</option>
</select>
]]>
</programlisting>
</screen>
</example>
<para>
Ñì. òàêæå
<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>
è
<link linkend="tips.dates">Ñîâåòû îòíîñèòåëüíî äàò</link>.
</para>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

319
docs/ru/designers/language-custom-functions/language-function-html-select-time.xml
View File

@@ -1,171 +1,161 @@
<?xml version="1.0" encoding="windows-1251"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.3 Maintainer: freespace Status: ready -->
<!-- EN-Revision: 1.7 Maintainer: freespace Status: ready -->
<sect1 id="language.function.html.select.time">
<title>html_select_time</title>
<title>{html_select_time}</title>
<para>
{html_select_time} ÿâëÿåòñÿ
<link linkend="language.custom.functions">ïîëüçîâàòåëüñêîé ôóíêöèåé</link>,
êîòîðàÿ ñîçäàåò âûïàäàþùåå ìåíþ äëÿ âûáîðà âðåìåíè.
Îíà ìîæåò îòîáðàæàòü ïîëÿ äëÿ ÷àñà, ìèíóòû, ñåêóíäû è ìåðèäèàíà.
</para>
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
<colspec colname="type" align="center" />
<colspec colname="required" align="center" />
<colspec colname="default" align="center" />
<colspec colname="desc" />
<thead>
<row>
<entry>Èìÿ àòðèáóòà</entry>
<entry>Òèï</entry>
<entry>Îáÿçàòåëåí</entry>
<entry>Ïî óìîë÷àíèþ</entry>
<entry>Îïèñàíèå</entry>
</row>
</thead>
<tbody>
<row>
<entry>prefix</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry>Time_</entry>
<entry>ïðåôèêñ íàçâàíèé ïåðåìåííûõ</entry>
</row>
<row>
<entry>time</entry>
<entry>timestamp</entry>
<entry>Íåò</entry>
<entry>òåêóùåå âðåìÿ</entry>
<entry>èñïîëüçóåìîå âðåìÿ</entry>
</row>
<row>
<entry>display_hours</entry>
<entry>boolean</entry>
<entry>Íåò</entry>
<entry>true</entry>
<entry>âûâîäèòü ÷àñû</entry>
</row>
<row>
<entry>display_minutes</entry>
<entry>boolean</entry>
<entry>Íåò</entry>
<entry>true</entry>
<entry>âûâîäèòü ìèíóòû</entry>
</row>
<row>
<entry>display_seconds</entry>
<entry>boolean</entry>
<entry>Íåò</entry>
<entry>true</entry>
<entry>âûâîäèòü ñåêóíäû</entry>
</row>
<row>
<entry>display_meridian</entry>
<entry>boolean</entry>
<entry>Íåò</entry>
<entry>true</entry>
<entry>âûâîäèòü ìåðèäèàí (am/pm)</entry>
</row>
<row>
<entry>use_24_hours</entry>
<entry>boolean</entry>
<entry>Íåò</entry>
<entry>true</entry>
<entry>èñïîëüçîâàòü 24-÷àñîâîé ôîðìàò âðåìåíè</entry>
</row>
<row>
<entry>minute_interval</entry>
<entry>integer</entry>
<entry>Íåò</entry>
<entry>1</entry>
<entry>èíòåðâàë ýëåìåíòîâ âûïàäàþùåãî ñïèñêà ìèíóò</entry>
</row>
<row>
<entry>second_interval</entry>
<entry>integer</entry>
<entry>Íåò</entry>
<entry>1</entry>
<entry>èíòåðâàë ýëåìåíòîâ âûïàäàþùåãî ñïèñêà ñåêóíä</entry>
</row>
<row>
<entry>field_array</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry>n/a</entry>
<entry>
íàçâàíèå ïåðåìåííîé, â êîòîðóþ ïåðåäàäóòñÿ âûáðàííûå çíà÷åíèÿ
â âèäå ìàññèâà
</entry>
</row>
<row>
<entry>all_extra</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry>null</entry>
<entry>
óêàçûâàåò äîïîëíèòåëüíûå àòðèáóòû äëÿ âñåõ òýãîâ select/input
</entry>
</row>
<row>
<entry>hour_extra</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry>null</entry>
<entry>
óêàçûâàåò äîïîëíèòåëüíûå àòðèáóòû äëÿ òýãîâ select/input
äëÿ âûáîðà ÷àñîâ
</entry>
</row>
<row>
<entry>minute_extra</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry>null</entry>
<entry>
óêàçûâàåò äîïîëíèòåëüíûå àòðèáóòû äëÿ òýãîâ select/input
äëÿ âûáîðà ìèíóò
</entry>
</row>
<row>
<entry>second_extra</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry>null</entry>
<entry>
óêàçûâàåò äîïîëíèòåëüíûå àòðèáóòû äëÿ òýãîâ select/input
äëÿ âûáîðà ñåêóíä
</entry>
</row>
<row>
<entry>meridian_extra</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry>null</entry>
<entry>
óêàçûâàåò äîïîëíèòåëüíûå àòðèáóòû äëÿ òýãîâ select/input
äëÿ âûáîðà ìåðèäèàí
</entry>
</row>
</tbody>
<colspec colname="param" align="center" />
<colspec colname="type" align="center" />
<colspec colname="required" align="center" />
<colspec colname="default" align="center" />
<colspec colname="desc" />
<thead>
<row>
<entry>Èìÿ àòðèáóòà</entry>
<entry>Òèï</entry>
<entry>Îáÿçàòåëåí</entry>
<entry>Ïî óìîë÷àíèþ</entry>
<entry>Îïèñàíèå</entry>
</row>
</thead>
<tbody>
<row>
<entry>prefix</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry>Time_</entry>
<entry>ïðåôèêñ äëÿ èìåí ïåðåìåííûõ</entry>
</row>
<row>
<entry>time</entry>
<entry>timestamp</entry>
<entry>Íåò</entry>
<entry>òåêóùåå âðåìÿ</entry>
<entry>êàêóþ äàòó/âðåìÿ èñïîëüçîâàòü</entry>
</row>
<row>
<entry>display_hours</entry>
<entry>boolean</entry>
<entry>Íåò</entry>
<entry>true</entry>
<entry>îòîáðàæàòü ëè ÷àñû</entry>
</row>
<row>
<entry>display_minutes</entry>
<entry>boolean</entry>
<entry>Íåò</entry>
<entry>true</entry>
<entry>Îòîáðàæàòü ëè ìèíóòû</entry>
</row>
<row>
<entry>display_seconds</entry>
<entry>boolean</entry>
<entry>Íåò</entry>
<entry>true</entry>
<entry>Îòîáðàæàòü ëè ñåêóíäû</entry>
</row>
<row>
<entry>display_meridian</entry>
<entry>boolean</entry>
<entry>Íåò</entry>
<entry>true</entry>
<entry>îòîáðàæàòü ëè ìåðèäèàí (am/pm)</entry>
</row>
<row>
<entry>use_24_hours</entry>
<entry>boolean</entry>
<entry>Íåò</entry>
<entry>true</entry>
<entry>èñïîëüçîâàòü ëè 24-÷àñîâîé ôîðìàò</entry>
</row>
<row>
<entry>minute_interval</entry>
<entry>integer</entry>
<entry>Íåò</entry>
<entry>1</entry>
<entry>èíòåðâàë ïóíêòîâ âûïàäàþùåãî ìåíþ ìèíóò</entry>
</row>
<row>
<entry>second_interval</entry>
<entry>integer</entry>
<entry>Íåò</entry>
<entry>1</entry>
<entry>èíòåðâàë ïóíêòîâ âûïàäàþùåãî ìåíþ ñåêóíä</entry>
</row>
<row>
<entry>field_array</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry>n/a</entry>
<entry>ïðèñâîèòü çíà÷åíèÿ ìàññèâó ñ òàêèì èìåíåì</entry>
</row>
<row>
<entry>all_extra</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry>null</entry>
<entry>äîáàâëÿåò äîïîëíèòåëüíûå àòðèáóòû ê òýãàì select/input</entry>
</row>
<row>
<entry>hour_extra</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry>null</entry>
<entry>äîáàâëÿåò äîïîëíèòåëüíûå àòðèáóòû ê òýãó select ÷àñà</entry>
</row>
<row>
<entry>minute_extra</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry>null</entry>
<entry>äîáàâëÿåò äîïîëíèòåëüíûå àòðèáóòû ê òýãó select ìèíóòû</entry>
</row>
<row>
<entry>second_extra</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry>null</entry>
<entry>äîáàâëÿåò äîïîëíèòåëüíûå àòðèáóòû ê òýãó select ñåêóíäû</entry>
</row>
<row>
<entry>meridian_extra</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry>null</entry>
<entry>äîáàâëÿåò äîïîëíèòåëüíûå àòðèáóòû ê òýãó select ìåðèäèàíà</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para>
Ïîëüçîâàòåëüñêàÿ ôóíêöèÿ html_select_time ãåíåðèðóåò HTML ïîëÿ
äëÿ âûáîðà âðåìåíè. Îíà ìîæåò âûáîðî÷íî îòîáðàæàòü ïîëÿ äëÿ ÷àñîâ,
ìèíóò, ñåêóíä è ìåðèäèàíà.
</para>
<para>
Àòòðèáóò time èìååò íåñêîëüêî ðàçíûõ ôîðìàòîâ:
îí ìîýåò áûòü ïðåäñòàâëåí â âèäå óíèêàëüíîé âðåìåííîé
ìåòêè (UNIX timestamp) èëè ñòðîêè â ôîðìàòå
ÃÃÃÃÌÌÄÄ××ÌÌÑÑ èëè ëþáî äðóãîé ñòðîêè, êîòîðóþ ìîæåò
îáðàáîòàòü PHP-ôóíêöèÿ strtotime().
Àòðèáóò time ìîæåò èìåòü ðàçíûå ôîðìàòû.
Îí ìîæåò áûòü óíèêàëüíîé âðåìåííîé ìåòêîé (Unix timestamp),
ñòðîêîé ôîðìàòà YYYYMMDDHHMMSS èëè ëþáîé äðóãîé ñòðîêîé,
êîòîðóþ ìîæåò îáðàáîòàòü ôóíêöèÿ PHP
<ulink url="&url.php-manual;strtotime">strtotime()</ulink>.
</para>
<example>
<title>html_select_time</title>
<programlisting>
<title>{html_select_time}</title>
<para>Øàáëîí:</para>
<programlisting>
<![CDATA[
{html_select_time use_24_hours=true}
ÂÛÂÎÄ:
]]>
</programlisting>
<para>
Ðåçóëüòàò îáðàáîòêè øàáëîíà:
</para>
<screen>
<![CDATA[
<select name="Time_Hour">
<option value="00">00</option>
<option value="01">01</option>
@@ -176,7 +166,7 @@
<option value="06">06</option>
<option value="07">07</option>
<option value="08">08</option>
<option value="09" selected="selected">09</option>
<option value="09" selected>09</option>
<option value="10">10</option>
<option value="11">11</option>
<option value="12">12</option>
@@ -213,7 +203,7 @@
<option value="17">17</option>
<option value="18">18</option>
<option value="19">19</option>
<option value="20" selected="selected">20</option>
<option value="20" selected>20</option>
<option value="21">21</option>
<option value="22">22</option>
<option value="23">23</option>
@@ -278,7 +268,7 @@
<option value="20">20</option>
<option value="21">21</option>
<option value="22">22</option>
<option value="23" selected="selected">23</option>
<option value="23" selected>23</option>
<option value="24">24</option>
<option value="25">25</option>
<option value="26">26</option>
@@ -317,12 +307,19 @@
<option value="59">59</option>
</select>
<select name="Time_Meridian">
<option value="am" selected="selected">AM</option>
<option value="am" selected>AM</option>
<option value="pm">PM</option>
</select>
]]>
</programlisting>
</screen>
</example>
<para>
Ñì. òàêæå
<link linkend="language.variables.smarty.now">$smarty.now</link>,
<link linkend="language.function.html.select.date">{html_select_date}</link>
è
<link linkend="tips.dates">Ñîâåòû îòíîñèòåëüíî äàò</link>.
</para>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:

262
docs/ru/designers/language-custom-functions/language-function-html-table.xml
View File

@@ -1,147 +1,154 @@
<?xml version="1.0" encoding="windows-1251"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.6 Maintainer: freespace Status: ready -->
<!-- EN-Revision: 1.9 Maintainer: freespace Status: ready -->
<sect1 id="language.function.html.table">
<title>html_table</title>
<title>{html_table}</title>
<para>
{html_table} ÿâëÿåòñÿ
<link linkend="language.custom.functions">ïîëüçîâàòåëüñêîé ôóíêöèåé</link>,
êîòîðàÿ ðàñïå÷àòûâàåò ìàññèâ äàííûõ â HTML-òýã table.
Àòðèáóò <emphasis>cols</emphasis> óêàçûâàåò, ñêîëüêî â òàáëèöå áóäåò êîëîíîê.
Àòðèáóòû <emphasis>table_attr</emphasis>, <emphasis>tr_attr</emphasis> è
<emphasis>td_attr</emphasis> îïðåäåëÿþò àòðèáóòû ñîîòâåòñòâóþùèõ ýëåìåíòîâ
òàáëèöû - òýãîâ table, tr è td. Åñëè ïàðàìåòðû <emphasis>tr_attr</emphasis>
èëè <emphasis>td_attr</emphasis> ÿâëÿþòñÿ ìàññèâàìè, èõ çíà÷åíèÿ áóäóò
èñïîëüçîâàòüñÿ öèêëè÷åñêè. <emphasis>trailpad</emphasis> - ýòî çíà÷åíèå,
ïîìåùàåìîå â ïóñòûå ÿ÷åéêè ïîñëåäíåé ñòðîêè, åñëè òàêèå áóäóò.
</para>
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
<colspec colname="type" align="center" />
<colspec colname="required" align="center" />
<colspec colname="default" align="center" />
<colspec colname="desc" />
<thead>
<row>
<entry>Èìÿ àòðèáóòà</entry>
<entry>Òèï</entry>
<entry>Îáÿçàòåëåí</entry>
<entry>Ïî óìîë÷àíèþ</entry>
<entry>Îïèñàíèå</entry>
</row>
</thead>
<tbody>
<row>
<entry>loop</entry>
<entry>array</entry>
<entry>Äà</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>ìàññèâ äàííûõ, ïî êîòîðîìó áóäåò ïðîèçâåäåí îáõîä</entry>
</row>
<row>
<entry>cols</entry>
<entry>integer</entry>
<entry>Íåò</entry>
<entry><emphasis>3</emphasis></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>
êîëè÷åñòâî ñòðîê â òàáëèöå. åñëè àòðèáóò rows íå óêàçàí, íî óêàçàí cols,
òîãäà êîë-âî ñòðîê â³÷èñëÿåòñÿ èñõîäÿ èç êîë-âà êîëîíîê è êîë-âà
ýëåìåíòîâ, êîòîðûå íåîáõîäèìî îòîáðàçèòü.
</entry>
</row>
<row>
<entry>inner</entry>
<entry>string</entry>
<entry>No</entry>
<entry><emphasis>cols</emphasis></entry>
<entry>
íàïðàâëåíèå ïîñëåäîâàòåëüíîãî îòîáðàæåíèÿ ýëåìåíòîâ èç ìàññèâà loop.
<emphasis>cols</emphasis> îçíà÷àåò, ÷òî ýëåìåíòû îòîáðàæàþòñÿ êîëîíêà
çà êîëîíêîé.
<emphasis>rows</emphasis> îçíà÷àåò, ÷òî ýëåìåíòû îòîáðàæàþòñÿ ñòðîêà
çà ñòðîêîé.
</entry>
</row>
<row>
<entry>table_attr</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>border="1"</emphasis></entry>
<entry>äîïîëíèòåëüíûå àòðèáóòû òýãà table</entry>
</row>
<row>
<entry>tr_attr</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>ïóñòî</emphasis></entry>
<entry>äîïîëíèòåëüíûå àòðèáóòû òýãà tr (åñëè óêàçàí
ìàññèâ, òî åãî ýëåìåíòû öèêëè÷åñêè ïîâòîðÿþòñÿ)</entry>
</row>
<row>
<entry>td_attr</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>ïóñòî</emphasis></entry>
<entry>äîïîëíèòåëüíûå àòðèáóòû òýãà td (åñëè óêàçàí
ìàññèâ, òî åãî ýëåìåíòû öèêëè÷åñêè ïîâòîðÿþòñÿ)</entry>
</row>
<row>
<entry>trailpad</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>&amp;nbsp;</emphasis></entry>
<entry>çíà÷åíèå îñòàòî÷íûõ ÿ÷ååê íà ïîñëåäíåé ñòðîêå òàáèëöû</entry>
</row>
<row>
<entry>hdir</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>right</emphasis></entry>
<entry>
íàïðàâëåíèå îòîáðàæåíèÿ êàæäîãî ðÿäà. äîïóñòèìûå çíà÷åíèÿ:
<emphasis>left</emphasis> (ñëåâà íàïðàâî),
<emphasis>right</emphasis> (ñïðàâà íàëåâî)
</entry>
</row>
<row>
<entry>vdir</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>down</emphasis></entry>
<entry>
íàïðàâëåíèå îòîáðàæåíèå êàæäîé êîëîíêè. äîïóñòèìûå çíà÷åíèÿ:
<emphasis>down</emphasis> (ñâåðõó âíèç),
<emphasis>up</emphasis> (ñíèçó ââåðõ)
</entry>
</row>
</tbody>
<colspec colname="param" align="center" />
<colspec colname="type" align="center" />
<colspec colname="required" align="center" />
<colspec colname="default" align="center" />
<colspec colname="desc" />
<thead>
<row>
<entry>Èìÿ àòðèáóòà</entry>
<entry>Òèï</entry>
<entry>Îáÿçàòåëåí</entry>
<entry>Ïî óìîë÷àíèþ</entry>
<entry>Îïèñàíèå</entry>
</row>
</thead>
<tbody>
<row>
<entry>loop</entry>
<entry>array</entry>
<entry>Äà</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>ìàññèâ äàííûõ äëÿ îáðàáîòêè</entry>
</row>
<row>
<entry>cols</entry>
<entry>integer</entry>
<entry>Íåò</entry>
<entry><emphasis>3</emphasis></entry>
<entry>
êîëè÷åñòâî êîëîíîê â òàáëèöå. Åñëè ýòîò àòðèáóò íå óêàçàí, íî óêàçàí
àòðèáóò rows, òî êîëè÷åñòâî êîëîíîê àâòîìàòè÷åñêè âû÷èñëÿåòñÿ èñõîäÿ
èç êîëè÷åñòâà ñòðîê è êîëè÷åñòâà ýëåìåíòîâ äëÿ îòîáðàæåíèÿ, ÷òîáû êàê
ðàç óìåñòèòü âñå ýëåìåíòû. Åñëè îáà ïàðàìåòðà (è rows, è cols) îïóùåíû,
cols ïðèíèìàåò çíà÷åíèå ïî óìîë÷àíèþ, ðàâíîå 3.
</entry>
</row>
<row>
<entry>rows</entry>
<entry>integer</entry>
<entry>Íåò</entry>
<entry><emphasis>empty</emphasis></entry>
<entry>
êîëè÷åñòâî ñòðîê â òàáëèöå. Åñëè ýòîò àòðèáóò íå óêàçàí, íî óêàçàí
àòðèáóò cols, òî êîëè÷åñòâî ñòðîê àâòîìàòè÷åñêè âû÷èñëÿåòñÿ èñõîäÿ
èç êîîè÷åñòâà êîëîíîê è êîëè÷åñòâà ýëåìåíòîâ äëÿ îòîáðàæåíèÿ, ÷òîáû êàê
ðàç óìåñòèòü âñå ýëåìåíòû.
</entry>
</row>
<row>
<entry>inner</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>cols</emphasis></entry>
<entry>
íàïðàâëåíèå çàïîëíåíèÿ ýëåìåíòîâ òàáëèöû èç ìàññèâà.
<emphasis>cols</emphasis> îçíà÷àåò çàïîëíåíèå ýëåìåíòîâ êîëîíêè çà êîëîíêîé.
<emphasis>rows</emphasis> îçíà÷àåò çàïîëíåíèå ýëåìåíòîâ ñòðîêà çà ñòðîêîé.
</entry>
</row>
<row>
<entry>table_attr</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>border="1"</emphasis></entry>
<entry>àòðèáóòû äëÿ òýãà table</entry>
</row>
<row>
<entry>tr_attr</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>empty</emphasis></entry>
<entry>àòðèáóòû äëÿ òýãà tr (çíà÷åíèÿ ìàññèâà îòîáðàæàþòñÿ öèêëè÷íî)</entry>
</row>
<row>
<entry>td_attr</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>empty</emphasis></entry>
<entry>àòðèáóòû äëÿ òýãà td (çíà÷åíèÿ ìàññèâà îòîáðàæàþòñÿ öèêëè÷íî)</entry>
</row>
<row>
<entry>trailpad</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>&amp;nbsp;</emphasis></entry>
<entry>çíà÷åíèå äëÿ çàïîëíåíèÿ ïóñòûõ ÿ÷ååê ïîñëåäíåé ñòðîêè (åñëè òàêèå åñòü)</entry>
</row>
<row>
<entry>hdir</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>right</emphasis></entry>
<entry>
íàïðàâëåíèÿ çàïîëíåíèÿ êàæäîé ñòðîêè. äîñòóïíûå çíà÷åíèÿ:
<emphasis>right</emphasis> (ñëåâà-íàïðàâî)
è
<emphasis>left</emphasis> (ñïðàâà-íàëåâî)
</entry>
</row>
<row>
<entry>vdir</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>down</emphasis></entry>
<entry>
íàïðàâëåíèå çàïîëíåíèÿ êàæäîé êîëîíêè. äîñòóïíûå çíà÷åíèÿ:
<emphasis>down</emphasis> (ñâåðõó-âíèç)
è
<emphasis>up</emphasis> (ñíèçó-ââåðõ)
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para>
Ïîëüçîâàòåëüñêàÿ ôóíêöèÿ <emphasis>html_table</emphasis> âûâîäèò
ìàññèâ â âèäå HTML òàáëèöû. Àòðèáóò <emphasis>cols</emphasis>
óêàçûâàåò êîëè÷åñòâî êîëîíîê. Àòðèáóòû <emphasis>table_attr</emphasis>,
<emphasis>tr_attr</emphasis> è <emphasis>td_attr</emphasis> óêàçûâàþò
äîïîëíèòåëüíûå àòðèáóòû òýãîâ table, tr è td. Åñëè çíà÷åíèå
<emphasis>tr_attr</emphasis> èëè <emphasis>td_attr</emphasis> - ìàññèâ,
òî êãî çíà÷åíèÿ öèêëè÷åñêèé ïîâòîðÿþòñÿ. Àòðèáóò
<emphasis>trailpad</emphasis> óñòàíàâëèâàåò çíà÷åíèÿ äëÿ îñòàòî÷íûõ
ÿ÷ååê íà ïîñëåäíåé ñòðîêå òàáëèöû.
</para>
<example>
<title>html_table</title>
<title>{html_table}</title>
<programlisting role="php">
<![CDATA[
<?php
require('Smarty.class.php');
$smarty = new Smarty;
$smarty->assign('data',array(1,2,3,4,5,6,7,8,9));
$smarty->assign('tr',array('bgcolor="#eeeeee"','bgcolor="#dddddd"'));
$smarty->display('index.tpl');
?>
]]>
</programlisting>
<para>
Øàáëîí:
</para>
<programlisting>
<![CDATA[
{html_table loop=$data}
@@ -173,6 +180,7 @@ $smarty->display('index.tpl');
</screen>
</example>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

79
docs/ru/designers/language-custom-functions/language-function-mailto.xml
View File

@@ -1,8 +1,15 @@
<?xml version="1.0" encoding="windows-1251"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.3 Maintainer: freespace Status: ready -->
<!-- EN-Revision: 1.6 Maintainer: freespace Status: ready -->
<sect1 id="language.function.mailto">
<title>mailto</title>
<title>{mailto}</title>
<para>
{mailto} àâòîìàòè÷åñêè ñîçäàåò ññûëêè "mailto:" è îïöèîíàëüíî êîäèðóåò
èõ. Êîäèðîâàíèå e-mail'îâ íà âàøåì ñàéòå óñëîæíÿåò èõ îáíàðóæåíèå
àâòîìàòè÷åñêèìè ïðîãðàììàìè-àíàëèçàòîðàìè è ÿâëÿåòñÿ ýëåìåíòàðíûì
ñïîñîáîì çàùèòû îò ñïàìà.
</para>
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
@@ -95,54 +102,60 @@
</tbody>
</tgroup>
</informaltable>
<para>
ïîëüçîâàòåëüñêàÿ ôóíêöèÿ mailto àâòîìàòèçèðóåò ñîçäàíèå ññûëîê
íà e-mail àäðåñà ñ âîçìîæíîñòüþ êîäèðîâàíèÿ èõ. Êîäèðîâàíèå
óñëîæíÿåò ðàáîòó web-ïàóêîâ, êîòîðûå ñîáèðàþò e-mail àäðåñà
ñ âàøåãî ñàéòà.
</para>
<note>
<title>Òåõíè÷åñêîå Çàìå÷àíèå</title>
<para>
javascript - ñêîðåå âñåãî íàèáîëåå ïîëíàÿ ôîðìà êîäèðîâàíèÿ,
õîòÿ âû òàê æå ìîæåòå èñïîëüçîâàòü øåñòíàäöàòèðè÷íîå
êîäèðîâàíèå.
êîäèðîâàíèå. Ê ñîæàëåíèþ, javascript íå ïîääåðæèâàåò
êîäèðîâàíèå ðóññêèõ ñèìâîëîâ.
</para>
</note>
<example>
<title>mailto</title>
<title>{mailto}</title>
<programlisting>
<![CDATA[
{mailto address="me@example.com"}
{mailto address="me@example.com" text="send me some mail"}
{mailto address="me@example.com" encode="javascript"}
{mailto address="me@example.com" encode="hex"}
{mailto address="me@example.com" subject="Hello to you!"}
{mailto address="me@example.com" cc="you@example.com,they@example.com"}
{mailto address="me@example.com" extra='class="email"'}
{mailto address="me@example.com" encode="javascript_charcode"}
OUTPUT:
{mailto address="me@example.com"}
<a href="mailto:me@example.com" >me@example.com</a>
{mailto address="me@example.com" text="send me some mail"}
<a href="mailto:me@example.com" >send me some mail</a>
<script type="text/javascript" language="javascript">eval(unescape('%64%6f%63%75%6d%65%6e%74%2e%77%72%6
9%74%65%28%27%3c%61%20%68%72%65%66%3d%22%6d%61%69%6c%74%6f%3a%6d%65%40%64%6f%6d%
61%69%6e%2e%63%6f%6d%22%20%3e%6d%65%40%64%6f%6d%61%69%6e%2e%63%6f%6d%3c%2f%61%3e
%27%29%3b'))</script>
<a href="mailto:%6d%65@%64%6f%6d%61%69%6e.%63%6f%6d" >&#x6d;&#x65;&#x40;&#x64;&
#x6f;&#x6d;&#x61;&#x69;&#x6e;&#x2e;&#x63;&#x6f;&#x6d;</a>
<a href="mailto:me@example.com?subject=Hello%20to%20you%21" >me@example.com</a>
<a href="mailto:me@example.com?cc=you@example.com%2Cthey@example.com" >me@example.com</a>
<a href="mailto:me@example.com" class="email">me@example.com</a>
{mailto address="me@example.com" encode="javascript"}
<script type="text/javascript" language="javascript">
<!--
{document.write(String.fromCharCode(60,97,32,104,114,101,102,61,34,109,97,105,108,116,111,58,109,101,64,101,120,97,109,112,108,101,46,99,111,109,34,32,62,109,101,64,101,120,97,109,112,108,101,46,99,111,109,60,47,97,62))}
//-->
eval(unescape('%64%6f% ... snipped ...%61%3e%27%29%3b'))
</script>
{mailto address="me@example.com" encode="hex"}
<a href="mailto:%6d%65.. snipped..3%6f%6d">&#x6d;&..snipped...#x6f;&#x6d;</a>
{mailto address="me@example.com" subject="Hello to you!"}
<a href="mailto:me@example.com?subject=Hello%20to%20you%21" >me@example.com</a>
{mailto address="me@example.com" cc="you@example.com,they@example.com"}
<a href="mailto:me@example.com?cc=you@example.com%2Cthey@example.com" >me@example.com</a>
{mailto address="me@example.com" extra='class="email"'}
<a href="mailto:me@example.com" class="email">me@example.com</a>
{mailto address="me@example.com" encode="javascript_charcode"}
<script type="text/javascript" language="javascript">
<!--
{document.write(String.fromCharCode(60,97, ... snipped ....60,47,97,62))}
//-->
</script>
]]>
</programlisting>
</example>
<para>
Ñì. òàêæå
<link linkend="language.modifier.escape">escape</link>,
<link linkend="tips.obfuscating.email">Ñîêðûòèå E-mail àäðåñà</link>
è
<link linkend="language.function.textformat">{textformat}</link>
</para>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:

269
docs/ru/designers/language-custom-functions/language-function-math.xml
View File

@@ -1,135 +1,170 @@
<?xml version="1.0" encoding="windows-1251"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: freespace Status: ready -->
<!-- EN-Revision: 1.4 Maintainer: freespace Status: ready -->
<sect1 id="language.function.math">
<title>math</title>
<title>{math}</title>
<para>
{math} ïîçâîëÿåò äèçàéíåðàì øàáëîíîâ ïðîâîäèòü ìàòåìàòè÷åñêèå âû÷èñëåíèÿ
â øàáëîíå. Ëþáûå ÷èñëîâûå ïåðåìåííûå øàáëîíà ìîãóò áûòü èñïîëüçîâàíû â
óðàâíåíèÿõ, è ðåçóëüòàò áóäåò âûâåäåí íà ìåñòå ýòîãî òåãà.
Ïåðåìåííûå, èñïîëüçóåìûå â óðàâíåíèè, ïåðåäàþòñÿ â âèäå ïàðàìåòðîâ,
êîòîðûå ìîãóò áûòü ïåðåìåííûìè øàáëîíà èëè ñòàòè÷åñêèìè çíà÷åíèÿìè.
+, -, /, *, abs, ceil, cos, exp, floor, log, log10, max, min, pi, pow,
rand, round, sin, sqrt, srans è tan ÿâëÿþòñÿ äîñòóïíûìè îïåðàòîðàìè.
Îáðàòèòåñü ê äîêóìåíòàöèè PHP äëÿ ïîëó÷åíèÿ äîïîëíèòåëüíîé èíôîðìàöèè
ïî ýòèì ìàòåìàòè÷åñêèì ôóíêöèÿì.
</para>
<para>
Åñëè âû óêàçûâàåòå ñïåöèàëüíûé ïàðàìåòð "assign", ðåçóëüòàò âûïîëíåíèÿ
ôóíêöèè {math} áóäåò ïðèñâîåí ïåðåìåííîé øàáëîíà âìåñòî âûâîäà â øàáëîí.
</para>
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
<colspec colname="type" align="center" />
<colspec colname="required" align="center" />
<colspec colname="default" align="center" />
<colspec colname="desc" />
<thead>
<row>
<entry>Èìÿ àòðèáóòà</entry>
<entry>Òèï</entry>
<entry>Îáÿçàòåëåí</entry>
<entry>Ïî óìîë÷àíèþ</entry>
<entry>Îïèñàíèå</entry>
</row>
</thead>
<tbody>
<row>
<entry>equation</entry>
<entry>string</entry>
<entry>Äà</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>ìàòåìàòè÷åñêîé âûðàæåíèå</entry>
</row>
<row>
<entry>format</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>ôîðìàò ðóçóëüòàòà (sprintf)</entry>
</row>
<row>
<entry>var</entry>
<entry>numeric</entry>
<entry>Äà</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>ïåðåìåííàÿ âûðàæåíèÿ</entry>
</row>
<row>
<entry>assign</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>
ïåðåìåííàÿ øàáëîíà, êîòîðîé áóäåò ïðèñâîåí
âûâîä
</entry>
</row>
<row>
<entry>[var ...]</entry>
<entry>numeric</entry>
<entry>Äà</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>äîïîëíèòåëüíûå ïåðåìåííûå âûðàæåíèÿ</entry>
</row>
</tbody>
<colspec colname="param" align="center" />
<colspec colname="type" align="center" />
<colspec colname="required" align="center" />
<colspec colname="default" align="center" />
<colspec colname="desc" />
<thead>
<row>
<entry>Èìÿ àòðèáóòà</entry>
<entry>Òèï</entry>
<entry>Îáÿçàòåëåí</entry>
<entry>Ïî óìîë÷àíèþ</entry>
<entry>Îïèñàíèå</entry>
</row>
</thead>
<tbody>
<row>
<entry>equation</entry>
<entry>string</entry>
<entry>Äà</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>óðàâíåíèå äëÿ âûïîëíåíèÿ</entry>
</row>
<row>
<entry>format</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>ôîðìàò ðåçóëüòàòà (sprintf)</entry>
</row>
<row>
<entry>var</entry>
<entry>numeric</entry>
<entry>Äà</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>çíà÷åíèå ïåðåìåííîé óðàâíåíèÿ</entry>
</row>
<row>
<entry>assign</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>èìÿ ïåðåìåííîé øàáëîíà äëÿ ñîõðàíåíèÿ ðåçóëüòàòà</entry>
</row>
<row>
<entry>[var ...]</entry>
<entry>numeric</entry>
<entry>Äà</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>çíà÷åíèå ïåðåìåííîé óðàâíåíèÿ</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para>
ïîëüçîâàòåëüñêàÿ ôóíêöèÿ math ïîçâîëÿåò äèçàéíåðàì øàáëîíîâ
âû÷èñëÿòü ìàòåìàòè÷åñêèå âûðàæåíèÿ â øàáëîíå. Ëþáàÿ ÷èñëåííàÿ
ïåðåìåííàÿ øàáëîíà ìîæåò áûòü èñïîëüçîâàíà â âûðàæåíèè. Ïåðåìåííûå,
èñïîëüçóåìûå â âûðàæåíèè, ïåðåäàþòñÿ â êà÷åñòâå ïàðàìåòðîâ,
êîòîðûìè ìîãóò áûòü êàê è ïåðåìåííûå øàáëîíà, òàê è ñòàòè÷åñêèå
çíà÷åíèÿ. Äîïóñòèìûå îïåðàòîðû: +, -, /, *, abs, ceil, cos,
exp, floor, log, log10, max, min, pi, pow, rand, round, sin, sqrt,
srans è tan. Îçíàêîìòåñü ñ php äîêóìåíòàöèåé ïîä äàííûì ôóíêöèÿì.
</para>
<para>
Åñëè óêàçàí àòðèáóò "assign", òî âûâîä áóäåò ïðèñâîåí ïåðåìåííîé,
âìåñòî îòîáðàæåíèÿ.
</para>
<note>
<title>Òåõíè÷åñêîå Çàìå÷àíèå</title>
<para>
èñïîëüçîâàíèå ôóíêöèè math çíà÷èòåëüíî ñêàçûâàåòñÿ íà
âðåìåíè âûïîëíåíèÿ ïðîãðàììû, òàê êàê ðåàëèçîâàíà ñ ïîìîùüþ
php ôóíêöèè eval(). Âûïîëíåíèå ìàòåìàòè÷åñêèõ îïåðàöèé â php
ïðîãðàììå áîëåå ýôôåêòèâíî, òî åñòü âåçäå, ãäå âîçìîæíî,
ñëåäóåò äåëàòü âû÷èñëåíèÿ â ïðîãðàììå è ïåðåäàâàòü ðåçóëüòàò
â øàáëîí. Ñëåäóåò òàêæå èçáåãàòü ïîâòîðÿþùåãîñÿ âûçîâà ôóíêöèè
math (íàïðèìåð, â öèêëàõ).
{math} - ýòî î÷åíü ðåñóðñî¸ìêàÿ ôóíêöèÿ èç-çà èñïîëüçîâàíèÿ åþ ôóíêöèè PHP
<ulink url="&url.php-manual;eval">eval()</ulink>.
Âûïîëíåíèå ìàòåìàòè÷åñêèõ îïåðàöèé â PHP íàìíîãî ýôôåêòèâíåå, òàê ÷òî
ïî âîçìîæíîñòè èñïîëüçóéòå PHP äëÿ ìàòåìàòè÷åñêèõ ðàññ÷åòîâ è
<link linkend="api.assign">ïðèñâàèâàéòå</link> ðåçóëüòàò øàáëîíó.
Ïðè ëþáûõ îáñòîÿòåëüñòâàõ, èçáåãàéòå ïîâòîðÿþùèõñÿ âûçîâîâ ôóíêöèè {math},
íàïðèìåð âíóòðè öèêëîâ
<link linkend="language.function.section">{section}</link>.
</para>
</note>
<example>
<title>math</title>
<programlisting>
<example>
<title>{math}</title>
<para>
<emphasis role="bold">Ïðèìåð ¹1:</emphasis>
</para>
<programlisting>
<![CDATA[
{* $height=4, $width=5 *}
{* $height=4, $width=5 *}
{math equation="x + y" x=$height y=$width}
OUTPUT:
9
{* $row_height = 10, $row_width = 20, #col_div# = 2, assigned in template *}
{math equation="height * width / division"
height=$row_height
width=$row_width
division=#col_div#}
OUTPUT:
100
{* ìîæíî èñïîëüçîâàòü ñêîáêè *}
{math equation="(( x + y ) / z )" x=2 y=10 z=2}
OUTPUT:
6
{* ìîæíî óêàçàòü ôîðìàò ðåçóëüòàòà (sprintf) *}
{math equation="x + y" x=4.4444 y=5.0000 format="%.2f"}
OUTPUT:
9.44
{math equation="x + y" x=$height y=$width}
]]>
</programlisting>
<para>
Ðåçóëüòàò âûïîëíåíèÿ äàííîãî ïðèìåðà:
</para>
<screen>
<![CDATA[
9
]]>
</screen>
<para>
<emphasis role="bold">Ïðèìåð ¹2:</emphasis>
</para>
<programlisting>
<![CDATA[
{* $row_height = 10, $row_width = 20, #col_div# = 2, assigned in template *}
{math equation="height * width / division"
height=$row_height
width=$row_width
division=#col_div#}
]]>
</programlisting>
<para>
Ðåçóëüòàò âûïîëíåíèÿ äàííîãî ïðèìåðà:
</para>
<screen>
<![CDATA[
100
]]>
</screen>
<para>
<emphasis role="bold">Ïðèìåð ¹3:</emphasis>
</para>
<programlisting>
<![CDATA[
{* âû ìîæåòå èñïîëüçîâàòü ñêîáêè *}
{math equation="(( x + y ) / z )" x=2 y=10 z=2}
]]>
</programlisting>
<para>
Ðåçóëüòàò âûïîëíåíèÿ äàííîãî ïðèìåðà:
</para>
<screen>
<![CDATA[
6
]]>
</screen>
<para>
<emphasis role="bold">Ïðèìåð ¹4:</emphasis>
</para>
<programlisting>
<![CDATA[
{* âû ìîæåòå óêàçàòü ôîðìàò sprintf â ïàðàìåòðå format *}
{math equation="x + y" x=4.4444 y=5.0000 format="%.2f"}
]]>
</programlisting>
<para>
Ðåçóëüòàò âûïîëíåíèÿ äàííîãî ïðèìåðà:
</para>
<screen>
<![CDATA[
9.44
]]>
</screen>
</example>
</sect1>
<!-- Keep this comment at the end of the file
@@ -151,4 +186,4 @@ End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
-->

43
docs/ru/designers/language-custom-functions/language-function-popup-init.xml
View File

@@ -1,31 +1,32 @@
<?xml version="1.0" encoding="windows-1251"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.2 Maintainer: freespace Status: ready -->
<!-- EN-Revision: 1.5 Maintainer: freespace Status: ready -->
<sect1 id="language.function.popup.init">
<title>popup_init</title>
<title>{popup_init}</title>
<para>
ôóíêöèÿ popup ðåàëèçóåò èíòåãðàöèþ ñ áèáëèîòåêîé overLib, êîòîðàÿ
èñïîëüçóåòñÿ äëÿ ñîçäàíèÿ âñïëûâàþùèõ îêîí. Îíè ìîãóò èñïîëüçîâàòüñÿ
äëÿ âûâîäà êîíòåêñòíî-çàâèñèìîé èíôîðìàöèè, òàêîé êàê êîíòåêñòíàÿ
ïîìîùü èëè âñïëûâàþùèå ïîäñêàçêè. Ôóíêöèÿ popup_init äîëæíà áûòü
âûçâàíà îäèí ðàç â íà÷àëå ñòðàíèöû, ãäå ïëàíèðóåòñÿ âûçîâ ôóíêöèè
<link linkend="language.function.popup">popup</link>. Áèáëèîòåêó
overLib íàïèñàë Ýðèê Áîñðàï (Erik Bosrup). Äîìàøíÿÿ ñòðàíèöà ðàñïîëîæåíà
ïî àäðåñó http://www.bosrup.com/web/overlib/.
</para>
<para>
Íà÷èíàÿ ñî Smarty âåðñèè 2.1.2, áèáëèîòåêà overLib íå âêëþ÷àåòñÿ
â ðåëèç. Ñêà÷àéòå áèáëèîòåêó overLib, ïîìåñòèòå ôàéë overlib.js
â êîðåíü äîêóìåíòîâ (DOCUMENT_ROOT) èëè ãëóáæå. Ïðè âûçîâå ôóíêöèè
popup_init ïåðåäàéòå îòíîñèòåëüíûé ïóòü ê ýòîìó ôàéëó â êà÷åñòâå
ïàðàìåòðà src.
<link linkend="language.function.popup">{popup}</link> -
ýòî ôóíêöèÿ äëÿ èíòåãðàöèè
<ulink url="&url.overLib;">overLib</ulink>, áèáëèîòåêè, êîòîðàÿ
èñïîëüçóåòñÿ äëÿ îòîáðàæåíèÿ âñïëûâàþùèõ îêîí. Îíè èñïîëüçóþòñÿ äëÿ
êîíòåêñòíî-÷óâñòâèòåëüíîé èíôîðìàöèè, òàêîé êàê îêíà ñïðàâêè è âñïëûâàþùèå
ïîäñêàçêè. {popup_init} äîëæíà áûòü âûçâàíà îäèí ðàç â íà÷àëå ñòðàíèöû,
åñëè âû ñîáèðàåòåñü èñïîëüçîâàòü íà íåé ôóíêöèþ
<link linkend="language.function.popup">{popup}</link>.
</para>
<para>
<ulink url="&url.overLib;">overLib</ulink>
íàïèñàíà Ýðèêîì Áîñðóïîì (Erik Bosrup) è å¸ äîìàøíÿÿ ñòðàíèöà íàõîäèòñÿ ïî
àäðåñó <ulink url="&url.overLib;">&url.overLib;</ulink>.
</para>
<example>
<title>popup_init</title>
<title>{popup_init}</title>
<programlisting>
<![CDATA[
{* popup_init äîëæåí áûòü âûçâàí îäèí ðàç â íà÷àëå ñòðàíèöû *}
{popup_init src="/javascripts/overlib.js"}
<head>
{* popup_init äîëæíà áûòü âûçâàíà îäèí ðàç â íà÷àëå ñòðàíèöû *}
{popup_init src="javascripts/overlib.js"}
</head>
]]>
</programlisting>
</example>
@@ -49,4 +50,4 @@ End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
-->

226
docs/ru/designers/language-custom-functions/language-function-popup.xml
View File

@@ -1,10 +1,16 @@
<?xml version="1.0" encoding="windows-1251"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.3 Maintainer: freespace Status: ready -->
<!-- EN-Revision: 1.6 Maintainer: freespace Status: ready -->
<sect1 id="language.function.popup">
<title>popup</title>
<informaltable frame="all">
<tgroup cols="5">
<title>{popup}</title>
<para>
{popup} èñïîëüçóåòñÿ äëÿ ñîçäàíèÿ âûñïëûâàþùèõ îêîí ïðè ïîìîùè javascript.
Äëÿ îáåñïå÷åíèÿ ðàáîòû ýòîé ôóíêöèè, ïðåäâàðèòåëüíî ÄÎËÆÍÀ áûòü âûçâàíà
ôóíêöèÿ <link linkend="language.function.popup.init">{popup_init}</link>.
</para>
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
<colspec colname="type" align="center" />
<colspec colname="required" align="center" />
@@ -25,9 +31,7 @@
<entry>string</entry>
<entry>Äà</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>
HTML êîä (òåêñò), êîòîðûé áóäåò âûâîäèòüñÿ â âûñïëûâàþùåì îêíå.
</entry>
<entry>òåêñò/html äëÿ îòîáðàæåíèÿ âî âñïëûâàþùåì îêíå</entry>
</row>
<row>
<entry>trigger</entry>
@@ -35,406 +39,386 @@
<entry>Íåò</entry>
<entry><emphasis>onMouseOver</emphasis></entry>
<entry>
Ñïîñîá âûçîâà îêíà. Ìîæåò áûòü ëèáî onMouseOver, ëèáî onclick
</entry>
Êàêîå ñîáûòèå èñïîëüçóåòñÿ äëÿ àêòèâàöèè âñïëûâàþùåãî îêíà.
Ìîæåò áûòü onMouseOver èëè onClick.
</entry>
</row>
<row>
<entry>sticky</entry>
<entry>boolean</entry>
<entry>Íåò</entry>
<entry><emphasis>false</emphasis></entry>
<entry>Makes the popup stick around until closed</entry>
<entry>Âñïëûâàþùåå îêíî çàêðûâàåòñÿ êëèêîì</entry>
</row>
<row>
<entry>caption</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>óñòàíàâëèâàåò çàãîëîâîê</entry>
<entry>óñòàíàâëèâàåò çàãîëîâîê îêíà</entry>
</row>
<row>
<entry>fgcolor</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>öâåò âíóòðè îêíà</entry>
<entry>öâåò âñïëûâàþùåãî îêíà</entry>
</row>
<row>
<entry>bgcolor</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>öâåò ãðàíèöû îêíà</entry>
<entry>öâåò ðàìêè âñïëûâàþùåãî îêíà</entry>
</row>
<row>
<entry>textcolor</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>öâåò òåêñòà â îêíå</entry>
<entry>óñòàíàâëèâàåò öâåò òåêñòà âíóòðè âñïëûâàþùåãî îêíà</entry>
</row>
<row>
<entry>capcolor</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>öâåò çàãîëîâêà îêíà</entry>
<entry>óñòàíàâëèâàåò öâåò çàãîëîâêà âñïëûâàþùåãî îêíà</entry>
</row>
<row>
<entry>closecolor</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>öâåò òåêñòà "Close" (Çàêðûòü)</entry>
<entry>óñòàíàâëèâàåò öâåò íàäïèñè "çàêðûòü"</entry>
</row>
<row>
<entry>textfont</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>øðèôò òåêñòà â îêíå</entry>
<entry>óñòàíàâëèâàåò øðèôò äëÿ ãëàâíîãî òåêñòà</entry>
</row>
<row>
<entry>captionfont</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>øðèôò çàãîëîâêà îêíà</entry>
<entry>óñòàíàâëèâàåò øðèôò äëà çàãîëîâêà</entry>
</row>
<row>
<entry>closefont</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>øðèôò òåêñòà "Close" (Çàêðûòü)</entry>
<entry>óñòàíàâëèâàåò øðèôò íàäïèñè "Çàêðûòü"</entry>
</row>
<row>
<entry>textsize</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>ðàçìåð øðèôòà â îêíå</entry>
<entry>óñòàíàâëèâàåò ðàçìåð ãëàâíîãî òåêñòà</entry>
</row>
<row>
<entry>captionsize</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>ðàçìåð øðèôòà çàãîëîâêà</entry>
<entry>óñòàíàâëèâàåò ðàçìåð çàãîëîâêà</entry>
</row>
<row>
<entry>closesize</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>ðàçìåð øðèôòà òåêñòà "Close" (Çàêðûòü)</entry>
<entry>óñòàíàâëèâàåò ðàçìåð íàäïèñè "Çàêðûòü"</entry>
</row>
<row>
<entry>width</entry>
<entry>integer</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>øèðèíà îêíà</entry>
<entry>óñòàíàâëèâàåò øèðèíó âñïëûâàþùåãî îêíà</entry>
</row>
<row>
<entry>height</entry>
<entry>integer</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>âûñîòà îêíà</entry>
<entry>óñòàíàâëèâàåò âûñîòó âñïëûâàþùåãî îêíà</entry>
</row>
<row>
<entry>left</entry>
<entry>boolean</entry>
<entry>Íåò</entry>
<entry><emphasis>false</emphasis></entry>
<entry>ñîçäàâàòü îêíî ñëåâà îò êóðñîðà ìûøè</entry>
<entry>çàñòàâëÿåò âñïëûâàþùåå îêíî ïîÿâëÿòüñÿ ñëåâà îò êóðñîðà ìûøè</entry>
</row>
<row>
<entry>right</entry>
<entry>boolean</entry>
<entry>Íåò</entry>
<entry><emphasis>false</emphasis></entry>
<entry>ñîçäàâàòü îêíî ñïðàâà îò êóðñîðà ìûøè</entry>
<entry>çàñòàâëÿåò âñïëûâàþùåå îêíî ïîÿâëÿòüñÿ ñïðàâà îò êóðñîðà ìûøè</entry>
</row>
<row>
<entry>center</entry>
<entry>boolean</entry>
<entry>Íåò</entry>
<entry><emphasis>false</emphasis></entry>
<entry>ñîçäàâàòü îêíî íà ìåñòå ìûøè</entry>
<entry>çàñòàâëÿåò âñïëûâàþùåå îêíî ïîÿâëÿòüñÿ ïî öåíòðó êóðñîðà ìûøè</entry>
</row>
<row>
<entry>above</entry>
<entry>boolean</entry>
<entry>Íåò</entry>
<entry><emphasis>false</emphasis></entry>
<entry>ñîçäàåò îêíî âûøå êóðñîðà ìûøè. ÇÀÌÅ×ÀÍÈÅ: âîçìîæíî
òîëüêî åñëè óêàçàí àòðèáóò height</entry>
<entry>
Çàñòàâëÿåò âñïëûâàþùåå îêíî ïîÿâëÿòüñÿ ñâåðõó îò êóðñîðà.
Âíèìàíèå: ðàáîòàåò òîëüêî åñëè óñòàíîâëåí àòðèáóò height.
</entry>
</row>
<row>
<entry>below</entry>
<entry>boolean</entry>
<entry>Íåò</entry>
<entry><emphasis>false</emphasis></entry>
<entry>ñîçäàåò îêíî ïîä êóðñîðîì ìûøè</entry>
<entry>çàñòàâëÿåò âñïëûâàþùåå îêíî ïîÿâëÿòüñÿ ñíèçó îò êóðñîðà ìûøè</entry>
</row>
<row>
<entry>border</entry>
<entry>integer</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>òîëùèíà ãðàíèöû îêíà</entry>
<entry>äåëàåò ðàìêó âîêðóò âñïëûâàþùåãî îêíà òîíüøå èëè òîëùå</entry>
</row>
<row>
<entry>offsetx</entry>
<entry>integer</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>ãîðèçîíòàëüíîå ñìåùåíèå îêíà îò êóðñîðà ìûøè.</entry>
<entry>êàê äàëåêî îò êóðñîðà áóäåò îòîáðàæàòüñÿ âñïëûâàþùåå îêíî,
ïî ãîðèçîíòàëè</entry>
</row>
<row>
<entry>offsety</entry>
<entry>integer</entry>
<entry>Íåò</entry>
<entry>No</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>âåðòèêàëüíîå ñìåùåíèå îêíà îò êóðñîðà ìûøè</entry>
<entry>êàê äàëåêî îò êóðñîðà áóäåò îòîáðàæàòüñÿ âñïëûâàþùåå îêíî,
ïî âåðòèêàëè</entry>
</row>
<row>
<entry>fgbackground</entry>
<entry>url to image</entry>
<entry>url ê êàðòèíêå</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>
îïðåäåëÿåò ôîíîâîå èçîáðàæåíèå òåêñòà,
âìåñòî fgcolor.
</entry>
<entry>îïðåäåëÿåò êàðòèíêó, êîòîðàÿ áóäåò èñïîëüçîâàíà âìåñòî öâåòà äëÿ
ñîäåðæèìîãî âñïëûâàþùåãî îêíà.</entry>
</row>
<row>
<entry>bgbackground</entry>
<entry>url to image</entry>
<entry>Íåò</entry>
<entry>url ê êàðòèíêå</entry>
<entry>No</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>
îïðåäåëÿåò ôîíîâîå èçîáðàæåíèå äëÿ ãðàíèö îêíà, âìåñòî bgcolor.
ÇÀÌÅ×ÀÍÈÅ: Ìîæåò ïîíàäîáèòüñÿ óñòàíîâèòü bgcolor â "" èëè áóäåò
ïîêàçàí öâåò, à íå çèîáðàæåíèå.
ÇÀÌÅ×ÀÍÈÅ: Ïðè íàëè÷èè ññûëêè "Close" Netscape ïåðåðèñîâûâàåò
ÿ÷åéêè òàáëèöû, ÷òî ïðèâîäèò ê íåêîððåêòíîìó îòîáðàæåíèþ.
</entry>
<entry>îïðåäåëÿåò êàðòèíêó, êîòîðàÿ áóäåò èñïîëüçîâàíà âìåñòî öâåòà äëÿ
ðàìêè âñïëûâàþùåãî îêíà. Âíèìàíèå: âàì ñëåäóåò óñòàíîâèòü bgcolor â "",
èíà÷å öâåò òàê æå áóäåò îòîáðàæàòüñÿ. Âíèìàíèå: êîãäà ïðèñóòñòâóåò ññûëêà
"Çàêðûòü", Netscape áóäåò ïåðåðèñîâûâàòü ÿ÷åêè òàáëèöû, èç-çà ÷åãî ðåçóëüòàò
ìîæåò áûòü íåâåðíûì</entry>
</row>
<row>
<entry>closetext</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>óñòàíâëèâàåò òåêñò âìåñòî "Close"</entry>
<entry>óñòàíàâëèâàåò òåêñò äëÿ íàäïèñè "Çàêðûòü"</entry>
</row>
<row>
<entry>noclose</entry>
<entry>boolean</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>íå îòîáðàæàòü òåêñò "Close"</entry>
<entry>íå îòîáðàæàòü òåêñò "Çàêðûòü" äëÿ âñïëûâàþùèõ îêîí ñ çàãîëîâêîì</entry>
</row>
<row>
<entry>status</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>óñòàíîâèòü çíà÷åíèå ñòðîêè ñòàòóñà â áðàóçåðå</entry>
<entry>óñòàíàâëèâàåò òåêñò â ñòðîêó ñòàòóñà áðàóçåðà</entry>
</row>
<row>
<entry>autostatus</entry>
<entry>boolean</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>
óñòàíîâèòü çíà÷åíèå ñòðîêè ñòàòóñà â áðàóçåðå â òåêñò îêíà.
ÇÀÌÅ×ÀÍÈÅ: îòìåíÿåò çíà÷åíèå status
</entry>
<entry>óñòàíàâëèâàåò òåêñò âñïëûâàþùåãî îêíà â ñòðîêó ñòàòóñà áðàóçåðà
Âíèìàíèå: ïåðåíàçíà÷àåò óñòàíîâêó status</entry>
</row>
<row>
<entry>autostatuscap</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>
óñòàíîâèòü çíà÷åíèå ñòðîêè ñòàòóñà â áðàóçåðå â òåêñò çàãîëîâêà.
ÇÀÌÅ×ÀÍÈÅ: îòìåíÿåò íà÷åíèå autostatus
</entry>
<entry>óñòàíàâëèâàåò òåêñò çàãîëîâêà âñïëûâàþùåãî îêíà â ñòðîêó ñòàòóñà
áðàóçåðà.
NOTE: ïåðåíàçíà÷àåò óñòàíîâêè status è autostatus</entry>
</row>
<row>
<entry>inarray</entry>
<entry>integer</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>
óêàçûâàåò, ÷òî òåêñò îêíà ñëåäóåò âçÿòü èç óêàçàííîãî ýëåìåíòà ìàññèâà
ol_text, ðàñïîëîæåííîãî â overlib.js. Ýòîò ïàðàìåòð ìîæåò èñïîëüçîâàòüñÿ
âìåñòî text
</entry>
<entry>ãîâîðèò overLib ïðî÷èòàòü òåêñò ïî ýòîìó èíäåêñó â
ìàññèâå ol_text, ðàñïîëîæåíîì â overlib.js. Ýòîò ïàðàìåòð
ìîæåò áûòü èñïîëüçîâàí âìåñòî ïàðàìåòðà text</entry>
</row>
<row>
<entry>caparray</entry>
<entry>integer</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>
óêàçûâàåò, ÷òî çàãîëîâîê îêíà ñëåäóåò âçÿòü èç óêàçàííîãî ýëåìåíòà
ìàññèâà ol_caps
</entry>
<entry>ãîâîðèò overLib è ïðî÷èòàòü çàãîëîâîê ïî ýòîìó èíäåêñó â
ìàññèâå ol_caps</entry>
</row>
<row>
<entry>capicon</entry>
<entry>url</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>âûâîäèò èçîáðàæåíèå ïåðåä çàãîëîâêîì îêíà.</entry>
<entry>îòîáðàæàåò êàðòèíêó ïåðåä çàãîëîâêîì âñïëûâàþùåãî îêíà</entry>
</row>
<row>
<entry>snapx</entry>
<entry>integer</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>ðîâíÿåò îêíî ê ãîðèçîíòàëüíîé ñåòêå</entry>
<entry>ïðèêðåïëÿåò âñïëûâàþùåå îêíî ê êàæäîìó N-îìó ïèêñåëþ ïî ãîðèçîíòàëè</entry>
</row>
<row>
<entry>snapy</entry>
<entry>integer</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>ðîâíÿåò îêíî ê âåðòèêàëüíîé ñåòêå</entry>
<entry>ïðèêðåïëÿåò âñïëûâàþùåå îêíî ê êàæäîìó N-îìó ïèêñåëþ ïî âåðòèêàëè</entry>
</row>
<row>
<entry>fixx</entry>
<entry>integer</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>
çàêðåïëÿåò ãîðèçîíòàëüíîå ïîëîæåíèå îêíà.
ÇÀÌÅ×ÀÍÈÅ: îòìåíÿåò âñå îñòàëüíûå ïàðàìåòðû ãîðèçîíòàëüíîãî ïîëîæåíèÿ
</entry>
<entry>áëîêèðóåò ãîðèçîíòàëüíîå ïîëîæåíèå âñïëûâàþùåãî îêíà.
Âíèìàíèå: ïåðåíàçíà÷àåò âñ¸ ãîðèçîíòàëüíîå ïîçèöèîíèðîâàíèå</entry>
</row>
<row>
<entry>fixy</entry>
<entry>integer</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>
çàêðåïëÿåò âåðòèêàëííîå ïîëîæåíèå îêíà.
ÇÀÌÅ×ÀÍÈÅ: îòìåíÿåò âñå îñòàëüíûå ïàðàìåòðû âåðòèêàëüíîãî ïîëîæåíèÿ
</entry>
<entry>áëîêèðóåò âåðòèêàëüíîå ïîëîæåíèå âñïëûâàþùåãî îêíà.
Âíèìàíèå: ïåðåíàçíà÷àåò âñ¸ âåðòèêàëüíîå ïîçèöèîíèðîâàíèå</entry>
</row>
<row>
<entry>background</entry>
<entry>url</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>óêàçûâàåò ôîíîâîå èçîáðàæåíèå îêíà</entry>
<entry>óñòàíàâëèâàåò êàðòèíêó äëÿ èñïîëüçîâàíèÿ âìåñòî ôîíà òàáëèöû</entry>
</row>
<row>
<entry>padx</entry>
<entry>integer,integer</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>
äîïîëíÿåò ôîíîâîå èçîáðàæåíèå ãîðèçîíòàëüíûìè îòñòóïàìè ê òåêñòó.
ÇÀÌÅ×ÀÍÈÅ: ýòîò ïàðàìåòð ïðèíèìàåò äâà çíà÷åíèÿ</entry>
<entry>äåëàåò ãîðèçîíòàëüíûé îòñòóï ôîíîâîé êàðòèíêè äëÿ ðàçìåùåíèÿ òåêñòà.
Âíèìàíèå: ýòî äâîéíàÿ êîìàíäà</entry>
</row>
<row>
<entry>pady</entry>
<entry>integer,integer</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>
äîïîëíÿåò ôîíîâîå èçîáðàæåíèå âåðòèêàëüíûìè îòñòóïàìè ê òåêñòó.
ÇÀÌÅ×ÀÍÈÅ: ýòîò ïàðàìåòð ïðèíèìàåò äâà çíà÷åíèÿ</entry>
<entry>äåëàåò âåðòèêàëüíûé îòñòóï ôîíîâîé êàðòèíêè äëÿ ðàçìåùåíèÿ òåêñòà.
Âíèìàíèå: ýòî äâîéíàÿ êîìàíäà</entry>
</row>
<row>
<entry>fullhtml</entry>
<entry>boolean</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>
Ïîçâîëÿåò ïîëíîñòüþ êîíòðîëèðîâàòü HTML íàä ôîíîâûì èçîáðàæåíèåì.
HTML êîä îæèäàåòñÿ â ïàðàìåòðå text
</entry>
<entry>äàåò âàì âîçìîæíîñòü ïîëíîñòüþ êîíòðîëèðîâàòü html ïîâåðõ ôîíîâîé
êàðòèíêè. HTML-êîä îæèäàåòñÿ â àòðèáóòå "text"</entry>
</row>
<row>
<entry>frame</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>
Êîíòðîëèðîâàòü âûñïëûâàþùèå îêíà â ðàçëè÷íûõ ôðýéìàõ.
Ñì. ñàéò overlib äëÿ äîïîëíèòåëüíîé èíôîðìàöèè ïî ýòîé ôóíêöèè
</entry>
<entry>êîíòðîëèðóåò âñïëûâàþùåå îêíî â äðóãîì ôðåéìå.
Ñì. äîìàøíþþ ñòðàíèöó overlib äëÿ äîïîëíèòåëüíîé èíôîðìàöèè ïî ýòîé
ôóíêöèè</entry>
</row>
<row>
<entry>timeout</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>
âûçûâàåò óêàçàííóþ javascript ôóíêöèþ è èñïîëüçóåò ðåçóëüòàò
êàê òåêñò îêíà
</entry>
<entry>âûçûâàåò óêàçàííóþ ôóíêöèþ javascript è îòîáðàæàåò âîçâðàùåííîå
çíà÷åíèå âî âñïëûâàþùåì îêíå</entry>
</row>
<row>
<entry>delay</entry>
<entry>integer</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>
âðåìÿ æèçíè îêíà â ìèëèñåêóíäàõ. Ïîçâîëÿåò ðåàëèçîâûâàòü
âûñïëûâàþùèå ïîäñêàçêè.
</entry>
<entry>çàñòàâëÿåò âñïëûâàþùåå îêíî âåñòè ñåáÿ êàê âñïëûâàþùóþ ïîäñêàçêó.
Îíî âñïëûâåò òîëüêî ïîñëå îïðåäåëåííîé çàäåðæêè â ìèëëèñåêóíäàõ.</entry>
</row>
<row>
<entry>hauto</entry>
<entry>boolean</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>
àâòîìàòè÷åñêîå îïðåäëåíèå ãîðèçîíòàëüíîãî ìåñòîïîëîæåíèÿ îêíà
îòíîñèòåëüíî ìûøè.
</entry>
<entry>àâòîìàòè÷åñêè îïðåäåëÿòü, äîëæíà ëè âñïëûâàþùàÿ ïîäñêàçêà áûòü
ñëåâà èëè ñïðàâà îò êóðñîðà ìûøè.</entry>
</row>
<row>
<entry>vauto</entry>
<entry>boolean</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>
àâòîìàòè÷åñêîå îïðåäëåíèå âåðòèêàëüíîãî ìåñòîïîëîæåíèÿ îêíà
îòíîñèòåëüíî ìûøè.
</entry>
<entry>àâòîìàòè÷åñêè îïðåäåëÿòü, äîëæíà ëè âñïëûâàþùàÿ ïîäñêàçêà áûòü
âûøå èëè íèæå êóðñîðà ìûøè.</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para>
ôóíêöèÿ popup èñïîëüçóåòñÿ äëÿ ãåíåðàöèè javascript êîäà,
êîòîðûé ñîçäàñò âûñïëûâàþùåå îêíî.
</para>
<example>
<title>popup</title>
<title>{popup}</title>
<programlisting>
<![CDATA[
{* popup_init äîëæåí áûòü âûçâàí îäèí ðàç â íà÷àëå ñòðàíèöû *}
{* popup_init äîëæíà áûòü âûçâàíà îäèí ðàç â íà÷àëå ñòðàíèöû *}
{popup_init src="/javascripts/overlib.js"}
{* ñîçäàåì ññûëêó ñ âñïëûâàþùèì îêíîì, êîòîðîå ïîÿâëÿåòüñÿ ïðè íàâåäåíèè ìûøè *}
<a href="mypage.html" {popup text="This link takes you to my page!"}>mypage</A>
{* ñîçäàåò ññûëêó ñî âñïëûâàþùèì îêíîì, êîãäà âû íàâîäèòå íà íå¸ êóðñîð *}
<a href="mypage.html" {popup text="This link takes you to my page!"}>mypage</a>
{* ìîæíî èñïîëüçîâàòü html, ññûëêè è ò.ï. â âûñïëûâàþùåì îêíå *}
{* âû ìîæåòå èñïîëüçîâàòü HTML, ññûëêè è ò.ä. â òåêñòå *}
<a href="mypage.html" {popup sticky=true caption="mypage contents"
text="<ul><li>links</li><li>pages</li><li>images</li></ul>" snapx=10 snapy=10}>mypage</A>
text="<ul><li>links</li><li>pages</li><li>images</li></ul>"
snapx=10 snapy=10}>mypage</a>
]]>
</programlisting>
</example>
<para>
Ñì. òàêæå
<link linkend="language.function.popup.init">{popup_init}</link>
è
<ulink url="&url.overLib;">overLib</ulink>.
</para>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:

483
docs/ru/designers/language-custom-functions/language-function-textformat.xml
View File

@@ -1,240 +1,283 @@
<?xml version="1.0" encoding="windows-1251"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: freespace Status: ready -->
<!-- EN-Revision: 1.4 Maintainer: freespace Status: ready -->
<sect1 id="language.function.textformat">
<title>textformat</title>
<title>{textformat}</title>
<para>
{textformat} - ýòî
<link linkend="plugins.block.functions">áëîêîâàÿ ôóíêöèÿ</link>,
èñïîëüçóåìàÿ äëÿ ôîðìàòèðîâàíèÿ òåêñòà. Ïðîùå ãîâîðÿ, îíà óáèðàåò
ëèøíèå ïðîáåëû è ñïåöñèìâîëû, à òàê æå ôîðìàòèðóåò ïàðàãðàôû äîáàâëÿÿ
ðàçðûâû ñòðîê è îòñòóïû.
</para>
<para>
Âû ìîæåòå óêàçàòü ïàðàìåòðû ÿâíî, ëèáî èñïîëüçîâàòü ïðåäóñòàíîâëåííûé
ñòèëü.
Íà äàííûé ìîìåíò, åäèíñòâåííûì òàêèì ñòèëåì ÿâëÿåòñÿ "email".
</para>
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
<colspec colname="type" align="center" />
<colspec colname="required" align="center" />
<colspec colname="default" align="center" />
<colspec colname="desc" />
<thead>
<row>
<entry>Èìÿ àòðèáóòà</entry>
<entry>Òèï</entry>
<entry>Îáÿçàòåëåí</entry>
<entry>Ïî óìîë÷àíèþ</entry>
<entry>Îïèñàíèå</entry>
</row>
</thead>
<tbody>
<row>
<entry>style</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>ïðåäóñòàíîâëåííûé ñòèëü</entry>
</row>
<row>
<entry>indent</entry>
<entry>number</entry>
<entry>Íåò</entry>
<entry><emphasis>0</emphasis></entry>
<entry>îòñòóï ñòðîêè</entry>
</row>
<row>
<entry>indent_first</entry>
<entry>number</entry>
<entry>Íåò</entry>
<entry><emphasis>0</emphasis></entry>
<entry>îòñòóï ïåðâîé ñòðîêè</entry>
</row>
<row>
<entry>indent_char</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>(single space)</emphasis></entry>
<entry>ñèìâîë, êîòîðûì çàïîëíÿåòñÿ îòñòóï ñòðîê.</entry>
</row>
<row>
<entry>wrap</entry>
<entry>number</entry>
<entry>Íåò</entry>
<entry><emphasis>80</emphasis></entry>
<entry>êîëè÷åñòâî ñèìâîëîâ â ñòðîêå</entry>
</row>
<row>
<entry>wrap_char</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>\n</emphasis></entry>
<entry>òåêñò, ðàçäåëÿþùèé êàæäóþ ñòðîêó</entry>
</row>
<row>
<entry>wrap_cut</entry>
<entry>boolean</entry>
<entry>Íåò</entry>
<entry><emphasis>false</emphasis></entry>
<entry>
Ïåðåíîñèòü òåêñò ïî ñèìâîëàì (òî åñòü òî÷íî
ïî óêàçàííîé äëèíå ñòðîêè) (true), èëè ïî
ãðàíèöàì ñëîâ (false)
</entry>
</row>
<row>
<entry>assign</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>ïåðåìåííàÿ øàáëîíà, êîòîðîé áóäåò ïðèñâîåí âûâîä</entry>
</row>
</tbody>
<colspec colname="param" align="center" />
<colspec colname="type" align="center" />
<colspec colname="required" align="center" />
<colspec colname="default" align="center" />
<colspec colname="desc" />
<thead>
<row>
<entry>Èìÿ àòðèáóòà</entry>
<entry>Òèï</entry>
<entry>Îáÿçàòåëåí</entry>
<entry>Ïî óìîë÷àíèþ</entry>
<entry>Îïèñàíèå</entry>
</row>
</thead>
<tbody>
<row>
<entry>style</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>ïðåäóñòàíîâëåííûé ñòèëü</entry>
</row>
<row>
<entry>indent</entry>
<entry>number</entry>
<entry>Íåò</entry>
<entry><emphasis>0</emphasis></entry>
<entry>Êîëè÷åñòâî ñèìâîëîâ äëÿ îòñòóïà íà êàæäîé ñòðîêå</entry>
</row>
<row>
<entry>indent_first</entry>
<entry>number</entry>
<entry>Íåò</entry>
<entry><emphasis>0</emphasis></entry>
<entry>Êîëè÷åñòâî ñèìâîëîâ äëÿ îòñòóïà íà ïåðâîé ñòðîêå</entry>
</row>
<row>
<entry>indent_char</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>(îäèí ïðîáåë)</emphasis></entry>
<entry>Ñèìâîë (èëè íàáîð ñèìâîëîâ), ïðè ïîìîùè êîòîðûõ áóäåò
îñóùåñòâëÿòüñÿ îòñòóï</entry>
</row>
<row>
<entry>wrap</entry>
<entry>number</entry>
<entry>Íåò</entry>
<entry><emphasis>80</emphasis></entry>
<entry>Ìàêñèìàëüíîå êîëè÷åñòâî ñèìâîëîâ, ïîñëå êîòîðîãî áóäåò âñòàâëåí
ïåðåíîñ ñòðîêè</entry>
</row>
<row>
<entry>wrap_char</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>\n</emphasis></entry>
<entry>Ñèìâîë (èëè íàáîð ñèìâîëîâ), ïðè ïîìîùè êîòîðûõ áóäåò
îñóùåñòâëÿòüñÿ ïåðåíîñ ñòðîêè</entry>
</row>
<row>
<entry>wrap_cut</entry>
<entry>boolean</entry>
<entry>Íåò</entry>
<entry><emphasis>false</emphasis></entry>
<entry>Åñëè true, ïåðåíîñ ñòðîêè áóäåò ðàçáèâàòü ñòðîêó íà ëþáîì ñèìâîëå,
à íå òîëüêî íà ãðàíèöå ñëîâ</entry>
</row>
<row>
<entry>assign</entry>
<entry>string</entry>
<entry>Íåò</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>ïåðåìåííàÿ øàáëîíà äëÿ ïðèñâîåíèÿ ðåçóëüòàòà ðàáîòû ôóíêöèè</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para>
ôóíêöèÿ textformat èñïîëüçóåòñÿ äëÿ ôîðìàòèðîâàíèÿ òåêñòà,
çàêëþ÷åííîãî âíòóðè åå.  îñíîâíîì, óáèðàåò ëèøíèå ïðîáåëû è
ñïåöèàëüíûå ñèìâîëû, à òàê æå ôîðìàòèðóåò àáçàöû, äåëàåò îòñòóïû,
ïåðåíîñèò ñëîâà.
</para>
<para>
Ìîæíî óêàçûâàòü ïàðàìåòðû ÿâíî, èëè èñïîëüçîâàòü ïðåäóñòàíîâëåííûå ñòèëè.
Íà äàííûé ìîìåíò ñóùåñòâóåò òîëüêî ñòèëü "email".
</para>
<example>
<title>textformat</title>
<title>{textformat}</title>
<programlisting>
<![CDATA[
{textformat wrap=40}
{textformat wrap=40}
This is foo.
This is foo.
This is foo.
This is foo.
This is foo.
This is foo.
This is foo.
This is foo.
This is foo.
This is foo.
This is foo.
This is foo.
This is bar.
This is bar.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
{/textformat}
{/textformat}
OUTPUT:
This is foo. This is foo. This is foo.
This is foo. This is foo. This is foo.
This is bar.
bar foo bar foo foo. bar foo bar foo
foo. bar foo bar foo foo. bar foo bar
foo foo. bar foo bar foo foo. bar foo
bar foo foo. bar foo bar foo foo.
{textformat wrap=40 indent=4}
This is foo.
This is foo.
This is foo.
This is foo.
This is foo.
This is foo.
This is bar.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
{/textformat}
OUTPUT:
This is foo. This is foo. This is
foo. This is foo. This is foo. This
is foo.
This is bar.
bar foo bar foo foo. bar foo bar foo
foo. bar foo bar foo foo. bar foo
bar foo foo. bar foo bar foo foo.
bar foo bar foo foo. bar foo bar
foo foo.
{textformat wrap=40 indent=4 indent_first=4}
This is foo.
This is foo.
This is foo.
This is foo.
This is foo.
This is foo.
This is bar.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
{/textformat}
OUTPUT:
This is foo. This is foo. This
is foo. This is foo. This is foo.
This is foo.
This is bar.
bar foo bar foo foo. bar foo bar
foo foo. bar foo bar foo foo. bar
foo bar foo foo. bar foo bar foo
foo. bar foo bar foo foo. bar foo
bar foo foo.
{textformat style="email"}
This is foo.
This is foo.
This is foo.
This is foo.
This is foo.
This is foo.
This is bar.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
{/textformat}
OUTPUT:
This is foo. This is foo. This is foo. This is foo. This is foo. This is
foo.
This is bar.
bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo
bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo
foo.
]]>
</programlisting>
<para>
Ðåçóëüòàò âûïîëíåíèÿ äàííîãî ïðèìåðà:
</para>
<screen>
<![CDATA[
This is foo. This is foo. This is foo.
This is foo. This is foo. This is foo.
This is bar.
bar foo bar foo foo. bar foo bar foo
foo. bar foo bar foo foo. bar foo bar
foo foo. bar foo bar foo foo. bar foo
bar foo foo. bar foo bar foo foo.
]]>
</screen>
<programlisting>
<![CDATA[
{textformat wrap=40 indent=4}
This is foo.
This is foo.
This is foo.
This is foo.
This is foo.
This is foo.
This is bar.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
{/textformat}
]]>
</programlisting>
<para>
Ðåçóëüòàò âûïîëíåíèÿ äàííîãî ïðèìåðà:
</para>
<screen>
<![CDATA[
This is foo. This is foo. This is
foo. This is foo. This is foo. This
is foo.
This is bar.
bar foo bar foo foo. bar foo bar foo
foo. bar foo bar foo foo. bar foo
bar foo foo. bar foo bar foo foo.
bar foo bar foo foo. bar foo bar
foo foo.
]]>
</screen>
<programlisting>
<![CDATA[
{textformat wrap=40 indent=4 indent_first=4}
This is foo.
This is foo.
This is foo.
This is foo.
This is foo.
This is foo.
This is bar.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
{/textformat}
]]>
</programlisting>
<para>
Ðåçóëüòàò âûïîëíåíèÿ äàííîãî ïðèìåðà:
</para>
<screen>
<![CDATA[
This is foo. This is foo. This
is foo. This is foo. This is foo.
This is foo.
This is bar.
bar foo bar foo foo. bar foo bar
foo foo. bar foo bar foo foo. bar
foo bar foo foo. bar foo bar foo
foo. bar foo bar foo foo. bar foo
bar foo foo.
]]>
</screen>
<programlisting>
<![CDATA[
{textformat style="email"}
This is foo.
This is foo.
This is foo.
This is foo.
This is foo.
This is foo.
This is bar.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
{/textformat}
]]>
</programlisting>
<para>
Ðåçóëüòàò âûïîëíåíèÿ äàííîãî ïðèìåðà:
</para>
<screen>
<![CDATA[
This is foo. This is foo. This is foo. This is foo. This is foo. This is
foo.
This is bar.
bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo
bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo
foo.
]]>
</screen>
</example>
<para>
Ñì. òàêæå
<link linkend="language.function.strip">{strip}</link>
è
<link linkend="language.modifier.wordwrap">{wordwrap}</link>.
</para>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
@@ -255,4 +298,4 @@ End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
-->

2
docs/ru/designers/language-modifiers/language-modifier-strip-tags.xml
View File

@@ -4,7 +4,7 @@
<sect1 id="language.modifier.strip.tags">
<title>strip_tags</title>
<para>
Âûðåçàåò HTML òåãè, îáû÷íî âñå ìåæäó &lt; è &gt;.
Âûðåçàåò HTML òýãè, îáû÷íî âñå ìåæäó &lt; è &gt;.
</para>
<example>
<title>strip_tags</title>

2
docs/ru/programmers/api-functions/api-unregister-modifier.xml
View File

@@ -22,7 +22,7 @@
<programlisting role="php">
<![CDATA[
<?php
// ìû íå õîòèì, ÷òîáû äèçàéíåð øàáëîíîâ î÷èùàë ïåðåìåííûå îò òåãîâ
// ìû íå õîòèì, ÷òîáû äèçàéíåð øàáëîíîâ î÷èùàë ïåðåìåííûå îò òýãîâ
$smarty->unregister_modifier("strip_tags");
?>

2
docs/ru/programmers/api-variables/variable-php-handling.xml
View File

@@ -14,7 +14,7 @@
<listitem><para>SMARTY_PHP_PASSTHRU - Smarty ïîêàçûâàåò òýãè áåç îáðàáîòêè.</para></listitem>
<listitem><para>SMARTY_PHP_QUOTE - Smarty ïðåâðàùàåò ñïåöñèìâîëû òýãîâ â HTML-ñóùíîñòè.</para></listitem>
<listitem><para>SMARTY_PHP_REMOVE - Smarty óäàëÿåò òýãè èç øàëîíà.</para></listitem>
<listitem><para>SMARTY_PHP_ALLOW - Smarty áóäåò âûïîëíÿòü òåãè êàê PHP-êîä.</para></listitem>
<listitem><para>SMARTY_PHP_ALLOW - Smarty áóäåò âûïîëíÿòü òýãè êàê PHP-êîä.</para></listitem>
</itemizedlist>
<note>
<para>

2
docs/ru/programmers/plugins/plugins-functions.xml
View File

@@ -19,7 +19,7 @@
</para>
<para>
Âûâîä (âîçâðàùàåìîå çíà÷åíèå) ôóíêöèè áóäåò ïîäñòàâëåí â ìåñòî ðàñïîëîæåíèÿ
òåãà ôóíêöèè â øàáëîíå (ôóíêöèÿ <function>fetch</function> íàïðèìåð).
òýãà ôóíêöèè â øàáëîíå (ôóíêöèÿ <function>fetch</function> íàïðèìåð).
 êà÷åñòâå àëüòåðíàòèâû, ôóíêöèÿ ìîæåò âûïîëíÿòü êàêèå ëèáî äåéñòâèÿ
áåç êàêîãî-ëèáî âûâîäà (<function>assign</function> ôóíêöèÿ).
</para>