DOC-ES Update and new files

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

documentation/manual/es/module_specs/Zend_Application-AvailableResources-Dojo.xml

@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 20017 -->
+<!-- Reviewed: no -->
+<sect2 id="zend.application.available-resources.dojo">
+    <title>Zend_Application_Resource_Dojo</title>
+
+    <para>
+        <classname>Zend_Application_Resource_Dojo</classname> puede ser usado
+        para configurar los <classname>Zend_Dojo</classname> viewhelpers.
+    </para>
+
+    <example id="zend.application.available-resources.dojo.configExample">
+        <title>Configuración de ejemplo del recurso Dojo</title>
+
+        <para>
+            Aquí se muestra un archivo <acronym>INI</acronym> de ejemplo
+            que indica como habilitar <classname>Zend_Dojo</classname>.
+        </para>
+
+        <programlisting language="ini"><![CDATA[
+resources.dojo.enable = true ; Siempre cargar archivos javascript de Dojo
+]]></programlisting>
+
+        <para>
+            El recurso complemento <classname>Zend_Dojo</classname> utiliza las opciones de
+            <methodname>Zend_Dojo_View_Helper_Dojo_Container::setOptions()</methodname> para
+            configurar sus viewhelpers. Por favor diríjase al capítulo acerca de
+            <link linkend="zend.dojo">Zend_Dojo</link> para una lista completa de opciones
+            disponibles para la configuración y sus descripciones.
+        </para>
+    </example>
+</sect2>

documentation/manual/es/module_specs/Zend_Application-AvailableResources-Log.xml

@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 20017 -->
+<!-- Reviewed: no -->
+<sect2 id="zend.application.available-resources.log">
+    <title>Zend_Application_Resource_Log</title>
+
+    <para>
+        Use <classname>Zend_Application_Resource_Log</classname> para instanciar un
+        <classname>Zend_Log</classname> con una cantidad de escritores arbitraria.
+        La configuración será pasada al método <methodname>Zend_Log::factory()</methodname>
+        para permitir especificar una combinacion de filtros y escritores de logs. La instancia
+        de log podra ser tomada del bootstrap luego para guardar eventos de log.
+    </para>
+
+    <example id="zend.application.available-resources.log.configExample">
+        <title>Ejemplo de configuración del recurso de Log</title>
+
+        <para>
+            Abajo se muestra un extracto de archivo <acronym>INI</acronym> de ejemplo donde se
+            muestra como configurar el recurso de log.
+        </para>
+
+        <programlisting language="ini"><![CDATA[
+resources.log.stream.writerName = "Stream"
+resources.log.stream.writerParams.stream = APPLICATION_PATH"/../data/logs/application.log"
+resources.log.stream.writerParams.mode = "a"
+resources.log.stream.filterName = "Priority"
+resources.log.stream.filterParams.priority = 4
+]]></programlisting>
+
+        <para>
+            Para más información de las opciones disponibles, por favor lea la
+            <link linkend="zend.log.factory">documentacion de Zend_Log::factory()</link>.
+        </para>
+    </example>
+</sect2>

documentation/manual/es/module_specs/Zend_Application-AvailableResources-Mail.xml

@@ -0,0 +1,43 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 20017 -->
+<!-- Reviewed: no -->
+<sect2 id="zend.application.available-resources.mail">
+    <title>Zend_Application_Resource_Mail</title>
+
+    <para>
+        <classname>Zend_Application_Resource_Mail</classname> puede ser usado para instanciar un
+        transporte para <classname>Zend_Mail</classname> o configurar el nombre y dirección
+        por defecto, asimismo como el nombre y dirección para el encabezado "replyto".
+    </para>
+
+    <para>
+        Al instanciar un transporte, éste es registrado automáticamente con
+        <classname>Zend_Mail</classname> aunque si se quisiera evitar este comportamiento se puede
+        configurar la directiva <property>transport.register</property> con el valor
+        <constant>FALSE</constant>.
+    </para>
+
+    <example id="zend.application.available-resources.mail.configExample">
+        <title>Ejemplo de configuración del recurso Mail</title>
+
+        <para>
+            Abajo se muestra un extracto de archivo <acronym>INI</acronym> de ejemplo donde se
+            muestra como configurar el recurso de Mail.
+        </para>
+
+        <programlisting language="ini"><![CDATA[
+resources.mail.transport.type = smtp
+resources.mail.transport.host = "smtp.example.com"
+resources.mail.transport.auth = login
+resources.mail.transport.username = myUsuario
+resources.mail.transport.password = myClave
+resources.mail.transport.register = true ; True por defecto
+
+resources.mail.defaultFrom.email = john@example.com
+resources.mail.defaultFrom.name = "John Doe"
+resources.mail.defaultReplyTo.email = Jane@example.com
+resources.mail.defaultReplyTo.name = "Jane Doe"
+]]></programlisting>
+
+    </example>
+</sect2>

documentation/manual/es/module_specs/Zend_Application-AvailableResources-Multidb.xml

@@ -0,0 +1,87 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 20017 -->
+<!-- Reviewed: no -->
+<sect2 id="zend.application.available-resources.multidb">
+    <title>Zend_Application_Resource_Multidb</title>
+
+    <para>
+        <classname>Zend_Application_Resource_Multidb</classname> puede ser utulizado para
+        instanciar múltiples conexiones a distintas bases de datos. Se pueden usar las mismas
+        opciones que con el
+        <link linkend="zend.application.available-resources.db">recurso complemento Db</link>.
+        Sin embargo, para especificar una conexión por defecto, se puede usar la directiva
+        'default'.
+    </para>
+
+    <example id="zend.application.available-resources.multidb.configexample">
+        <title>Configurando múltiples conexiones</title>
+
+        <para>
+            Abajo se muestra un extracto de archivo <acronym>INI</acronym> de ejemplo donde se
+            muestra como configurar dos conexiones.
+        </para>
+
+        <programlisting language="ini"><![CDATA[
+[production]
+resources.multidb.db1.adapter = "pdo_mysql"
+resources.multidb.db1.host = "localhost"
+resources.multidb.db1.username = "webuser"
+resources.multidb.db1.password = "miClaveDificil"
+resources.multidb.db1.dbname = "db1"
+
+resources.multidb.db2.adapter = "pdo_pgsql"
+resources.multidb.db2.host = "example.com"
+resources.multidb.db2.username = "dba"
+resources.multidb.db2.password = "otraClaveDificil"
+resources.multidb.db2.dbname = "db2"
+resources.multidb.db2.default = true
+]]></programlisting>
+    </example>
+
+    <example id="zend.application.available-resources.multidb.retrieveSpecificDb">
+        <title>Obteniendo un adaptador de base de datos en particular</title>
+
+        <para>
+            Al usar este recurso complemento, por lo general se desea obtener el adaptador
+            de una base de datos en particular. Esto puede ser realizado usando el método
+            <methodname>getDb()</methodname> provisto por el recurso. El método
+            <methodname>getDb()</methodname> devuelve una instancia de una clase que extiende
+            <classname>Zend_Db_Adapter_Abstract</classname>. Si no ha especificado una base
+            de datos por defecto, saltará una excepción si este método es llamado sin pasarle
+            un parámetro
+         </para>
+
+        <programlisting language="php"><![CDATA[
+$resource = $bootstrap->getPluginResource('multidb');
+$db1 = $resource->getDb('db1');
+$db2 = $resource->getDb('db2');
+$defaultDb = $resource->getDb();
+]]></programlisting>
+    </example>
+
+    <example id="zend.application.available-resources.multidb.retrieveDefaultDb">
+        <title>Obteniendo el adaptador de base de datos por defecto</title>
+
+        <para>
+            Adicionalmente, se puede obtener el adaptador por defecto usando el método
+            <methodname>getDefaultDb()</methodname>. Si no ha especificado un adaptador por
+            defecto, el primer adaptador configurado será devuelto. A menos que especifique
+            <constant>FALSE</constant> como primer parámetro, <constant>NULL</constant> será
+            devuelto cuando no se haya configurado ningún adaptador por defecto.
+         </para>
+
+        <para>
+            Abajo se muestra un ejemplo que asume que el recurso complemento MultiDb se ha
+            configurado con el ejemplo <acronym>INI</acronym> mostrado anteriormente.
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$resource = $bootstrap->getPluginResource('multidb');
+$db2 = $resource->getDefaultDb();
+
+// Misma configuración, pero ahora con la db por defecto:
+$db1 = $resource->getDefaultDb();
+$null = $resource->getDefaultDb(false); // null
+]]></programlisting>
+    </example>
+</sect2>

documentation/manual/es/module_specs/Zend_Application-AvailableResources-Navigation.xml

@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 20017 -->
+<!-- Reviewed: no -->
+<sect2 id="zend.application.available-resources.navigation">
+    <title>Zend_Application_Resource_Navigation</title>
+
+    <para>
+        <classname>Zend_Application_Resource_Navigation</classname> puede ser usado para configurar
+        una instancia de <classname>Zend_Navigation</classname>. Las
+        opciones de configuración son las mismas que para <link
+        linkend="zend.navigation.pages.common.options">
+        <classname>Zend_Navigation</classname></link>.
+    </para>
+
+    <para>
+        Al terminar de configurar la instancia de navegación, la asigna a
+        <classname>Zend_View_Helper_Navigation</classname> por defecto, de donde se puede
+        obtener posteriormente.
+    </para>
+
+    <example id="zend.application.available-resources.navigation.configExample">
+        <title>Ejemplo de configuración del recurso Navigation</title>
+
+        <para>
+            Abajo se muestra un extracto de archivo <acronym>INI</acronym> de ejemplo donde se
+            muestra como configurar una navegación.
+        </para>
+
+        <programlisting language="ini"><![CDATA[
+resources.navigation.pages.page1.label = "Etiqueta para la primera página"
+resources.navigation.pages.page1.route = "Route perteneciente a la primera página"
+
+; La página 2 es una subpágina de la página 1
+resources.navigation.pages.page1.pages.page2.type = "Zend_Navigation_Page_Uri"
+resources.navigation.pages.page1.pages.page2.label = "Etiqueta para la segunda página"
+resources.navigation.pages.page1.pages.page2.uri = "/url/to/page/2"
+]]></programlisting>
+    </example>
+</sect2>

documentation/manual/es/module_specs/Zend_Application-AvailableResources-Router.xml

@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 20017 -->
+<!-- Reviewed: no -->
+<sect2 id="zend.application.available-resources.router">
+    <title>Zend_Application_Resource_Router</title>
+
+    <para>
+        <classname>Zend_Application_Resource_Router</classname> puede ser usado para configurar
+        el router mientras es registrado con el Front Controller.
+        La configuración es la misma que para <link
+        linkend="zend.controller.router.routes.standard">
+        <classname>Zend_Controller_Router_Route</classname></link>.
+    </para>
+
+    <example id="zend.application.available-resources.router.configExample">
+        <title>Configuración de ejemplo del recurso Router</title>
+
+        <para>
+            Abajo se muestra un extracto de archivo <acronym>INI</acronym> de ejemplo donde se
+            muestra como configurar el recurso de Router.
+        </para>
+
+        <programlisting language="ini"><![CDATA[
+resources.router.routes.route_id.route = "/login"
+resources.router.routes.route_id.defaults.module = "user"
+resources.router.routes.route_id.defaults.controller = "login"
+resources.router.routes.route_id.defaults.action = "index"
+
+; Opcionalmente se puede configurar un separador de nombre encadenado:
+resources.router.chainNameSeparator = "_"
+]]></programlisting>
+
+        <para>Para más información, vea la sección del
+            <link linkend="zend.controller.router.routes.chain.config">separador de
+            nombre encadenado</link>.
+        </para>
+    </example>
+</sect2>

documentation/manual/es/module_specs/Zend_Application-AvailableResources-Translate.xml

@@ -0,0 +1,84 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 23027 -->
+<!-- Reviewed: no -->
+<sect2 id="zend.application.available-resources.translate">
+    <title>Zend_Application_Resource_Translate</title>
+
+    <para>
+        <classname>Zend_Application_Resource_Translate</classname> inicializara un adaptador
+        <classname>Zend_Translate</classname> basado en las opciones con las que se lo configure.
+    </para>
+
+    <para>
+        Las siguientes claves de configuración son válidas:
+    </para>
+
+    <itemizedlist>
+        <listitem>
+            <para>
+                <emphasis><property>adapter</property></emphasis> : El tipo de adaptador
+                <classname>Zend_Translate</classname>. El adaptador por defecto es array si es
+                que no se especifica ninguno.
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>
+                <emphasis><property>data</property></emphasis> : ruta a la traducción.
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>
+                <emphasis><property>locale</property></emphasis> : la localidad a ser usada para la
+                traducción. Por defecto la localidad es detectada automáticamente. Para forzar una
+                localidad arbitraria hay que guardar una instancia de
+                <classname>Zend_Locale</classname> en el <classname>
+                Zend_Registry</classname>.
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>
+                <emphasis><property>options</property></emphasis> : las opciones son distintas para
+                cada adaptador. Ver la sección <xref linkend="zend.translate.additional.options" />
+                para mas detalles.
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>
+                <emphasis><property>registry</property></emphasis> : la clave customizada para
+                guardar la instancia de <classname>Zend_Translate</classname> en el registry.
+                Por defecto, la clave se llamará <property>Zend_Translate</property>.
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>
+                <emphasis><property>cache</property></emphasis> : el nombre de la plantilla de
+                cache o una instancia de <classname>Zend_Cache_Core</classname> para que
+                <classname>Zend_Translate_Adapter</classname> use como cache. Su gol es acelerar
+                la carga, sobre todo en el caso de los archivos <acronym>XML</acronym>.
+            </para>
+        </listitem>
+    </itemizedlist>
+
+    <example id="zend.application.available-resources.translate.configExample">
+        <title>Ejemplo de configuración del recurso de traducción</title>
+
+        <para>
+            Abajo se muestra un extracto de archivo <acronym>INI</acronym> de ejemplo donde se
+            muestra como configurar el recurso de traducción.
+        </para>
+
+        <programlisting language="ini"><![CDATA[
+resources.translate.adapter = tmx
+resources.translate.content = APPLICATION_PATH "/../data/locales"
+resources.translate.scan = Zend_Translate::LOCALE_DIRECTORY
+
+; Opcionalmente se puede especificar una plantilla de cache:
+resources.translate.cache = "languages"
+]]></programlisting>
+    </example>
+</sect2>