From 04cb59e09c317d9e3fa3c8a1f8f9cc6bee99e3c1 Mon Sep 17 00:00:00 2001 From: freespace Date: Thu, 20 Jul 2006 12:42:00 +0000 Subject: [PATCH] sync with EN --- .../language-modifier-date-format.xml | 9 ++- .../language-modifier-default.xml | 23 +++++-- .../language-modifier-escape.xml | 48 ++++++++++---- .../language-modifier-indent.xml | 5 +- .../language-modifier-lower.xml | 5 +- .../language-modifier-nl2br.xml | 2 +- .../language-modifier-strip.xml | 10 ++- .../language-modifier-truncate.xml | 4 +- .../language-modifier-upper.xml | 5 +- .../language-modifier-wordwrap.xml | 1 + .../language-variables-smarty.xml | 65 +++++++++++++++---- 11 files changed, 135 insertions(+), 42 deletions(-) diff --git a/docs/ru/designers/language-modifiers/language-modifier-date-format.xml b/docs/ru/designers/language-modifiers/language-modifier-date-format.xml index 2a8d7623..76ade028 100644 --- a/docs/ru/designers/language-modifiers/language-modifier-date-format.xml +++ b/docs/ru/designers/language-modifiers/language-modifier-date-format.xml @@ -1,6 +1,6 @@ - + date_format @@ -79,6 +79,9 @@ assign('config',$config); $smarty->assign('yesterday', strtotime('-1 day')); ?> @@ -91,10 +94,10 @@ $smarty->assign('yesterday', strtotime('-1 day')); diff --git a/docs/ru/designers/language-modifiers/language-modifier-default.xml b/docs/ru/designers/language-modifiers/language-modifier-default.xml index ad96d291..0cee020e 100644 --- a/docs/ru/designers/language-modifiers/language-modifier-default.xml +++ b/docs/ru/designers/language-modifiers/language-modifier-default.xml @@ -1,14 +1,24 @@ - + default Используется для установки значения по умолчанию для переменной. - Если переменная пуста или не установлена, указанное значение по умолчанию - будет подставлено вместо неё. + Если переменная не установлена или является пустой строкой, указанное + значение по умолчанию будет подставлено вместо неё. + + + + Если директива error_reporting установлена в E_ALL, необъявленные переменные + всегда будут отображать ошибку в шаблоне. Эта функция полезна для замены + пустых значений или строк нулевой длинны. + + + + @@ -44,6 +54,7 @@ assign('articleTitle', 'Dealers Will Hear Car Talk at Noon.'); +$smarty->assign('email',''); ?> ]]> @@ -53,8 +64,9 @@ $smarty->assign('articleTitle', 'Dealers Will Hear Car Talk at Noon.'); @@ -64,6 +76,7 @@ $smarty->assign('articleTitle', 'Dealers Will Hear Car Talk at Noon.'); diff --git a/docs/ru/designers/language-modifiers/language-modifier-escape.xml b/docs/ru/designers/language-modifiers/language-modifier-escape.xml index ccc76853..df01c3ed 100644 --- a/docs/ru/designers/language-modifiers/language-modifier-escape.xml +++ b/docs/ru/designers/language-modifiers/language-modifier-escape.xml @@ -1,12 +1,12 @@ - + escape - Используется для экранирования спецсимволов html, url, одинарных кавычек - на переменной, если они ещё не экранированы; шестнадцатиричное кодирование, - шестнадцатиричное кодирование в HTML-entities и javascript-экранирование. + Используется для кодирования / экранирования спецсимволов по алгоритмам + экранирования HTML, URL'ов, одиночных кавычек, hex-экранирования, + hex-сущностей, javascript и экранирования почтовых адресов. По умолчанию активирован режим экранирования HTML. @@ -33,7 +33,7 @@ 1 string Нет - html,htmlall,url,urlpathinfo,quotes,hex,hexentity,javascript + html,htmlall,url,urlpathinfo,quotes,hex,hexentity,javascript,mail html формат экранирования @@ -59,7 +59,7 @@ $smarty->assign('articleTitle', "'Stiff Opposition Expected to Casketless Funeral Plan'" ); - +$smarty->assign('EmailAddress','smarty@example.com'); ?> ]]> @@ -70,11 +70,13 @@ $smarty->assign('articleTitle', *} -{$articleTitle|escape:"htmlall"} {* экранирует все html entities *} -{$articleTitle|escape:"url"} -{$articleTitle|escape:"quotes"} +{$articleTitle|escape:'html'} {* экранирует & " ' < > *} +{$articleTitle|escape:'htmlall'} {* экранирует ВСЕ HTML-сущности *} +{$articleTitle|escape:'url'} +{$articleTitle|escape:'quotes'} {$EmailAddress|escape:"hexentity"} +{$EmailAddress|escape:'mail'} {* конвертирует e-mail в текст *} +{'mail@example.com'|escape:'mail'} ]]> @@ -89,12 +91,36 @@ $smarty->assign('articleTitle', %27Stiff+Opposition+Expected+to+Casketless+Funeral+Plan%27 \'Stiff Opposition Expected to Casketless Funeral Plan\' bob..snip..et +smarty [AT] example [DOT] com +mail [AT] example [DOT] com ]]> + + Обратите внимание, что родные функции PHP могут использоваться в качестве + модификаторов, так что следующие приёмы сработают + + +click here + ]]> + + + Это очень полезно для e-mail'ов, но см. также + {mailto} + + +{$EmailAddress|escape:'mail'} +]]> + + См. также - Предотвращение обработки Smarty + Предотвращение обработки Smarty, + {mailto} и Сокрытие E-mail адреса. diff --git a/docs/ru/designers/language-modifiers/language-modifier-indent.xml b/docs/ru/designers/language-modifiers/language-modifier-indent.xml index 5ed704f6..c3f02d10 100644 --- a/docs/ru/designers/language-modifiers/language-modifier-indent.xml +++ b/docs/ru/designers/language-modifiers/language-modifier-indent.xml @@ -1,6 +1,6 @@ - + indent @@ -100,7 +100,8 @@ Statistics show that teen pregnancy drops off significantly after 25. См. также - strip + strip, + wordwrap и spacify. diff --git a/docs/ru/designers/language-modifiers/language-modifier-lower.xml b/docs/ru/designers/language-modifiers/language-modifier-lower.xml index ca4a1b26..73feea22 100644 --- a/docs/ru/designers/language-modifiers/language-modifier-lower.xml +++ b/docs/ru/designers/language-modifiers/language-modifier-lower.xml @@ -1,10 +1,11 @@ - + lower - Переводит строку в нижний регистр. + Переводит строку в нижний регистр. Является эквивалентом функции PHP + strtolower(). lower diff --git a/docs/ru/designers/language-modifiers/language-modifier-nl2br.xml b/docs/ru/designers/language-modifiers/language-modifier-nl2br.xml index 6018d62f..9bc41125 100644 --- a/docs/ru/designers/language-modifiers/language-modifier-nl2br.xml +++ b/docs/ru/designers/language-modifiers/language-modifier-nl2br.xml @@ -1,6 +1,6 @@ - + nl2br diff --git a/docs/ru/designers/language-modifiers/language-modifier-strip.xml b/docs/ru/designers/language-modifiers/language-modifier-strip.xml index 08db5968..57bdf627 100644 --- a/docs/ru/designers/language-modifiers/language-modifier-strip.xml +++ b/docs/ru/designers/language-modifiers/language-modifier-strip.xml @@ -1,6 +1,6 @@ - + strip @@ -33,7 +33,7 @@ $smarty->assign('articleTitle', "Grandmother of\neight makes\t hole in one.") @@ -48,6 +48,12 @@ Grandmother of eight makes hole in one. ]]> + + См. также + {strip} + и + truncate. + - + truncate @@ -89,6 +89,7 @@ $smarty->assign('articleTitle', 'Two Sisters Reunite after Eighteen Years at Che {$articleTitle|truncate:30:"---"} {$articleTitle|truncate:30:"":true} {$articleTitle|truncate:30:"...":true} +{$articleTitle|truncate:30:'..':true:true} ]]> @@ -103,6 +104,7 @@ Two Sisters Reunite after Two Sisters Reunite after--- Two Sisters Reunite after Eigh Two Sisters Reunite after E... +Two Sisters Re..ckout Counter. ]]> diff --git a/docs/ru/designers/language-modifiers/language-modifier-upper.xml b/docs/ru/designers/language-modifiers/language-modifier-upper.xml index 56404fb7..42f03951 100644 --- a/docs/ru/designers/language-modifiers/language-modifier-upper.xml +++ b/docs/ru/designers/language-modifiers/language-modifier-upper.xml @@ -1,10 +1,11 @@ - + upper - Переводит строку в верхний регистр. + Переводит строку в верхний регистр. Является эквивалентом функции PHP + strtoupper(). upper diff --git a/docs/ru/designers/language-modifiers/language-modifier-wordwrap.xml b/docs/ru/designers/language-modifiers/language-modifier-wordwrap.xml index 6ba7ce26..6fae1b5d 100644 --- a/docs/ru/designers/language-modifiers/language-modifier-wordwrap.xml +++ b/docs/ru/designers/language-modifiers/language-modifier-wordwrap.xml @@ -1,5 +1,6 @@ + wordwrap diff --git a/docs/ru/designers/language-variables/language-variables-smarty.xml b/docs/ru/designers/language-variables/language-variables-smarty.xml index e10a756b..d91b76b2 100644 --- a/docs/ru/designers/language-variables/language-variables-smarty.xml +++ b/docs/ru/designers/language-variables/language-variables-smarty.xml @@ -1,11 +1,11 @@ - + Зарезервированная переменная {$smarty} Зарезервированная переменная {$smarty} может быть использована для получения - доступа к нескольким специальным переменным шаблона. Далее следует их полный + доступа к нескольким переменным окружения и запроса. Далее следует их полный список. @@ -51,17 +51,26 @@ получить непосредственно, хотя предпочтительным способом является обращение {$smarty.server.SCRIPT_NAME}. + +click me +click me +]]> + {$smarty.now} Текущая временная метка - содержится в переменной {$smarty.now}. Это число отображает количество + содержится в переменной {$smarty.now}. Это значение отражает количество секунд, которые прошли с момента наступления так называемой Эпохи (1 января 1970 года). Её можно прямо передавать модификатору date_format - для отображения текущей даты/времени. + для отображения текущей даты/времени. Обратите внимание, + что time() вызывается при каджом обращении; к примеру, скрипт, работающий + три секунды и вызывающий $smarty.now в начале и в конце работы, покажет + разницу в три секунды. Использование {$smarty.now} @@ -80,9 +89,16 @@ linkend="smarty.constants">Константы Smarty - Использование {$smarty.const} - + Использование {$smarty.const} для доступа к константам + + + + @@ -92,9 +108,9 @@ {$smarty.capture} - Результат захвата конструкции {capture}..{/capture} - доступен при помощи переменной {$smarty}. См. раздел о + Результат обработки шаблона, сохраненный конструкцией {capture}..{/capture}, + доступен при помощи переменной {$smarty.capture}. См. раздел о {capture} для получения примера. @@ -117,26 +133,49 @@ Переменную {$smarty} можно использовать для обращения к свойствам циклов {section} и {foreach}. + Это очень полезные значения вроде .first, .index и т.д. {$smarty.template} - Эта переменная содержит имя текущего обрабатываемого шаблона. + Возвращает имя текущего обрабатываемого шаблона. Этот пример показывает + container.tpl и включенные в него banner.tpl, оба имеют вызов + {$smarty.template} + +Main container is {$smarty.template} +{include file='banner.tpl} +]]> + + + результат обработки шаблона: + + +Main page if container.tpl +banner.tpl +]]> + {$smarty.version} - Эта переменная содержит версию Smarty, с которой был скомпилирован шаблон. + Возвращает версию Smarty, с которой был скомпилирован шаблон. + +Powered by Smarty {$smarty.version} +]]> + {$smarty.ldelim}, {$smarty.rdelim} - Эти переменные используются для отображения левого и правого ограничителей. - См. {ldelim},{rdelim}. + Эти переменные используются для отображения левого и правого ограничителей - + так же, как и {ldelim},{rdelim}. См. также