br.vuejs.org

Este é o repositório oficial da tradução em português brasileiro do site vuejs.org. O site foi construído com hexo e seu conteúdo é escrito em formato Markdown, localizado na pasta src. Pull requests são bem-vindos!

Situação da tradução

A tradução ainda é um trabalho em progresso. Quase todo o Guia foi traduzido, mas alguns conteúdos carecem de revisão após as atualizações 2.2 e 2.3 do Vue. Além disso, o conteúdo da API está quase todo em inglês, carecendo de colaboração para tradução. A situação de cada página do site:

Website

Tela Principal (Tradução: @danielschmitz, @ErickPetru. Revisão: @ErickPetru)
Menus e barras (Tradução: @ErickPetru. Revisão: @ErickPetru)

Guide

API

Examples

Como colaborar?

Problemas pontuais nas traduções já realizadas, como erros de grafia ou frases demasiadamente confusas, podem ser reportados apenas enviando issues neste repositório.

Para participar ativamente traduzindo/revisando os conteúdos, siga os passos:

Faça um fork deste repositório para sua própria conta;
Edite o arquivo README registrando seu usuário ao lado da página que deseja traduzir/revisar;
Faça um pull request do README para que todos aqui sejam notificados e não ocorram trabalhos repetidos em paralelo.
Ao finalizar, faça um novo pull request com os arquivos modificados por você.
Não se esqueça de fazer um merge para obter as alterações mais recentes antes de recomeçar o processo assumindo outra tradução/revisão.

Caso não consiga terminar por completo algum arquivo, mas queira enviar o trabalho parcial, pedimos que abra uma nova Issue logo após a submissão para informar quais problemas persistem no arquivo enviado.

Ambiente de desenvolvimento

Após clonar seu repositório, inicie um servidor de desenvolvimento em localhost:4000:

$ npm install -g hexo-cli
$ npm install
$ hexo server

Considerações para padronização

A fim de obtermos uma documentação padronizada, seguem recomendações do que fazer:

Traduzir os comentários dos códigos-fonte;
Traduzir os textos informativos dos códigos-fonte, por exemplo: <div id="level-1">Nível 1</div>;
Seguir maiúsculas e minúsculas conforme o original em inglês, mantendo a notação sempre que possível;
Utilizar alguma extensão para ortografia e gramática, para evitar que erros deste tipo passem;
Embora não obrigatório, sugere-se usar itálico em expressões sem tradução (por exemplo, view layer);
Quando for submeter, sempre escreva os comentários do commit em INGLÊS.

E algumas recomendações do que não fazer:

Não traduzir nomes de variáveis, métodos, dados, ids, classes etc. nos códigos-fonte.
Não faça pull request diretamente para vuejs/master, o processo de tradução deve passar por esse repositório.
Não faça pull ou merge diretamente de vuejs/master, faça apenas deste repositório para seu fork pessoal.

Traduções padronizadas

Alguns termos recorrentes no guia devem ser traduzidos sempre da mesma maneira, desde que a tradução não atrapalhe o contexto da frase:

Bundle = Pacote
Debug = Depuração
Handling = Manipulação
Event Listening = Escuta de Eventos
Render Funcion = Função de Renderização
Computed Properties = Dados Computados
Single-File Components = Componentes Single-File
Custom Elements = Elementos Personalizados
Performance = Desempenho
Watchers = Observadores

Termos não traduzidos

Atualmente recomenda-se que estes termos sejam mantidos em inglês: getter, setter, standalone, runtime, build, alias, store, scaffolding loader, bind, loop, true, false, Number, String, template, wrapper, hot-reload, hook.

Discussões entre a equipe

Durante a tradução, se sentir necessidade de sugerir novos termos para alguma das listas de padronização, abra uma nova Issue para discussão. Se precisar apontar problemas específicos em algum item já traduzido, o caminho também é esse.

Se for necessário se apronfundar em discussões maiores, tirar dúvidas ou mesmo interagir de qualquer outra forma com a equipe, participe de nosso canal de tradução no Slack.

tiag00liveira/br.vuejs.org