diff --git a/docs/ru/programmers/advanced-features.xml b/docs/ru/programmers/advanced-features.xml index 60359829..4684fd54 100644 --- a/docs/ru/programmers/advanced-features.xml +++ b/docs/ru/programmers/advanced-features.xml @@ -1,14 +1,14 @@ - + Расширенные возможности - &programmers.advanced-features.advanced-features-objects; - &programmers.advanced-features.advanced-features-prefilters; - &programmers.advanced-features.advanced-features-postfilters; - &programmers.advanced-features.advanced-features-outputfilters; - &programmers.advanced-features.section-template-cache-handler-func; - &programmers.advanced-features.template-resources; + &programmers.advanced-features.advanced-features-objects; + &programmers.advanced-features.advanced-features-prefilters; + &programmers.advanced-features.advanced-features-postfilters; + &programmers.advanced-features.advanced-features-outputfilters; + &programmers.advanced-features.section-template-cache-handler-func; + &programmers.advanced-features.template-resources; - + - Методы - &programmers.api-functions.api-append; - &programmers.api-functions.api-append-by-ref; - &programmers.api-functions.api-assign; - &programmers.api-functions.api-assign-by-ref; - &programmers.api-functions.api-clear-all-assign; - &programmers.api-functions.api-clear-all-cache; - &programmers.api-functions.api-clear-assign; - &programmers.api-functions.api-clear-cache; - &programmers.api-functions.api-clear-compiled-tpl; - &programmers.api-functions.api-clear-config; - &programmers.api-functions.api-config-load; - &programmers.api-functions.api-display; - &programmers.api-functions.api-fetch; - &programmers.api-functions.api-get-config-vars; - &programmers.api-functions.api-get-registered-object; - &programmers.api-functions.api-get-template-vars; - &programmers.api-functions.api-is-cached; - &programmers.api-functions.api-load-filter; - &programmers.api-functions.api-register-block; - &programmers.api-functions.api-register-compiler-function; - &programmers.api-functions.api-register-function; - &programmers.api-functions.api-register-modifier; - &programmers.api-functions.api-register-object; - &programmers.api-functions.api-register-outputfilter; - &programmers.api-functions.api-register-postfilter; - &programmers.api-functions.api-register-prefilter; - &programmers.api-functions.api-register-resource; - &programmers.api-functions.api-trigger-error; - &programmers.api-functions.api-template-exists; - &programmers.api-functions.api-unregister-block; - &programmers.api-functions.api-unregister-compiler-function; - &programmers.api-functions.api-unregister-function; - &programmers.api-functions.api-unregister-modifier; - &programmers.api-functions.api-unregister-object; - &programmers.api-functions.api-unregister-outputfilter; - &programmers.api-functions.api-unregister-postfilter; - &programmers.api-functions.api-unregister-prefilter; - &programmers.api-functions.api-unregister-resource; + Методы класса Smarty + &programmers.api-functions.api-append; + &programmers.api-functions.api-append-by-ref; + &programmers.api-functions.api-assign; + &programmers.api-functions.api-assign-by-ref; + &programmers.api-functions.api-clear-all-assign; + &programmers.api-functions.api-clear-all-cache; + &programmers.api-functions.api-clear-assign; + &programmers.api-functions.api-clear-cache; + &programmers.api-functions.api-clear-compiled-tpl; + &programmers.api-functions.api-clear-config; + &programmers.api-functions.api-config-load; + &programmers.api-functions.api-display; + &programmers.api-functions.api-fetch; + &programmers.api-functions.api-get-config-vars; + &programmers.api-functions.api-get-registered-object; + &programmers.api-functions.api-get-template-vars; + &programmers.api-functions.api-is-cached; + &programmers.api-functions.api-load-filter; + &programmers.api-functions.api-register-block; + &programmers.api-functions.api-register-compiler-function; + &programmers.api-functions.api-register-function; + &programmers.api-functions.api-register-modifier; + &programmers.api-functions.api-register-object; + &programmers.api-functions.api-register-outputfilter; + &programmers.api-functions.api-register-postfilter; + &programmers.api-functions.api-register-prefilter; + &programmers.api-functions.api-register-resource; + &programmers.api-functions.api-trigger-error; + + &programmers.api-functions.api-template-exists; + &programmers.api-functions.api-unregister-block; + &programmers.api-functions.api-unregister-compiler-function; + &programmers.api-functions.api-unregister-function; + &programmers.api-functions.api-unregister-modifier; + &programmers.api-functions.api-unregister-object; + &programmers.api-functions.api-unregister-outputfilter; + &programmers.api-functions.api-unregister-postfilter; + &programmers.api-functions.api-unregister-prefilter; + &programmers.api-functions.api-unregister-resource; - + - Переменные - &programmers.api-variables.variable-template-dir; - &programmers.api-variables.variable-compile-dir; - &programmers.api-variables.variable-config-dir; - &programmers.api-variables.variable-plugins-dir; - &programmers.api-variables.variable-debugging; - &programmers.api-variables.variable-debug-tpl; - &programmers.api-variables.variable-debugging-ctrl; - &programmers.api-variables.variable-autoload-filters; - &programmers.api-variables.variable-compile-check; - &programmers.api-variables.variable-force-compile; - &programmers.api-variables.variable-caching; - &programmers.api-variables.variable-cache-dir; - &programmers.api-variables.variable-cache-lifetime; - &programmers.api-variables.variable-cache-handler-func; - &programmers.api-variables.variable-cache-modified-check; - &programmers.api-variables.variable-config-overwrite; - &programmers.api-variables.variable-config-booleanize; - &programmers.api-variables.variable-config-read-hidden; - &programmers.api-variables.variable-config-fix-newlines; - &programmers.api-variables.variable-default-template-handler-func; - &programmers.api-variables.variable-php-handling; - &programmers.api-variables.variable-security; - &programmers.api-variables.variable-secure-dir; - &programmers.api-variables.variable-security-settings; - &programmers.api-variables.variable-trusted-dir; - &programmers.api-variables.variable-left-delimiter; - &programmers.api-variables.variable-right-delimiter; - &programmers.api-variables.variable-compiler-class; - &programmers.api-variables.variable-request-vars-order; - &programmers.api-variables.variable-request-use-auto-globals; - &programmers.api-variables.variable-error-reporting; - &programmers.api-variables.variable-compile-id; - &programmers.api-variables.variable-use-sub-dirs; - &programmers.api-variables.variable-default-modifiers; - &programmers.api-variables.variable-default-resource-type; + Переменные класса Smarty + &programmers.api-variables.variable-template-dir; + &programmers.api-variables.variable-compile-dir; + &programmers.api-variables.variable-config-dir; + &programmers.api-variables.variable-plugins-dir; + &programmers.api-variables.variable-debugging; + &programmers.api-variables.variable-debug-tpl; + &programmers.api-variables.variable-debugging-ctrl; + &programmers.api-variables.variable-autoload-filters; + &programmers.api-variables.variable-compile-check; + &programmers.api-variables.variable-force-compile; + &programmers.api-variables.variable-caching; + &programmers.api-variables.variable-cache-dir; + &programmers.api-variables.variable-cache-lifetime; + &programmers.api-variables.variable-cache-handler-func; + &programmers.api-variables.variable-cache-modified-check; + &programmers.api-variables.variable-config-overwrite; + &programmers.api-variables.variable-config-booleanize; + &programmers.api-variables.variable-config-read-hidden; + &programmers.api-variables.variable-config-fix-newlines; + &programmers.api-variables.variable-default-template-handler-func; + &programmers.api-variables.variable-php-handling; + &programmers.api-variables.variable-security; + &programmers.api-variables.variable-secure-dir; + &programmers.api-variables.variable-security-settings; + &programmers.api-variables.variable-trusted-dir; + &programmers.api-variables.variable-left-delimiter; + &programmers.api-variables.variable-right-delimiter; + &programmers.api-variables.variable-compiler-class; + &programmers.api-variables.variable-request-vars-order; + &programmers.api-variables.variable-request-use-auto-globals; + &programmers.api-variables.variable-error-reporting; + &programmers.api-variables.variable-compile-id; + &programmers.api-variables.variable-use-sub-dirs; + &programmers.api-variables.variable-default-modifiers; + &programmers.api-variables.variable-default-resource-type; - + Кэширование - - Кэширование используется для ускорения вызовов - display() или - fetch() путем сохранения их результатов в - файл. Кэшированная версия файла (если таковая будет найдена) отображается - сразу, без перегенерации вывода. Кэширование может значительно ускорить - работу, особенно если используются сложные шаблоны с большим количеством - данных. Так как кэшируется вывод display() и - fetch(), один файл в кэше может - представлять из себя набор разных шаблонов, конфигурационных файлов - всего - того, что использовалось при генерации этого вывода. + Кэширование используется для ускорения вызовов display() или fetch() при помощи сохранения результатов + их работы в файл. Если доступна кэшированная версия вызова, она отображается + вместо повторной обработки шаблона. Кэширование может значительно ускорить + работу, особенно в случае длительно обрабатываемых шаблонов. + Так как результат работы методов display() или fetch() кэшируется, один файл кэша вполне может + состоять из нескольких файлов шаблонов, конфигурационных файлов и т.д. - Так как шаблоны могут меняться со временем, очень важно следить за тем что - вы кэшируете и на который срок. Например, если вы отображаете титульную - страницу вашего сайта, которая не меняется слишком часто, то её кэшированную - версию можно не обновлять в течение часа или больше. С другой стороны, если - вы выводите страницу с прогнозом погоды, которая может меняться с каждой - минутой, то кэшировать её не имеет смысла. + Так как шаблоны динамичны, очень важно быть осторожным относительно того, + что вы кэшируете и на какой период. Например, если вы отображаете главную + страницу вашего сайта, которая меняет своё содержимое достаточно редко, + хорошей идеей может быть кэширование этой страницы на час и более. + С другой стороны, если вы отображаете страницу с картой погоды, которая + обновляется ежеминутно, смысла в кэшировании этой страницы нет. - &programmers.caching.caching-setting-up; &programmers.caching.caching-multiple-caches; &programmers.caching.caching-groups; &programmers.caching.caching-cacheable; - Плагины - расширение функциональности Smarty - Архитектура версии 2.0 позволяет внедрять плагины, которыми являются практически все настраиваемые элементы функционала Smarty. Сюда входят: @@ -18,36 +17,15 @@ ресурсы вставки - За исключением ресурсов, в целях обратной совместимости с предыдущими версиями, сохранена - возможность регистрации функций посредством register_* API. - Если вы не используете API, а вместо этого модифицируете - $custom_funcs, $custom_mods и некоторые другие - переменные напрямую, тогда вам придется подогнать ваши скрипты под использование - API или преобразовать добавленную вами функциональность в плагины. + За исключением ресурсов, в целях обратной совместимости с + предыдущими версиями, сохранена возможность регистрации функций + посредством register_* API. + Если вы не используете API, а вместо этого модифицируете свойства + $custom_funcs, $custom_mods и + некоторые другие напрямую, тогда вам придется подогнать ваши скрипты под + использование API или преобразовать добавленную вами функциональность в + плагины. - - - Как работают плагины - - Плагины загружаются только при необходимости. Загруженными окажутся - только только те модификаторы, функции,ресурсы и т.п., которые - определены в скрипте шаблона. Более того, каждый плагин загружается - лишь один раз, даже если у вас имеется несколько различных экземпляров - объекта Smarty, выполняемых внутри одного запроса. - - - Пре/постфильтры и фильтры вывода - это отдельный случай. Так как - они не упоминаются в шаблонах, их необходимо зарегистрировать - или явно загрузить с помощью API-функций перед обработкой шаблона. - Порядок исполнения множественных фильтров зависит от порядка, в котором - они были зарегистрированы или загружены. - - - В целях оптимизации производительности, под плагины отведена одна - специальная директория. Чтобы установить плагин, просто поместите его - в эту директорию и Smarty будет использовать его в автоматическом режиме. - - &programmers.plugins.plugins-howto; &programmers.plugins.plugins-naming-conventions; &programmers.plugins.plugins-writing; diff --git a/docs/ru/programmers/smarty-constants.xml b/docs/ru/programmers/smarty-constants.xml index b8bd344f..044dcf2a 100644 --- a/docs/ru/programmers/smarty-constants.xml +++ b/docs/ru/programmers/smarty-constants.xml @@ -1,54 +1,72 @@ - + Константы SMARTY_DIR - Эта константа должна содержать полный путь к файлам Smarty. + Эта константа должна содержать полный путь + к файлам класса Smarty. Если константа не определена, Smarty будет пытаться определить путь - самостоятельно. При определении данной константы, слэш в конце строки - обязателен. + самостоятельно. При определении данной константы, + слэш в конце строки обязателен. SMARTY_DIR - + ]]> - + - - - SMARTY_CORE_DIR - - Это полный путь к файлам ядра (core) Smarty. - Если он не установлен, Smarty будет использовать значение по умолчанию - - путь к поддиректории internals/ директории SMARTY_DIR. - Если константа определена, путь должен заканчиваться слэшем. - Используйте эту константу, когда вручную подключаете любой из - core.* файлов. - - - SMARTY_CORE_DIR - + + См. также + $smarty.const + и + константы $php_handling + + + + + SMARTY_CORE_DIR + + Это полный путь к файлам ядра (core) Smarty. + Если он не установлен, Smarty будет использовать значение по умолчанию + - путь к поддиректории internals/ директории + SMARTY_DIR. + Если константа определена, путь должен заканчиваться слэшем. + Используйте эту константу, когда вручную подключаете любой из + core.* файлов. + + + SMARTY_CORE_DIR + ]]> - - - + + + + См. также + $smarty.const + +