first interaction

pt/appendices.rst

@@ -1,12 +1,11 @@
 Apêndices
-##########
+#########
 
-Apêndices contêm informações sobre os novos recursos
-introduzidos na versão 2.0, e o guia de migração da versão 
-1.3 para a versão 2.0.
+Os apêndices contêm informações sobre os novos recursos
+introduzidos na versão 2.0 e o guia de migração da versão 1.3 para a versão 2.0.
 
-2.0 Guia de Migração
-=========================
+Guia de Migração para a Versão 2.0
+==================================
 
 .. toctree::
     :maxdepth: 1
@@ -15,8 +14,8 @@ introduzidos na versão 2.0, e o guia de migração da versão
     appendices/new-features-in-cakephp-2-0
     appendices/phpunit-migration-hints
 
-Migração da 1.2 para 1.3
-=========================
+Migrando da Versão 1.2 para 1.3
+===============================
 
 .. toctree::
     :maxdepth: 1
@@ -25,12 +24,10 @@ Migração da 1.2 para 1.3
     appendices/new-features-in-cakephp-1-3
 
 Informações Gerais
-===================
+==================
 
 .. toctree::
     :maxdepth: 1
 
     appendices/cakephp-development-process
-    appendices/cakephp-coding-conventions
-    appendices/documentation-formatting
     appendices/glossary

pt/cakephp-overview.rst

@@ -1,12 +1,11 @@
-Resumo do CakePHP
-#################
-
-Bem vindo ao `Cookbook`, o manual para o framework de aplicações web CakePHP que
-torna o desenvolvimento uma parte do bolo!
+Visão Geral do CakePHP
+######################
+Bem vindo ao Cookbook, o manual para o framework de aplicações web CakePHP que
+torna o desenvolvimento um pedaço de bolo!
 
 Este manual assume que você tenha um entendimento geral sobre PHP e conhecimentos
 básicos em programação orientada a objetos. Diferentes funcionalidades dentro do
-framework utilizam diversas tecnologias - como SQL, Javascript e XML - e este
+framework utilizam diversas tecnologias – como SQL, Javascript e XML – e este
 manual não tenta explicar estas tecnologias, somente aquelas que são utilizadas
 no contexto.
 

pt/contents.rst

@@ -2,11 +2,23 @@ Contents
 ########
 
 .. toctree::
+   :maxdepth: 3
 
    index
-   basic-info
-   cakephp-overview
    installation
+   getting-started
+   cakephp-overview
+   controllers
+   views
+   models
+   core-libraries
+   plugins
+   console-and-shells
+   development
+   deployment
+   tutorials-and-examples
+   contributing
+   appendices
 
 .. todolist::
 
@@ -17,3 +29,4 @@ Indices and tables
 * :ref:`genindex`
 * :ref:`modindex`
 * :ref:`search`
+* :doc:`/appendices/glossary`

pt/deployment.rst

@@ -1,4 +1,55 @@
-Implantação
-###########
+Implementação
+#############
 
-Passos para a implantação em um servidor de hospedagem.
+Uma vez que sua aplicação está completa, ou mesmo antes quando você quiser
+colocá-la no ar. Existem algumas poucas coisas que você deve fazer quando
+colocar em produção uma aplicação CakePHP.
+
+
+Definindo a Raiz
+================
+
+Definir a raiz do documento da sua aplicação corretamente é um passo importante
+para manter seu código protegido e sua aplicação mais segura. As aplicações
+desenvolvidas com o CakePHP devem ter a raiz apontando para o diretório
+``app/webroot``. Isto torna a aplicação e os arquivos de configurações
+inacessíveis via URL. Configurar a raiz do documento depende de cada webserver.
+Veja a :doc:`/installation/advanced-installation` para informações sobre
+webservers específicos.
+
+Atualizar o core.php
+====================
+
+Atualizar o arquivo ``core.php``, especificamente o valor do ``debug`` é de extrema
+importância. Tornar o debug igual a ``0`` desabilita muitos recursos do processo
+de desenvolvimento que nunca devem ser expostos ao mundo. Desabilitando o debug,
+as coisas a seguir mudarão:
+
+* Mensagens de depuração criadas com :php:func:`pr()` e :php:func:`debug()`
+  serão desabilitadas.
+* O cache interno do CakePHP será descartado após 99 anos em vez de 10 segundos.
+* `Views` de erros serão menos informativas, retornando mensagens de erros
+  genéricas.
+* Erros não serão mostrados.
+* O rastro da pilha de exceções será desabilitado.
+
+Além dos itens citados acima, muitos plugins e extensões usam o valor do
+``debug`` para modificarem seus comportamentos.
+
+
+Multiplas aplicações usando o mesmo core do CakePHP
+===================================================
+
+Existem algumas maneiras de você configurar múltiplas aplicações para usarem
+o mesmo `core` (núcleo) do CakePHP. Você pode usar o ``include_path`` do PHP ou
+definir a constante ``CAKE_CORE_INCLUDE_PATH`` no ``webroot/index.php`` da sua
+aplicação. Geralmente, usar o ``include_path`` do PHP é a meneira mais fácil e
+robusta pois o CakePHP já vem pré-configurado para olhar o ``include_path``.
+
+No seu arquivo ``php.ini`` localize a diretiva ``include_path`` existente e
+anexe no final o caminho para o diretório ``lib`` do CakePHP::
+
+    include_path = '.:/usr/share/php:/usr/share/cakephp-2.0/lib'
+
+Assumimos que você está rodando um servidor \*nix e instalou o CakePHP em
+``/usr/share/cakephp-2.0``.

pt/development.rst

@@ -3,7 +3,7 @@ Desenvolvimento
 
 Nesta seção vamos cobrir os vários aspectos do desenvolvimento de uma aplicação
 CakePHP. Temas como configuração, manipulação de erros e exceções, depuração e 
-testes serão cobertos.
+testes serão abordados.
 
 .. toctree::
     :maxdepth: 1
@@ -16,4 +16,4 @@ testes serão cobertos.
     development/debugging
     development/testing
     development/rest
-    development/vendor-packages
+    development/vendor-packages

pt/index.rst

@@ -3,67 +3,57 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-O Manual
-########
-
-Bem vindo ao `Cookbook`, a documentação do CakePHP. O `Cookbook` é um sistema
-como um wiki, que permite que o público faça suas contribuições. Com um sistema
-aberto, esperamos manter um elevado nível de qualidade, validade, e precisão
-para a documentação do CakePHP. O CakePHP também torna mais fácil para que
-qualquer pessoal possa contribuir.
-
-Um ***enorme*** obrigado a `AD7six <http://www.ad7six.com/>`_, que defendeu o
-Cookbook, colocando intermináveis horas de desenvolvimento, testes e melhorando
-esta aplicação.
-
-Como Você Pode Ajudar
-=====================
-
-Se você perceber algum erro, algo que está incompleta, algo que não foi coberto
-ou alguma coisa que não esteja te agradando, aqui está como você pode ajudar:
-
-#. Clique no link editar da seção que pretende alterar.
-#. Acesse o `Cookbook`, se solicitado use a sua conta do 
-#. Log in to `Cookbook` if prompted using your `Bakery <http://bakery.cakephp.org>`_.
-   Qualquer pessoa pode ter uma conta do `bakery`.
-#. Por favor, leia as `diretrizes para submeter ao Cookbook <http://docs.cakephp.org/view/482/contributing-to-the-cookbook>`_
-   para garantir a consistência.
-#. Envie as adições/edições para revisão usando HTML válido e semântico.
-#. Acompanhe o progresso de suas submissões usando o Feed RSS ou volte no dia
-   seguinte para ver as alterações aprovadas.
-
-Traduções
-=========
-
-Envie um email para a equipe de documentação (docs at cakephp dot org) ou vá até
-o canal do IRC (#cakephp on freenode) para discutir os esforços de tradução que
-você gostaria de participar.
-
-Dicas de tradução:
-
-- Navegue e edite no idioma em que você deseja que o conteúdo seja traduzido, de
-  outro modo você não vai ver o que já foi traduzido.
-- Sinta-se livre para ir com tudo se o idioma escolhido já existe no
-  `Cookbook`.
-- Use a lista de tarefas (canto superior direito) para ver onde a atenção é
-  necessária para seu idioma.
-- Use a `Linguagem Informal <http://en.wikipedia.org/wiki/Register_(linguistics)>`_.
-- Traduza o conteúdo e o títudo ao mesmo tempo.
-- Compare com o conteúdo em Inglês antes de submeter a correção (se você
-  corrigir algo, mas não integrar com o `upstream` suas mudanças não seram
-  aceitas).
-- Se você precisar escrever um termo em Inglês, coloque-o entre as tags ``<em>``.
-  Por exemplo: "asdf asdf *Controller* asdf" ou "asdf asdf Controlador
-  (*Controller*) asdf" conforme apropriado.
-- Não submeta traduções parciais.
-- Não edite seções com mudanças pendentes.
-- Não use `entidades html <http://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references>`_
-  para caracteres acentuados, o `Cookbook` utiliza UTF-8.
-- Não faça modificações significativas na marcação (HTML) ou adicione novos
-  conteúdos.
-- Se no conteúdo original está faltando alguma informação, envie uma edição
-  primeiro.
-
-Estamos empenhados para fazer a documentação do CakePHP melhor do que nunca.
-Esperamos que você se junte a nós, usando o `Cookbook` e retribuindo a um
-projeto que nos tem beneficiado tanto.
+Bem Vindo
+#########
+
+O cookbook CakePHP é um projeto aberto de documentação editável pela comunidade.
+Esperamos manter um alto nível de qualidade, validade e precisão para a
+documentação do CakePHP.
+
+Download da documentação:
+
+- `formato epub <../_downloads/en/CakePHPCookbook.epub>`_
+- `código-fonte original <http://github.com/cakephp/docs>`_
+
+Introdução
+==========
+
+Construindo um blog
+-------------------
+
+Comece :doc:`construindo um Blog</tutorials-and-examples/blog/blog>`.
+Você vai aprender o básico do CakePHP e construirá no processo um blog básico.
+
+Convenções
+----------
+
+Leia sobre uma típica :doc:`requisição do CakePHP
+</getting-started/a-typical-cakephp-request>` e as :doc:`convenções
+</getting-started/cakephp-conventions>` que dão forças ao CakePHP.
+
+Controllers
+-----------
+Os `controllers` (controladores) manipulam as requisições e ajudam coordenando e
+preparando as respostas que serão enviadas para o cliente.
+Lei mais sobre os :doc:`/controllers`
+
+Views
+-----
+
+As `views` (visões) formam a camada de apresentação no CakePHP. Elas geram as
+saídas para as requisições dos clientes transformando os dados que foram obtidos
+a partir dos `models`.
+Leia mais sobre as :doc:`/views`
+
+Models
+------
+
+Os `models` (modelos) formam o coração de sua aplicação. Tratam das validações,
+armazenamento e recuperação dos seus dados.
+Leia mais sobre os :doc:`/models`
+
+Obtendo Ajuda
+=============
+
+Se você travou em algum ponto, existem inúmeros lugares onde :doc:`você pode
+obter ajuda </cakephp-overview/where-to-get-help>`