From 737ba0849f11018cf599c653124ca5effd1fd424 Mon Sep 17 00:00:00 2001 From: Osvaldo Dias dos Santos Date: Fri, 2 Oct 2020 01:39:59 +0100 Subject: [PATCH] Update 1-js/01-getting-started. --- .../2-manuals-specifications/article.md | 13 ++------ .../3-code-editors/article.md | 33 ++++--------------- 1-js/01-getting-started/4-devtools/article.md | 26 +++------------ 3 files changed, 15 insertions(+), 57 deletions(-) diff --git a/1-js/01-getting-started/2-manuals-specifications/article.md b/1-js/01-getting-started/2-manuals-specifications/article.md index 7bc4ac642..8456de0f8 100644 --- a/1-js/01-getting-started/2-manuals-specifications/article.md +++ b/1-js/01-getting-started/2-manuals-specifications/article.md @@ -1,26 +1,19 @@ + # Manuais e especificações Este livro é um *tutorial*. Ele tem como objetivo lhe ajudar a aprender gradualmente a linguagem. Mas uma vez familiarizado com o básico, irá precisar de outros recursos. ## Especificação -A [Especificacão ECMA-262](https://www.ecma-international.org/publications/standards/Ecma-262.htm) contém as mais profundas, detalhadas e formalizadas informações sobre JavaScript. Ela define a linguagem. +A [Especificação ECMA-262](https://www.ecma-international.org/publications/standards/Ecma-262.htm) contém as mais profundas, detalhadas e formalizadas informações sobre JavaScript. Ela define a linguagem. -<<<<<<< HEAD Mas, estando num formato mais formal, fica difícil de entender à primeira vista. Porém, se você precisa da mais confiável fonte de informações sobre detalhes da linguagem, está no lugar certo. Contudo, não é para o uso cotidiano. -======= -[The ECMA-262 specification](https://www.ecma-international.org/publications/standards/Ecma-262.htm) contains the most in-depth, detailed and formalized information about JavaScript. It defines the language. ->>>>>>> e074a5f825a3d10b0c1e5e82561162f75516d7e3 Uma nova versão dessa especificação é lançada todos os anos. Entre estes lançamentos, a sua última versão de esboço se encontra em . -<<<<<<< HEAD Para ler sobre as mais novas funcionalidades (*bleeding-edge features*), incluindo as que estão em fase de padronização (chamadas também de "estágio 3"), veja as suas propostas em . -======= -A new specification version is released every year. In-between these releases, the latest specification draft is at . ->>>>>>> e074a5f825a3d10b0c1e5e82561162f75516d7e3 -E mais, se você está desenvolvendo para browsers, há outras especificações que cobrem esta demanda na [segunda parte](https://javascript.info/browser-environment) do tutorial. +E mais, se você está desenvolvendo para browsers, há outras especificações que cobrem esta demanda na [segunda parte](info:browser-environment) do tutorial. ## Manuais diff --git a/1-js/01-getting-started/3-code-editors/article.md b/1-js/01-getting-started/3-code-editors/article.md index 10c4aa20d..f9fdb18cd 100644 --- a/1-js/01-getting-started/3-code-editors/article.md +++ b/1-js/01-getting-started/3-code-editors/article.md @@ -12,10 +12,8 @@ Uma IDE carrega o projeto (que pode ter muitos arquivos), permite navegação en Se você ainda não tiver selecionado uma IDE, considere as seguintes opções: -- [WebStorm](http://www.jetbrains.com/webstorm/) para desenvolvimento de front-end. A mesma empresa oferece outros editores para outras linguagens (pago). -- [Netbeans](http://netbeans.org/) (livre). - -Todas essas IDEs são multi-plataforma. +- [Visual Studio Code](https://code.visualstudio.com/) (plataforma cruzada, livre). +- [WebStorm](http://www.jetbrains.com/webstorm/) (plataforma cruzada, pago). Para Windows, há também "Visual Studio", que não deve ser confundido com "Visual Studio Code". "Visual Studio" é um editor pago e poderoso somente para Windows, bem adequado para a plataforma .NET . Uma versão gratuita é chamada [Visual Studio Community](https://www.visualstudio.com/vs/community/). @@ -31,35 +29,18 @@ A principal diferença entre um "editor leve" e uma "IDE", é que uma IDE trabal Na prática, os editores leves podem ter muitos plug-ins, incluindo analisadores de sintaxe no nível de diretório e preenchimentos automáticos, portanto não há uma limitação rígida entre um editor leve e uma IDE. -<<<<<<< HEAD As seguintes opções merecem sua atenção: -======= -- [Atom](https://atom.io/) (cross-platform, free). -- [Visual Studio Code](https://code.visualstudio.com/) (cross-platform, free). -- [Sublime Text](http://www.sublimetext.com) (cross-platform, shareware). -- [Notepad++](https://notepad-plus-plus.org/) (Windows, free). -- [Vim](http://www.vim.org/) and [Emacs](https://www.gnu.org/software/emacs/) are also cool if you know how to use them. ->>>>>>> e074a5f825a3d10b0c1e5e82561162f75516d7e3 - -- [Visual Studio Code](https://code.visualstudio.com/) (plataforma cruzada, livre) também tem muitos recursos similares a IDE. -- [Atom](https://atom.io/) (multi-plataforma, livre). -- [Sublime Text](http://www.sublimetext.com) (multi-plataforma, shareware). + +- [Atom](https://atom.io/) (plataforma cruzada, livre). +- [Visual Studio Code](https://code.visualstudio.com/) (plataforma cruzada, livre). +- [Sublime Text](http://www.sublimetext.com) (plataforma cruzada, shareware). - [Notepad++](https://notepad-plus-plus.org/) (Windows, livre). - [Vim](http://www.vim.org/) e [Emacs](https://www.gnu.org/software/emacs/) também são legais se você sabe como usá-los. -## Os meus favoritos - -A preferência pessoal do autor deve ter uma IDE para projetos e um editor leve para edição de arquivo rápida e fácil. - -Eu estou usando: - -- Como uma IDE para JS -- [WebStorm](http://www.jetbrains.com/webstorm/) (Eu mudo para uma das outras ofertas do JetBrains quando uso outras linguagens) -- Como um editor de peso leve -- [Sublime Text](http://www.sublimetext.com) ou [Atom](https://atom.io/). - ## Não vamos discutir Os editores nas listas acima são aqueles que eu ou os meus amigos que eu considero bons desenvolvedores têm usado por um longo tempo e estão felizes com eles. Há outros grandes editores no nosso grande mundo. Por favor, escolha o que você mais gosta. -A escolha de um editor, como qualquer outra ferramenta, é individual e depende de seus projetos, hábitos e preferências pessoais. \ No newline at end of file +A escolha de um editor, como qualquer outra ferramenta, é individual e depende de seus projetos, hábitos e preferências pessoais. diff --git a/1-js/01-getting-started/4-devtools/article.md b/1-js/01-getting-started/4-devtools/article.md index 63583324c..ff7c8864c 100644 --- a/1-js/01-getting-started/4-devtools/article.md +++ b/1-js/01-getting-started/4-devtools/article.md @@ -1,6 +1,6 @@ # Console do desenvolvedor -O código é propenso a erros. Você provavelmente cometerá erros ... Oh, do que estou falando? Você está * inevitavelmente * cometendo erros, pelo menos se você for um humano, não um [robô] (https://pt.wikipedia.org/wiki/Bender_Bending_Rodr%C3%ADguez). +O código é propenso a erros. Você provavelmente cometerá erros ... Oh, do que estou falando? Você está *inevitavelmente* cometendo erros, pelo menos se você for um humano, não um [robô] ( Mas no navegador, os usuários não vêem os erros por padrão. Assim, se algo correr mal no script, não veremos de onde está partindo e não poderemos corrigir. @@ -29,23 +29,17 @@ 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. -<<<<<<< HEAD -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). -======= -Below the error message, there is a blue `>` symbol. It marks a "command line" where we can type JavaScript commands. Press `key:Enter` to run them. ->>>>>>> e074a5f825a3d10b0c1e5e82561162f75516d7e3 +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. 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 . -<<<<<<< HEAD -## Firefox, Edge, e outros -======= ```smart header="Multi-line input" Usually, when we put a line of code into the console, and then press `key:Enter`, it executes. To insert multiple lines, press `key:Shift+Enter`. This way one can enter long fragments of JavaScript code. ``` ->>>>>>> e074a5f825a3d10b0c1e5e82561162f75516d7e3 + +## Firefox, Edge, e outros A maioria dos outros navegadores usam `key:F12` para abrir ferramentas de desenvolvimento. @@ -61,19 +55,9 @@ Abra Preferências e vá para o painel "Avançado". Há uma caixa de seleção n 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 - -<<<<<<< HEAD -Normalmente, quando colocamos uma linha de código no console, e então pressionamos `key:Enter`, ele executa. - -Para inserir várias linhas, pressione `key:Shift+Enter`. - ## Resumo -======= -## Summary ->>>>>>> e074a5f825a3d10b0c1e5e82561162f75516d7e3 - As ferramentas de desenvolvedor nos permitem ver erros, executar comandos, examinar variáveis e muito mais. - 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. \ No newline at end of file +Agora temos o ambiente pronto. Na próxima seção, chegaremos ao JavaScript.