translation-workflow.md 4.23 KB
Newer Older
1 2 3
Como Colaborar Com a Tradução Para o Português do Brasil
========================================================

4 5 6
O Yii tem tradução para vários idiomas, incluindo o Português do Brasil. Existem
duas áreas onde a contribuição para a tradução é muito bem-vindo. A primeira é a
documentação e a segunda são as mensagens do framework.
7 8 9 10

Mensagens do Framework
----------------------

11 12 13
O Framework tem dois tipos de mensagens: as exceções que são destinadas para o
desenvolvedor e nunca são traduzidas, e as mensagens que são realmente visíveis
para o usuário final, tais como erros de validação.
14 15 16

Os passos para iniciar a tradução de mensagens são:

17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38
1. Com o `console` entre na pasta `yii2/framework`  e execute o seguinte comando:
   `yii message/extract messages/config.php`.
2. As mensagens a serem traduzidas encontram-se no seguinte caminho:
   `framework/messages/pt-BR/yii.php`. Certifique-se de salvar o arquivo com a
   codificação UTF-8 (Plain).
3. Após realizar as devidas traduções o passo seguinte é enviar as suas
   modificações para o respositório do Yii no Github.
   [Veja aqui](https://github.com/yiisoft/yii2/blob/master/docs/internals/git-workflow.md)
   os passos necessários para o envio dos arquivos.

Para manter as traduções sempre atualizadas, certifique-se que seu fork do Yii
esteja com a última versão. Em seguida, basta executar o comando
`yii message/extract messages/config.php` novamente e o mesmo irá adicionar
automaticamente as novas mensagens a serem traduzidas.

No arquivo de tradução cada elemento do array representa a tradução de uma
mensagem. Sendo que a "chave" representa o texto a ser traduzido e o "valor" a
sua tradução. Se o "valor" estiver vazio, a mensagem é considerada como não
traduzida. As mensagens que não precisam de tradução terão seus valores cercadas
por um par de '@@'. Atentar para algumas mensagens que estão no formato de plural,
para isso verifique a [seção i18n do guia](../guide-pt-BR/tutorial-i18n.md) para
mais detalhes.
39 40 41 42

Documentação
------------

43 44 45
As traduções da documentação para o português do Brasil devem ficar dentro do
diretório `docs/` seguindo o padrão  `docs/<original>-<pt-BR>` onde `<original>`
corresponde ao nome da pasta tal como `guide` ou `internals`.
46

47 48 49
Com a tradução do documento concluída, você pode obter um diff das mudanças desde
a última tradução, para isso, execute o seguinte comando a partir do diretório
`build/` do framework:
50 51 52 53 54

```
build translation "../docs/guide" "../docs/guide-pt-BR" > report-guide-pt-BR.html
```

55 56
Antes de iniciar seus trabalhos de tradução certifique-se que o arquivo em qual
irá trabalhar esteja disponível para ser traduzido. Para isso, acesse a
57
[planilha no Google Docs](https://docs.google.com/spreadsheets/d/1pAMe-qsKK0poEsQwGI2HLFmj4afKSkEUd_1qegU5YqQ).
58 59 60 61 62


Regras e Observações
--------------------

63 64 65 66 67 68 69 70 71
- Alguns termos não tem uma tradução muito boa para o português, em casos como
  esse convém escrever a palavra ou expressão em inglês primeiro em seguida sua
  possível tradução em parênteses.
- Se você acredita que alguma parte de sua tradução não faz sentido e você não
  tem certeza de como traduzi-la corretamente. Coloque este bloco de texto em
  *itálico*, isso ajudará na revisão.
- Para reduzir erros de digitação você pode utilizar um editor de texto como o
  MS Word para escrever pequenos blocos textos e em seguida copiar estes blocos
  para um editor visual de Markdown como o http://dillinger.io/.
72

73
### Convenções Para Tradução
74 75

- action — ação
76
- application system - sistema
77
- application template — template de aplicação
78 79 80 81 82
- controller — controller (controlador)
- eager loading — eager loading (carregamento na inicialização)
- lazy loading — lazy loading (carregamento retardado)
- model — model (modelo)
- query builder — query builder (construtor de consulta)
83
- view — view (visão)
84 85 86 87 88 89 90
- note — observação
- info — informação
- tip — dica
- warning - atenção
- attribute label - label do atributo
- inline action — ação inline
- standalone action — ação standalone
91 92 93 94 95 96

### Termos Sem Tradução

- active record
- alias
- cache
97
- CamelCase, camel-case
98
- core
99 100 101 102
- framework
- hash
- helper
- id
103
- runtime
104
- widget
105 106 107
- backend
- frontend
- web service