[DOCUMENTATION] Russian:

- Sync with r20765
- Thanks to Vika Sukmanova

git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@23794 44c647ce-9c0f-0410-b52a-842ac1e357ba

documentation/manual/ru/module_specs/Zend_Controller-ActionHelpers-ActionStack.xml

@@ -1,38 +1,36 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 20765 -->
 <!-- Reviewed: no -->
 <sect3 id="zend.controller.actionhelpers.actionstack">
     <title>ActionStack</title>
 
     <para>
-        Помощник <code>ActionStack</code> позволяет помещать в стек запросы к
-        плагину
-        <link linkend="zend.controller.plugins.standard.actionstack">ActionStack</link>
-        фронт-контроллера, помогая эффективно создавать очереди действий,
-        выполняемых в течение запроса. Этот помощник позволяет добавлять
-        действия посредством установки новых объектов запросов или наборов
-        действие/контроллер/модуль.
+        Помощник <emphasis>ActionStack</emphasis> позволяет добавлять в стек запросы к плагину
+        фронт-контроллера, именуемуму
+        <link linkend="zend.controller.plugins.standard.actionstack">ActionStack</link>.
+        Это позволяет создать очередь из задач, планируемых к выполнению в ходе данного запроса.
+        Помощник <emphasis>ActionStack</emphasis> позволяет добавлять задачи как путем указания
+        новых объектов запроса, так и набора действие - контроллер - модуль.
     </para>
 
     <note>
         <title>Вызов помощника ActionStack инициализирует плагин ActionStack</title>
 
         <para>
-            При вызове помощника <code>ActionStack</code> неявным образом
-            регистрируется плагин <code>ActionStack</code>. Это значит, что нет
-            необходимости явным образом регистрировать плагин
-            <code>ActionStack</code> для того, чтобы использовать его
-            функционал.
+            Вызов помощника <emphasis>ActionStack</emphasis> неявно регистрирует плагин
+            <emphasis>ActionStack</emphasis>, следовательно, нет необходимости
+            явным образом регистрировать плагин <emphasis>ActionStack</emphasis>
+            для использования данной функциональности.
         </para>
     </note>
 
     <example id="zend.controller.actionhelpers.actionstack.simple">
-        <title>Добавление задачи с использованием имен действия, контроллера и модуля</title>
+        <title>Добавление задачи с указанием имен действия, контроллера и модуля</title>
 
         <para>
-            Зачастую наиболее простым способом будет указание действия,
-            контроллера и модуля (и необязательных параметров запроса), почти
-            так же, как если бы вы вызывали
-            <code>Zend_Controller_Action::_forward()</code>:
+            Зачастую, проще всего указать имена действия, контроллера и модуля
+            (и прочие параметры запроса) таким же образом, как и при вызове
+            <methodname>Zend_Controller_Action::_forward()</methodname>:
         </para>
 
         <programlisting language="php"><![CDATA[
@@ -40,30 +38,29 @@ class FooController extends Zend_Controller_Action
 {
     public function barAction()
     {
-        // Добавление двух действий в стек
-        // Добавление вызова к /foo/baz/bar/baz
-        // (FooController::bazAction() с переменной запроса bar == baz)
+        // Добавить две задачи в стек
+        // Добавить вызов к /foo/baz/bar/baz
+        // (FooController::bazAction() со следующими переменными в запросе: bar = baz)
         $this->_helper->actionStack('baz',
                                     'foo',
                                     'default',
                                     array('bar' => 'baz'));
 
-        // Добавление вызова к /bar/bat
+        // Добавить вызов к /bar/bat
         // (BarController::batAction())
         $this->_helper->actionStack('bat', 'bar');
     }
 }
 ]]></programlisting>
-
     </example>
 
     <example id="zend.controller.actionhelpers.actionstack.simple2">
-        <title>Добавление задачи с использованием объекта запроса</title>
+        <title>Добавление задачи с использованием нового объекта запроса</title>
 
         <para>
-            Иногда имеет смысл использовать объект запроса, что более
-            соответствует духу ООП. Объект запроса тоже можно передавать
-            помощнику <code>ActionStack</code>.
+            Иногда появляется необходимость работать с запросом как с объектом
+            (в лучших традициях <acronym>ООП</acronym>). В таком случае объект запроса
+            можно передать помощнику <emphasis>ActionStack</emphasis> при его вызове.
         </para>
 
         <programlisting language="php"><![CDATA[
@@ -71,21 +68,22 @@ class FooController extends Zend_Controller_Action
 {
     public function barAction()
     {
-        // Добавление двух действий в стек
-        // Добавление вызова к /foo/baz/bar/baz
-        // (FooController::bazAction() с переменной запроса bar == baz)
+        // Добавить две задачи в стек
+        // Добавить вызов к /foo/baz/bar/baz
+        // (FooController::bazAction() со следующими
+        // переменными в запросе: bar = baz)
         $request = clone $this->getRequest();
-        // Не устанавливайте контроллер и модуль;
-        // используются текущие значения
+        // Использовать текущие контроллер и модуль;
+        // установить новое действие - baz
         $request->setActionName('baz')
                 ->setParams(array('bar' => 'baz'));
         $this->_helper->actionStack($request);
 
-        // Add call to /bar/bat
+        // Добавить вызов к /bar/bat
         // (BarController::batAction())
         $request = clone $this->getRequest();
-        // Не устанавливайте модуль;
-        // используется текущиее значение
+        // Использовать текущий модуль; установить новый контроллер - bar
+        // и действие - bat
         $request->setActionName('bat')
                 ->setControllerName('bar');
         $this->_helper->actionStack($request);
@@ -96,4 +94,4 @@ class FooController extends Zend_Controller_Action
 </sect3>
 <!--
 vim:se ts=4 sw=4 et:
--->
+-->

documentation/manual/ru/module_specs/Zend_Controller-ActionHelpers-FlashMessenger.xml

@@ -6,30 +6,30 @@
 
     <sect4 id="zend.controller.actionhelper.flashmessenger.introduction">
         <title>Введение</title>
+
         <para>
             Помощник <emphasis>FlashMessenger</emphasis> позволяет передавать сообщения,
-            которые нужно отобразить пользователю при следующем запросе.
-            Для хранения сообщений до следующего запроса
-            <emphasis>FlashMessenger</emphasis> использует
-            <classname>Zend_Session_Namespace</classname> . Как правило, лучше всего
-            использовать тот <classname>Zend_Session</classname> или
-            <classname>Zend_Session_Namespace</classname>, который вы инициализировали с
-            помощью <methodname>Zend_Session::start()</methodname> в своем файле загрузки.
-            (За более подробной информацией об использовании см.
-            <link linkend="zend.session.advanced_usage.starting_a_session">Zend Session</link>).
+            которые требуется отобразить пользователю при следующем запросе.
+            Это достигается путем сохранения сообщений в
+            <classname>Zend_Session_Namespace</classname>, откуда они могут быть получены при
+            последующих запросах. Если вы планируете использовать
+            <classname>Zend_Session</classname> или <classname>Zend_Session_Namespace</classname>,
+            имеет смысл инициализировать сессию еще в файле загрузки командой
+            <methodname>Zend_Session::start()</methodname>. (Подробнее о работе с сессиями в
+            документации к
+            <link linkend="zend.session.advanced_usage.starting_a_session">Zend_Session</link>)
         </para>
-
     </sect4>
 
     <sect4 id="zend.controller.actionhelper.flashmessenger.basicusage">
-        <title>Базовый пример использования</title>
+        <title>Пример использования</title>
+
         <para>
-            Пример использования ниже демонстрирует простейший случай
-            использования мессенджера. Когда вызывается действие
-            <filename>/some/my</filename>, оно добавляет мгновенное сообщение "Record
-            Saved!". Последующий запрос к действию
-            <filename>/some/my-next-request</filename> получит это сообщение
-            (и удалит его).
+            Нижеприведенный пример иллюстрирует самое простое использование помощника
+            <emphasis>FlashMessenger</emphasis>. При вызове действия <filename>/some/my</filename>
+            добавляется сообщение "Запись сохранена!". При последующем вызове действия
+            <filename>/some/my-next-request</filename> это сообщение будет
+            получено из сессии (сразу после этого удалено) и отображено пользователю.
         </para>
 
         <programlisting language="php"><![CDATA[
@@ -52,10 +52,10 @@ class SomeController extends Zend_Controller_Action
     public function myAction()
     {
         /**
-         * используемый по умолчанию метод для получения экземпляра
+         * метод для получения экземпляра помощника
          * Zend_Controller_Action_Helper_FlashMessenger
          */
-        $this->_flashMessenger->addMessage('Record Saved!');
+        $this->_flashMessenger->addMessage('Запись сохранена!');
     }
 
     public function myNextRequestAction()