theus / br.vuejs.org

The website.

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 atualmente é um trabalho em progresso. Situação de cada página do site:

Website

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

Guide

• Installation (Tradução: @danielschmitz, @ErickPetru. Revisão 2.2: @ErickPetru)
• Introduction (Tradução: @ErickPetru. Revisão 2.2: @ErickPetru)
• The Vue Instance (Tradução: @danielschmitz. Revisão 2.2: @ErickPetru)
• Template Syntax (Tradução: @vitorarjol. Revisão 2.2: pendente)
• Computed Properties and Watchers (Tradução: @danielschmitz. Revisão 2.2: pendente)
• Class and Style Bindings (Tradução: @gidenilson. Revisão 2.2: pendente)
• Conditional Rendering (Tradução: @gidenilson. Revisão 2.2: pendente)
• List Rendering (Tradução: @ErickPetru. Revisão 2.2: pendente)
• Event Handling (Tradução: @gidenilson. Revisão 2.2: pendente)
• Form Input Bindings(Tradução: @gidenilson. Revisão 2.2: pendente)
• Components (Tradução: pendente)
• Reactivity in Depth (Tradução: @gidenilson. Revisão 2.2: pendente)
• Transition Effects (Tradução: @jbruni, @NicholasPedroso. Revisão 2.2: pendente)
• Transitioning State (Tradução: pendente)
• Render Functions (Tradução: @jbruni. Revisão 2.2: pendente)
• Custom Directives (Tradução: @gidenilson. Revisão 2.2: pendente)
• Mixins (Tradução: @jbruni. Revisão 2.2: pendente)
• Plugins (Tradução: @jbruni. Revisão 2.2: pendente)
• Single File Components (Tradução: @ErickPetru. Revisão 2.2: pendente)
• Production Deployment Tips (Tradução: @vitorarjol. Revisão 2.2: pendente)
• Routing (Tradução: @natanaelphp. Revisão 2.2: pendente)
• State Management (Tradução: @ErickPetru. Revisão 2.2: pendente)
• Unit Testing (Tradução: @capaci. Revisão 2.2: pendente)
• Server-Side Rendering (Tradução: @ErickPetru. Revisão 2.2: pendente)
• Migration from Vue 1.x (Tradução: pendente)
• Migration from Vue Router 0.7.x (Tradução: @ErickPetru. Revisão 2.2: pendente)
• Migration from Vuex 0.6.x to 1.0 (Tradução: @ErickPetru. Revisão 2.2: pendente)
• Comparison with Other Frameworks (Tradução: @ErickPetru. Revisão 2.2: pendente)
• Join the Vue.js Community! (Tradução: pendente)

API

• Global Config (Tradução: @theus. Revisão 2.2: @theus)
• Global API
• Options / Data
• Options / DOM (Tradução: @guilherme-dev. Revisão 2.2: pendente)
• Options / Lifecycle Hooks (Tradução: @guilherme-dev. Revisão 2.2: pendente)
• Options / Assets
• Options / Composition
• Options / Misc
• Instance Properties
• Instance Methods / Data
• Instance Methods / Events
• Instance Methods / Lifecycle
• Directives
• Special Attributes
• Built-In Components
• VNode Interface
• Server-Side Rendering

Examples

• Markdown Editor (Tradução: @vitorarjol. Revisão 2.2: pendente)
• GitHub Commits (Tradução: @vitorarjol. Revisão 2.2: pendente)
• Firebase + Validation (Tradução: @vitorarjol. Revisão 2.2: pendente)
• Grid Component (Tradução: @vitorarjol. Revisão 2.2: pendente)
• Tree View (Tradução: @vitorarjol. Revisão 2.2: pendente)
• SVG Graph (Tradução: @vitorarjol. Revisão 2.2: pendente)
• Modal Component (Tradução: @vitorarjol. Revisão 2.2: pendente)
• Elastic Header (Tradução: @vitorarjol. Revisão 2.2: pendente)
• Wrapper Component (Tradução: @vitorarjol. Revisão 2.2: pendente)
• TodoMVC (Tradução: @vitorarjol. Revisão 2.2: pendente)
• HackerNews Clone (Tradução: @vitorarjol. Revisão 2.2: pendente)

Como colaborar?

Para participar 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:

• Bundle = Pacote
• Debug = Depuração
• Handling = Manipulação
• Event Listening = Escuta de Eventos
• Render Funcion = Função de Renderização
• Computed Properties = Propriedades Computadas
• 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: bundle,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.