Skip to content

Commit f90120e

Browse files
lucianomlimahalian-vilela
authored andcommitted
Add Universal Style Guide translation to Glossary (reactjs#154)
* Add Universal Style Guide tranalation * [WIP] Translate Glossary (reactjs#109) * Translate Glossary * Add Universal Style Guide to glossary as suggested * Add Universal Style Guide tranalation * Little fix * Fix merge issues
1 parent aecd5df commit f90120e

File tree

1 file changed

+101
-10
lines changed

1 file changed

+101
-10
lines changed

GLOSSARY.md

Lines changed: 101 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,103 @@
1-
# Guia de Estilo
1+
# Guia de Estilo Universal
22

3-
* Não traduza os blocos de código -- Porém atente-se aos comentários, também é aceitável traduzir as strings dentro dos blocos.
4-
* Links de referência (MDN, Wikipedia) devem apontar para a versão em Português.
5-
* Quando se referir ao prório `React`, use `o React`.
6-
* Também é recomendado seguir a [Universal Style Guide](https://github.com/reactjs/reactjs.org-translation/blob/master/style-guide.md)
3+
Este documento descreve as regras que devem ser aplicadas para **todos** os idiomas.
4+
Quando estiver se referindo ao próprio `React`, use `o React`.
75

8-
# Traduções Comuns
6+
## IDs dos Títulos
7+
8+
Todos os títulos possuem IDs explícitos como abaixo:
9+
10+
```md
11+
## Tente React {#try-react}
12+
```
13+
14+
**Não** traduza estes IDs! Eles são usado para navegação e quebrarão se o documento for um link externo, como:
15+
16+
```md
17+
Veja a [seção iniciando](/getting-started#try-react) para mais informações.
18+
```
19+
20+
✅ FAÇA:
21+
22+
```md
23+
## Tente React {#try-react}
24+
```
25+
26+
❌ NÃO FAÇA:
27+
28+
```md
29+
## Tente React {#tente-react}
30+
```
31+
32+
Isto quebraria o link acima.
33+
34+
## Texto em Blocos de Código
35+
36+
Mantenha o texto em blocos de código sem tradução, exceto para os comentários. Você pode optar por traduzir o texto em strings, mas tenha cuidado para não traduzir strings que se refiram ao código!
37+
38+
Exemplo:
39+
```js
40+
// Example
41+
const element = <h1>Hello, world</h1>;
42+
ReactDOM.render(element, document.getElementById('root'));
43+
```
44+
45+
✅ FAÇA:
46+
47+
```js
48+
// Exemplo
49+
const element = <h1>Hello, world</h1>;
50+
ReactDOM.render(element, document.getElementById('root'));
51+
```
52+
53+
✅ PERMITIDO:
54+
55+
```js
56+
// Exemplo
57+
const element = <h1>Olá mundo</h1>;
58+
ReactDOM.render(element, document.getElementById('root'));
59+
```
60+
61+
❌ NÃO FAÇA:
62+
63+
```js
64+
// Exemplo
65+
const element = <h1>Olá mundo</h1>;
66+
// "root" se refere a um ID de elemento.
67+
// NÃO TRADUZA
68+
ReactDOM.render(element, document.getElementById('raiz'));
69+
```
70+
71+
❌ DEFINITIVAMENTE NÃO FAÇA:
72+
73+
```js
74+
// Exemplo
75+
const elemento = <h1>Olá mundo</h1>;
76+
ReactDOM.renderizar(elemento, documento.obterElementoPorId('raiz'));
77+
```
78+
79+
## Links Externos
80+
81+
Se um link externo se referir a um artigo no [MDN] or [Wikipedia] e se houver uma versão traduzida em seu idioma em uma qualidade decente, opte por usar a versão traduzida.
82+
83+
[MDN]: https://developer.mozilla.org/pt-BR/
84+
[Wikipedia]: https://pt.wikipedia.org/wiki/Wikipédia:Página_principal
85+
86+
Exemplo:
87+
88+
```md
89+
React elements are [immutable](https://en.wikipedia.org/wiki/Immutable_object).
90+
```
91+
92+
✅ OK:
93+
94+
```md
95+
Elementos React são [imutáveis](https://pt.wikipedia.org/wiki/Objeto_imutável).
96+
```
97+
98+
Para links que não possuem tradução (Stack Overflow, vídeos do YouTube, etc.), simplesmente use o link original.
99+
100+
## Traduções Comuns
9101

10102
Sugestões de palavras e termos:
11103

@@ -42,13 +134,12 @@ Sugestões de palavras e termos:
42134
| stateful component | componente com estado |
43135
| container | contêiner |
44136
| helper function | função auxiliar |
45-
| siblings | irmãos |
46-
| DOM node | nó do DOM |
137+
| siblings | irmãos |
138+
| DOM node | nó do DOM |
47139
| handler | manipulador |
48140
| event handler | manipulador de eventos (event handler) |
49141

50-
51-
# Conteúdo que não deve ser traduzido
142+
## Conteúdo que não deve ser traduzido
52143

53144
* array
54145
* arrow function

0 commit comments

Comments
 (0)