Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 3 additions & 10 deletions 1-js/01-getting-started/2-manuals-specifications/article.md
Original file line number Diff line number Diff line change
@@ -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 <https://tc39.es/ecma262/>.

<<<<<<< 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 <https://github.com/tc39/proposals>.
=======
A new specification version is released every year. In-between these releases, the latest specification draft is at <https://tc39.es/ecma262/>.
>>>>>>> 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

Expand Down
33 changes: 7 additions & 26 deletions 1-js/01-getting-started/3-code-editors/article.md
Original file line number Diff line number Diff line change
Expand Up @@ -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/).

Expand All @@ -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.
A escolha de um editor, como qualquer outra ferramenta, é individual e depende de seus projetos, hábitos e preferências pessoais.
26 changes: 5 additions & 21 deletions 1-js/01-getting-started/4-devtools/article.md
Original file line number Diff line number Diff line change
@@ -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ô] (<https://pt.wikipedia.org/wiki/Bender_Bending_Rodr%C3%ADguez).>

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.

Expand Down Expand Up @@ -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 <info:debugging-chrome>.

<<<<<<< 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.

Expand All @@ -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.
Agora temos o ambiente pronto. Na próxima seção, chegaremos ao JavaScript.