From 613c6ceeff9c8ddd2cfd021eae34e184115d4f5d Mon Sep 17 00:00:00 2001 From: yttrinis <171431080+yttrinis@users.noreply.github.com> Date: Thu, 5 Dec 2024 10:53:46 +0100 Subject: [PATCH 1/2] Italian translation for 'preface' and 'why nixos' --- src/content/docs/de/preface.md | 0 src/content/docs/de/whynixos.md | 0 src/content/docs/it/preface.md | 27 +++++++++++++++++++++++++++ src/content/docs/it/whynixos.md | 33 +++++++++++++++++++++++++++++++++ 4 files changed, 60 insertions(+) create mode 100644 src/content/docs/de/preface.md create mode 100644 src/content/docs/de/whynixos.md create mode 100644 src/content/docs/it/preface.md create mode 100644 src/content/docs/it/whynixos.md diff --git a/src/content/docs/de/preface.md b/src/content/docs/de/preface.md new file mode 100644 index 0000000..e69de29 diff --git a/src/content/docs/de/whynixos.md b/src/content/docs/de/whynixos.md new file mode 100644 index 0000000..e69de29 diff --git a/src/content/docs/it/preface.md b/src/content/docs/it/preface.md new file mode 100644 index 0000000..d4684fe --- /dev/null +++ b/src/content/docs/it/preface.md @@ -0,0 +1,27 @@ +--- +title: Prefazione +--- + +Ammettiamolo, la documentazione di NixOS è un disastro. + +Guardando ad altre distribuzioni con curve di apprendimento ripide, come Gentoo o Arch, la documentazione è di livello banale. Arch, in particolare, ha fatto un lavoro fantastico nel fornire una documentazione chiara e concisa. Al tal punto che gli utenti di altre distribuzioni spesso guardano l'Arch-Wiki per trovare le informazioni di cui hanno bisogno. Anche il wiki di Gentoo, sebbene meno popolare, è molto dettagliato. + +NixOS, con una curva di apprendimento ancora più ripida, ha ovviamente bisogno di una documentazione che sia altrettanto approfondita, utile ed estesa come quella delle altre distibuzioni "avanzate". Il fatto che non lo sia, rende l'apprendimento di NixOS un'impresa al limite dell'erculeo per qualsiasi utente inesperto che voglia provarla. + +Il [wiki ufficiale](https://wiki.nixos.org) è carente. Sebbene i wiki siano un formato popolare per catalogare molte informazioni su un unico sito, il wiki di NixOS permette a chiunque di contribuire. Riteniamo che questo modello funzioni efficacemente solo per piattaforme come Wikipedia, che hanno una base di editori sorprendentemente ampia. Per uno dei sistemi operativi più di nicchia del pianeta, un wiki che si affida al crowdsourcing è destinato ad avere imprecisioni, informazioni superficiali e, in linea generale, uno sviluppo meno efficace. + +Naturalmente, NixOS dispone anche di un [manuale](https://nixos.org/manual/nixos/stable/). Il manuale è ottimo: le informazioni vengono aggiornate rapidamente e una pull request approvata dal team di documentazione di NixOS rappresenta un metodo efficace per apportare modifiche. + +Tuttavia, il manuale non è privo di problemi. Non copre funzionalità "sperimentali" dell'ecosistema Nix, come i ampiamente utilizzati "Flakes" o la correlata interfaccia a riga di comando (CLI). In quanto tale, non potrà mai essere un documento veramente completo. Inoltre, la sua struttura a pagina singola rende la lettura faticosa ed è piuttosto difficile per i nuovi utenti comprenderne i contenuti. + +Esiste anche molta documentazione di terze parti, ma è spesso [obsoleta](https://nixos.wiki) o difficile da leggere per un nuovo utente. + +Sebbene noi del NUG siamo consapevoli del rischio di contribuire a una [proliferazione di standard](https://xkcd.com/927/), riteniamo di avere la capacità e la volontà di creare una documentazione che sia facile da usare, comoda da leggere e che copra tutte le aree di NixOS che gli utenti desiderebbero conoscere. + +Pertanto, siamo orgogliosi di presentarvi il nostro manual ufficiale: Sherpa. + +Chiamato così in onore degli Sherpa del Nepal, noti per le loro abilità alpinistiche. E come guida sulle montagne, il manuale Sherpa è la tua guida per esplorare il mondo di NixOS! + +Il nostro obiettivo di design per Sherpa è semplice: un nuovo utente, con zero conoscenze di programmazione e/o Nix, dovrebbe essere in grado di leggerlo e comprenderlo abbastanza da usare NixOS in modo fluido. Sebbene non possiamo garantire che questo obiettivo sia sempre pienamente raggiunto, ci impegniamo constantemente a migliorare e sviluppare ulteriormente lo stato della documentazione in NixOS. + +Benvenuti in NixOS; vi auguriamo buona fortuna nel vostro viaggio sulle montagne! diff --git a/src/content/docs/it/whynixos.md b/src/content/docs/it/whynixos.md new file mode 100644 index 0000000..fc75008 --- /dev/null +++ b/src/content/docs/it/whynixos.md @@ -0,0 +1,33 @@ +--- +title: Perché usare Nix/NixOS? +--- + +Una domanda ragionevole! Perché usare tutto questo? Perché abbandonare tutto ciò che sai su Linux e adottare questo sistema operativo di nicchia? Per capire, dobbiamo prima esaminare i vantaggi di Nix, il potente [sistema di gestione dei pacchetti](https://it.wikipedia.org/wiki/Sistema_di_gestione_dei_pacchetti) su cui è basato NixOS. + +Vantaggi di Nix: + +- **Il Nix Store**: Nix archivia tutti i pacchetti in una cartella speciale chiamata "nix store", che si trova nella directory /nix. Nel nix store, un pacchetto viene costruito insieme alle sue dipendenze e archiviato come un hash. Lo store è a sola lettura, il che significa che non è possibile modificarlo senza comandi specifici, _nemmeno come root_! +- **Aggiornamenti atomici**: quando i pacchetti installati con Nix devono essere aggiornati, Nix non consente che l'aggiornamento avvenga a meno che tutti i pacchetti non vengano aggiornati con successo. Questo elimina la possibilità di ritrovarsi con pacchetti danneggiati. Se un pacchetto non riesce ad essere compilato, basta aspettare il prossimo aggiornamento! Questo di solito richiede solo pochi giorni, durante i quali il tuo sistema sarà completamente funzionante. +- **Compilazioni riproducibili**: quando Nix compila un pacchetto, otterrà sempre ed esattamente lo stesso risultato su qualsiasi sistema su cui viene compilato. +- **Un unico gestore di pacchetti per domarli tutti**: stanco di usare NPM, pip, AUR e tutti gli altri gestori di pacchetti? Anche noi! Ecco perché siamo molto felici di dirvi che Nix ha oltre 100.000 pacchetti pronti per l’installazione ed è il gestore di pacchetti più aggiornato in circolazione! Ci piace pensarlo come la Regola 34 dei gestori di pacchetti: se esiste, è in nixpkgs. E se non c'è, sarà aggiunto. +- **Ottimo per lo sviluppo**: lo sviluppo è uno dei motivi principali dell'esistenza di Nix! Con strumenti come "direnv", creare ambienti di sviluppo è facile e beneficia di tutto ciò che Nix offre. +- **Provare pacchetti senza installarli con `nix shell` o `nix run`**: hai mai voluto provare un programma di, per esempio, KDE? Su altri sistemi, questo richiede di installare completamente tutte le dipendenze di KDE. Poi, se non ti piace il programma e lo disinstalli, quelle dipendenze rimangono sul sistema. Con i comandi sopra, invece, puoi provare rapidamente qualsiasi programma ti piaccia. E se no sei soddisfatto, nessun problema! Non resteranno sul tuo sistema quando li rimuovi. +- **Utilizza cache binarie**: Nix compila automaticamente i pacchetti nel suo repository in remoto, quindi compilare manualmente qualsiasi cosa presente in nixpkgs è inutile! E se hai bisogno di una cache binaria per il tuo programma, puoi configurarla facilmente. +- **Portatile**: Nix funziona ovunque: Linux, MacOS, WSL, e c'è persino un progetto chiamato nix-on-droid che ti consente di usarlo su Android. +- **Mischiare diverse versioni di pacchetti senza conflitti**: poiché i pacchetti vengono compilati in modo indipendente, dipendenze incluse, puoi avere più versioni di un pacchetto - tutti installati contemporaneamente! Non c'è nulla da configurare, funziona così di default. + +Quindi, ora che sai perché dovresti usare Nix, perché usare NixOS? + +Vantaggi di NixOS: + +- **Configurazione dichiarativa**: la caratteristica centrale di NixOS, oltre al gestore di pacchetti, è il sistema di moduli. I moduli sono essenzialmente opzioni predefinite. Nella tua configurazione di NixOS, puoi fare riferimento a uno dei migliaia di moduli che NixOS offre per le applicazioni. Questo offre due vantaggi: + - **_Configurazione facile_**: dimentica i giorni in cui configuravi manualmente i servizi o usavi Docker. Con NixOS, se esiste un modulo, puoi configurare tutto questo con poche righe di codice. + - **_Manutenzione semplificata_**: dato che la configurazione è composta da poche righe di codice e si trova sempre nella stessa directory, non è necessario eseguire una moltitudine di comandi complessi per risolvere problemi. Basta cambiare alcuni valori nella configurazione di NixOS. +- **Sistema riproducibile**: questa è una delle caratteristiche principali di NixOS: portare la riproducibilità di Nix al livello del sistema operativo. Puoi fare il backup della tua configurazione in un repository Git e utilizzarla su quanti computer desideri, ottenendo sempre lo stesso sistema operativo, esclusa la tua /home directory. Questo semplifica enormemente i backup. +- **Rollback integrati**: un'altra caratteristica distintiva di NixOS (e di qualsiasi distribuzione immutabile). C'è un problema con il tuo sistema attuale? Nessun problema! Puoi tornare facilmente a una configurazione precedente. +- **Opzioni di configurazione per molti programmi e servizi**: ci sono migliaia di moduli e opzioni in NixOS, tutti scritti in un unico linguaggio. +- **Privo di effetti collaterali - Rimuove effettivamente i pacchetti e le loro dipendenze**: poiché le dipendenze vengono installate e archiviate con i pacchetti che le richiedono, nessuna dipendenza resterà inutilizzata quando rimuovi un pacchetto. E qualsiasi directory del nix store non necessaria può essere ripulita con il comando `nix-collect-garbage`. +- **Facile configurazione di macchine virtuali**: puoi configurare QEMU/KVM facilmente utilizzando un modulo. Non più problemi con systemd o interfacce grafiche ingombranti. Nix può fare tutto! +- **Testare altre configurazioni**: ricordi `nix shell` e `nix run`? Entrambi questi comandi possono anche costruire configurazioni da un URL. Basta indicare il repository Git dove si trova la configurazione e Nix farà il resto. + +Se uno di questi vantaggi ti sembra interessante, passa alla pagina successiva per scoprire come installare NixOS sul tuo computer. From e8bae697167b30696d2dbb78fdaa12d803e72c48 Mon Sep 17 00:00:00 2001 From: yttrinis <171431080+yttrinis@users.noreply.github.com> Date: Thu, 5 Dec 2024 10:58:45 +0100 Subject: [PATCH 2/2] fixed small errors --- src/content/docs/en/whynixos.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/content/docs/en/whynixos.md b/src/content/docs/en/whynixos.md index 4b81fcc..c4f6d1b 100644 --- a/src/content/docs/en/whynixos.md +++ b/src/content/docs/en/whynixos.md @@ -23,7 +23,7 @@ Nix advantages: same result on any system that package is built on. - **Single package manager to rule them all**: tired of using NPM, pip, the AUR, and all these other package managers? We were too! That's why we are very - happy to say that Nix has more than 80,000 packages to install, amd is the + happy to say that Nix has more than 100,000 packages to install, and is the most up-to-date package manager in existence! We like to think of it as the Rule 34 of package managers: if it exists, it's in nixpkgs. If it isn't in nixpkgs, it will be added. @@ -54,7 +54,7 @@ NixOS advantages: - **Declarative configuration**: the central feature of NixOS, other than the package manager, is the module system. Modules are pretty much a fancy term for options. In your NixOS configuration, you can reference one of the - thousands of modules NixOS has for applications. This has three advantages: + thousands of modules NixOS has for applications. This has two advantages: - **_Easy configuration_**: Gone are the days of setting up services manually or using docker containers. With NixOS, as long as the module exists, you can do all of that with a few lines of code.