Merge pull request #8073 from kromodoro/5.x

[refact]: translated (pt/index)

Author: markstory

pt/index.rst

@@ -1,15 +1,14 @@
 Bem-vindo
 #########
 
-O CakePHP 4 é um framework de desenvolvimento web que funciona com o PHP 8.0
-(pelo menos |minphpversion|). Leia a seção :doc:`CakePHP num piscar de olhos </intro>`
-para ter uma ideia geral dos fundamentos do CakePHP.
+O CakePHP 5 é um framework de desenvolvimento web executado em PHP |phpversion| (min. PHP
+|minphpversion|). Leia :doc:`CakePHP num piscar de olhos </intro>` para obter uma
+introdução aos fundamentos do CakePHP.
 
-O *cookbook* (guia de receitas) do CakePHP é um projeto de documentação
-editável e aberto à comunidade. Observe o botão com um ícone de um lápis
-no canto direito, ele vai direcioná-lo para o editor online do GitHub
-referente a página atual, permitindo que você facilmente contribua com
-quaisquer adições, exclusões ou correções para a documentação.
+O livro CakePHP é um projeto de documentação aberto e editável pela comunidade.
+Observe o botão com o ícone de lápis fixado na parede direita; ele
+direcionará você para o editor online do GitHub da página ativa, permitindo que você
+contribua com quaisquer adições, exclusões ou correções à documentação.
 
 .. container:: offline-download
 
@@ -33,25 +32,19 @@ Se você está com dificuldades, existem vários lugares onde
 Primeiros passos
 ================
 
-Aprender um novo framework pode ser intimidador e excitante ao mesmo tempo. Para
-ajudar você nesse processo, nós criamos um *cookbook* recheado de exemplos e
-receitas que remetem tarefas rotineiras. Se você está iniciando, deveria começar
-com o :doc:`/quickstart` que vai lhe proporcionar um panorama geral sobre o que
-o CakePHP tem a oferecer e seu funcionamento.
+Aprender um novo framework pode ser intimidador e empolgante ao mesmo tempo. Para
+ajudá-lo, criamos um livro de receitas repleto de exemplos e receitas para
+concluir as tarefas comuns. Se você é iniciante, comece com o
+:doc:`/quickstart`, pois ele lhe dará um rápido tour pelo que
+o CakePHP tem a oferecer e como funciona.
 
-Após concluir o Guia de Início Rápido, você pode se aprofundar sobre os
-principais elementos existentes em uma aplicação construída com o CakePHP:
+Após concluir o tutorial de Início Rápido, você pode revisar os principais elementos de um aplicativo CakePHP:
 
 * O :ref:`ciclo de requisição do CakePHP <request-cycle>`
-* As :doc:`convenções </intro/conventions>` que o CakePHP
-  utiliza.
-* :doc:`Controllers </controllers>` lidam com requisições e coordenam seus
-  *models* com as respostas que sua aplicação gera.
-* :doc:`Views </views>` são a camada de apresentação da sua aplicação. Elas
-  te oferecem poderosas ferramentas para criar HTML, JSON e as outras saídas
-  que sua aplicação precisa.
-* :doc:`Models </orm>` são o ingrediente principal em qualquer aplicação. Eles
-  lidam com a validação e a lógica de domínio em sua aplicação.
+* As :doc:`convenções </intro/conventions>` que o CakePHP utiliza.
+* :doc:`Controllers </controllers>` lidar com requisições e coordenar seus *modelos* com as respostas que sua aplicação gera.
+* :doc:`Views </views>` são a camada de apresentação da sua aplicação. Elas te oferecem ferramentas poderosas para criar HTML, JSON e outras saídas que sua aplicação precisa.
+* :doc:`Modelos </orm>` são o ingrediente principal em qualquer aplicação. Eles lidam com a validação e a lógica de domínio em sua aplicação.
 
 .. meta::
     :title lang=pt: .. CakePHP book arquivo mestre de documentação, criado por

pt/intro.rst

@@ -1,14 +1,14 @@
 CakePHP num piscar de olhos
 ###########################
 
-O CakePHP é desenvolvido para tornar tarefas rotineiras do desenvolvimento web 
-mais simples e fáceis. Ao fornecer uma caixa de ferramentas completa para você 
-começar, as várias partes do CakePHP funcionam bem juntas ou separadamente.
+O CakePHP foi projetado para simplificar e facilitar tarefas comuns de desenvolvimento web. 
+Ao fornecer um conjunto de ferramentas completo para você começar, as diversas partes do 
+CakePHP funcionam bem juntas ou separadamente.
 
 O objetivo desta apresentação é introduzir os conceitos gerais presentes no CakePHP
 e lhe dar uma rápida visão geral de como esses conceitos são implementados. Se
-você está ansioso para começar um projeto, você pode :doc:`começar com o tutorial
-</tutorials-and-examples/bookmarks/intro>`, ou
+você está ansioso para começar um projeto, você pode 
+:doc:`começar com o tutorial </tutorials-and-examples/cms/installation>`, ou
 :doc:`mergulhar na documentação</topics>`.
 
 Convenções Sobre Configuração
@@ -36,12 +36,11 @@ objetos de modelo podem ser pensados como "Friend", "User", "Comment", ou
 "Photo". Se nós quiséssemos carregar alguns dados da nossa tabela ``users``
 poderíamos fazer::
 
-    use Cake\ORM\TableRegistry;
+    use Cake\ORM\Locator\LocatorAwareTrait;
 
-    // Prior to 3.6 use TableRegistry::get('Users')
-    $users = TableRegistry::getTableLocator()->get('Users');
-    $query = $users->find();
-    foreach ($query as $row) {
+    $users = $this->fetchTable('Users');
+    $resultset = $users->find()->all();
+    foreach ($resultset as $row) {
         echo $row->username;
     }
 
@@ -52,10 +51,9 @@ utilizar classes padrão para tabelas e entidades que ainda não foram definidas
 Se nós quiséssemos criar um usuário e salvá-lo (com validação) faríamos algo
 assim::
 
-    use Cake\ORM\TableRegistry;
+    use Cake\ORM\Locator\LocatorAwareTrait;
 
-    // Prior to 3.6 use TableRegistry::get('Users')
-    $users = TableRegistry::getTableLocator()->get('Users');
+    $users = $this->fetchTable('Users');
     $user = $users->newEntity(['email' => 'mark@example.com']);
     $users->save($user);
 
@@ -71,10 +69,10 @@ Por exemplo, a view pode usar dados da model para renderizar uma página HTML qu
 os contenha, ou um resultado formatado como XML::
 
     // No arquivo view, nós renderizaremos um 'element' para cada usuário.
-    <?php foreach ($users as $user): ?>
-        <div class="user">
-            <?= $this->element('user', ['user' => $user]) ?>
-        </div>
+    <?php foreach ($resultset as $user): ?>
+        <li class="user">
+            <?= $this->element('user_info', ['user' => $user]) ?>
+        </li>
     <?php endforeach; ?>
 
 A camada View fornece vários pontos de extensão, como :ref:`view-templates`, :ref:`view-elements`
@@ -102,7 +100,7 @@ camada View. Um exemplo de controller para registro de usuário seria::
 
     public function add()
     {
-        $user = $this->Users->newEntity();
+        $user = $this->Users->newEmptyEntity();
         if ($this->request->is('post')) {
             $user = $this->Users->patchEntity($user, $this->request->getData());
             if ($this->Users->save($user, ['validate' => 'registration'])) {
@@ -158,12 +156,12 @@ Alguns outros grandes recursos do CakePHP são:
 
 * :doc:`Framework de cache </core-libraries/caching>` que integra com
   Memcached, Redis e outros backends.
-* Poderosas :doc:`ferramentas de geração de código </bake>` para você começar imediatamente.
+* Poderosas :doc:`ferramentas de geração de código </bake/usage>` para você começar imediatamente.
 * :doc:`Framework de teste integrado </development/testing>` para você
   assegurar-se que seu código funciona perfeitamente.
 
 Os próximos passos óbvios são :doc:`baixar o CakePHP </installation>` e ler o
-:doc:`tutorial e construir algo fantástico </tutorials-and-examples/blog/blog>`.
+:doc:`tutorial e construir algo fantástico </tutorials-and-examples/cms/installation>`.
 
 Leitura Adicional
 =================