DOC-ES news files

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

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

@@ -0,0 +1,68 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 23007 -->
+<!-- Reviewed: no -->
+<sect2 id="zend.application.available-resources.cachemanager">
+    <title>Zend_Application_Resource_Cachemanager</title>
+
+    <para>
+        <classname>Zend_Application_Resource_Cachemanager</classname> puede ser
+        utilizado para configurar un grupo de opciones de <classname>Zend_Cache</classname>
+        para ser usado para cargar caches bajo demanda usando
+        <classname>Zend_Cache_Manager</classname>
+    </para>
+
+    <para>
+        Como el Cache Manager usa un mecanismo de carga bajo demanda, las opciones son traducidas
+        a plantillas de opciones usadas para instanciar un objeto de cache a pedido.
+    </para>
+
+    <example id="zend.application.available-resources.cachemanager.configExample">
+        <title>Ejemplo de configuración del recurso Cachemanager</title>
+
+        <para>
+            Aquí abajo se muestra un archivo <acronym>INI</acronym> de ejemplo
+            que muestra como se puede configurar el <classname>Zend_Cache_Manager</classname>.
+            El formato consta de un prefijo de recurso Cachemanager (
+            <property>resources.cachemanager</property>) seguido por el nombre de la plantilla
+            de cache (por ejemplo <property>resources.cachemanager.database</property>)
+            y finalmente seguido de una opción típica de <classname>Zend_Cache</classname>.
+        </para>
+
+        <programlisting language="ini"><![CDATA[
+resources.cachemanager.database.frontend.name = Core
+resources.cachemanager.database.frontend.customFrontendNaming = false
+resources.cachemanager.database.frontend.options.lifetime = 7200
+resources.cachemanager.database.frontend.options.automatic_serialization = true
+resources.cachemanager.database.backend.name = File
+resources.cachemanager.database.backend.customBackendNaming = false
+resources.cachemanager.database.backend.options.cache_dir = "/path/to/cache"
+resources.cachemanager.database.frontendBackendAutoload = false
+]]></programlisting>
+
+        <para>
+            En realidad, buscar éste cache desde el Cache Manager es tan simple como
+            acceder a una instancia del Manager (<classname>Zend_Cache_Manager</classname>)
+            tomada desde <classname>Zend_Application_Resource_Cachemanager</classname>
+            y llamar <methodname>$cacheManager->getCache('database');</methodname>.
+            El siguiente ejemplo fue tomado de un controlador donde la clase bootstrap puede
+            ser accedida como un parametro de Front Controller (que es automáticamente asignado
+            durante el proceso de bootstrap). Como se puede ver, el recurso Cache Manager
+            implementa el método <methodname>getCacheManager()</methodname> para obtener una
+            instancia de <classname>Zend_Cache_Manager</classname>.
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$manager = $this->getFrontController()
+            ->getParam('bootstrap')
+            ->getResource('cachemanager')
+            ->getCacheManager();
+$dbCache = $manager->getCache('database');
+]]></programlisting>
+
+        <para>
+            Ver el método <methodname>Zend_Cache::factory()</methodname> para una descripción
+            de los valores por defecto que se pueden asignar al momento de configurar un cache
+            como el del ejemplo usando un archivo de configuración <acronym>INI</acronym>.
+        </para>
+    </example>
+</sect2>

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

@@ -0,0 +1,151 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 23009 -->
+<!-- Reviewed: no -->
+<sect2 id="zend.application.available-resources.locale">
+    <title>Zend_Application_Resource_Locale</title>
+
+    <para>
+        <classname>Zend_Application_Resource_Locale</classname> puede ser usado para configurar
+        una localidad en el ámbito de una aplicación entera. Ésta localidad es usada en todas las
+        clases y componentes que trabajen con localización o internacionalización. Por defecfto
+        la localidad es guardada en una entrada en <classname>Zend_Registry</classname> baje la
+        clave '<property>Zend_Locale</property>'.
+    </para>
+
+    <para>
+        Hay básicamente tres casos de uso para el Locale Resource Plugin. Cada uno deberá ser usado
+        dependiendo de la necesidad de la apliación.
+    </para>
+
+    <sect3 id="zend.application.available-resources.locale.auto">
+        <title>Autodetectando la localidad a usar</title>
+
+        <para>
+            Sin especificar ninguna opción para
+            <classname>Zend_Application_Resource_Locale</classname>,
+            <classname>Zend_Locale</classname> detectará la localidad y la aplicación la usará
+            automaticamente.
+        </para>
+
+        <para>
+            Ésta detección funciona porque el cliente envía el idioma deseado en su pedido
+            <acronym>HTTP</acronym>. Normalmente el navegador envía los idiomas que desea ver
+            y <classname>Zend_Locale</classname> usa esta información para la detección.
+        </para>
+
+        <para>
+            Pero hay dos problemas con este enfoque:
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    El navegador podría estar configurado para no enviar el idioma
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    El usuario podría haber configurado manualmente una localidad que no exista
+                </para>
+            </listitem>
+        </itemizedlist>
+
+        <para>
+            En ambos casos <classname>Zend_Locale</classname> se apoyará en otros mecanismos
+            para realizar la detección de la localidad:
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    Cuando se configuró una localidad que no existe,
+                    <classname>Zend_Locale</classname> trata de degradar la cadena.
+                </para>
+
+                <para>
+                    Cuando, por ejemplo se configura <emphasis>en_ZZ</emphasis>, automáticamente
+                    será degradado a <emphasis>en</emphasis>. En este caso <emphasis>en</emphasis>
+                    será usado como la localidad de la aplicación.
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    Cuando la localidad tampoco haya podido ser detectada incluso degradando la
+                    cadena, la localidad de su entorno (servidor web) será usada. La mayoría de 
+                    los entornos disponibles en la web usan <emphasis>en</emphasis> como localidad.
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    Cuando la localidad del sistema no se haya podido detectar,
+                    <classname>Zend_Locale</classname> usara su localidad por defecto, que está 
+                    configurada como <emphasis>en</emphasis>.
+                </para>
+            </listitem>
+        </itemizedlist>
+
+        <para>
+            Para más información acerda de la detección de localidad, vea <link
+            linkend="zend.locale.selection.automatic">este capitulo acerca de detección automática
+            de Zend_Locale</link>
+        </para>
+    </sect3>
+
+    <sect3 id="zend.application.available-resources.locale.fallback">
+        <title>Autodetectando la localidad y agregando su mecanismo propio de reserva</title>
+
+        <para>
+            La detección descrita más arriba podría llegar a provocar problemas cuando la localidad
+            no haya podido ser detectada y se desea tener otra localidad como defecto que no sea
+            <emphasis>en</emphasis>. Para prevenir esto,
+            <classname>Zend_Application_Resource_Locale</classname> permite configurar su propia
+            localidad, que será usada en el cado de que una localidad no se haya podido detectar.
+        </para>
+
+        <example id="zend.application.available-resources.locale.configExampleDetectAndFallback">
+            <title>Autodetectar la loclidad configurando un mecanismo de reserva</title>
+
+            <para>
+                El siguiente ejemplo muestra como configurar su propia localidad que será usada
+                cuando el cliente no especifique ninguna localidad.
+            </para>
+
+            <programlisting language="ini"><![CDATA[
+; Try to determine automatically first,
+; if unsuccessful, use nl_NL as fallback.
+resources.locale.default = "nl_NL"
+]]></programlisting>
+        </example>
+    </sect3>
+
+    <sect3 id="zend.application.available-resources.locale.forcing">
+        <title>Forzando una localidad en particular</title>
+
+        <para>
+            Muchas veces es útil definir una única localidad para ser usada. Esto se puede
+            conseguir usando la opción <property>force</property>.
+        </para>
+
+        <para>
+            En este caso, ésta única localidad será usada y detección automática será desactivada.
+        </para>
+
+        <example id="zend.application.available-resources.locale.configExampleFallbackOnly">
+            <title>Definiendo una única localidad a ser usada</title>
+
+            <para>
+                El siguiente ejemplo muestra como usar una única localidad para la aplicación
+                entera.
+            </para>
+
+            <programlisting language="ini"><![CDATA[
+; No matter what, the nl_NL locale will be used.
+resources.locale.default = "nl_NL"
+resources.locale.force = true
+]]></programlisting>
+        </example>
+    </sect3>
+</sect2>