[MANUAL] Brazilian Portuguese:

- sync to r20792


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

documentation/manual/pt-br/module_specs/Zend_Json-Basics.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 19912 -->
+<!-- EN-Revision: 20792 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.json.basics">
     <title>Uso Básico</title>

documentation/manual/pt-br/module_specs/Zend_Json-Introduction.xml

@@ -1,8 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17227 -->
+<!-- EN-Revision: 20792 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.json.introduction">
     <title>Introdução</title>
+
     <para>
         <classname>Zend_Json</classname> provê métodos convenientes para serialização do
         <acronym>PHP</acronym> nativo para <acronym>JSON</acronym> e a descodificação
@@ -10,6 +11,7 @@
         <acronym>JSON</acronym>, <ulink url="http://www.json.org/">visite o site do projeto
         <acronym>JSON</acronym></ulink>.
     </para>
+
     <para>
         <acronym>JSON</acronym>, JavaScript Object Notation, pode ser usado para o intercâmbio de
         dados leves entre o JavaScript e outras linguagens. Desde que o <acronym>JSON</acronym>
@@ -29,7 +31,6 @@
         vantajosa função que resulta em mais dados específicos do aplicativo de
         processamento de dados.
     </para>
-
 </sect1>
 <!--
 vim:se ts=4 sw=4 et:

documentation/manual/pt-br/module_specs/Zend_Json-Objects.xml

@@ -1,16 +1,18 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17227 -->
+<!-- EN-Revision: 20792 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.json.advanced">
     <title>Uso Avançado do Zend_Json</title>
 
     <sect2 id="zend.json.advanced.objects1">
         <title>Objetos JSON</title>
+
         <para>
             Quando codificamos objetos <acronym>PHP</acronym> como <acronym>JSON</acronym>, todas
             as propriedades públicas desse objeto estarão codificadas em um objeto
             <acronym>JSON</acronym>.
         </para>
+
         <para>
             <acronym>JSON</acronym> não permite referências de objeto, por isso deve-se tomar
             cuidado para não codificar objetos com referências recursivas. Se você tiver problemas
@@ -19,6 +21,7 @@
             opcional para verificar a recursividade; se um objeto for serializado duplamente,
             uma exceção será lançada.
         </para>
+
         <para>
             Descodificar objetos <acronym>JSON</acronym> traz uma ligeira dificuldade, entretanto,
             desde que os objetos do JavaScript correspondam o mais próximo de uma matriz
@@ -27,20 +30,24 @@
             os pares chave/valor do objeto <acronym>JSON</acronym>; outros pensam que isto poderia
             gerar um risco substancial da segurança.
         </para>
+
         <para>
             Por padrão, <classname>Zend_Json</classname> irá descodificar objetos
             <acronym>JSON</acronym> como matriz associativas. Entretanto, se você deseja que o
             retorne um objeto, você pode especificar isto:
         </para>
+
         <programlisting language="php"><![CDATA[
 // Descodifique objetos JSON como objetos PHP
 $phpNative = Zend_Json::decode($encodedValue, Zend_Json::TYPE_OBJECT);
 ]]></programlisting>
+
         <para>
             Todos os objetos descodificados assim são retornados como objetos de
             <code>StdClass</code> com as propriedades que correspondem aos pares chave/valor na
             notação de <acronym>JSON</acronym>.
         </para>
+
         <para>
             A recomendação do Zend Framework é que o desenvolvedor deve decidir-se como
             descodificar objetos <acronym>JSON</acronym>. Se um objeto de um tipo especificado for

documentation/manual/pt-br/module_specs/Zend_Json-xml2json.xml

@@ -1,8 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17227 -->
+<!-- EN-Revision: 20792 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.json.xml2json">
     <title>Conversão de XML para JSON</title>
+
     <para>
         <classname>Zend_Json</classname> fornece um conveniente método para transformar dados
         formatados em <acronym>XML</acronym> para o formato <acronym>JSON</acronym>. Este recurso
@@ -19,9 +20,10 @@
         Tem também um parâmetro de entrada opcional do tipo booleano que instrui a lógica de
         conversão para ignorar ou não os atributos <acronym>XML</acronym> durante o processo de
         conversão. Se esse parâmetro de entrada opcional não é dado, então o comportamento padrão
-        é ignorar os atributos <acronym>XML</acronym>.
-        Esta chamada de função é feita como mostrado abaixo:
+        é ignorar os atributos <acronym>XML</acronym>. Esta chamada de função é feita como mostrado
+        abaixo:
     </para>
+
     <programlisting language="php"><![CDATA[
 // a função fromXml simplesmente recebe uma String contendo conteúdo
 // em XML como entrada.
@@ -121,7 +123,6 @@ $jsonContents = Zend_Json::fromXml($xmlStringContents, true);
         Mais detalhes sobre o recurso xml2json podem ser encontrados na proposta original em si.
         Dê uma olhada na <ulink url="http://tinyurl.com/2tfa8z">proposta Zend_xml2json</ulink>.
     </para>
-
 </sect1>
 <!--
 vim:se ts=4 sw=4 et:

documentation/manual/pt-br/module_specs/Zend_Layout-Advanced.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17175 -->
+<!-- EN-Revision: 20792 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.layout.advanced">
     <title>Uso Avançado de Zend_Layout</title>
@@ -15,33 +15,41 @@
     </para>
 
     <itemizedlist>
-        <listitem><para>
+        <listitem>
+            <para>
                 <emphasis>Custom view objects</emphasis>.
-                <classname>Zend_Layout</classname> permite a você utilizar qualquer classe
-                que implemente <classname>Zend_View_Interface</classname>.
-        </para></listitem>
+                <classname>Zend_Layout</classname> permite a você utilizar qualquer classe que
+                implemente <classname>Zend_View_Interface</classname>.
+            </para>
+        </listitem>
 
-        <listitem><para>
+        <listitem>
+            <para>
                 <emphasis>Custom front controller plugins</emphasis>.
                 <classname>Zend_Layout</classname> vem embarcado com um front controller plugin
                 padrão que automatiza a renderização de layouts antes de retornar a resposta.
                 Você pode substituir por seu próprio plugin.
-        </para></listitem>
+            </para>
+        </listitem>
 
-        <listitem><para>
+        <listitem>
+            <para>
                 <emphasis>Custom action helpers</emphasis>.
-                <classname>Zend_Layout</classname> vem embarcado com um action helper
-                padrão que deve servir para a maioria das necessidades já que é um
-                proxy mudo para o próprio objeto de layout.
-        </para></listitem>
+                <classname>Zend_Layout</classname> vem embarcado com um action helper padrão que
+                deve servir para a maioria das necessidades já que é um proxy mudo para o próprio
+                objeto de layout.
+            </para>
+        </listitem>
 
-        <listitem><para>
+        <listitem>
+            <para>
                 <emphasis>Custom layout script path resolution</emphasis>.
                 <classname>Zend_Layout</classname> permite a você usar seu próprio
                 <link linkend="zend.filter.inflector">inflector</link> para resolução do
                 caminho do script de layout, ou simplesmente modificar o inflector
                 anexado para especificar suas próprias regras de inflexão.
-        </para></listitem>
+            </para>
+        </listitem>
     </itemizedlist>
 
     <sect2 id="zend.layout.advanced.view">
@@ -159,13 +167,13 @@ $layoutVars   = $placeholders->placeholder('Zend_Layout')->getArrayCopy();
         </para>
 
         <itemizedlist>
-            <listitem><para>
-                    'foo' será transformado em 'foo.phtml'.
-            </para></listitem>
+            <listitem>
+                <para>'foo' será transformado em 'foo.phtml'.</para>
+            </listitem>
 
-            <listitem><para>
-                    'FooBarBaz' será transformado em 'foo-bar-baz.phtml'.
-            </para></listitem>
+            <listitem>
+                <para>'FooBarBaz' será transformado em 'foo-bar-baz.phtml'.</para>
+            </listitem>
         </itemizedlist>
 
         <para>

documentation/manual/pt-br/module_specs/Zend_Layout-Introduction.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17175 -->
+<!-- EN-Revision: 20792 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.layout.introduction">
     <title>Introdução</title>
@@ -12,40 +12,48 @@
         e Zend Framework adotou esse termo por consistência.
     </para>
 
-    <para>
-        Os objetivos globais de <classname>Zend_Layout</classname> são os seguintes:
-    </para>
+    <para>Os objetivos globais de <classname>Zend_Layout</classname> são os seguintes:</para>
 
     <itemizedlist>
-        <listitem><para>
+        <listitem>
+            <para>
                 Automatizar seleção e renderização de layouts quando usado com os componentes
                 <acronym>MVC</acronym> do Zend Framework.
-        </para></listitem>
+            </para>
+        </listitem>
 
-        <listitem><para>
+        <listitem>
+            <para>
                 Fornecer escopo separado para variáveis relacionadas ao layout e ao conteúdo.
-        </para></listitem>
+            </para>
+        </listitem>
 
-        <listitem><para>
+        <listitem>
+            <para>
                 Permitir configuração, incluindo o nome do layout, a resolução do script de
                 layout (inflection), e o caminho do script de layout.
-        </para></listitem>
+            </para>
+        </listitem>
 
-        <listitem><para>
+        <listitem>
+            <para>
                 Permitir a desabilitação de layouts, mudança de scripts de layout,
                 e outros estados; permitir essas ações de dentro de action controllers
                 e view scripts.
-        </para></listitem>
+            </para>
+        </listitem>
 
-        <listitem><para>
+        <listitem>
+            <para>
                 Seguir as mesmas regras de resolução de script (inflection) que <link
                 linkend="zend.controller.actionhelpers.viewrenderer">ViewRenderer</link>,
                 mas permitir também o uso de regras diferentes.
-        </para></listitem>
+            </para>
+        </listitem>
 
-        <listitem><para>
-                Permitir o uso sem os componentes <acronym>MVC</acronym> do Zend Framework.
-        </para></listitem>
+        <listitem>
+            <para>Permitir o uso sem os componentes <acronym>MVC</acronym> do Zend Framework.</para>
+        </listitem>
     </itemizedlist>
 </sect1>
 <!--

documentation/manual/pt-br/module_specs/Zend_Layout-Options.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20115 -->
+<!-- EN-Revision: 20792 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.layout.options">
     <title>Opções de Configuração Zend_Layout</title>
@@ -14,27 +14,34 @@
     </para>
 
     <itemizedlist>
-        <listitem><para>
+        <listitem>
+            <para>
                 <emphasis>layout</emphasis>: o layout a ser usado. Utiliza o inflector atual para
                 resolver o nome fornecido para o view script de layout apropriado. Por padrão,
                 esse valor é 'layout' e resolve para 'layout.phtml'. Os acessores são
                 <methodname>setLayout()</methodname> e <methodname>getLayout()</methodname>.
-        </para></listitem>
+            </para>
+        </listitem>
 
-        <listitem><para>
+        <listitem>
+            <para>
                 <emphasis>layoutPath</emphasis>: o caminho base para os view scripts
                 de layout. Os acessores são <methodname>setLayoutPath()</methodname> e
                 <methodname>getLayoutPath()</methodname>.
-        </para></listitem>
+            </para>
+        </listitem>
 
-        <listitem><para>
+        <listitem>
+            <para>
                 <emphasis>contentKey</emphasis>: a variável de layout usada para o conteúdo
                 padrão (quando usado com o <acronym>MVC</acronym>). O valor padrão é 'content'.
                 Os acessores são <methodname>setContentKey()</methodname> e
                 <methodname>getContentKey()</methodname>.
-        </para></listitem>
+            </para>
+        </listitem>
 
-        <listitem><para>
+        <listitem>
+            <para>
                 <emphasis>mvcSuccessfulActionOnly</emphasis>: quando usar o
                 <acronym>MVC</acronym>, se uma ação lança uma exceção e esse marco
                 é <constant>TRUE</constant>, o layout não será renderizado (isso é para
@@ -43,43 +50,52 @@
                 estiver em uso). Por padrão, o marco é <constant>TRUE</constant>. Os acessores são
                 <methodname>setMvcSuccessfulActionOnly()</methodname> e
                 <methodname>getMvcSuccessfulActionOnly()</methodname>.
-        </para></listitem>
+            </para>
+        </listitem>
 
-        <listitem><para>
+        <listitem>
+            <para>
                 <emphasis>view</emphasis>: O objeto view para ser usado na renderização.
                 Quando usado com o <acronym>MVC</acronym>, <classname>Zend_Layout</classname>
                 tentará usar o objeto view registrado com o
                 <link linkend="zend.controller.actionhelpers.viewrenderer">ViewRenderer</link>
                 se nenhum objeto view tiver sido passado explicitamente. Os acessores são
                 <methodname>setView()</methodname> e <methodname>getView()</methodname>.
-        </para></listitem>
+            </para>
+        </listitem>
 
-        <listitem><para>
+        <listitem>
+            <para>
                 <emphasis>helperClass</emphasis>: a classe action helper para usar quando
                 <classname>Zend_Layout</classname> estiver utilizando os componentes
                 <acronym>MVC</acronym>. Por padrão, ela é
                 <classname>Zend_Layout_Controller_Action_Helper_Layout</classname>.
                 Os acessores são <methodname>setHelperClass()</methodname> e
                 <methodname>getHelperClass()</methodname>.
-        </para></listitem>
+            </para>
+        </listitem>
 
-        <listitem><para>
+        <listitem>
+            <para>
                 <emphasis>pluginClass</emphasis>: a classe front controller plugin para usar
                 quando <classname>Zend_Layout</classname> estiver utilizando os componentes
                 <acronym>MVC</acronym>. Por padrão, ela é
                 <classname>Zend_Layout_Controller_Plugin_Layout</classname>. Os acessores são
                 <methodname>setPluginClass()</methodname> e
                 <methodname>getPluginClass()</methodname>.
-        </para></listitem>
+            </para>
+        </listitem>
 
-        <listitem><para>
+        <listitem>
+            <para>
                 <emphasis>inflector</emphasis>: o inflector a ser usado quando resolver
                 nomes para caminhos de view scripts de layout; veja
                 <link linkend="zend.layout.advanced.inflector">a documentação
                 <classname>Zend_Layout</classname> inflector para mais detalhes</link>. Os
                 acessores são <methodname>setInflector()</methodname> e
                 <methodname>getInflector()</methodname>.
-        </para></listitem>
+            </para>
+        </listitem>
     </itemizedlist>
 
     <note>
@@ -129,9 +145,7 @@ $config = new Zend_Config_Ini('/path/to/layout.ini', 'layout');
                 a instância de <classname>Zend_Layout</classname>.
             </para>
 
-            <para>
-                Primeiro, dê uma olhada na passagem de uma matriz:
-            </para>
+            <para>Primeiro, dê uma olhada na passagem de uma matriz:</para>
 
             <programlisting language="php"><![CDATA[
 // Usando um construtor:
@@ -141,9 +155,7 @@ $layout = new Zend_Layout($options);
 $layout = Zend_Layout::startMvc($options);
 ]]></programlisting>
 
-            <para>
-                E agora usando um objeto config:
-            </para>
+            <para>E agora usando um objeto config:</para>
 
             <programlisting language="php"><![CDATA[
 $config = new Zend_Config_Ini('/path/to/layout.ini', 'layout');

documentation/manual/pt-br/module_specs/Zend_Layout-QuickStart.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17175 -->
+<!-- EN-Revision: 20792 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.layout.quickstart">
     <title>Guia Rápido Zend_Layout</title>
@@ -216,13 +216,17 @@ $layout = Zend_Layout::getMvcInstance();
         </para>
 
         <itemizedlist>
-            <listitem><para>
+            <listitem>
+                <para>
                     Escopo de variáveis de layout.
-            </para></listitem>
+                </para>
+            </listitem>
 
-            <listitem><para>
+            <listitem>
+                <para>
                     Isolamento do view script de layout de outros scripts view.
-            </para></listitem>
+                </para>
+            </listitem>
         </itemizedlist>
 
         <para>
@@ -257,7 +261,7 @@ echo $layout->render();
             um exemplo de um script de layout.
         </para>
 
-         <para>
+        <para>
             <inlinegraphic align="center" valign="middle"
                 fileref="figures/zend.layout.quickstart.example.png" format="PNG" />
         </para>