Skip to content

Commit 9a5e1fc

Browse files
committed
cap15: revisão de estilo
1 parent fb4e121 commit 9a5e1fc

File tree

3 files changed

+813
-398
lines changed

3 files changed

+813
-398
lines changed

guia-de-estilo.adoc

Lines changed: 27 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -59,6 +59,30 @@ Exemplo de `cap06.adoc`:
5959
</pre>
6060
++++
6161

62+
### Formatação de links externos
63+
64+
O título do recurso externo em língua estrangeira deve estar em itálico, assim:
65+
66+
https://fpy.li/15-47[_Programming TypeScript_]
67+
68+
Quando for interessante traduzir o título da página de destino,
69+
a tradução deverá aparecer depois e fora do link, entre parêntesis, assim:
70+
71+
https://fpy.li/15-51[_Generics Considered Harmful_] (Genéricos considerados nocivos_)
72+
73+
O título original pode ficar em Title Case, a tradução deve começar com maíuscula e
74+
usar maiúscula só para siglas e nomes próprios.
75+
76+
O tradutor usou esta convenção:
77+
78+
https://fpy.li/15-51["Generics Considered Harmful" (_Genéricos Considerados Nocivos_)]
79+
80+
Para transformar, no VS Code esta expressão regular funciona:
81+
82+
----
83+
DE: "([^"]+)" \(_([^)]+)_\)\]
84+
PARA: _$1_] ($2)
85+
----
6286

6387

6488
## Termos adotados
@@ -89,7 +113,7 @@ Termo em português adotado::
89113
embutido _(built-in)_
90114

91115
Termo em inglês adotado::
92-
_o cluster_ (agrupamento)
116+
_cluster_ (agrupamento)
93117

94118
**Legenda**
95119

@@ -130,6 +154,7 @@ Termo em inglês adotado::
130154
|❗ _evaluate_ (verb) |✅ avaliar | contraste com "analisar" (_parse_)
131155
|❗ _evaluation_ |✅ avaliação |
132156
|❗ _factory_ |✅ fábrica |
157+
|❗ _forward reference_ |✅ referência futura | 🔎 referência adiantada
133158
|✅ _framework_ (s.m.) |❗ arcabouço | 🔎 a framework
134159
|❗ _Further Reading_ |✅ Para saber mais| título de seção (note: apenas 1ª letra maiúscula)
135160
|✅ _future_ (s.m.) |❓ |
@@ -146,7 +171,7 @@ Termo em inglês adotado::
146171
|✅ MRO (s.m.) | Ordem de Resolução de Métodos (_Method Resolution Order_)
147172
|✅ _offset_ (s.m.) | ❗ deslocamento | 🔎 a offset
148173
|❗ _override_ | ✅ sobrescrever | 🔎 sobrepor
149-
|❗ _overload_ | ✅ sobrecarregar |
174+
|❗ _overload_ | ✅ sobrecarregar | 🔎 sobrepor
150175
|❗ _overloading_ | ✅ sobrecarga |
151176
|❗ _overloaded signatures_ |✅ assinaturas sobrecarregadas|
152177
|❗ _parse_ |✅ analise (ou análise sintática) | contraste com "avaliar" (_evaluate_)

0 commit comments

Comments
 (0)