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

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

@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Reviewed: no -->
+<sect2 id="zend.application.available-resources.layout">
+    <title>Zend_Application_Resource_Layout</title>
+
+    <para>
+        <classname>Zend_Application_Resource_Layout</classname> can be used to
+        configure <classname>Zend_Layout</classname>. Configuration options are
+        per <link linkend="zend.layout.options">the <classname>Zend_Layout
+        </classname> options</link>.
+    </para>
+
+    <example id="zend.application.available-resources.layout.configExample">
+        <title>Sample Layout configuration</title>
+
+        <para>
+            Below is a sample <acronym>INI</acronym> snippet showing how to
+            configure the navigation resource.
+        </para>
+
+        <programlisting language="ini"><![CDATA[
+resources.layout.layout = "NameOfDefaultLayout"
+resources.layout.layoutPath = "/path/to/layouts"
+]]></programlisting>
+    </example>
+</sect2>

documentation/manual/es/module_specs/Zend_Dojo-View-Helpers.xml

@@ -657,18 +657,20 @@ echo $view->editor('foo');
 
                     <para> The Editor dijit uses an <acronym>HTML</acronym>
                         <acronym>DIV</acronym> by default. The
-                        <classname>dijit._editor.RichText</classname> <ulink
-                            url="http://api.dojotoolkit.org/jsdoc/HEAD/dijit._editor.RichText">documentation</ulink> indicates that having it built on an
-                            <acronym>HTML</acronym>
+                            <classname>dijit._editor.RichText</classname>
+                        <ulink
+                            url="http://api.dojotoolkit.org/jsdoc/HEAD/dijit._editor.RichText"
+                            >documentation</ulink> indicates that having it
+                        built on an <acronym>HTML</acronym>
                         <acronym>TEXTAREA</acronym> can potentially have
                         security implications. </para>
 
                     <para> In order to allow graceful degradation in
                         environments where Javascript is unavailable,
-                        <classname>Zend_Dojo_View_Helper_Editor</classname>
+                            <classname>Zend_Dojo_View_Helper_Editor</classname>
                         also wraps a <acronym>textarea</acronym> within a
-                        <acronym>noscript</acronym> tag; the content of this
-                        <acronym>textarea</acronym> will be properly escaped
+                            <acronym>noscript</acronym> tag; the content of this
+                            <acronym>textarea</acronym> will be properly escaped
                         to avoid security vulnerability vectors. </para>
                 </note>
             </listitem>

documentation/manual/es/module_specs/Zend_Exception-Basic.xml

@@ -0,0 +1,37 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Reviewed: no -->
+<sect1 id="zend.exception.basic">
+    <title>Basic usage</title>
+
+    <para>
+        <classname>Zend_Exception</classname> is the base class for all exceptions thrown by Zend
+        Framework.  This class extends the base <classname>Exception</classname> class of PHP.
+    </para>
+
+    <example id="zend.exception.catchall.example">
+        <title>Catch all Zend Framework exceptions</title>
+
+        <programlisting language="php"><![CDATA[
+try {
+    // your code
+} catch (Zend_Exception $e) {
+    // do something
+}
+]]></programlisting>
+    </example>
+
+    <example id="zend.exception.catchcomponent.example">
+        <title>Catch exceptions thrown by a specific component of Zend Framework</title>
+
+        <programlisting language="php"><![CDATA[
+try {
+    // your code
+} catch (Zend_Db_Exception $e) {
+    // do something
+}
+]]></programlisting>
+    </example>
+</sect1>
+<!--
+vim:se ts=4 sw=4 et:
+-->

documentation/manual/es/module_specs/Zend_Form-StandardElements.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20115 -->
+<!-- EN-Revision: 20212 -->
     <!-- Reviewed: no -->
 <sect1 id="zend.form.standardElements">
     <title>Elementos Enviados en el Formulario Estandard de Zend

documentation/manual/es/module_specs/Zend_Loader.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20115 -->
+<!-- EN-Revision: 20243 -->
     <!-- Reviewed: no -->
 <sect1 id="zend.loader.load">
 
@@ -115,6 +115,72 @@ Zend_Loader::loadClass('Container_Tree',
             así que el nombre de la clase puede contener únicamente caracteres
             alfanuméricos, guiones ('-'), barras bajas ('_'), y puntos ('.'). </para>
 
+			<note>
+            <title>Loading Classes from PHP Namespaces</title>
+
+            <para>
+                Starting in version 1.10.0, Zend Framework now allows loading classes from PHP
+                namespaces. This support follows the same guidelines and implementation as that
+                found in the <ulink
+                    url="http://groups.google.com/group/php-standards/web/psr-0-final-proposal">PHP
+                Framework Interop Group PSR-0</ulink> reference implementation.
+            </para>
+
+            <para>
+                Under this guideline, the following rules apply:
+            </para>
+
+            <itemizedlist>
+                <listitem>
+                    <para>
+                        Each namespace separator is converted to a
+                        <constant>DIRECTORY_SEPARATOR</constant> when loading from the file system.
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        Each "_" character in the <emphasis>CLASS NAME</emphasis> is converted to a
+                        <constant>DIRECTORY_SEPARATOR</constant>.  The "_" character has no special
+                        meaning in the namespace.
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        The fully-qualified namespace and class is suffixed with ".php" when loading
+                        from the file system.
+                    </para>
+                </listitem>
+            </itemizedlist>
+
+            <para>
+                As examples:
+            </para>
+
+            <itemizedlist>
+                <listitem>
+                    <para>
+                        <classname>\Doctrine\Common\IsolatedClassLoader</classname> =&gt;
+                        <filename>/path/to/project/lib/vendor/Doctrine/Common/IsolatedClassLoader.php</filename>
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <classname>\namespace\package\Class_Name</classname> =&gt;
+                        <filename>/path/to/project/lib/vendor/namespace/package/Class/Name.php</filename>
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <classname>\namespace\package_name\Class_Name</classname> =&gt;
+                        <filename>/path/to/project/lib/vendor/namespace/package_name/Class/Name.php</filename>
+                    </para>
+                </listitem>
+            </itemizedlist>
+        </note>
     </sect2>
 
     <sect2 id="zend.loader.load.isreadable">

documentation/manual/es/module_specs/Zend_Mail-Boundary.xml

@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 20128 -->
+<!-- Reviewed: no -->
+<sect1 id="zend.mail.boundary">
+    <title>Controlling the MIME Boundary</title>
+
+    <para>
+        In a multipart message, a <acronym>MIME</acronym> boundary for separating the different
+        parts of the message is normally generated at random. In some cases, however, you might
+        want to specify the <acronym>MIME</acronym> boundary that is used. This can be done using
+        the <methodname>setMimeBoundary()</methodname> method, as in the following example:
+    </para>
+
+    <example id="zend.mail.boundary.example-1">
+        <title>Changing the MIME Boundary</title>
+        <programlisting language="php"><![CDATA[
+$mail = new Zend_Mail();
+$mail->setMimeBoundary('=_' . md5(microtime(1) . $someId++));
+// build message...
+]]></programlisting>
+    </example>
+</sect1>
+<!--
+vim:se ts=4 sw=4 et:
+-->

documentation/manual/es/module_specs/Zend_Markup.xml

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Reviewed: no -->
+<sect1 id="zend.markup.introduction">
+    <title>Introduction</title>
+
+    <para>
+        The <classname>Zend_Markup</classname> component provides an extensible
+        way for parsing text and rendering lightweight markup languages like
+        BBcode and Textile. It is available as of Zend Framework version 1.10.
+    </para>
+
+    <para>
+        <classname>Zend_Markup</classname> uses a factory method to instantiate
+        an instance of a renderer that extends
+        <classname>Zend_Markup_Renderer_Abstract</classname>. The factory
+        method accepts three arguments. The first one is the parser used to
+        tokenize the text (e.g. BbCode). The second (optional) parameter is
+        the renderer to use, Html by default. Thirdly an array with options
+        to use for the renderer can be specified.
+    </para>
+</sect1>

documentation/manual/es/module_specs/Zend_Validate-Set.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20115 -->
+<!-- EN-Revision: 20229 -->
     <!-- Reviewed: no -->
 
 <sect1 id="zend.validate.set" xmlns:xi="http://www.w3.org/2001/XInclude">
@@ -180,7 +180,8 @@ if ($validator->isValid($iban)) {
     </sect2>
 
     <xi:include href="Zend_Validate-Ip.xml"/>
-
+	 <xi:include href="Zend_Validate-Isbn.xml" />
+	 
     <sect2 id="zend.validate.set.less_than">
         <title>LessThan</title>
         <para> Devuelve <constant>TRUE</constant> si y sólo si

documentation/manual/es/tutorials/quickstart-intro-mvc.xml

@@ -0,0 +1,115 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 19912 -->
+<!-- Reviewed: no -->
+<sect1 id="learning.quickstart.intro">
+    <title>Introducción a MVC &amp; ZF</title>
+
+    <sect2 id="learning.quickstart.intro.zf">
+        <title>Zend Framework</title>
+
+        <para>
+            Zend Framework es un framework de código abierto y orientado a objectos para facilitar 
+            el desarrollo de aplicaciones web con PHP 5.
+            A menudo es considerado una 'biblioteca de componentes', debido a que estos poseen bajo
+            acoplamiento entre sí lo cual permite reutilizarlos con un alto grado de independencia. Proporciona
+            además una sofisticada implementación del patrón Modelo-Vista-Controlador (MVC) el cual puede
+            ser utilizado para fijar la estructura básica de las aplicaciones desarrolladas con el framework.
+            Encontrarás la lista completa de los componentes del Zend Framework junto a
+            breves descripciones de los mismos en la
+            <ulink url="http://framework.zend.com/about/components">lista de componentes</ulink>.
+            En este tutorial te ayudaremos a familiarizarte con aquellos componentes del framework
+            utilizados de manera más frecuente incluyendo
+            <classname>Zend_Controller</classname>, <classname>Zend_Layout</classname>,
+            <classname>Zend_Config</classname>, <classname>Zend_Db</classname>,
+            <classname>Zend_Db_Table</classname> y <classname>Zend_Registry</classname>.
+        </para>
+
+        <para>
+            Utilizando dichos componentes construiremos en pocos minutos una sencilla aplicación de ejemplo
+            en la cual nos serviremos de una base de datos para registrar los comentarios que dejen los usuarios
+            de un sitio web. Puedes descargar el código fuente completo para
+            esta aplicación de los siguientes enlaces:
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <ulink
+                        url="http://framework.zend.com/demos/ZendFrameworkQuickstart.zip">formato zip</ulink>
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <ulink
+                        url="http://framework.zend.com/demos/ZendFrameworkQuickstart.tar.gz">formato tar.gz</ulink>
+                </para>
+            </listitem>
+        </itemizedlist>
+    </sect2>
+
+    <sect2 id="learning.quickstart.intro.mvc">
+        <title>Modelo-Vista-Controlador</title>
+
+        <para>
+            En resumen ¿qué es exactamente el patrón MVC del que tanto hablan? ¿y por qué
+            debería importarte? MVC no es sólo un acrónimo de tres letras que puedes utilizar
+            para impresionar a tus amigos, actualmente MVC se ha convertido en un estándar
+            para el diseño de las aplicaciones web modernas. Y por buenas razones ya que 
+            ayuda a modelar de forma precisa la separación de intereses permitiendo agrupar
+            en distintas partes de la aplicación el código que se relaciona con la presentación,
+            el que implementa la lógica de negocios y el que accede a los datos.
+            Muchos desarrolladores encuentran indispensable dicha separación para ayudarlos a mantener
+            su código organizado, especialmente cuando más de un desarrollador se encuentra
+            trabajando en la misma aplicación.
+        </para>
+
+        <note>
+            <title>Más información</title>
+
+            <para>
+                Profundicemos un poco y veamos cada parte de este patrón por separado:
+            </para>
+
+            <para>
+                <inlinegraphic width="321" scale="100" align="center" valign="middle"
+                               fileref="figures/learning.quickstart.intro.mvc.png" format="PNG" />
+            </para>
+
+            <itemizedlist>
+                <listitem>
+                    <para>
+                        <emphasis role="strong">Modelo</emphasis> - ofrece las funcionalidades básicas
+                        de la aplicación incluyendo las rutinas de acceso a datos y la lógica de negocios.
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <emphasis role="strong">Vista</emphasis> - se encarga de generar lo que se presenta
+                        al usuario a partir de los datos que recibe del controlador, al mismo tiempo que recogen
+                        los datos que brindan los usuarios. Es la parte de la aplicación donde encontrarás el HTML.
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <emphasis role="strong">Controlador</emphasis> - son los que unen el patrón.
+                        Según el pedido del usuario y otras variables ellos pueden decidir ejecutar
+                        otro controlador o manipular los datos del modelo para luego asignarle el resultado
+                        a una vista en particular.
+                        Muchos expertos en MVC recomiendan <ulink
+                            url="http://weblog.jamisbuck.org/2006/10/18/skinny-controller-fat-model">mantener
+                            el controlador lo más limpio posible</ulink>.
+                    </para>
+                </listitem>
+            </itemizedlist>
+
+            <para>
+                Podríamos <ulink url="http://ootips.org/mvc-pattern.html">extendernos aún más</ulink>
+                sobre este patrón pero por ahora ya posees los conocimientos suficientes
+                que te permitirán entender la aplicación que vamos a construir.
+            </para>
+        </note>
+    </sect2>
+</sect1>