Skip to content

Commit c4c3f99

Browse files
SauloSilvaSauloSilva
committed
Clonando a branch chapter4 do fork do @fdaciuk 
2 parents ac0edc7 + 6f72620 commit c4c3f99

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

53 files changed

+11790
-826
lines changed

‎.gitignore

+3
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
.DS_Store
2+
*.swp
3+
*.swo

‎CONTRIBUTING.md

+141
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,141 @@
1+
# Contribuições
2+
3+
### Por onde começar?
4+
5+
**1.** Faça o _fork_ do projeto.
6+
7+
**2.** [Entenda nosso fluxo](#fluxo).
8+
9+
**3.** [Leia e pratique as boas práticas](#boas-pr%C3%A1ticas).
10+
11+
**4.** Veja nas [issues](https://github.com/braziljs/eloquente-javascript/issues) o status, através das *labels*, do capítulo que você deseja traduzir ou revisar.
12+
13+
**5.** Caso o capítulo ainda não esteja em tradução ou revisão, comente na _Issue_ correspondente que você irá iniciar tal tarefa, para que assim possamos atribuir o capítulo para você.
14+
15+
**IMPORTANTE:** Adquira a concessão para tradução de outro capítulo somente **APÓS** terminar o anterior solicitado.
16+
17+
### Entenda nossas __labels__
18+
19+
* **em tradução**: sinaliza que um arquivo está em tradução.
20+
* **aguardando revisão**: sinaliza que o capítulo já foi traduzido e está esperando para ser revisado.
21+
* **em revisão**: sinaliza que um arquivo traduzido está sendo revisado.
22+
* **aguardando supervisão**: sinaliza que um arquivo que já foi traduzido e revisado está esperando uma última revisão antes de ser finalizado.
23+
* **em supervisão**: sinaliza que um arquivo já traduzido e revisado está recebendo uma última revisão antes de ser finalizado.
24+
* **dúvidas**: dúvidas, sugestões e outros.
25+
26+
### Etapas da _Isuue_
27+
28+
O andamento das _Issues_ está divido em **5 etapas** na ordem apresentada abaixo:
29+
30+
**`em tradução` > `aguardando revisão` > `em revisão` > `aguardando supervisão` > `em supervisão` > `fechamento da issue`**
31+
32+
### Fluxo
33+
34+
Ao mostrar-se interessado por uma _Issue_ seguiremos as regras:
35+
36+
**1.** A _Issue_ será atribuida ao interessado.
37+
38+
**2.** Colocaremos uma _milestone_ com o prazo de 2 semanas para entrega do _Pull Request_.
39+
40+
**3.** Quando o prazo da _milestone_ vencer, nós verificaremos a atividade da _Issue_, caso necessário estenderemos o prazo para mais 2 semanas.
41+
42+
**4.** Quando o prazo da _milestone_ vencer e não houver nenhuma atividade correspondente a _Issue_, entraremos em contato com responsável pela própria _Issue_. Caso a pessoa não se manifestar no prazo de **14 dias**, a _Issue_ retrocederá ao estado anterior, de acordo com as [etapas citadas acima](#etapas-da-isuue).
43+
44+
### Boas práticas
45+
46+
**1.** Faça referência ao repositório oficial após o _fork_
47+
48+
```
49+
git remote add upstream git@github.com:braziljs/eloquente-javascript.git
50+
```
51+
52+
**2.** Antes de iniciar o processo de tradução, crie uma branch com um nome coerente com o que estiver fazendo, Exemplo:
53+
54+
- Para tradução:
55+
56+
```
57+
git checkout -b c0x
58+
```
59+
60+
- Para revisões:
61+
62+
```
63+
git checkout -b c0xr0y
64+
```
65+
66+
> `x` representa o número do cápitulo e `y` o número da review.
67+
68+
**3.** Após a tradução ou revisão de um cápitulo é hora de fazer um commit com uma mensagem bem coerente do que foi feito. Exemplo:
69+
70+
```
71+
git add --all
72+
git commit -am 'Tradução do tópico foo do capítulo 1 #numero-da-issue'
73+
git push origin c0xr0y
74+
```
75+
76+
> **ps**: Lembre de **sempre** fazer a referência da issue que representa o capítulo em tradução/revisão na hora do commit.
77+
>
78+
> **Ex**: `git commit -m 'Tradução capítulo 13 - DOM #13'`
79+
80+
Caso queira enviar o _Pull Request_ do que foi feito, abra-o referenciando para a `master` do repositório oficial.
81+
82+
**4.** Após finalizar a tradução ou revisão de uma _Issue_ siga os passos:
83+
84+
- Delete a branch utilizada:
85+
86+
```
87+
git checkout master
88+
git push origin :c0xr0y
89+
git branch -D c0xr0y
90+
```
91+
92+
- Atualize seu repositório com o repositório oficial:
93+
94+
```
95+
git fetch upstream
96+
git rebase upstream/master
97+
git push -f origin master
98+
```
99+
100+
**5.** Quando for iniciar uma nova tradução ou revisão, inicie todo processo pelo passo 2.
101+
102+
### Dúvidas em tradução de termos, palavras, expressões etc...
103+
104+
Quando estiver em uma situação em que você não sabe exatamente como traduzir uma palavra, termo ou expressão, nós recomendamos que siga os seguintes passos:
105+
106+
**1.** Abra uma _Issue_ com um título descritivo como por exemplo: "_Como traduzir a palavra/termo "x"?_" e coloque uma descrição fazendo referência a _Issue_ do capítulo que você está trabalhando e explicando o contexto com informações relevantes.
107+
108+
**2.** Adicione um label `[TODO: ref #<número-da-issue-da-discussão>]<palavra/termo não traduzido>[/TODO]` e continue trabalhando no arquivo enquanto não há uma conclusão na _Issue_. Esse processo é importante para facilitar o acesso a itens pendentes e ter uma referência clara onde está ocorrendo a discussão.
109+
110+
**3.** Após a conclusão da discussão na _Issue_, feche a mesma. Em seguida, remova o label adicionado no passo 2 e atualize a palavra/termo não traduzido.
111+
112+
**4.** Como mantemos um arquivo de [glossário](https://github.com/braziljs/eloquente-javascript/blob/master/glossario.md), faça um _Pull Request_ adicionando o novo termo, colocando a referência `#<número-da-issue>` no termo/palavra em questão para fácil acesso no futuro.
113+
114+
### Definições para termos em geral
115+
116+
- Delimitação para títulos de obras: Utilizar o travessão para o início da frase, nome do autor e logo após o nome da obra, sem alterar nenhum valor. Exemplo:
117+
118+
> — Master Yuan-Ma, The Book of Programming
119+
120+
- Estrangeirismo: Utilizar o formato itálico. Exemplo: _bug_
121+
- Sentido Figurado: Sempre destacar com aspas duplas.
122+
- Citação: Aspas duplas com o sinal de >. Exemplo:
123+
124+
> "Foo bar"
125+
126+
- Marcação para código: Utilizar um apóstrofe (\`) para indicar um pedaço de código no meio de um texto (`var foo = undefined`). Ou três apóstrofe com o nome da linguagem de programação na frente (\`\`\`js), para indicar um bloco de código:
127+
128+
```js
129+
var foo;
130+
foo = undefined;
131+
```
132+
133+
### Esmagando seus commits
134+
135+
Quando algum revisor achar que alguma mensagem de commit não estiver coerente, ele pode pedir para você esmagar seus commits. Mais informações você encontra [aqui](http://gitready.com/advanced/2009/02/10/squashing-commits-with-rebase.html).
136+
137+
### O que é traduzivél?
138+
139+
Apenas os textos, códigos e termos técnicos permanecem intactos.
140+
141+
Obrigado! :heart: :heart: :heart:

‎README.md

+32-45
Original file line numberDiff line numberDiff line change
@@ -2,58 +2,45 @@
22

33
**Uma moderna introdução ao JavaScript, programação e maravilhas digitais.**
44

5-
Escrito por **Marijn Haverbeke**
5+
> **Mantenedor:** [Eric Douglas](https://github.com/ericdouglas)
66
7+
![JavaScript Eloquente](img/eloq-js.png)
78

9+
## Conteúdo do Livro
810

9-
### Original [aqui](http://eloquentjavascript.net/2nd_edition/preview/).
11+
[Introdução](https://github.com/braziljs/eloquente-javascript/blob/master/chapters/00-introducao.md)
1012

11-
### Download do livro traduzido no formato `.pdf`, `.mobi` e `.epub` **[AQUI](https://leanpub.com/eloquentejavascript).**
13+
1. [Valores, Tipos e Operadores](https://github.com/braziljs/eloquente-javascript/blob/master/chapters/01-valores-tipos-operadores.md) - (**Parte 1: Linguagem**)
14+
1. [Estrutura do Programa](https://github.com/braziljs/eloquente-javascript/blob/master/chapters/02-estrutura-do-programa.md)
15+
1. [Funções](https://github.com/braziljs/eloquente-javascript/blob/master/chapters/03-funcoes.md)
16+
1. [Estrutura de Dados: Objeto e Array](https://github.com/braziljs/eloquente-javascript/blob/master/chapters/04-estruturas-de-dados.md)
17+
1. [Funções de Ordem Superior](https://github.com/braziljs/eloquente-javascript/blob/master/chapters/05-funcoes-de-ordem-superior.md)
18+
1. [A Vida Secreta dos Objetos](https://github.com/braziljs/eloquente-javascript/blob/master/chapters/06-a-vida-secreta-dos-objetos.md)
19+
1. [Prática: Vida Eletrônica](https://github.com/braziljs/eloquente-javascript/blob/master/chapters/07-pratica-vida-eletronica.md)
20+
1. [Erros e Manipulação de Erros](https://github.com/braziljs/eloquente-javascript/blob/master/chapters/08-erros-e-manipulacao-de-erros.md)
21+
1. [Expressões Regulares](https://github.com/braziljs/eloquente-javascript/blob/master/chapters/09-expressoes-regulares.md)
22+
1. [Módulos](https://github.com/braziljs/eloquente-javascript/blob/master/chapters/10-modulos.md)
23+
1. [Prática: A Linguagem de Programação](https://github.com/braziljs/eloquente-javascript/blob/master/chapters/11-pratica-linguagem-de-programacao.md)
24+
1. [JavaScript e o Navegador](https://github.com/braziljs/eloquente-javascript/blob/master/chapters/12-javascript-e-o-navegador.md) - (**Parte 2: Navegador**)
25+
1. [O *Document Object Model*](https://github.com/braziljs/eloquente-javascript/blob/master/chapters/13-document-object-model.md)
26+
1. [Manipulando Eventos](https://github.com/braziljs/eloquente-javascript/blob/master/chapters/14-manipulando-eventos.md)
27+
1. [Projeto: Plataforma de Jogo](https://github.com/braziljs/eloquente-javascript/blob/master/chapters/15-projeto-plataforma-de-jogo.md)
28+
1. [Desenhando no Canvas](https://github.com/braziljs/eloquente-javascript/blob/master/chapters/16-desenhando-n0-canvas.md)
29+
1. [HTTP](https://github.com/braziljs/eloquente-javascript/blob/master/chapters/17-http.md)
30+
1. [Formulários e Campos de Formulários](https://github.com/braziljs/eloquente-javascript/blob/master/chapters/18-formularios-e-campos-de-formularios.md)
31+
1. [Projeto: Um Programa de Pintura](https://github.com/braziljs/eloquente-javascript/blob/master/chapters/19-projeto-um-programa-de-pintura.md)
32+
1. [Node.js](https://github.com/braziljs/eloquente-javascript/blob/master/chapters/20-nodejs.md) - (**Parte 3: Node.js**)
33+
1. [Projeto: Website de Compartilhamento de Habilidades](https://github.com/braziljs/eloquente-javascript/blob/master/chapters/21-projeto-website-de-compartilhamento-de-habilidades.md)
1234

13-
![JavaScript Eloquente](img/eloq-js.jpg)
35+
## Como Contribuir
1436

37+
Veja nosso guia de contribuição [aqui](https://github.com/braziljs/eloquente-javascript/blob/master/CONTRIBUTING.md).
1538

16-
Licensiado sobre licença [Creative Commons attribution-noncommercial.](http://creativecommons.org/licenses/by-nc/3.0/) Todo código neste livro também pode ser considerado sobre [licença MIT](http://opensource.org/licenses/MIT).
39+
## Informações Importantes
1740

18-
# Conteúdo do Livro
41+
- Autor: **Marijn Haverbeke**
42+
- [Versão original](http://eloquentjavascript.net) deste livro.
1943

20-
* [Introdução](https://github.com/eoop/eloquente-javascript/blob/master/chapters/01-introducao.md)
21-
* [Valores, Tipos e Operadores](https://github.com/eoop/eloquente-javascript/blob/master/chapters/02-valores-tipos-operadores.md)
22-
* [Estrutura do Programa](https://github.com/eoop/eloquente-javascript/blob/master/chapters/03-estrutura-do-programa.md)
23-
* [Funções](https://github.com/eoop/eloquente-javascript/blob/master/chapters/04-funcoes.md)
24-
* [Estrutura de Dados: Objeto e Array](https://github.com/eoop/eloquente-javascript/blob/master/chapters/05-estruturas-de-dados.md)
25-
* [Funções de Ordem Superior](https://github.com/eoop/eloquente-javascript/blob/master/chapters/06-funcoes-de-ordem-superior.md)
26-
* [A Vida Secreta dos Objetos](https://github.com/eoop/eloquente-javascript/blob/master/chapters/07-a-vida-secreta-dos-objetos.md)
27-
* [Prática: Vida Eletrônica](https://github.com/eoop/eloquente-javascript/blob/master/chapters/08-pratica-vida-eletronica.md)
28-
* [Erros e Manipulação de Erros](https://github.com/eoop/eloquente-javascript/blob/master/chapters/09-erros-e-manipulacao-de-erros.md)
29-
* [Expressões Regulares](https://github.com/eoop/eloquente-javascript/blob/master/chapters/10-expressoes-regulares.md)
30-
* [Módulos](https://github.com/eoop/eloquente-javascript/blob/master/chapters/11-modulos.md)
31-
* [Prática: A Linguagem de Programação](https://github.com/eoop/eloquente-javascript/blob/master/chapters/12-pratica-linguagem-de-programacao.md)
44+
Licenciado sob a licença [Creative Commons attribution-noncommercial.](http://creativecommons.org/licenses/by-nc/3.0/).
3245

33-
34-
# Contribuições
35-
36-
## Como Colaborar?
37-
38-
1. Fork o projeto.
39-
2. Veja nas [issues](https://github.com/eoop/eloquente-javascript/issues?state=open) o status, através das *labels*, do capítulo que você deseja traduzir e/ou revisar.
40-
3. Caso o capítulo ainda não esteja em tradução e/ou revisão, comente na issue correspondente que você irá iniciar tal tarefa, para que assim possamos adicionar a label de status nela.
41-
4. Faça o *Pull Request* para o repositório original.
42-
43-
**IMPORTANTE:** "Adquira" a concessão para tradução de outro capítulo somente **após** terminar o anteriormente solicitado.
44-
45-
## Entendendo as labels
46-
47-
* **em tradução**: sinaliza que um arquivo está em tradução.
48-
* **traduzido**: sinaliza que um arquivo foi traduzido, e está aguardando revisão.
49-
* **aguardando revisão**: capítulo para ser revisado (preferencialmente, por outro colaborador sem ser o próprio tradutor).
50-
* **em revisão**: sinaliza que um arquivo traduzido está sendo revisado.
51-
* **questões**: dúvidas, sugestões e outros.
52-
53-
## Fluxo do Trabalho - Issues
54-
55-
O andamento das issues está divido em 5 etapas, na ordem apresentada abaixo:
56-
57-
**`em tradução` > `traduzido` > `aguardando revisão` > `em revisão` > `fechamento da issue`**
58-
59-
Após essas etapas, irei compilar o livro no [Leanpub](https://leanpub.com/eloquentejavascript) para a versão final do mesmo.
46+
Todo código neste livro também pode ser considerado sob a [licença MIT](http://opensource.org/licenses/MIT).

0 commit comments

Comments
 (0)