From a05920d6a12fadbeef7418d2f3e250758f53c953 Mon Sep 17 00:00:00 2001
From: freespace <freespace@localhost>
Date: Fri, 3 Feb 2006 09:47:05 +0000
Subject: [PATCH] sync with EN

---
 docs/ru/programmers/advanced-features.xml | 14 ++--
 docs/ru/programmers/api-functions.xml     | 81 ++++++++++++-----------
 docs/ru/programmers/api-variables.xml     | 74 ++++++++++-----------
 docs/ru/programmers/caching.xml           | 37 +++++------
 docs/ru/programmers/plugins.xml           | 38 +++--------
 docs/ru/programmers/smarty-constants.xml  | 74 +++++++++++++--------
 6 files changed, 156 insertions(+), 162 deletions(-)

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 @@
 <?xml version="1.0" encoding="windows-1251"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.4 Maintainer: tony2001 Status: ready -->
+<!-- EN-Revision: 1.4 Maintainer: freespace Status: ready -->
 <chapter id="advanced.features">
  <title>Расширенные возможности</title>
-  &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;
 </chapter>
 <!-- Keep this comment at the end of the file
 Local variables:
diff --git a/docs/ru/programmers/api-functions.xml b/docs/ru/programmers/api-functions.xml
index 1cc27e0f..c3d0278e 100644
--- a/docs/ru/programmers/api-functions.xml
+++ b/docs/ru/programmers/api-functions.xml
@@ -1,46 +1,47 @@
 <?xml version="1.0" encoding="windows-1251"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.9 Maintainer: freespace Status: ready -->
+<!-- EN-Revision: 1.10 Maintainer: freespace Status: ready -->
 <chapter id="api.functions">
- <title>Методы</title>
-  &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;
+ <title>Методы класса Smarty</title>
+ &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;
 </chapter>
 <!-- Keep this comment at the end of the file
 Local variables:
diff --git a/docs/ru/programmers/api-variables.xml b/docs/ru/programmers/api-variables.xml
index e0d9ba0c..52d8eb4d 100644
--- a/docs/ru/programmers/api-variables.xml
+++ b/docs/ru/programmers/api-variables.xml
@@ -1,43 +1,43 @@
 <?xml version="1.0" encoding="windows-1251"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.3 Maintainer: tony2001 Status: ready -->
+<!-- EN-Revision: 1.4 Maintainer: freespace Status: ready -->
 <chapter id="api.variables">
- <title>Переменные</title>
-  &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;
+ <title>Переменные класса Smarty</title>
+ &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;
 </chapter>
 <!-- Keep this comment at the end of the file
 Local variables:
diff --git a/docs/ru/programmers/caching.xml b/docs/ru/programmers/caching.xml
index b5c9b05d..9fae0954 100644
--- a/docs/ru/programmers/caching.xml
+++ b/docs/ru/programmers/caching.xml
@@ -1,35 +1,32 @@
 <?xml version="1.0" encoding="windows-1251"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.3 Maintainer: tony2001 Status: ready -->
+<!-- EN-Revision: 1.4 Maintainer: freespace Status: ready -->
 <chapter id="caching">
  <title>Кэширование</title>
-
  <para>
-  Кэширование используется для ускорения вызовов
-  <link linkend="api.display">display()</link> или
-  <link linkend="api.fetch">fetch()</link> путем сохранения их результатов в
-  файл. Кэшированная версия файла (если таковая будет найдена) отображается
-  сразу, без перегенерации вывода. Кэширование может значительно ускорить
-  работу, особенно если используются сложные шаблоны с большим количеством
-  данных. Так как кэшируется вывод <link linkend="api.display">display()</link> и
-  <link linkend="api.fetch">fetch()</link>, один файл в кэше может
-  представлять из себя набор разных шаблонов, конфигурационных файлов - всего
-  того, что использовалось при генерации этого вывода.
+  Кэширование используется для ускорения вызовов <link
+  linkend="api.display">display()</link> или <link
+  linkend="api.fetch">fetch()</link> при помощи сохранения результатов
+  их работы в файл. Если доступна кэшированная версия вызова, она отображается
+  вместо повторной обработки шаблона. Кэширование может значительно ускорить
+  работу, особенно в случае длительно обрабатываемых шаблонов.
+  Так как результат работы методов <link
+  linkend="api.display">display()</link> или <link
+  linkend="api.fetch">fetch()</link> кэшируется, один файл кэша вполне может
+  состоять из нескольких файлов шаблонов, конфигурационных файлов и т.д.
  </para>
  <para>
-  Так как шаблоны могут меняться со временем, очень важно следить за тем что
-  вы кэшируете и на который срок. Например, если вы отображаете титульную
-  страницу вашего сайта, которая не меняется слишком часто, то её кэшированную
-  версию можно не обновлять в течение часа или больше. С другой стороны, если
-  вы выводите страницу с прогнозом погоды, которая может меняться с каждой
-  минутой, то кэшировать её не имеет смысла.
+  Так как шаблоны динамичны, очень важно быть осторожным относительно того,
+  что вы кэшируете и на какой период. Например, если вы отображаете главную
+  страницу вашего сайта, которая меняет своё содержимое достаточно редко,
+  хорошей идеей может быть кэширование этой страницы на час и более.
+  С другой стороны, если вы отображаете страницу с картой погоды, которая
+  обновляется ежеминутно, смысла в кэшировании этой страницы нет.
  </para>
-
  &programmers.caching.caching-setting-up;
  &programmers.caching.caching-multiple-caches;
  &programmers.caching.caching-groups;
  &programmers.caching.caching-cacheable;
-
 </chapter>
 <!-- Keep this comment at the end of the file
 Local variables:
diff --git a/docs/ru/programmers/plugins.xml b/docs/ru/programmers/plugins.xml
index 11489517..c70a8add 100644
--- a/docs/ru/programmers/plugins.xml
+++ b/docs/ru/programmers/plugins.xml
@@ -3,7 +3,6 @@
 <!-- EN-Revision: 1.5 Maintainer: freespace Status: ready -->
 <chapter id="plugins">
  <title>Плагины - расширение функциональности Smarty</title>
-
  <para>
   Архитектура версии 2.0 позволяет внедрять плагины, которыми являются
   практически все настраиваемые элементы функционала Smarty. Сюда входят:
@@ -18,36 +17,15 @@
    <listitem><simpara>ресурсы</simpara></listitem>
    <listitem><simpara>вставки</simpara></listitem>
   </itemizedlist>
-  За исключением ресурсов, в целях обратной совместимости с предыдущими версиями, сохранена
-  возможность регистрации функций посредством register_* API.
-  Если вы не используете  API, а вместо этого модифицируете
-  <literal>$custom_funcs</literal>, <literal>$custom_mods</literal> и некоторые другие
-  переменные напрямую, тогда вам придется подогнать ваши скрипты под использование
-  API или преобразовать добавленную вами функциональность в плагины.
+  За исключением ресурсов, в целях обратной совместимости с
+  предыдущими версиями, сохранена возможность регистрации функций
+  посредством register_* API.
+  Если вы не используете API, а вместо этого модифицируете свойства
+  <literal>$custom_funcs</literal>, <literal>$custom_mods</literal> и
+  некоторые другие напрямую, тогда вам придется подогнать ваши скрипты под
+  использование API или преобразовать добавленную вами функциональность в
+  плагины.
  </para>
-
- <sect1>
-  <title>Как работают плагины</title>
-  <para>
-   Плагины загружаются только при необходимости. Загруженными окажутся
-   только только те модификаторы, функции,ресурсы и т.п., которые
-   определены в скрипте шаблона. Более того, каждый плагин загружается
-   лишь один раз, даже если у вас имеется несколько различных экземпляров
-   объекта Smarty, выполняемых внутри одного запроса.
-  </para>
-  <para>
-   Пре/постфильтры и фильтры вывода - это отдельный случай. Так как
-   они не упоминаются в шаблонах, их необходимо зарегистрировать
-   или явно загрузить с помощью API-функций перед обработкой шаблона.
-   Порядок исполнения множественных фильтров зависит от порядка, в котором
-   они были зарегистрированы или загружены.
-  </para>
-  <para>
-   В целях оптимизации производительности, под плагины отведена одна
-   специальная директория. Чтобы установить плагин, просто поместите его
-   в эту директорию и Smarty будет использовать его в автоматическом режиме.
-  </para>
- </sect1>
  &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 @@
 <?xml version="1.0" encoding="windows-1251"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.3 Maintainer: freespace Status: ready -->
+<!-- EN-Revision: 1.8 Maintainer: freespace Status: ready -->
 <chapter id="smarty.constants">
  <title>Константы</title>
 
  <sect1 id="constant.smarty.dir">
   <title>SMARTY_DIR</title>
   <para>
-   Эта константа должна содержать полный путь к файлам Smarty.
+   Эта константа должна содержать <emphasis role="bold">полный путь</emphasis>
+   к файлам класса Smarty.
    Если константа не определена, Smarty будет пытаться определить путь
-   самостоятельно. При определении данной константы, слэш в конце строки
-   обязателен.
+   самостоятельно. При определении данной константы,
+   <emphasis role="bold">слэш в конце строки обязателен</emphasis>.
   </para>
   <example>
    <title>SMARTY_DIR</title>
-     <programlisting role="php">
+   <programlisting role="php">
 <![CDATA[
 <?php
-// установка пути к директории Smarty
-define("SMARTY_DIR","/usr/local/lib/php/Smarty/");
+// устанавливает путь к директории Smarty в стиле *nix
+define('SMARTY_DIR', '/usr/local/lib/php/Smarty/libs/');
 
-require_once(SMARTY_DIR."Smarty.class.php");
+// путь к директории Smarty в стиле windows
+define('SMARTY_DIR', 'c:/webroot/libs/Smarty/libs/');
+
+// подключаем класс Smarty - обратите внимание на заглавную 'S'
+require_once(SMARTY_DIR . 'Smarty.class.php');
 ?>
 ]]>
-     </programlisting>
+   </programlisting>
   </example>
- </sect1>
-   <sect1 id="constant.smarty.core.dir">
-    <title>SMARTY_CORE_DIR</title>
-    <para>
-     Это полный путь к файлам ядра (core) Smarty.
-     Если он не установлен, Smarty будет использовать значение по умолчанию
-     - путь к поддиректории internals/ директории SMARTY_DIR.
-     Если константа определена, путь должен заканчиваться слэшем.
-     Используйте эту константу, когда вручную подключаете любой из
-     core.* файлов.
-    </para>
-    <example>
-     <title>SMARTY_CORE_DIR</title>
-     <programlisting role="php">
+  <para>
+   См. также
+   <link linkend="language.variables.smarty.const">$smarty.const</link>
+   и
+   <link linkend="variable.php.handling">константы $php_handling</link>
+  </para>
+ </sect1> 
+
+ <sect1 id="constant.smarty.core.dir">
+  <title>SMARTY_CORE_DIR</title>
+  <para>
+   Это полный путь к файлам ядра (core) Smarty.
+   Если он не установлен, Smarty будет использовать значение по умолчанию
+   - путь к поддиректории <emphasis>internals/</emphasis> директории
+   <link linkend="constant.smarty.dir">SMARTY_DIR</link>.
+   Если константа определена, путь должен заканчиваться слэшем.
+   Используйте эту константу, когда вручную подключаете любой из
+   core.* файлов.
+  </para>
+  <example>
+   <title>SMARTY_CORE_DIR</title>
+   <programlisting role="php">
 <![CDATA[
 <?php
-// загрузка core.get_microtime.php
 
-require_once(SMARTY_CORE_DIR."core.get_microtime.php");
+// загружаем core.get_microtime.php
+require_once(SMARTY_CORE_DIR . 'core.get_microtime.php');
+
 ?>
 ]]>
-     </programlisting>
-    </example>
-   </sect1>
+   </programlisting>
+  </example>
+  <para>
+   См. также
+   <link linkend="language.variables.smarty.const">$smarty.const</link>
+  </para>
+ </sect1>
 </chapter>
 <!-- Keep this comment at the end of the file
 Local variables: