The Modern JavaScript Tutorial in italiano
In questa repository viene pubblicata la traduzione italiana di https://javascript.info.
Ci piacerebbe rendere questo tutorial disponibile in molte lingue. Aiutaci a tradurlo.
Guarda il link https://github.com/javascript-tutorial/translate per maggiori dettagli.
Ci piacerebbe anche ricevere la vostra collaborazione nel tutorial.
Hai trovato un errore? Manca un argomento? Createlo voi, e inviate un PR 👏
Puoi modificare i file con un qualsiasi editor di testo. Il tutorial sfrutta il formato "markdown", molto facile da utilizzare. Potete anche testare in tempo reale le modifiche, utilizzando il server locale presente a questo link https://github.com/javascript-tutorial/server.
E' disponibile una lista di chi ha contribuito: https://javascript.info/about#contributors.
Un file inizia con # Title Header, e il testo è in formato Markdown, che può esserre modificato con un semplice editor di testo.
Eventuali risorse aggiuntive ed esempi utili per un articolo o esercizio, risiedono nella stessa cartella.
Consigli per la traduzione
Se volete tradurre un articolo vi chiedo di seguire questi semplici passi:
- Leggete tra gli issue quello denominato "Translate Progress".
- Scegliete l'articolo che desiderate tradurre e mettete la spunta.
- Create un issue per informare il gestore della repository sull'articolo scelto.
- Procedete con il fork della repository, traducete e infine infine inviate una PR (Pull Request).
Il vostro nome apparirĂ nella pagina "About project" quando la traduzione verrĂ pubblicata.
Esempi ed Esercizi
- I commenti possono essere tradotti
- Le variabili, classi o identificatori non devono essere assolutamente tradotte
- Assicuratevi che il codice funzioni dopo averlo tradotto
Esempio:
// Example const text = "Hello, world"; document.querySelector('.hello').innerHTML = text;
âś… GIUSTO (traduzione commento):
// Esempio const text = 'Ciao mondo'; document.querySelector('.hello').innerHTML = text;
❌ SBAGLIATO (traduzione classi):
// Esempio const testo = 'Ciao mondo'; // ".hello" è una classe // NON TRADURLO document.querySelector('.ciao').innerHTML = text;
Link esterni
Se trovate dei link esterni verso Wikipedia, esempio https://en.wikipedia.org/wiki/JavaScript, ed esiste la versione italiana, accertatevi che questa sia di qualitĂ prima di cambiare il link.
Esempio:
[JavaScript](https://en.wikipedia.org/wiki/JavaScript) is a programming language.
âś… OK (en -> it):
[JavaScript](https://it.wikipedia.org/wiki/JavaScript) è un linguaggio di programmazione.
Per i link verso MDN, che sono tradotti solo parzialmente, conviene utilizzare quelli originali.
Se un articolo linkato non possiede una versione italiana, allora mantenete quello originale.
Glossario dei termini
Alcuni termini utilizzati spesso:
- 'Summary' viene tradotto con 'Riepilogo'
- Il nome dei tipi come: 'primitives', 'string', 'object' viene tradotto ('primitivi', 'stringhe', 'oggetto') mantenendo tra parentesi la versione in lingua originale
♥
Ilya Kantor @iliakan