Skip to content

Commit

Permalink
Merge pull request #7 from yttrinis/main
Browse files Browse the repository at this point in the history
Italian translation for 'preface' and 'why nixos' + small fixes for en/whynixos.md
  • Loading branch information
DamitusThyYeetus123 authored Dec 5, 2024
2 parents 357a17d + 8604723 commit d705e82
Show file tree
Hide file tree
Showing 5 changed files with 62 additions and 2 deletions.
Empty file added src/content/docs/de/preface.md
Empty file.
Empty file added src/content/docs/de/whynixos.md
Empty file.
4 changes: 2 additions & 2 deletions src/content/docs/en/whynixos.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down Expand Up @@ -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.
Expand Down
27 changes: 27 additions & 0 deletions src/content/docs/it/preface.md
Original file line number Diff line number Diff line change
@@ -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!
33 changes: 33 additions & 0 deletions src/content/docs/it/whynixos.md
Original file line number Diff line number Diff line change
@@ -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.

0 comments on commit d705e82

Please sign in to comment.