From e48ef064fe8b0bef504ccc19a4165de6fd08fd25 Mon Sep 17 00:00:00 2001 From: freespace Date: Mon, 9 May 2005 17:34:38 +0000 Subject: [PATCH] --- docs/ru/designers/language-basic-syntax.xml | 8 +- .../language-syntax-functions.xml | 17 +- .../language-function-config-load.xml | 7 +- .../language-function-ldelim.xml | 31 ++- .../language-function-literal.xml | 8 +- .../language-function-html-checkboxes.xml | 12 +- .../language-function-html-radios.xml | 10 +- .../language-function-mailto.xml | 17 +- docs/ru/designers/language-modifiers.xml | 4 +- .../language-modifier-capitalize.xml | 7 +- .../language-modifier-count-characters.xml | 8 +- .../language-modifier-count-paragraphs.xml | 8 +- .../language-modifier-count-sentences.xml | 8 +- .../language-modifier-count-words.xml | 8 +- .../language-modifier-date-format.xml | 254 +++++++++++------- .../language-modifier-escape.xml | 121 +++++---- .../language-modifier-lower.xml | 44 ++- .../language-modifier-upper.xml | 40 ++- .../language-variables-smarty.xml | 6 +- .../programmers/api-functions/api-display.xml | 12 +- .../programmers/api-functions/api-fetch.xml | 12 +- .../api-functions/api-register-object.xml | 8 +- .../api-functions/api-unregister-object.xml | 9 +- .../api-variables/variable-compile-id.xml | 30 ++- .../variable-error-reporting.xml | 11 +- .../api-variables/variable-left-delimiter.xml | 6 +- .../variable-right-delimiter.xml | 18 +- 27 files changed, 474 insertions(+), 250 deletions(-) diff --git a/docs/ru/designers/language-basic-syntax.xml b/docs/ru/designers/language-basic-syntax.xml index 92727fa3..1b2642b8 100644 --- a/docs/ru/designers/language-basic-syntax.xml +++ b/docs/ru/designers/language-basic-syntax.xml @@ -1,17 +1,17 @@ - + Базовый синтаксис Все тэги шаблонов Smarty располагаются между специальными разделителями. По умолчанию это { и - }, но они могут быть изменены. + }, но они могут быть изменены. Для наших примеров мы будем использовать стандартные разделители. - Smarty все содержимое вне разделителей отображает как статическое - содержание, без изменений. Когда Smarty встречает тэги, то пытается + Smarty все содержимое вне разделителей отображает как статический + контент, без изменений. Когда Smarty встречает тэги шаблона, то пытается интерпретировать их и вывести вместо них соответствующий результат. 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 0efc002d..14c4b086 100644 --- a/docs/ru/designers/language-basic-syntax/language-syntax-functions.xml +++ b/docs/ru/designers/language-basic-syntax/language-syntax-functions.xml @@ -1,14 +1,14 @@ - + Функции Каждый тэг Smarty либо выводит значение переменной, либо вызывает - некоторую функцию. Для вызова функции надо название функции и ее - параметры заключить в разделители, например: {funcname attr1="val" - attr2="val"}. + некоторую функцию. Для вызова функции надо заключить в разделители + название функции и ее параметры, например: + {funcname attr1="val" attr2="val"}. Синтаксис функций @@ -32,11 +32,14 @@ Welcome, {$name}! И встроенные, и пользовательские функции используются с одинаковым синтаксисом. Встроенные функции реализованы внутри Smarty и не могут быть изменены или переопределены. Это такие функции, как - if, section, - strip. Пользовательские функции реализуются через + if, + section и + strip. + Пользовательские функции реализуются через плагины. Они могут быть изменены по вашему желанию, также вы можете написать новые. Примеры пользовательских функций: - html_options, html_select_date. + html_options и + html_select_date. - + config_load @@ -125,6 +125,11 @@ ]]> + + + См. также Конфигурационные файлы и + config_load. + - + ldelim,rdelim ldelim и rdelim используются для отображения разделителей. - В нашем случае это "{" и "}". Вы можете использовать блок {literal}{/literal} для + В нашем случае это "{" и "}". Вы можете использовать блок + {literal}{/literal} для экранирования блоков текста. - См. также {$smarty.ldelim} - и {$smarty.rdelim} + См. также + {$smarty.ldelim} и + {$smarty.rdelim} ldelim, rdelim @@ -19,17 +20,21 @@ {ldelim}funcname{rdelim} is how functions look in Smarty! ]]> - - - Результат выполнения данного примера: - - + + + Результат выполнения данного примера: + + - - - + + + + См. также + Предотвращение обработки Smarty + + - + literal @@ -18,7 +18,7 @@ + +%27%29%3b')) me@d& #x6f;main.com me@example.com me@example.com + ]]> diff --git a/docs/ru/designers/language-modifiers.xml b/docs/ru/designers/language-modifiers.xml index 827f5303..f7248909 100644 --- a/docs/ru/designers/language-modifiers.xml +++ b/docs/ru/designers/language-modifiers.xml @@ -1,6 +1,6 @@ - + Модификаторы переменных @@ -44,9 +44,9 @@ количество елементов в массиве $articleTitle. +&designers.language-modifiers.language-modifier-cat; &designers.language-modifiers.language-modifier-capitalize; &designers.language-modifiers.language-modifier-count-characters; -&designers.language-modifiers.language-modifier-cat; &designers.language-modifiers.language-modifier-count-paragraphs; &designers.language-modifiers.language-modifier-count-sentences; &designers.language-modifiers.language-modifier-count-words; diff --git a/docs/ru/designers/language-modifiers/language-modifier-capitalize.xml b/docs/ru/designers/language-modifiers/language-modifier-capitalize.xml index 6c5d8f69..51b22c21 100644 --- a/docs/ru/designers/language-modifiers/language-modifier-capitalize.xml +++ b/docs/ru/designers/language-modifiers/language-modifier-capitalize.xml @@ -1,6 +1,6 @@ - + capitalize @@ -68,6 +68,11 @@ Next X-Men Film, X3, Delayed. ]]> + + См. также + lower и + upper + - + count_characters @@ -26,6 +26,12 @@ Cold Wave Linked to Temperatures. 32 + + См. также + count_paragraphs, + count_sentences и + count_words + - + count_paragraphs @@ -28,6 +28,12 @@ War Dims Hope for Peace. Child's Death Ruins Couple's Holiday. Man is Fatally Slain. Death Causes Loneliness, Feeling of Isolation. 2 + + См. также + count_characters, + count_sentences и + count_words + - + count_sentences @@ -26,6 +26,12 @@ Two Soviet Ships Collide - One Dies. Enraged Cow Injures Farmer with Axe. 2 + + См. также + count_characters, + count_paragraphs и + count_words + - + count_words @@ -26,6 +26,12 @@ Dealers Will Hear Car Talk at Noon. 7 + + См. также + count_characters, + count_paragraphs и + count_sentences + - + date_format @@ -46,117 +46,173 @@ date_format - -index.php: - + +assign('yesterday', strtotime('-1 day')); +$smarty->display('index.tpl'); + +?> +]]> + + + Где index.tpl: + + + + + + Результатом будет: + + + - - - date_format conversion specifiers - -%a - сокращенное название дня недели, в зависимости от текущей локали - -%A - полное название дня недели, в зависимости от текущей локали - -%b - сокращенное название месяца, в зависимости от текущей локали - -%B - полное название месяца, в зависимости от текущей локали - -%c - формат даты и времени по умолчанию для текущей локали - -%C - номер века (год, деленный на 100, представленный в виде целого в промежутке от 00 до 99) - -%d - день месяца в десятичном формате (от 00 до 31) - -%D - синоним %m/%d/%y - -%e - день месяца в десятичном формате без ведущего нуля (от 1 до 31) - -%g - Week-based year within century [00,99] - -%G - Week-based year, including the century [0000,9999] - -%h - синоним %b - -%H - часы по 24-часовым часам (от 00 до 23) - -%I - часы по 12-часовым часам (от 01 до 12) - -%j - день года (от 001 до 366) - -%k - часы по 24-часовым часам без ведущего нуля (от 0 до 23) - -%l - часы по 12-часовым часам без ведущего нуля (от 1 до 12) - -%m - номер месяца (от 01 до 12) - -%M - минуты - -%n - символ новой строки - -%p - `am' или `pm', в зависимости от заданного формата времени и текущей локали. - -%r - time in a.m. and p.m. notation - -%R - time in 24 hour notation - -%S - секунды - -%t - символ табуляции - -%T - время в формате %H:%M:%S - -%u - номер дня недели [1,7], где 1-ый день - понедельник - -%U - номер недели в году, считая первое воскресенья года первым днем первой недели - -%V - номер недели в году (по ISO 8601:1988) в диапазоне от 01 до 53, где первая неделя - та, у которой хотя бы 4 дня находятся в данном году. Понедельник считается - первым днем недели. - -%w - номер дня недели, где 0 - воскресенье - -%W - номер недели в году, считаю первый понедельник первым днем первой недели. - -%x - preferred date representation for the current locale without the time - -%X - preferred time representation for the current locale without the date - -%y - year as a decimal number without a century (range 00 to 99) - -%Y - year as a decimal number including the century - -%Z - time zone or name or abbreviation - -%% - a literal `%' character - - -ЗАМЕЧАНИЕ ДЛЯ ПРОГРАММИСТОВ: date_format - это обертка для функции strftime(), -поэтому полный список спецификаторов, соответствующий вашей системе, вы -сможете найти в соответствующем системном руководстве. - +14:33:00 +]]> + + + Указатели преобразования date_format: + + + %a - сокращенное название дня недели, в зависимости от текущей локали + + + %A - полное название дня недели, в зависимости от текущей локали + + + %b - сокращенное название месяца, в зависимости от текущей локали + + + %B - полное название месяца, в зависимости от текущей локали + + + %c - формат даты и времени по умолчанию для текущей локали + + + %C - номер века (год, деленный на 100, представленный в виде целого в промежутке от 00 до 99) + + + %d - день месяца в десятичном формате (от 00 до 31) + + + %D - синоним %m/%d/%y + + + %e - день месяца в десятичном формате без ведущего нуля (от 1 до 31) + + + %g - Week-based year within century [00,99] + + + %G - Week-based year, including the century [0000,9999] + + + %h - синоним %b + + + %H - часы по 24-часовым часам (от 00 до 23) + + + %I - часы по 12-часовым часам (от 01 до 12) + + + %j - день года (от 001 до 366) + + + %k - часы по 24-часовым часам без ведущего нуля (от 0 до 23) + + + %l - часы по 12-часовым часам без ведущего нуля (от 1 до 12) + + + %m - номер месяца (от 01 до 12) + + + %M - минуты + + + %n - символ новой строки + + + %p - `am' или `pm', в зависимости от заданного формата времени и текущей локали. + + + %r - time in a.m. and p.m. notation + + + %R - time in 24 hour notation + + + %S - секунды + + + %t - символ табуляции + + + %T - время в формате %H:%M:%S + + + %u - номер дня недели [1,7], где 1-ый день - понедельник + + + %U - номер недели в году, считая первое воскресенья года первым днем первой недели + + + %V - номер недели в году (по ISO 8601:1988) в диапазоне от 01 до 53, где первая неделя + та, у которой хотя бы 4 дня находятся в данном году. Понедельник считается + первым днем недели. + + + %w - номер дня недели, где 0 - воскресенье + + + %W - номер недели в году, считаю первый понедельник первым днем первой недели. + + + %x - предпочтительное представление даты для текущих настроек locale без времени + + + %X - предпочтительное представление времени для текущих настроек locale без даты + + + %y - год в виде десятичного числа без века (от 00 до 99) + + + %Y - год в виде десятичного числа включая век + + + %Z - часовой пояс или имя или сокращение + + + %% - буквальный символ `%' + + + + Замечание для программистов + + date_format - это просто обёртка функции PHP + strftime(). + Вы можете иметь больше или меньше доступных указателей преобразования + в зависимости от функции strftime() той системы, где был + скомпилирован PHP. Обратитесь к руководству вашей системы + для полного списка доступных указателей. + + + - + escape - - - - - - - - - - Позиция параметра - Тип - Обязателен - Возможные значения - По умолчанию - Описание - - - - - 1 - string - Нет - html,htmlall,url,quotes,hex,hexentity,javascript - html - Формат защиты (escape). - - - + + + + + + + + + + Позиция параметра + Тип + Обязателен + Возможные значения + По умолчанию + Описание + + + + + 1 + string + Нет + html,htmlall,url,quotes,hex,hexentity,javascript + html + Формат защиты (escape). + + + - + "Защищает" специальные символы в переменной. Используется для защиты специальных символов html, защиты специальных символов url, защиты одиночных кавычек, конвертации в шестандцатеричный вид (hex), конвертации каждого символа в шестандцатеричное html представление (hexentity), защита специальных символов - javascript. + javascript. По умолчанию используется защита спецсимволов html. escape - -index.php: - + +assign('articleTitle', "'Stiff Opposition Expected to Casketless Funeral Plan'"); +$smarty->display('index.tpl'); + +?> +]]> + + + Где index.tpl: + + + *} +{$articleTitle|escape:"htmlall"} {* escapes ALL html entities *} {$articleTitle|escape:"url"} {$articleTitle|escape:"quotes"} -<a -href="mailto:{$EmailAddress|escape:"hex"}">{$EmailAddress|escape:"hexentity"}</a> - -OUTPUT: - +{$EmailAddress|escape:"hexentity"} +]]> + + + Результатом будет: + + + - +bob@me.net +]]> + + + + См. также + Предотвращение обработки Smarty + - + lower @@ -8,23 +8,41 @@ lower - -index.php: - + +assign('articleTitle', 'Two Convicts Evade Noose, Jury Hung.'); +$smarty->display('index.tpl'); + +?> +]]> + + + Где index.tpl: + + + + + + Результатом будет: + + + +two convicts evade noose, jury hung. +]]> + + + См. также + upper и + capitalize. + - + upper @@ -8,25 +8,43 @@ upper - -index.php: + +assign('articleTitle', "If Strike isn't Settled Quickly it may Last a While."); +$smarty->display('index.tpl'); +?> +]]> + + + Где index.tpl: + + + + + + Результатом будет: + + + +]]> + + + См. также + lower и + capitalize. + + - + Зарезервированная переменная {$smarty} @@ -80,8 +80,8 @@ {$smarty.capture} Доступ к выводу, сохраненному с помощью тэгов - {capture}..{/capture}, можно получить используя переменную - {$smarty}. Смотрите раздел {capture}..{/capture}, + можно получить используя переменную {$smarty}. Смотрите раздел capture для примера. diff --git a/docs/ru/programmers/api-functions/api-display.xml b/docs/ru/programmers/api-functions/api-display.xml index 07cc0ffc..e8467011 100644 --- a/docs/ru/programmers/api-functions/api-display.xml +++ b/docs/ru/programmers/api-functions/api-display.xml @@ -1,6 +1,6 @@ - + display @@ -18,8 +18,9 @@ Функция отоброжает шаблон. Укажите верный тип ресурса шаблонов и путь. В качестве необязательного второго параметра, - вы можете передать cache id. Смотрите раздел - "Кэширование" для дополнительной информации. + вы можете передать cache id. Смотрите раздел + Кэширование + для дополнительной информации. ¶meter.compileid; @@ -80,6 +81,11 @@ $smarty->display("db:header.tpl"); ]]> + + См. также + fetch() и + template_exists. + - + fetch @@ -19,8 +19,9 @@ Укажите верный тип ресурса шаблонов и путь. В качестве необязательного второго параметра можно передать - cache id. Смотрите раздел - "Кэширование"; для получения дополнительной информации. + cache id. Смотрите раздел + Кэширование + для получения дополнительной информации. ¶meter.compileid; @@ -63,6 +64,11 @@ echo $output; + + См. также + display() и + template_exists. + - + register_object @@ -18,9 +18,13 @@ Функция регестрирует объект для использования в шаблоне. Обратитесь к - разделу "Объекты" + разделу Объекты за примерами. + + См. также + unregister_object. + - + unregister_object @@ -13,7 +13,12 @@ stringobject_name - Используется для дерегистрации объекта. + Используется для дерегистрации объекта. + + + См. также + register_object и раздел + Объекты diff --git a/docs/ru/programmers/api-variables/variable-compile-id.xml b/docs/ru/programmers/api-variables/variable-compile-id.xml index 4d064815..e38600b3 100644 --- a/docs/ru/programmers/api-variables/variable-compile-id.xml +++ b/docs/ru/programmers/api-variables/variable-compile-id.xml @@ -1,14 +1,40 @@ - + $compile_id Постоянный идентификатор компиляции. Как альтернативу использованию одного и того же compile_id при каждом вызове функции, вы можете самостоятельно - задавать этот идентификатор, и в этом случае будет использоваться именно + задавать этот идентификатор, и в этом случае будет безусловно автоматически это значение. + + С помощью compile_id вы можете обойти ограничение, из-за которого вы не + можете использовать один compile_dir для разных template_dir. + Если вы установите уникальный compile_id для каждого template_dir, Smarty + сможет различать компилированные шаблоны по их compile_id. + + + К примеру, если у вас есть префильтр, локализирующий ваш ваши шаблоны + (проще говоря, переводит части шаблонов на другой язык) во время + компиляции, то вам следует использовать текущий язык в качестве + compile_id и вы получите по набору скомпилированных шаблонов для + каждого используемого языка. + + + Другим примером может быть использование одной компиляционной директории + для нескольких доменов / нескольких vhost'ов, к примеру: + + + compile_id + +compile_id = $_SERVER['SERVER_NAME']; + $smarty->compile_dir = 'path/to/shared_compile_dir'; +]]> + + - + $error_reporting Если это свойство имеет ненулевое значние, то оно используется - в качестве значения error_reporting внутри display() и - fetch(). При включенном режиме отладки это значение игнорируется - и уровень обработки ошибок не меняется. + в качестве значения error_reporting внутри + display() и + fetch(). + При включенном режиме отладки это значение + игнорируется и уровень обработки ошибок не меняется. - + $left_delimiter Левый разделитель, используемый в языке шаблонов. По умолчанию равно "{". + + См. также + $right_delimiter. + - - - $right_delimiter - - Правый разделитель, используемый в языке шаблонов. - По умолчанию равно "}". - + + + $right_delimiter + + Правый разделитель, используемый в языке шаблонов. + По умолчанию равно "}". + + + См. также + $left_delimiter. +