Finalizing code structure translation

Author: Márcio Rodrigo

1-js/01-getting-started/3-devtools/article.md

@@ -16,7 +16,7 @@ Abra a página [bug.html](bug.html).
 
 Há um erro no código JavaScript dela. Ele está escondido dos olhos de um visitante comum, então vamos abrir as ferramentas de desenvolvedor para vê-lo.
 
-Pressione `tecla:F12` ou, se você estiver no Mac, então `tecla:Cmd+Opt+J`.
+Pressione `key:F12` ou, se você estiver no Mac, então `key:Cmd+Opt+J`.
 
 As ferramentas de desenvolvedor serão abertas na aba Console por padrão.
 
@@ -29,13 +29,13 @@ O aspecto exato das ferramentas de desenvolvimento depende da sua versão do Chr
 - Aqui podemos ver a mensagem de erro de cor vermelha. Neste caso, o script contém um comando "lalala" desconhecido.
 - À direita, há um link clicável para o código-fonte `bug.html:12` com o número da linha onde o erro ocorreu.
 
-Abaixo da mensagem de erro, há um símbolo azul `>`. Ele marca uma "linha de comando" onde podemos digitar comandos JavaScript. Pressione `tecla:Enter` para executá-los (`tecla:Shift+Enter` para introduzir comandos multi-linha).
+Abaixo da mensagem de erro, há um símbolo azul `>`. Ele marca uma "linha de comando" onde podemos digitar comandos JavaScript. Pressione `key:Enter` para executá-los (`key:Shift+Enter` para introduzir comandos multi-linha).
 
 Agora podemos ver erros, e isso é suficiente para começar. Voltaremos mais tarde às ferramentas de desenvolvedor e abordaremos a depuração mais profundamente no capítulo <info:debugging-chrome>.
 
 ## Firefox, Edge, e outros
 
-A maioria dos outros navegadores usam `tecla:F12` para abrir ferramentas de desenvolvimento.
+A maioria dos outros navegadores usam `key:F12` para abrir ferramentas de desenvolvimento.
 
 A interface deles é bem parecida. Uma vez que você saiba como usar uma dessas ferramentas (você pode começar com o Chrome), você pode facilmente mudar para outra.
 
@@ -47,17 +47,17 @@ Abra Preferências e vá para o painel "Avançado". Há uma caixa de seleção n
 
 ![safari](safari.png)
 
-Agora o `tecla:Cmd+Opt+C` pode alternar o console. Além disso, note que o novo item do menu superior chamado "Develop" apareceu. Ele tem muitos comandos e opções.
+Agora o `key:Cmd+Opt+C` pode alternar o console. Além disso, note que o novo item do menu superior chamado "Develop" apareceu. Ele tem muitos comandos e opções.
 
 ## Entrada multi-linha
 
-Normalmente, quando colocamos uma linha de código no console, e então pressionamos `tecla:Enter`, ele executa.
+Normalmente, quando colocamos uma linha de código no console, e então pressionamos `key:Enter`, ele executa.
 
-Para inserir várias linhas, pressione `tecla:Shift+Enter`.
+Para inserir várias linhas, pressione `key:Shift+Enter`.
 
 ## Resumo
 
 - As ferramentas de desenvolvedor nos permitem ver erros, executar comandos, examinar variáveis e muito mais.
-- Elas podem ser abertas com `tecla:F12` para a maioria dos navegadores no Windows. O Chrome para Mac precisa de `tecla:Cmd+Opt+J`, Safari: `tecla:Cmd+Opt+C` (precisa ser ativado primeiro).
+- Elas podem ser abertas com `key:F12` para a maioria dos navegadores no Windows. O Chrome para Mac precisa de `key:Cmd+Opt+J`, Safari: `key:Cmd+Opt+C` (precisa ser ativado primeiro).
 
 Agora temos o ambiente pronto. Na próxima seção, chegaremos ao JavaScript.

1-js/02-first-steps/01-hello-world/article.md

@@ -1,89 +1,89 @@
-# Hello, world!
+# Olá, mundo!
 
-The tutorial that you're reading is about core JavaScript, which is platform-independent. Later on, you'll learn about Node.js and other platforms that use it.
+O tutorial que você está lendo é sobre a core do JavaScript, que é independente de plataforma. Mais tarde, você vai aprender sobre Node.js e outras plataformas que o usam.
 
-But we need a working environment to run our scripts and, since this book is online, the browser is a good choice. We'll keep the amount of browser-specific commands (like `alert`) to a minimum so that you don't spend time on them if you plan to concentrate on another environment (like Node.js). We'll focus on JavaScript in the browser in the [next part](/ui) of the tutorial.
+Mas precisamos de um ambiente de trabalho para rodar nossos scripts e, como esse livro está online, o navegador é uma boa escolha. Vamos manter a quantidade de comandos específicos do navegador (como `alert`) no mínimo para que você não gaste tempo com eles se você planeja se concentrar em outro ambiente (como Node.js). Vamos focar em JavaScript no navegador na [próxima parte](/ui) do tutorial.
 
-So first, let's see how we attach a script to a webpage. For server-side environments (like Node.js), you can execute the script with a command like `"node my.js"`.
+Então, primeiro, vamos ver como anexar um script a uma página. Para ambientes server-side (como Node.js), você pode executar o script com um comando como `"node my.js"`.
 
 
-## The "script" tag
+## A tag "script"
 
-JavaScript programs can be inserted into any part of an HTML document with the help of the `<script>` tag.
+Os programas JavaScript podem ser inseridos em qualquer parte de um documento HTML com a ajuda da tag `<script>`.
 
-For instance:
+Por exemplo:
 
 ```html run height=100
 <!DOCTYPE HTML>
 <html>
 
 <body>
 
-  <p>Before the script...</p>
+  <p>Antes do script...</p>
 
 *!*
   <script>
-    alert( 'Hello, world!' );
+    alert( 'Olá, mundo!' );
   </script>
 */!*
 
-  <p>...After the script.</p>
+  <p>...Depois do script.</p>
 
 </body>
 
 </html>
 ```
 
 ```online
-You can run the example by clicking the "Play" button in the right-top corner of the box above.
+Você pode executar o exemplo clicando no botão "Jogar" no canto superior direito da caixa acima.
 ```
 
-The `<script>` tag contains JavaScript code which is automatically executed when the browser processes the tag.
+A tag `<script>` contém código JavaScript que é executado automaticamente quando o navegador processa a tag.
 
 
-## Modern markup
+## Marcação moderna
 
-The `<script>` tag has a few attributes that are rarely used nowadays but can still be found in old code:
+A tag `<script>` tem alguns atributos que raramente são usados hoje em dia, mas que ainda podem ser encontrados em códigos antigos:
 
-The `type` attribute: <code>&lt;script <u>type</u>=...&gt;</code>
-: The old HTML standard, HTML4, required a script to have a `type`. Usually it was `type="text/javascript"`. It's not required anymore. Also, the modern HTML standard, HTML5, totally changed the meaning of this attribute. Now, it can be used for JavaScript modules. But that's an advanced topic; we'll talk about modules in another part of the tutorial. 
+O atributo `type`: <code>&lt;script <u>type</u>=...&gt;</code>
+: O antigo padrão HTML, HTML4, requeria um script para ter um `type`. Normalmente era `type="text/javascript"`. Não é mais necessário. Além disso, o moderno padrão HTML, HTML5, mudou totalmente o significado deste atributo. Agora, ele pode ser usado para módulos JavaScript. Mas esse é um tópico avançado; vamos falar sobre módulos em outra parte do tutorial. 
 
-The `language` attribute: <code>&lt;script <u>language</u>=...&gt;</code>
-: This attribute was meant to show the language of the script. This attribute no longer makes sense because JavaScript is the default language. There is no need to use it.
+O atributo `language`: <code>&lt;script <u>language</u>=...&gt;</code>
+: Este atributo foi criado para mostrar o idioma do script. Este atributo não faz mais sentido porque JavaScript é a linguagem padrão. Não há necessidade de usá-lo.
 
-Comments before and after scripts.
-: In really ancient books and guides, you may find comments inside `<script>` tags, like this:
+Comentários antes e depois dos scripts.
+: Em livros e guias realmente antigos, você pode encontrar comentários dentro de tags `<script>`, assim:
 
     ```html no-beautify
     <script type="text/javascript"><!--
         ...
     //--></script>
     ```
 
-    This trick isn't used in modern JavaScript. These comments hid JavaScript code from old browsers that didn't know how to process the `<script>` tag. Since browsers released in the last 15 years don't have this issue, this kind of comment can help you identify really old code.
+    Esse truque não é usado no JavaScript moderno. Esses comentários esconderam código JavaScript de navegadores antigos que não sabiam como processar a tag `<script>`. Como os navegadores lançados nos últimos 15 anos não têm esse problema, esse tipo de comentário pode ajudá-lo a identificar códigos realmente antigos.
 
 
-## External scripts
+## Scripts externos
 
-If we have a lot of JavaScript code, we can put it into a separate file.
+Se tivermos muito código JavaScript, podemos colocá-lo em um arquivo separado.
 
-Script files are attached to HTML with the `src` attribute:
+Os arquivos de script são anexados ao HTML com o atributo `src`:
 
 ```html
 <script src="/path/to/script.js"></script>
 ```
 
-Here, `/path/to/script.js` is an absolute path to the script file (from the site root).
+Aqui, `/path/to/script.js` é um caminho absoluto para o arquivo script (da raiz do site).
 
-You can also provide a relative path from the current page. For instance, `src="script.js"` would mean a file `"script.js"` in the current folder.
+Você também pode fornecer um caminho relativo a partir da página atual. Por exemplo, `src="script.js"` significaria um arquivo `"script.js"` na pasta atual.
 
-We can give a full URL as well. For instance:
+Nós também podemos dar uma URL completa. Por exemplo:
 
 ```html
 <script src="https://cdnjs.cloudflare.com/ajax/libs/lodash.js/3.2.0/lodash.js"></script>
 ```
 
-To attach several scripts, use multiple tags:
+Para anexar vários scripts, use múltiplas tags:
 
 ```html
 <script src="/js/script1.js"></script>
@@ -92,29 +92,30 @@ To attach several scripts, use multiple tags:
 ```
 
 ```smart
-As a rule, only the simplest scripts are put into HTML. More complex ones reside in separate files.
+Como regra, apenas os scripts mais simples são colocados em HTML. Os mais complexos residem em arquivos separados.
 
-The benefit of a separate file is that the browser will download it and store it in its [cache](https://en.wikipedia.org/wiki/Web_cache).
+O benefício de um arquivo separado é que o navegador irá baixá-lo e armazená-lo em seu [cache] (https://pt.wikipedia.org/wiki/Web_cache).
 
-Other pages that reference the same script will take it from the cache instead of downloading it, so the file is actually downloaded only once.
+Outras páginas que referenciam o mesmo script o tirarão do cache ao invés de baixá-lo, então o arquivo é baixado apenas uma vez.
+
+Isso reduz o tráfego e torna as páginas mais rápidas.
 
-That reduces traffic and makes pages faster.
 ```
 
-````warn header="If `src` is set, the script content is ignored."
-A single `<script>` tag can't have both the `src` attribute and code inside.
+````warn header="Se `src` estiver definido, o conteúdo do script é ignorado."
+Uma única tag `<script>` não pode ter tanto o atributo `src` quanto o código dentro dela.
 
-This won't work:
+Isso não vai funcionar:
 
 ```html
 <script *!*src*/!*="file.js">
-  alert(1); // the content is ignored, because src is set
+  alert(1); // o conteúdo é ignorado, porque o src está definido
 </script>
 ```
 
-We must choose either an external `<script src="…">` or a regular `<script>` with code.
+Devemos escolher um `<script src="...">` ou um `<script>` com código.
 
-The example above can be split into two scripts to work:
+O exemplo acima pode ser dividido em dois scripts para funcionar:
 
 ```html
 <script src="file.js"></script>
@@ -124,11 +125,11 @@ The example above can be split into two scripts to work:
 ```
 ````
 
-## Summary
+## Resumo
 
-- We can use a `<script>` tag to add JavaScript code to a page.
-- The `type` and `language` attributes are not required.
-- A script in an external file can be inserted with `<script src="path/to/script.js"></script>`.
+- Podemos usar uma tag `<script>` para adicionar código JavaScript a uma página.
+- Os atributos `type` e `language` não são necessários.
+- Um script em um arquivo externo pode ser inserido com `<script src="path/to/script.js"></script>`.
 
 
-There is much more to learn about browser scripts and their interaction with the webpage. But let's keep in mind that this part of the tutorial is devoted to the JavaScript language, so we shouldn't distract ourselves with browser-specific implementations of it. We'll be using the browser as a way to run JavaScript, which is very convenient for online reading, but only one of many.
+Há muito mais a aprender sobre os scripts dos navegadores e sua interação com a página. Mas vamos ter em mente que esta parte do tutorial é dedicada à linguagem JavaScript, então não devemos nos distrair com implementações específicas de navegadores. Estaremos usando o navegador como uma maneira de rodar JavaScript, que é muito conveniente para leitura online, mas apenas um de muitos.