From a19c3348a0474b338bf18ed62dabf72bc9fec7bf Mon Sep 17 00:00:00 2001 From: freespace Date: Fri, 21 Apr 2006 10:01:03 +0000 Subject: [PATCH] sync with EN --- docs/ru/appendixes/tips.xml | 15 +++--- .../language-syntax-comments.xml | 22 +++++--- .../language-syntax-functions.xml | 26 ++++++---- .../language-syntax-variables.xml | 14 ++--- .../designers/language-builtin-functions.xml | 17 ++++-- docs/ru/designers/language-modifiers.xml | 52 +++++++++++++------ 6 files changed, 94 insertions(+), 52 deletions(-) diff --git a/docs/ru/appendixes/tips.xml b/docs/ru/appendixes/tips.xml index 56afa07f..e9a145d2 100644 --- a/docs/ru/appendixes/tips.xml +++ b/docs/ru/appendixes/tips.xml @@ -1,6 +1,6 @@ - + Советы @@ -103,13 +103,15 @@ - header.tpl + header.tpl - Обратите внимание, что "Smarty News" + отображается тогда, когда $title не задан, благодаря модификатору + default. - {$title|default:'BC News'} + {$title|default:'Smarty News'} ]]> @@ -348,7 +350,7 @@ function smarty_function_load_ticker($params, &$smarty) @@ -377,7 +379,7 @@ Stock Name: {$ticker.name} Stock Price: {$ticker.price} Пример сокрытия e-mail адреса diff --git a/docs/ru/designers/language-basic-syntax/language-syntax-comments.xml b/docs/ru/designers/language-basic-syntax/language-syntax-comments.xml index cf585ba7..88b7a653 100644 --- a/docs/ru/designers/language-basic-syntax/language-syntax-comments.xml +++ b/docs/ru/designers/language-basic-syntax/language-syntax-comments.xml @@ -1,6 +1,6 @@ - + Комментарии @@ -9,14 +9,20 @@ например: {* это комментарий *}. Комментарии не отображаются в выводе шаблона, в отличие от <!-- комментариев HTML -->, - и они используются для внутренних примечаний в шаблонах. + и они используются для внутренних примечаний в шаблонах, которые никто + не увидит ;-) - Комментарии + Комментарии внутри шаблона {* Я - простой комментарий Smarty, я не существую в скомпилированном выводе *} + + + {$title} + + {* другой однострочный комментарий Smarty *} @@ -33,11 +39,11 @@ @ css: the style output **********************************************************} -{* здесь включаем заголовок *} +{* Файл-заголовок с главным логотипом и т.д. *} {include file='header.tpl'} -{* Примечание разработчика: $includeFile назначается в скрипте foo.php *} +{* Примечание разработчика: переменная $includeFile назначается в скрипте foo.php *} {include file=$includeFile} @@ -48,10 +54,12 @@ *} -{* cvs-тэг шаблона *} +{* cvs-тэг шаблона: эти 36 ДОЛЖНЫ быть американской валютой, + но в таком случае CVS обработает их *} {* $Id: Exp $ *} - +{* $Id: *} + ]]> diff --git a/docs/ru/designers/language-basic-syntax/language-syntax-functions.xml b/docs/ru/designers/language-basic-syntax/language-syntax-functions.xml index c12bba1f..035a406c 100644 --- a/docs/ru/designers/language-basic-syntax/language-syntax-functions.xml +++ b/docs/ru/designers/language-basic-syntax/language-syntax-functions.xml @@ -1,15 +1,14 @@ - + Функции Каждый тэг Smarty либо выводит значение переменной, либо вызывает - некоторую функцию. Для вызова функции надо заключить в разделители - название функции и ее - параметры, - например: + некоторую функцию. Они обрабатываются путём заключения функции и ее + параметров + в разделители, например: {funcname attr1='val' attr2='val'}. @@ -19,15 +18,15 @@ {config_load file='colors.conf'} {include file='header.tpl'} -{insert file='banner_ads.tpl'} +{insert file='banner_ads.tpl' title='Smarty - это круто'} -{if $highlight_name} -Welcome, {$name}! +{if $logged_in} + Welcome, {$name}! {else} -Welcome, {$name}! + Hi, {$name}! {/if} -{include file='footer.tpl'} +{include file='footer.tpl' ad=$random_id} ]]> @@ -42,7 +41,7 @@ Welcome, {$name}! {if}, {section} и {strip}. - Они не должны быть модифицированы. + У вас не должно быть причин для их модификации. Пользовательские функции являются @@ -54,6 +53,11 @@ Welcome, {$name}! {html_options} и {popup}. + + + См. также + register_function() + - + Переменные Переменные шаблона начинаются со знака $доллара. Они могут состоять из цифр, букв, знаков подчёркивания - как и обычные PHP variable. - Вы можете обращаться к массивам, имеющим числовые и нечисловые индексы. + Вы можете обращаться к массивам по числовым и нечисловым индексам. Вы также можете обращаться к свойствам и методам объектов. Переменные конфигурационного файла - - это исключения из долларового синтаксиса. К ним можно обращаться, окружив + - это исключения из долларового синтаксиса; к ним можно обращаться, окружив их #решетками# или воспользовавшись специальной переменной $smarty.config. @@ -27,7 +27,7 @@ {#foo#} <-- отображает переменную "foo" конфигурационного файла {$smarty.config.foo} <-- синоним для {#foo#} {$foo[bar]} <-- синтаксис доступен только в цикле section, см. {section} -{assign var=foo value="baa"}{$foo} <-- отображает "baa", см. {assign} +{assign var=foo value='baa'}{$foo} <-- отображает "baa", см. {assign} Также доступно множество других комбинаций @@ -46,9 +46,9 @@ - Переменные запроса, такие как GET, POST, SESSION и т.д. также доступны, см. - описание зарезервированной переменной $smarty для дополнительной информации. + Переменные запроса, такие как $_GET, $_SESSION и т.д. также доступны, см. + описание зарезервированной переменной $smarty для дополнительной информации. diff --git a/docs/ru/designers/language-builtin-functions.xml b/docs/ru/designers/language-builtin-functions.xml index d715fd6f..138d4bbd 100644 --- a/docs/ru/designers/language-builtin-functions.xml +++ b/docs/ru/designers/language-builtin-functions.xml @@ -1,13 +1,20 @@ - + Встроенные функции - В smarty включены несколько встроенных функций. Встроенные функции - интегрированы в язык шаблонов. Нельзя создавать пользовательские - функции с такими же названиями или как-либо модифицировать - встроенные функции.. + В smarty включены несколько встроенных функций. Эти встроенные функции + интегрированы в язык шаблонов. Нельзя создавать + пользовательские функции + с такими же названиями и вам не следует модифицировать встроенные функции. + + + + Некоторые эти функции имеют атрибут assign, + который помещает результати их выполнения в переменную шаблона, вместо вывода + в браузер, практически как функция + {assign}. &designers.language-builtin-functions.language-function-capture; diff --git a/docs/ru/designers/language-modifiers.xml b/docs/ru/designers/language-modifiers.xml index 6a21f2eb..474de82d 100644 --- a/docs/ru/designers/language-modifiers.xml +++ b/docs/ru/designers/language-modifiers.xml @@ -1,38 +1,57 @@ - + Модификаторы переменных - Модификаторы переменных могут быть прмменены к переменным, пользовательским - функциям или строкам. Для их применения надо после модифицируемого значения + Модификаторы переменных могут быть прмменены к + переменным, + пользовательским функциям + или строкам. Для их применения надо после модифицируемого значения указать символ | (вертикальная черта) и название модификатора. Так же модификаторы могут принимать параметры, которые влияют на их поведение. Эти параметры следуют за названием модификатора и разделяются - : (двоеточием). + : (двоеточием). Кроме того, все функции PHP могут быть + использованы в качестве модификаторов - об этом дальше. - Пример модификатора + Примеры модификаторов + {html_options output=$myArray|upper|truncate:20} + ]]> @@ -45,15 +64,15 @@ - Модификаторы могут автоматически загружаться из вашей директории - $plugins_dir (см. также: - Соглашение об именах) - или могут регистрироваться явно (см.: register_modifier). + Модификаторы автоматически загружаются из директории + $plugins_dir + или могут быть явно зарегистрированы при помощи + register_modifier(); + это удобно для использования функции как в PHP-коде, так и в шаблоне. - К тому же, любая PHP-функция может быть явно использована в качестве модификатора. + Любая PHP-функция может быть явно использована в качестве модификатора. (Предыдущий пример с @count на самом деле использует функцию PHP, а не модификатор Smarty). Использование PHP-функций в качестве модификаторов имеет две маленькие "ловушки": Во-первых, иногда порядок аргументов функции @@ -62,7 +81,8 @@ который обеспечивается дистрибутивом Smarty). Во-вторых, в случае включения $security, все PHP-функции, которые будут использованы как модификаторы, должны быть объявлены "безопасными" - в массиве $security_settings['MODIFIER_FUNCS']. + в массиве + $security_settings['MODIFIER_FUNCS'].