Skip to content

Commit 7edf4e1

Browse files
LucaBlackDragondeblasis
authored andcommitted
Update STYLE_GUIDE.md (#11)
1 parent ae4ccb8 commit 7edf4e1

File tree

1 file changed

+109
-2
lines changed

1 file changed

+109
-2
lines changed

Diff for: STYLE_GUIDE.md

+109-2
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,109 @@
1-
<!-- content from the issue here, then we should update the pinned issue to point to the files for maximum visibility -->
2-
👷
1+
# Guida di Stile Universale
2+
3+
> This Style Guide is based on the [Universal Style Guide](https://github.com/reactjs/reactjs.org-translation/blob/master/style-guide.md)
4+
>
5+
> Questa Guida di Stile è basata sulla [Universal Style Guide](https://github.com/reactjs/reactjs.org-translation/blob/master/style-guide.md)
6+
7+
Questa Guida di Stile descrive le regole che dovrebbero essere applicate a **tutte** le lingue.
8+
9+
NOTA PER I MANUTENTORI: Potreste voler tradurre questa guida in modo che sia più accessibile ai traduttori.
10+
11+
## Glossario
12+
13+
Vedi [qui](https://github.com/reactjs/it.reactjs.org/blob/master/GLOSSARY.md)
14+
15+
## ID delle intestazioni
16+
17+
Tutte le intestazioni hanno degli ID espliciti, ad esempio:
18+
19+
```md
20+
## Try React {#try-react}
21+
```
22+
23+
**Non** tradurre questi ID! Sono utilizzati per la navigazione e non funzioneranno più se il documento è referenziato dall'esterno.
24+
25+
Ad esempio, dato questo link:
26+
27+
```md
28+
See the [beginning section](/getting-started#try-react) for more information.
29+
```
30+
31+
✅ COSÌ VA BENE:
32+
33+
```md
34+
## Prova React {#try-react}
35+
```
36+
37+
❌ COSÌ NO:
38+
39+
```md
40+
## Prova React {#prova-react}
41+
```
42+
43+
Nel secondo modo il link in alto non funzionerà più.
44+
45+
## Testo nei blocchi di codice
46+
47+
Non tradurre il testo nei blocchi di codice, a parte i commenti. Potresti voler tradurre anche il testo delle stringhe, ma fai attenzione a non tradurre le stringhe che costituiscono riferimenti al codice!
48+
49+
Ad esempio:
50+
```js
51+
// Example
52+
const element = <h1>Hello, world</h1>;
53+
ReactDOM.render(element, document.getElementById('root'));
54+
```
55+
56+
✅ COSÌ VA BENE:
57+
58+
```js
59+
// Esempio
60+
const element = <h1>Hello, world</h1>;
61+
ReactDOM.render(element, document.getElementById('root'));
62+
```
63+
64+
✅ ANCHE COSÌ:
65+
66+
```js
67+
// Esempio
68+
const element = <h1>Ciao mondo</h1>;
69+
ReactDOM.render(element, document.getElementById('root'));
70+
```
71+
72+
❌ COSÌ NO:
73+
74+
```js
75+
// Esempio
76+
const element = <h1>Ciao mondo</h1>;
77+
// "root" fa riferimento all'ID di un elemento.
78+
// NON TRADURLO
79+
ReactDOM.render(element, document.getElementById('radice'));
80+
```
81+
82+
❌ COSÌ DECISAMENTE NO:
83+
84+
```js
85+
// Esempio
86+
const elemento = <h1>Ciao mondo</h1>;
87+
ReactDOM.renderizza(elemento, documento.ottieniElementoDallId('radice'));
88+
```
89+
90+
## Link esterni
91+
92+
Se un link esterno punta ad un articolo di un riferimento come [MDN] o [Wikipedia], ed esiste una versione di quell'articolo nella tua lingua che sia di qualità soddisfacente, puoi valutare di linkare la versione tradotta dell'articolo invece di quella originale.
93+
94+
[MDN]: https://developer.mozilla.org/en-US/
95+
[Wikipedia]: https://en.wikipedia.org/wiki/Main_Page
96+
97+
Esempio:
98+
99+
```md
100+
React elements are [immutable](https://en.wikipedia.org/wiki/Immutable_object).
101+
```
102+
103+
✅ COSÌ VA BENE:
104+
105+
```md
106+
Gli elementi di React sono [immutabili](https://it.wikipedia.org/wiki/Struttura_dati_persistente).
107+
```
108+
109+
Per i link dei quali non esiste una versione tradotta (Stack Overflow, video di YouTube, ecc.), utilizza semplicemente il link in Inglese.

0 commit comments

Comments
 (0)