diff --git a/COLLABORATORS.md b/COLLABORATORS.md index a9e4086..34c4927 100644 --- a/COLLABORATORS.md +++ b/COLLABORATORS.md @@ -29,4 +29,5 @@ - [eunsucking](https://github.com/eunsucking) - [yous](https://github.com/yous) - [marocchino](https://github.com/marocchino) -- [MJayJang](https://github.com/MJayJang) \ No newline at end of file +- [MJayJang](https://github.com/MJayJang) +- [ginopc](https://github.com/ginopc) diff --git a/i18n/it.json b/i18n/it.json new file mode 100644 index 0000000..bc8147e --- /dev/null +++ b/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" +} diff --git a/index.js b/index.js index 51ae980..cebd3ac 100755 --- a/index.js +++ b/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', 'zh-cn'], + languages: ['en', 'es', 'ja', 'fr', 'ko', 'zh-cn', 'it'], appDir: __dirname, menu: { bg: 'white', diff --git a/problems/00-install-npm/problem.it.txt b/problems/00-install-npm/problem.it.txt new file mode 100644 index 0000000..58c87dc --- /dev/null +++ b/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.) diff --git a/problems/00-install-npm/skip.it.txt b/problems/00-install-npm/skip.it.txt new file mode 100644 index 0000000..3d09217 --- /dev/null +++ b/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. diff --git a/problems/01-dev-environment/problem.it.txt b/problems/01-dev-environment/problem.it.txt new file mode 100644 index 0000000..f4c58d0 --- /dev/null +++ b/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. + diff --git a/problems/01-dev-environment/success.it.txt b/problems/01-dev-environment/success.it.txt new file mode 100644 index 0000000..59efb35 --- /dev/null +++ b/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. diff --git a/problems/02-login/problem.it.txt b/problems/02-login/problem.it.txt new file mode 100644 index 0000000..3c39822 --- /dev/null +++ b/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` diff --git a/problems/03-start-a-project/continue.it.txt b/problems/03-start-a-project/continue.it.txt new file mode 100644 index 0000000..34aada9 --- /dev/null +++ b/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` diff --git a/problems/03-start-a-project/problem.it.txt b/problems/03-start-a-project/problem.it.txt new file mode 100644 index 0000000..63ac9cc --- /dev/null +++ b/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=`, e rimpiazza 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. diff --git a/problems/03-start-a-project/suggestion.it.txt b/problems/03-start-a-project/suggestion.it.txt new file mode 100644 index 0000000..0ed86ab --- /dev/null +++ b/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` diff --git a/problems/04-install-a-module/problem.it.txt b/problems/04-install-a-module/problem.it.txt new file mode 100644 index 0000000..88512a5 --- /dev/null +++ b/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 `. + +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. diff --git a/problems/05-listing-dependencies/continue.it.txt b/problems/05-listing-dependencies/continue.it.txt new file mode 100644 index 0000000..e5e40a0 --- /dev/null +++ b/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. diff --git a/problems/05-listing-dependencies/problem.it.txt b/problems/05-listing-dependencies/problem.it.txt new file mode 100644 index 0000000..75e325d --- /dev/null +++ b/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". diff --git a/problems/06-npm-test/problem.it.txt b/problems/06-npm-test/problem.it.txt new file mode 100644 index 0000000..06a251e --- /dev/null +++ b/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 diff --git a/problems/07-package-niceties/problem.it.txt b/problems/07-package-niceties/problem.it.txt new file mode 100644 index 0000000..0c4d073 --- /dev/null +++ b/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. diff --git a/problems/08-publish/problem.it.txt b/problems/08-publish/problem.it.txt new file mode 100644 index 0000000..84350ae --- /dev/null +++ b/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. diff --git a/problems/08-publish/success.it.txt b/problems/08-publish/success.it.txt new file mode 100644 index 0000000..04fb887 --- /dev/null +++ b/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! diff --git a/problems/09-version/problem.it.txt b/problems/09-version/problem.it.txt new file mode 100644 index 0000000..b04ac3f --- /dev/null +++ b/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. diff --git a/problems/10-publish-again/problem.it.txt b/problems/10-publish-again/problem.it.txt new file mode 100644 index 0000000..ac2000c --- /dev/null +++ b/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` \ No newline at end of file diff --git a/problems/11-dist-tag/problem.it.txt b/problems/11-dist-tag/problem.it.txt new file mode 100644 index 0000000..9c73075 --- /dev/null +++ b/problems/11-dist-tag/problem.it.txt @@ -0,0 +1,26 @@ +Ogni pacchetto pubblicato in npm continene una voce `dist-tags` che +mappa stringhe simili a "latest" a numeri di versione simili a "1.2.48". + +Per default, la versione "latest" (ultima) è quella che viene installata. +Quando pubblichi, la versione corrente viene taggata come "latest". +Solitamente questo va bene, perchè la maggior parte delle volte +pubblichi cose quando sono pronte per essere usate dagli utenti. + +Tuttavia, se hai bisogno di pubblicare qualcosa, e non renderla +la versione di default di un pacchetto (per esempio se è una release +di sicurezza di una versione precedente, o qualcosa di simile), puoi +gestire manualmente questa distribuzione di tag con la funzione +`dist-tag`. + +`npm dist-tag add @ []` aggiungerà un +nuovo tag. +Per scoprire il nome del tuo attuale pacchetto/versione digita `npm ls`. +La prima riga di output saranno il pacchetto e la versione; es. pkg@1.0.1. +Per aggiungere un tag scrivi in nome del tag. + + npm dist-tag add pkg@1.0.1 beta + +Esegui `npm help dist-tag` per apprendere di più su questo argomento. + +Aggiungiamo un dist-tag nel tuo pacchetto, +e poi eseguiamo `$ADVENTURE_COMMAND verify` per verificarlo. diff --git a/problems/11-dist-tag/success.it.txt b/problems/11-dist-tag/success.it.txt new file mode 100644 index 0000000..ea81c5f --- /dev/null +++ b/problems/11-dist-tag/success.it.txt @@ -0,0 +1,8 @@ +Congratulazioni! Hai aggiunto un dist-tag! + +Questo è un metodo manuale per gestire i rilasci. Per esempio, lo stesso +progetto npm pubblica ogni nuova versione come 'next' (anzichè 'latest') +in modo che gli utenti delle beta possano testarle prima che diventino +versioni di default. + +Esegui `how-to-npm` per andare al prossimo esercizio. diff --git a/problems/12-dist-tag-removal/problem.it.txt b/problems/12-dist-tag-removal/problem.it.txt new file mode 100644 index 0000000..d030b9c --- /dev/null +++ b/problems/12-dist-tag-removal/problem.it.txt @@ -0,0 +1,12 @@ +Ora che hai aggiunto un dist-tag o due, puliamo le cose. + +L'unico dist-tag che NON PUOI mai rimuovere è "latest" (ultimo o più recente). Questo perché +ogni pacchetto installa per default il suo tag "latest", quindi questo tag ha +qualche semantica speciale. + +PUOI puntare "latest" a una versione diversa o eliminare altri tag. + +Eliminiamo tutti i tag che possiamo e puntiamo anche "latest" a +qualcosa di diverso dalla versione più recente. + +Esegui `npm help dist-tag` per saperne di più sul comando. diff --git a/problems/12-dist-tag-removal/success.it.txt b/problems/12-dist-tag-removal/success.it.txt new file mode 100644 index 0000000..d7f0f11 --- /dev/null +++ b/problems/12-dist-tag-removal/success.it.txt @@ -0,0 +1,3 @@ +Congratulazioni! Sei un professionista del dist-tagging! + +Esegui `how-to-npm` per andare al prossimo esericizio. diff --git a/problems/13-outdated/problem.it.txt b/problems/13-outdated/problem.it.txt new file mode 100644 index 0000000..42f85ac --- /dev/null +++ b/problems/13-outdated/problem.it.txt @@ -0,0 +1,12 @@ +Ora che hai qualche dipendenza, e hai imparato che i tuoi pacchetti +possono essere aggiornati ripetutamente, la domanda ovvia è: cosa +dobbiamo fare quando qualcun *altro* aggiorna il *suo* pacchetto? + +Il primo passo è rilevarlo. Grazie al nostro modo di definire +le nostre dipendenze con una gamma di versioni, e che +ciascuna release è una combinazione unica di un nome e di +una versione, rileviamo programmaticamente rilasci compatibili +con il comando `npm outdated`. + +Per superare questa sfida, esegui `$ADVENTURE_COMMAND verify PKG` +dove `PKG` è il nome del pacchetto che è da aggiornare. diff --git a/problems/13-outdated/success.it.txt b/problems/13-outdated/success.it.txt new file mode 100644 index 0000000..d6415b7 --- /dev/null +++ b/problems/13-outdated/success.it.txt @@ -0,0 +1,9 @@ +Questo è assolutamente corretto! Il pacchetto `@linclark/pkg` +ha avuto un aggiornamento nel frattempo che non stavamo +guardando. +That's absolutely right! The `@linclark/pkg` package has had an update while +we weren't looking. + +Nella prossima lezione, impareremo come aggiornare i pacchetti +che non lo sono. + diff --git a/problems/14-update/problem.it.txt b/problems/14-update/problem.it.txt new file mode 100644 index 0000000..bcaeb0c --- /dev/null +++ b/problems/14-update/problem.it.txt @@ -0,0 +1,13 @@ +Va bene, ovviamente, verificare esplicitamente i moduli scaduti, +eseguendo poi `npm install` per tirarli dentro. + +Tuttavia, se vuoi essere un pò più raffinato su questo, c'è un +comando npm speciale che aggiornerà tutte le tue dipendenze alla +versione maggiore che è disponibile nel tuo package.json. + +Indovini quale comando potrebbe essere? (`npm help` potrebbe aiutarti) + +Aggiorna tutte le tue dipendenze all'ultima versione possibile, quindi +esegui `$ADVENTURE_COMMAND verify` per raccogliere la tua deliziosa +bandiera verde. + diff --git a/problems/15-rm/problem.it.txt b/problems/15-rm/problem.it.txt new file mode 100644 index 0000000..17dbad8 --- /dev/null +++ b/problems/15-rm/problem.it.txt @@ -0,0 +1,15 @@ +Se hai un modo per mettere le cose lì, naturalmente, avrai +bisogno un giorno di un modo per cancellarle. + +Inserisci il comando `npm rm` (alias `npm uninstall` se preferisci +digitare a lungo). + +Rimuovi tutte le dipendenze! Ma, assicurati di non tenere cose dipendendi da queste. + +Allo stesso modo in cui usi `--save` per installare i pacchetti, puoi anche +usare `--save` quando li rimuovi, per eliminare anche queste dal +tuo file package.json + +Quando hai rimosso le tue dipendenze, digita `$ADVENTURE_COMMAND verify` per +passare avanti. + diff --git a/problems/15-rm/success.it.txt b/problems/15-rm/success.it.txt new file mode 100644 index 0000000..c76e137 --- /dev/null +++ b/problems/15-rm/success.it.txt @@ -0,0 +1,6 @@ +Eccezionale! Hai rimosso i pacchetti dalla tua cartella node_modules +e anche aggiornato il tuo file package.json per riflettere il fatto +che non dipendi più da questi. + +Ben fatto. + diff --git a/problems/16-finale/problem.it.txt b/problems/16-finale/problem.it.txt new file mode 100644 index 0000000..4c9cafd --- /dev/null +++ b/problems/16-finale/problem.it.txt @@ -0,0 +1,6 @@ + +E' quasi il momento di salutarci. Ma non ti preoccupare! Questa è +solo un'introduzione. Se hai finito tutti gli altri esercizi, esegui +`$ADVENTURE_COMMAND verify` per imparare i prossimi passi al di là +di questo piccolo laboratorio. + diff --git a/problems/16-finale/success.it.txt b/problems/16-finale/success.it.txt new file mode 100644 index 0000000..592d1ea --- /dev/null +++ b/problems/16-finale/success.it.txt @@ -0,0 +1,15 @@ +C'è ANCORA MOLTO ALTRO che npm può fare. Alcune delle cose che non abbiamo +il tempo di coprire in questo modesto e piccolo laboratorio includono: + +1. Dividere la tua app in più moduli +2. Condividere codice privato con compagni di squadra usando l'ambito dei moduli +3. Altri divertenti comandi, come `edit` e `bugs` e `explore`! + +E' possibile saperne di più su tutte le cose divertenti che tu e npm +potete avere in comune. Tutto inizia con la cosa: "Ci dovrebbe essere +un modulo che fa questo..." + +La tua avventura sta aspettando te su https://www.npmjs.com/ + +Ci vediamo su internet! +