Italian i18n

COLLABORATORS.md

@@ -31,3 +31,4 @@
 - [yous](https://github.com/yous)
 - [marocchino](https://github.com/marocchino)
 - [MJayJang](https://github.com/MJayJang)
+- [ginopc](https://github.com/ginopc)

i18n/it.json

@@ -0,0 +1,111 @@
+{
+  "install-npm": {
+    "verifying": "verifica che npm sia installato...",
+    "missing": "Sembra che npm non sia installato.",
+    "npm-problem": "Oh oh!  npm ha un problema!",
+    "version-verified": "Hai installato la versione {{version}}.  Grande!\nOra vediamo che l'ultima versione... attendi per questo...",
+    "latest-version": "L'ultimo npm e': {{version}}",
+    "upgrade": "Hai la versione {{version}}, ma l'ultima versione e' {{latest}}\nEsegui `npm install npm -g` per aggiornarla\n(Puoi anche saltare questo passo se vuoi)",
+    "success": "Congratulazioni!\nHai installato una versione recente di npm!"
+  },
+  "dev-environment": {
+    "err_workshopper": "Se,bra che tu sia nella root del workshopper.",
+    "err_home": "Sembra che tu sia nella tua home directory.",
+    "hint": "Questo non e' saggio. Crea una nuova dir, e usa quella.",
+    "no_package": "Sembra che il `package.json` sia mancante. Hai eseguito `npm init`?"
+  },
+  "login": {
+    "whoami_err": "Oh oh!\nSembra che qualcosa sia andato storto",
+    "logged_out": "Hmmm... Non vedo un login qui\nHai eseguito `npm adduser` per creare l'account?",
+    "success": "Congratulazioni, {{user}}!\nSei il fiero proprietario di un nuovo immaginario account npm!\nUsalo con saggezza.  Mai con rabbia.  Sempre per il Bene.\n\nDa questo dolce potere deriva molta responsabilita', che e'\nsufficientemente diverso da quello di Spiderman tanto che siamo fiduciosi che Marvel\nnon voglia farci causa.\n\nExcelsior!"
+  },
+  "start-a-project": {
+    "no_package": "Nessun package.json trovato.\nEsegui `npm init` nella tua directory di lavoro.",
+    "success": "Congratulazioni!\nHai creato un progetto!  Guarda il file package.json per vederlo.",
+    "extra_credit": "EXTRA CREDITI!  Ben Fatto."
+  },
+  "install-a-module": {
+    "error": "Oh oh!  Sembra che non sia installato correttamente.\L'errore che ho ottenuto era: \n{{{error}}}\nAssicurati di usare il comando `npm install @linclark/pkg`\nper installare il modulo `@linclark/pkg`.",
+    "success": "Congratulazioni! L'hai installato."
+  },
+  "listing-dependencies": {
+    "usage": "Esegui:\n`how-to-npm verify OK` se tutto è ok,\noppure:\n`how-to-npm verify NOT OK` altrimenti.",
+    "ok_not": "Spiacente, no.  Non tutto e' ok!\nProva ad eseguire `npm ls` e controllare gli errori.",
+    "not_ok_not": "Hmm...\nBene, potrebbe esserci qualcosa di molto sbagliato nel mondo,\nma il tuo package.json e la cartella node_modules vanno bene.",
+    "success": "Sembra che tu abbia sistemato il problema.  Fantastico!\nNota che `npm ls` e' is molto piu' calmo ora."
+  },
+  "npm-test": {
+    "section_missing": "Oops!  Non hai una sezione `scripts.test` nel tuo\nfile package.json.  Modificalo, e prova di nuovo.",
+    "running": "Eseguo il tuo script di test...",
+    "running_done": "...fatto!",
+    "error": "Oh oh!  Test fallito!\nProva a creare un test che effettivamente funzioni.",
+    "success": "Congratulazioni!  Hai scritto un test che passa!\nLa scrittura di un test che sia effettivamente BUONO viene lasciata ad un altra volta."
+  },
+  "package-niceties": {
+    "problem": "Non proprio!\nC'e' ancora un problema da correggere.",
+    "error": "Oh oh!\nSembra che qualcosa sia andato storto",
+    "success": "Elegante!\nUn pacchetto senza un file readme e qualche metadato e' come un\nmucchio di Javascript senza istruzioni o collegamenti al repo git."
+  },
+  "publish": {
+    "error": "Oh oh!\nSembra che tu non abbia pubblicato con successo il pacchetto\n  {{name}}\n.  Prova di nuovo!"
+  },
+  "version": {
+    "invalid_semver": "Sembra che il tuo package.json abbia una version non valida!\nUsa `npm help semver` per apprendere di piu' sulla numerazione di versione\nIl numero di versione attuale e': {{version}}\n",
+    "old_version": "Oh oh!\nLa version e' ancora {{version}}\nControlla `npm help version` per una utilita' a portata di mano per farlo.",
+    "success": "Buon lavoro!\nEsegui `how-to-npm` per la prossima eccitante sfida!"
+  },
+  "publish-again": {
+    "not_republished": "Hoops!\nSEmbra che tu non abbia pubblicato il pacchetto di nuovo\nProva ad eseguire `npm publish` e quindi verifica di nuovo.",
+    "current_missing": "Hmm... Vedo che hai pubblicato pie' di una volta, ma\nla versione corrente ({{version}}) non e' stata impostata.\nQuesto e' quello che vedo li':\n{{{found}}}\nProva a pubblicare di nuovo!",
+    "success": "Wow!  Sei sulla buona strada per diventare un normale \nTJames \"Substack\" Halidaychuk! Non c'e' niente che ti fermi!\nEsegui `how-to-npm` per andare al prossimo passo."
+  },
+  "dist-tag": {
+    "success": "Oh oh, sembra che tu abbia ancora un solo dist-tag.\nUsa `npm help dist-tag` per apprendere come aggiungerne un altro."
+  },
+  "dist-tag-removal": {
+    "too_many": "Oh oh, sembra che tu abbia qualche extra dist-tags qui.\nUsa `npm help dist-tag` per apprendere come rimuoverlo.",
+    "version_mismatch": "Oops!  Il tuo \"ultimo\" tag punta ancora alla release \npiu' recente, {{version}}.\nPunta da un altra parte, e esegui nuovamente  `how-to-npm verify`\n\nUsa `npm help dist-tag` per apprendere di piu' su come farlo."
+  },
+  "outdated": {
+    "no_package": "Esegui `how-to-npm verify PKG` ma sostituisci `PKG` con il nome\ndel pacchetto che e' meno recente",
+    "wrong_package": "No, non e' {{{pkg}}}.  Prova di nuovo!"
+  },
+  "update": {
+    "outdated": "Oops!  Stai ancora usando la versione meno recente!",
+    "success": "Eccezionale!  Sei aggiornato!\nEsegui `how-to-npm` per andare al prossimo esercizio"
+  },
+  "rm": {
+    "dependencies_left": "Sembra che ci sia ancora qualche dipendenza in giro",
+    "package_json_left": "Hai rimosso i file, ma non le relative registrazioni in package.json"
+  },
+  "finale": {
+    "todo": "Sembra che tu abbia altro lavoro da fare. Finisci\ngli esercizi seguenti prima che tu possa iniziare questo:"
+  },
+  "error": {
+    "not_setup": "Sembra che tu non sia ancora pronto per questo!\nTorna indietro alla lezione `01 Ambiente di Sviluppo` per impostare\nla tua directory di lavoro.",
+    "wrong_folder": "Oh oh!\nSembra he tu sia nella cartella sbagliata.\ncd in {{cwd}}\ne prova di nuovo"
+  },
+  "exercise": {
+    "00 Install npm": "00 Installa npm",
+    "01 Dev Environment": "01 Ambiente di sviluppo",
+    "02 Login": "02 Login",
+    "03 Start A Project": "03 Inizia un Progetto",
+    "04 Install A Module": "04 Installa un Modulo",
+    "05 Listing Dependencies": "05 Lista delle Dipendenze",
+    "06 npm Test": "06 Test npm",
+    "07 Package Niceties": "07 Sottigliezze del Pacchetto",
+    "08 Publish": "08 Pubblica",
+    "09 Version": "09 Versione",
+    "10 Publish Again": "10 Pubblica di Nuovo",
+    "11 Dist Tag": "11 Dist Tag",
+    "12 Dist Tag Removal": "12 Rimozione dei Dist Tag",
+    "13 Outdated": "13 Meno Recente",
+    "14 Update": "14 Aggiorna",
+    "15 Rm": "15 Rm",
+    "16 Finale": "16 Finale"
+  },
+  "menu": {
+    "reset-registry": "RESET DEL REGISTRO"
+  },
+  "reset": "Reset del registro terminato con successo"
+}

index.js

@@ -15,7 +15,7 @@ if (notifier.update) {
 var adventure = require('workshopper-adventure/adventure')
 var shop = module.exports = adventure({
   name: 'how-to-npm',
-  languages: ['en', 'es', 'ja', 'fr', 'ko'],
+  languages: ['en', 'es', 'ja', 'fr', 'ko', 'it'],
   appDir: __dirname,
   menu: {
     bg: 'white',

problems/00-install-npm/problem.it.txt

@@ -0,0 +1,19 @@
+Ciao, e benvenuto al laboratorio di avventura su npm! Ti chiederò
+di fare diverse cose con npm affinchè tu possa iniziare con esso
+facilmente.
+
+Alcuni comandi utili:
+
+npm help ............ Mostra l'aiuto di npm
+how-to-npm print .... Mostra nuovamente l'esercizio corrente
+how-to-npm verify ... Verifica che tu abbia finito un esercizio
+how-to-npm solution . Mostra la soluzione per l'esercizio corrente
+
+La prima cosa che faremo è assicurarci che la tua versione di npm
+sia aggiornata.
+
+Esegui `$ADVENTURE_COMMAND verify` una volta che hai terminato.
+
+(Questa è l'unica parte del laboratorio che necessita un accesso di rete.
+Se la rete non è disponibile, e tu vuoi saltare questo passo, puoi eseguire 
+`$ADVENTURE_COMMAND verify skip` per farlo.)

problems/00-install-npm/skip.it.txt

@@ -0,0 +1,4 @@
+Ok, se dici così...
+Puoi sempre installare l'ultimo e migliore npm usando
+`npm install npm -g`.  Potresti aver bisogno di eseguirlo 
+con `sudo` o come Amministratore.

problems/01-dev-environment/problem.it.txt

@@ -0,0 +1,15 @@
+Una delle cose più importanti che npm fa è installare pacchetti.
+
+Comunque, affinchè sia un buon programma di laboratorio, non vogliamo
+riempire di file il tuo computer, prima di fare qualsiasi altra cosa
+imposteremo un ambiente di sviluppo.
+
+Per primo, crea una nuova cartella e fai `cd` dentro essa.
+
+Quindi, esegui `npm init` per creare un file package.json. Ti verrà chiesto
+di rispondere ad un certo numero di domande. Puoi premere enter per accettare il
+valore di default per ciscuna domanda.
+
+Esegui `$ADVENTURE_COMMAND verify` una volta che hai terminato. Tutti gli atri
+comandi di questo tutorial dovrebbero essere eseguiti in questa cartella.
+

problems/01-dev-environment/success.it.txt

@@ -0,0 +1,8 @@
+Congratulazioni!
+Hai un ambiente di sviluppo.
+
+Da qui in poi, assicurati di eseguire il laboratorio in questa dir
+
+Si potrebbe notare che un file `.npmrc` verrà visualizzato li.
+Normalmente non sarebbe richiesto, ma il laboratorio lo usa per
+modellare le parti che normalmente dovrebbero comunicare con internet.

problems/02-login/problem.it.txt

@@ -0,0 +1,15 @@
+npm è meglio quando fai parte di esso. Si può iniziare creando
+un account.
+
+Poichè questo è solo un tutorial avventura didattica, ricorda,
+non stiamo creando *effettivamente* nessun account. Tuttavia, quando
+si esegue questo nel Mondo Reale, si creerà un account reale, con una
+pagina su npmks.com e la capacità di pubblicare pacchetti che vivono
+realmente e che gli esseri umani possono installare e godere.
+
+Per vedere come ti sei loggato, esegui `npm whoami`
+
+Per creare il tuo account, esegui `npm adduser`
+
+Provalo ora, e apri la porta ai tempi sempre più divertenti!
+Quindi esegui `$ADVENTURE_COMMAND verify`

problems/03-start-a-project/continue.it.txt

@@ -0,0 +1,7 @@
+Per extra crediti, prova a impostare anche questa dir come repository git.
+
+La convenzione è di avere un singolo repo git per ciscun modulo o progetto.
+Usa il comando `git init` per impostare la tua cartella di lavoro come un 
+progetto git.
+
+Quindi, esegui `how-to-npm verify extra credit`

problems/03-start-a-project/problem.it.txt

@@ -0,0 +1,9 @@
+npm ti aiuta a costruire progetti, ma affinchè npm sia capace a farlo,
+devi dirgli alcune cose sul tuo progetto. Puoi dire a npm qualcosa sul tuo
+progetti tramite un file chiamato package.json.
+
+Esegui `npm init --scope=<username>`, e rimpiazza <username> con l'utente
+che hai creato nella lezione precedente. Sarà creato un file package.json.
+(Per avere crediti extra, imposta il progetto anche con un repo git.)
+
+Esegui `$ADVENTURE_COMMAND verify` una volta che hai terminato.

problems/03-start-a-project/suggestion.it.txt

@@ -0,0 +1,5 @@
+Bene, hai tutto eccetto che la parte git.
+La convenzione è un repo git per modulo, quindi di solito
+dovresti eseguire `git init` nella root del tuo progetto.
+
+Rimuovi la cartella .git ovunque tu fossi, e esegui la `git init`

problems/04-install-a-module/problem.it.txt

@@ -0,0 +1,13 @@
+La prima cosa che fanno molte persone con npm è installare le dipendenze.
+
+Le dipendenze vengono ricavate dal registro, e spacchettate nella cartella
+`node_modules`.
+
+Per instlalare un modulo, usa il comando `npm install <nome_modulo>`.
+
+Il registro che stiamo usiamo per questo tutorial è una versione ridotta di
+quello su https://registry.npmjs.org. Quindi dovresti trovarci solo un
+piccolo numero di cose.
+
+Cominicia installando il modulo "@linclark/pkg".
+Esegui `$ADVENTURE_COMMAND verify` una volta che hai terminato.

problems/05-listing-dependencies/continue.it.txt

@@ -0,0 +1,21 @@
+Infatti, non tutto va bene qui su dep-landia.
+
+Le tue dipendenze dovrebbero essere elencate nel file package.json
+in un oggetto chiamato 'dependecies'. Tuttavia, quando abbiamo installato
+'@linclark/pkg', non abbiamo aggiornato il file package.json per esporre
+questa dipendenza.
+
+Perciò, egli viene mostrato come 'estraneo', avvisandoti che abbiamo qualcosa
+qui che non abbiamo elencato nella lista delle dipendenze.
+
+La strada più semplice per evitare questa situazione è usare il 
+parametro `--save` quando installiamo le dipendeze. Potrestri non voler fare questo
+con cose che stai solo provando, ma quando hai preso una decisione,
+puoi usare questo parametro per aggiornare semplicemente il file package.json.
+
+Prova ad eseguire `npm install @linclark/pkg --save` per installare il modulo, e aggiornare
+contemporaneamente il tuo file package.json.
+
+(Un altra opzione è quella di modificare package.json con un editor di testi)
+
+Quindi esegui `how-to-npm verify OK` una volta che hai corretto il problema.

problems/05-listing-dependencies/problem.it.txt

@@ -0,0 +1,10 @@
+npm non è solo per installare cose. Ti mostra anche quello che hai
+installato (le tue dipendenze).
+
+Puoi farlo usando il comando `npm ls`.
+
+Esegui questo comando nella tua dir di lavoro. Se c'è
+qualche problema npm ti avvisa restituendo un messaggio "!ERR".
+
+Se tutto risulta ok, esegui `$ADVENTURE_COMMAND verify OK`, oppure
+`$ADVENTURE_COMMAND verify NOT OK` se npm riporta un problema".

problems/06-npm-test/problem.it.txt

@@ -0,0 +1,32 @@
+Ora che hai installato qualcosa, e usato `npm ls` per vedere cosa sta succedendo.
+Se guardi il file package.json, ha questo pezzo piuttosto strano:
+
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+
+npm viene usato come un esecutore di attività con le sue proprietà "scripts".
+npm can be used as a task runner with its "scripts" property. Quasi ciascun
+modulo e progetto avrà una script di test che si esegue per essere certi che 
+tutto vada bene. Allo scopo di ricordarti di farlo, npm mette dentro un test che 
+"fallisce sempre" per default.
+
+Per prima cosa, crea un file chiamato`test.js`. Per i propositi del laboratorio
+puoi lasciarlo vuoto, ma questo dovrebbe essere il posto dove scriverai i tuoi test
+(questa è una classe npm, non una classe di test).  Il test deve uscire senza
+chiamare un errore, altrimenti il test fallisce.
+
+Quindi, edita il tuo file `package.json` per creare la tua sezione di script simile a
+questa:
+
+  "scripts": {
+    "test": "node test.js"
+  },
+
+Una volta che hai terminato, esegui `$ADVENTURE_COMMAND verify` per controllare il tuo lavoro.
+
+Info aggiuntive: se vuoi effettivamente eseguire qualche test che hai scritto in
+`test.js` con la script "test", devi eseguire `npm test`.
+
+Puoi trovare la documentazione per le proprietà delle script qui:
+https://docs.npmjs.com/misc/scripts

problems/07-package-niceties/problem.it.txt

@@ -0,0 +1,19 @@
+Quindi, abbiamo creato un file package.json, ma abbiamo scordato alcune cose
+che le persone spesso si aspettano. Se digiti `npm install`, vedrai qualcosa
+simile a questo:
+
+    npm WARN package.json %ID% No description
+    npm WARN package.json %ID% No repository field.
+    npm WARN package.json %ID% No README data
+
+Prima di condividere questo lavoro artistico con il mondo, abbiamo bisogno
+di farlo più raffinato la gente sappia come usarlo.
+
+Per prima cosa, creare un file README.md, con alcune parole in esso. 
+
+Quindi, aggiungi un campo "repository" nel tuo file package.json, con un url
+dove la gente può accedere al codice.
+
+Edita il file package.json a mano, oppure esegui nuovamente `npm init`.
+
+Esegui `$ADVENTURE_COMMAND verify` quando hai fatto.

problems/08-publish/problem.it.txt

@@ -0,0 +1,16 @@
+A cosa serve un gestore di pacchetti senza pacchetti?
+
+Non a molto.
+
+Fortunatamente, questo non è un problema per npm, perchè è molto semplice
+per tutti gli utenti di npm pubblicare i loro moduli a condividerli con il mondo.
+
+I pacchetti vengono inseriti nel registro usando il comando `npm publish`.
+
+Provalo ora. Non c'è molto altro da fare.
+
+(Assicurati però di essere ancora nella directory di progetto giusta. Se pubblichi
+qualcosa per errore, puoi rimuoverla, ma non c'è nessuna garanzia
+che nel frattempo nessuno la veda.)
+
+Quindi esegui `$ADVENTURE_COMMAND verify` quando hai terminato.

problems/08-publish/success.it.txt

@@ -0,0 +1,20 @@
+Per vedere il contenuto del tuo pacchetto, posso eseguire questo comando:
+
+  npm view %NAME%
+
+Esegui questo comando tu stesso per vedere cosa stampa.
+
+Il comando `npm view` è un ottimo metodo per vedere il dettaglio del pacchetto,
+per vedere quello che hai appena pubblicato, e per controllare se un nome è già impegnato.
+
+Ora che hai pubblicato il tuo primo pacchetto qui nella terra del finto
+npm, esci e scrivi una cosa reale da condividere con umani reali! 
+
+Non è necessario condividere solamente il codice con altre persone. Ci sono
+ulteriori benefici a separare il tuo codice in piccoli e gestibili pezzetti, 
+anche se li usi soltanto tu.
+
+Immagina che il tuo futuro e il tuo passato siano altri sviluppatori del
+tuo team.  
+
+Esegui `how-to-npm` andare alla prossima avventura!

problems/09-version/problem.it.txt

@@ -0,0 +1,33 @@
+Ogni pacchetto in npm ha un numero di versione associato ad esso.
+Quando rilasci un aggiornamento del tuo pacchetto, questo aggiornamento
+richiede un aggiornamento di versione.
+
+I numeri di versione seguono uno standard chiamato "SemVer" che sta per
+Version numbers in npm follow a standard called "SemVer".  This stands
+"Semantic Version" (Versione Semantica). La specifica per questo standard
+può essere trovata su http://semver.org.
+
+Il num di versione è simile a il seguente:
+
+  1.2.3
+  ^ ^ ^
+  | | `-- Versione Patch. Aggiornato per ogni modifica.
+  | `---- Versione Minore. Aggiornato per aggiunte alla API.
+  `------ Versione Maggiore. Aggiornato per modifiche importanti alla API.
+
+npm ha un comando speciale chiamato `npm version` con il quale aggiorna
+il tuo file package.json per te, e fa il commit delle modifiche a git se
+il tuo progetto è in un repository git. Puoi apprendere maggiormente su con `npm help version`.
+
+Oppure, se non ti fidi delle macchine, puoi aprire il tuo file package.json
+a mano, e inserire alcuni numeri nel campo versione.
+
+Il registro nom non lascia pubblicare un nuovo rilascio del tuo pacchetto
+senza che tu abbia aggiornato il numero di versione! Sempre! Perciò, 
+abituati all'idea di sostituire la versione ogni volta che vuoi pubblicare,
+anche se la modifica è di piccola entità.
+
+Non ti preoccupare, ci sono un sacco di interi, 
+Don't worry, there's a lot of integers, probabilmente non li esauriremo.
+
+Aggiorna ora il numero di versione, quindi esegui `$ADVENTURE_COMMAND verify` per controllare.

problems/10-publish-again/problem.it.txt

@@ -0,0 +1,10 @@
+Pubblicare qualcosa una volta va bene. Ma i pacchetti vitali
+devono essere pubblicati ancora e ancora con nuove e interessanti 
+correzioni.
+
+Non puoi usare nuovamente lo stesso numero di versione, perché così
+confondi tutti i robot che eseguono le routine che alimentano il 
+registro npm. Ora che abbiamo cambiato il numero della versione
+nell'ultimo esercizio, possiamo pubblicare nuovamente il pacchetto.
+
+Fallo! Quindi ottieni il tuo premio con `$ ADVENTURE_COMMAND verify`