braziljs / eloquente-javascript Goto Github PK
View Code? Open in Web Editor NEWTradução do livro Eloquent JavaScript - 2ª edição.
Tradução do livro Eloquent JavaScript - 2ª edição.
Fala pessoal, tudo bem?
Sugiro que seja colocado uma tabela de conteúdo com os seus respectivos links no README.md. Além disso, podemos utilizar a mesma mecânica da tradução da documentação do Grunt. Ou seja, para cada arquivo será aberta uma issue, com labels para revisão, tradução e um milestone para o progresso da tradução.
Assim, deixamos mais organizado. O que acham?
Espero que ajude. Abraço!
Como foi conversado em #67 e tendo como base as modificações em #78
glossario.md
Como iremos acompanhar as atualizações que estão sendo feitas no repo do autor do livro?
Tradução do arquivo 04-estrutura-de-dados.md
Original: link
Seria interessante alterar o nome do repositório para eloquent-javascript
ao invés de eloquente-javascript
. Ficando assim com o nome original!
O que acham?
Tradução do arquivo 03-funcoes.md
Original: link
Me deparei com essa palavra na supervisão do capítulo 8 (#14 ). Estamos usando hoje "depuração" para traduzir esse termo, o que é uma tradução válida. Eu achei interessante levantar essa issue para discutir esse termo pois o verbo "Depurar" acaba se tornando muito formal, e muitas vezes acabamos falando algo na linha: "Debugar", "Debugando" etc...
O que vocês acham? Mantemos essa linha formal (já que é uma tradução de texto), ou seguimos uma direção mais informal?
Seguem algumas referências:
@braziljs/eloquent-javascript
Pessoas, esse é um guia vivo do que tem no website e na branch master onde está acontecendo as traduções/revisões. Se estiver faltando alguma coisa espero que deixem no comentário.
Vou começar a atualizar o site assim que possivel e irei alterando aqui.
Essa eu nem faço ideia de sugestões. Alguém sugere algo?
Estou pensando em mudar o website aqui nesse repositório.
Como ele é feito em jekyll, no caso é só criar uma branch orfã. Dessa forma centralizamos tudo nesse repositório.
O que acham?
Pessoal, pintou um projeto grande aqui na empresa e ta tomando o tempo que eu havia reservado para a tradução. Deve acabar ainda essa semana, espero que até quarta. Sei que já devo estar a mais de 15 dias sem fazer um PR da tradução, e isso pode estar atrasando o andamento do projeto.
Peço desculpas, e, espero na quinta retomar a tradução. Caso vocês queiram passar a tradução para alguém, tudo bem. Mas se puderem aguardar até quinta (7/5), eu pretendo voltar a traduzir.
Obrigado e grande abraço!
O @ewertonorg sugeriu usar uma ferramenta para comunicação. Tipo Gitter ou Slack. O que acham galera?
Seria interessante para colocar as ideias lá e interagimos melhor entre todos.
Por mim seria uma boa, e usaria Slack pela integração com o GitHub!
O que acham?
Então galera, traduzindo o capítulo 3, encontrei 2 problemas, e preciso da ajudar de vocês. Primeiro problema:
Tive dificuldade em traduzir o seguinte trecho:
Trecho original:
If a function is pure, a call to it can be seen as a thing in itself. When you are not sure that it is working correctly, you can test it by calling it directly from the console, which is simple because it does not depend on any context. It is easy to make these tests automatic ― to write a program that tests a specific function. Non-pure functions might return different values based on all kinds of factors, and have side effects that might be hard to test and think about.
Minha tradução:
Se uma função é pura, uma chamada a ela pode ser vista como uma coisa a ela mesma. Quando você não está certo se ela está funcionando corretamente, você pode testar ela chamando ela diretamente do console, que é simples, pois não depende de nenhum contexto. É facil fazer esses testes automaticamente - para escrever um programa que testa uma função específica. Funções não-puras podem retornar diferentes valores baseados em diferentes fatores, e possuem efeitos colaterais que podem ser difíceis de testar e pensar sobre eles.
Não entendi a parte do "uma coisa a ela mesma" e sobre a parte dos testes, nem mesmo em inglês consegui entender direito.
Trecho original:
People who have experience with other programming languages might expect that a block of code (between braces) also produces a new local environment. Not in JavaScript. Functions are the only things that create a new scope. You are allowed to use free-standing blocks like this...
var something = 1;
{
var something = 2;
print("Inside: " + something);
}
print("Outside: " + something);
... but the something inside the block refers to the same variable as the one outside the block. In fact, although blocks like this are allowed, they are utterly pointless. Most people agree that this is a bit of a design blunder by the designers of JavaScript, and ECMAScript Harmony will add some way to define variables that stay inside blocks (the let keyword).
O texto diz que variaveis criadas dentro de um bloco não são "válidas". Acredito que deva ter havido alguma mudança no javascript, porque agora elas são válidas, e como a variavel dentro do bloco foi declarada depois da primeira, ela sobrepõe a outra. Ou seja, o resultado dos dois "print" deveria ser 1, mas é 2. Acho que a solução é mudar totalmente esse paragrafo ou até mesmo tirar ele, mas precisamos avaliar se realmente mudou ou o código que está errado.
Acredito que podemos ser um pouco mais rigorosos nesse sentido. Se formos analisar um sistema tradicional de taquigrafia por exemplo, temos os seguinte workflow:
O nosso workflow hoje contempla apenas os dois primeiros setores. Acredito que poderia ser uma boa ideia termos um outro passo após a revisão e abrirmos a oportunidade de termos uma segunda revisão (supervisão), a fim de termos uma segunda opinião sobre a revisão e ao mesmo tempo achar eventuais erros que passarem da revisão. Vai dar um pouco mais de trabalho, porém acredito que assim podemos ter a oportunidade de produzir um material de maior qualidade. O que acham?
Linha 271:
atual:
Muitos programadores JavaScript envolvem os
if
e os loops com chaves. [...]
para:
Muitos programadores JavaScript envolvem cada
if
e loop com chaves. [...]
atual:
[...] quando houver alterações no número de declarações. [...]
para:
[...] quando houver alterações posteriores no número de declarações
Tradução do arquivo 09-expressoes-regulares.md
Original: link
Atualmente estamos linkando uma licença, não seria interessante termos uma dentro do repositório?
Talvez daria até pra usar alguma que o Github sugere, que tal?
Pessoal, acho que devemos adicionar no README um termo dizendo que após X dias que a pessoa se manifestou para realizar alguma tarefa, se ela não enviar nenhum PR, nós adm's temos a permissão para alterar a label do capítulo sem precisar confirmar com a pessoa.
Estamos com a situação de vários capítulos parados, e se alguém chegar e olhar rapidamente vai pensar que não tem mais nada disponível para traduzir.
Penso no período de 15 dias para cada interação.
Ex:
cc @joaostein @randsonjs @SauloSilva @gabrielfgularte
Tradução do arquivo 06-a-vida-secreta-dos-objetos.md
Original: link
Tradução do arquivo 00-introducao.md
Original: link
Tradução do arquivo 11-pratica-linguagem-de-programacao.md
Original: link
Galera, como a gente vai fazer (ou vem fazendo) pra traduzir essas partes dos exercícios? Eu vi pelo menos umas quatro formas diferentes. Exemplos:
Quando eu traduzi, eu olhei um desses e segui, achando que havia um padrão. Mas aparentemente não. No site ele só mostra a dica quando o usuário clica em mostrar. Vamos repetir esse padrão?
Essa issue tem o propósito de manter um log de todas as alterações referentes ao capítulo, não sendo um espaço para discussões, dúvidas e sugestões. Caso queira contribuir, abra uma issue/pull-request individual com sua contribuição.
Atenção: Quando abrir uma issue ou pull request referente a esse capítulo, faça referência usando:
ref "#215"
.
Arquivo: 04-estrutura-de-dados.md
Original: link
Converti para ePub
Para Converter
http://johnmacfarlane.net/pandoc/
Para Editar
https://github.com/user-none/Sigil/releases
Link pra baixar
http://minhateca.com.br/movibe/eloquente-javascript,411419992.epub
@randsonjs, você consegue atualizar o site com o conteúdo que nós temos até agora e deixar em sincronia a medida que novas alterações forem ocorrendo?
A única sugestão que vem na minha cabeça é gravável / graváveis. Até pq, quando leio em inglês é assim que minha mente traduz, existindo essa palavra em português ou não. hahaha.
Me deparei com esse termo revisando o #9 e não sei ao certo qual seria a melhor forma de traduzir.
O termo que usamos hoje é: "Vamos codar".
Eu tenho a impressão de que o termo "codar" não é um termo válido na língua portuguesa, porém descreve perfeitamente o termo em inglês e ouço bastante pessoas falando dessa forma. No português, o termo "codificar" representa bem a tradução, porém soa um pouco estranho: "Vamos codificar".
codificar
co.di.fi.car
(lat codice+ficar2) vtd 1 Reduzir a código; reunir em código. 2 Coligir.
O que acham sobre isso, e qual maneira que faz mais sentido para vocês? Claro que outras alternativas são totalmente bem-vindas :)
Acredito que seria interessante fazer uma espécie de glossário com os termos em inglês mais importantes encontrados no livro e suas respectivas traduções. Deste modo fica mais fácil uniformizar as traduções e revisões deste repo. O que acha @ericdouglas ?
Tem alguma possibilidade de empacotar nos formatos PDF e Epub?
Tradução do arquivo 01-valores-tipos-operadores.md
Tradução do arquivo 05-funcoes-de-ordem-superior.md
Original: link
Tradução do arquivo 13-document-object-model.md
Original: link
Tradução do arquivo 08-erros-e-manipulacao-de-erros.md
Original: link
Pessoal,
eu crie um repositório do livro e registrei um dominio para o mesmo. Vocês pode acessar por aqui: http://eloquentjavascript.com.br
Se vocês gostarem e quiserem colaborar com revisões ou tradução. Estou inteiramente a disposição para qualquer dúvidas :)
Ainda falta fazer muita coisa, então qualquer colaboração é bem-vinda :)
Obrigado
A minha idéia é construir um padrão a ser seguido durante todos os processos.
Iniciamos uma discussão neste PR sobre os termos de sentido figurado, gostaria de dar continuidade para saber a opinião de todos.
Caso alguém tenha algum outro termo para adicionar fique a vontade.
Aqui está minhas considerações sobre cada item.
console.log
Depois da definição de todos seria bem válido registrarmos essas decisões em algum lugar, pensei em coloca-las no CONTRIBUTING, o que acham?
Tradução do arquivo 02-estrutura-do-programa.md
Original: link
Galera, estou querendo finalizar este projeto antes do Natal para ficar de presente para a comunidade.
Para ajudar nisso, pensei em algumas coisas:
Creio que se formos finalizando todas as etapas de um capítulo antes de ir para o próximo, vamos ter mais sucesso. Dessa forma, uma pessoa incentiva a outra.
O que acham? Quem topa participar?
Se entrarmos nessa forma de trabalho, não existirão mais "donos" dos capítulos, assim que terminarmos um, já começaremos outro, e caso tenham mais pessoas querendo ajudar, repartimos as tarefas novamente e vamos prosseguindo. 😄
Aguardo a opinião/voto de vocês.
@braziljs/eloquent-javascript
Tradução do arquivo 10-modulos.md
Original: link
Tradução do arquivo 12-javascript-e-o-navegador.md
Original: link
Tradução do arquivo 07-pratica-vida-eletronica.md
Original: link
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.