rocky-linux · sspencerwire · Nov 5, 2022 · Nov 3, 2022 · Nov 3, 2022 · Nov 3, 2022
diff --git a/docs/books/admin_guide/03-commands.it.md b/docs/books/admin_guide/03-commands.it.md
@@ -66,9 +66,9 @@ Un'installazione di tipo workstation (con interfaccia grafica) avvia questa inte
 Una volta che l'utente è collegato a una console, la shell visualizza il **prompt** dei comandi. Quindi inizia un loop (ciclo infinito), con ogni stringa inserita:
 
 * visualizzazione del prompt dei comandi;
-* lettura del comando ;
-* analisi della sintassi ;
-* sostituzione di caratteri speciali ;
+* lettura del comando;
+* analisi della sintassi;
+* sostituzione di caratteri speciali;
 * esecuzione del comando;
 * visualizza il prompt dei comandi;
 * etc.

diff --git a/docs/books/admin_guide/03-commands.zh.md b/docs/books/admin_guide/03-commands.zh.md
@@ -43,7 +43,7 @@ update: 11-08-2021
 在 Linux系统中，用户是通过 `/etc/passwd` 文件中的以下条目定义的：
 
 * **登录名**，更普遍的叫法是 “用户名”，不含有空格；
-* 数字标识符 : **UID** (用户标识符)；
+* 数字标识符：**UID** (用户标识符)；
 * 用户组标识符：**GID** (用户组标识符)；
 * **命令解释器**（shell），不同用户可以不同；
 * **连接目录**，__家目录__。

diff --git a/docs/books/admin_guide/04-advanced-commands.it.md b/docs/books/admin_guide/04-advanced-commands.it.md
@@ -116,7 +116,7 @@ xargs
 use of xargs
 ```
 
-Il comando `xargs` attende un input dallo standard input **stdin**. Sono state inserite tre linee. La fine dell'ingresso dell'utente in `xargs` è specificato dalla sequenza di tasti <kbd>CTRL</kbd>+<kbd>D</kbd>. `xargs` esegue quindi il comando predefinito `echo` seguito dai tre argomenti corrispondenti all'ingresso dell'utente, vale a dire:
+Il comando `xargs` attende un input dallo standard input **stdin**. Sono state inserite tre linee. La fine dell'ingresso dell'utente in `xargs` è specificato dalla sequenza di tasti <kbd>CTRL</kbd>+<kbd>D</kbd>. `xargs` esegue quindi il comando predefinito `echo` seguito dai tre argomenti corrispondenti all'input dell'utente, vale a dire:
 
 ```
 $ echo "use" "of" "xargs"

diff --git a/docs/books/admin_guide/04-advanced-commands.zh.md b/docs/books/admin_guide/04-advanced-commands.zh.md
@@ -8,7 +8,7 @@ title: 高级Linux 命令
 
 ****
 
-**目标** : 在本章中，未来的Linux管理员将学习：
+**目标**：在本章中，未来的Linux管理员将学习：
 
 :heavy_check_mark: 上一章没有介绍的一些有用的命令；   
 :heavy_check_mark: 一些高级命令

diff --git a/docs/books/admin_guide/05-vi.zh.md b/docs/books/admin_guide/05-vi.zh.md
@@ -76,7 +76,7 @@ vim [-c command] [file]
 
     按 <kbd>ENTER</kbd> 键结束一行，但如果屏幕不够宽，VI 会自动换行，默认情况下为 _wrap_ 配置。 可能不需要这些换行符，可使用 _nowrap_ 配置。
 
-要退出 VI ，请从 command 模式中点击<kbd>:</kbd>，然后键入：
+要退出 VI ，请从 command 模式中按<kbd>:</kbd>，然后键入：
 
 * `q`不保存退出（_quit_）；
 * `w` 保存当前你的工作内容（_write_）；

diff --git a/docs/books/admin_guide/09-backups.it.md b/docs/books/admin_guide/09-backups.it.md
@@ -141,7 +141,7 @@ Un backup contiene in genere i seguenti elementi:
 * il nome;
 * il proprietario;
 * la dimensione;
-* i permessi;
+* le autorizzazioni
 * data di accesso.
 
 !!! Note "Nota"
@@ -204,7 +204,7 @@ $ tar cjf - /directory/to/backup/ | wc -c
 
 Ecco un esempio di convenzione di denominazione per un backup `tar`, sapendo che la data deve essere aggiunta al nome.
 
-| Opzioni | Files   | Suffisso         | Osservazione                                      |
+| chiavi  | Files   | Suffisso         | Osservazione                                      |
 | ------- | ------- | ---------------- | ------------------------------------------------- |
 | `cvf`   | `home`  | `home.tar`       | `/home` in modalità relativa, forma non compressa |
 | `cvfP`  | `/etc`  | `etc.A.tar`      | `/etc` in modalità assoluta, nessuna compressione |
@@ -283,7 +283,7 @@ $ tar cvzf backup.tar.gz dirname/
 
 !!! Note "Nota"
 
-    Mantenere invariate le opzioni `cvf` (`tvf` o `xvf`) per tutte le operazioni di backup e semplicemente aggiungere la chiave di compressione alla fine delle opzioni rende il comando più facile da capire (e.. `cvfz` o `cvfj`, ecc.).
+    Mantenere le chiavi `cvf` (`tvf` o `xvf`) invariate per tutte le operazioni di backup e aggiungere semplicemente la chiave di compressione alla fine delle chiavi rende il comando più facile da capire (ad esempio, `cvfz` o `cvfj`, ecc.).
 
 ##### Creazione di un backup compresso con `bzip`
 

diff --git a/docs/books/admin_guide/13-softwares.it.md b/docs/books/admin_guide/13-softwares.it.md
@@ -24,9 +24,9 @@ Su un sistema Linux, è possibile installare il software in due modi:
 
 **Il pacchetto**: si tratta di un singolo file contenente tutti i dati necessari per installare il programma. Può essere eseguito direttamente sul sistema da un repository software.
 
-**I file sorgente** : Alcuni software non sono forniti in pacchetti pronti per essere installati, ma tramite un archivio contenente i file sorgente. Spetta all'amministratore preparare questi file e compilarli per installare il programma.
+**I file sorgente**: Alcuni software non sono forniti in pacchetti pronti per essere installati, ma tramite un archivio contenente i file sorgente. Spetta all'amministratore preparare questi file e compilarli per installare il programma.
 
-## RPM : Gestione pacchetti RedHat
+## RPM: Gestione pacchetti RedHat
 
 **RPM** (RedHat Package Manager) è un sistema di gestione software. È possibile installare, disinstallare, aggiornare o controllare il software contenuto nei pacchetti.
 
@@ -132,7 +132,7 @@ httpd-filesystem.noarch             2.4.37-30.module_el8.3.0+561+97fdbbcc   @app
 httpd-tools.x86_64                  2.4.37-30.module_el8.3.0+561+97fdbbcc   @appstream
 ```
 
-## DNF : Dandified Yum
+## DNF: Dandified Yum
 
 **DNF** (**Dandified Yum**) è un gestore di pacchetti software, successore di **YUM** (**Y**ellow Dog **U**pdater **M**odified). Funziona con pacchetti **RPM** raggruppati in un repository locale o remoto (una directory per l'archiviazione dei pacchetti). Per i comandi più comuni, il suo utilizzo è identico a quello di `yum`.
 
@@ -568,7 +568,7 @@ Description  : This package contains the Extra Packages for Enterprise Linux
              : (EPEL) repository GPG key as well as configuration for yum.
 ```
 
-Il pacchetto, come puoi vedere dalla descrizione del pacchetto di cui sopra, non contiene eseguibili, librerie, ecc.. ma solo i file di configurazione e le chiavi GPG per la configurazione del repository.
+Il pacchetto, come puoi vedere dalla descrizione di cui sopra, non contiene eseguibili, librerie, ecc... ma solo i file di configurazione e le chiavi GPG per l'impostazione del repository.
 
 Un altro modo per verificare la corretta installazione è quello di interrogare il database rpm.
 

diff --git a/docs/books/nvchad/custom/plugins/init_lua.it.md b/docs/books/nvchad/custom/plugins/init_lua.it.md
@@ -0,0 +1,49 @@
+---
+title: init.lua
+author: Franco Colussi
+contributors: Steven Spencer, Franco Colussi
+tested with: 8.6, 9.0
+tags:
+  - nvchad
+  - coding
+  - editor
+---
+
+# `init.lua`
+
+Il file `custom/plugins/init.lua` chiude la configurazione di NvChad. È l'ultimo `init.lua` che viene letto e inserisce i nostri plugin aggiuntivi nella configurazione.
+
+La sua configurazione consiste nell'inserire i plugin nel seguente formato:
+
+```lua
+  ["github_username/plugin_name"] = {},
+```
+
+Se il plugin non necessita di configurazioni aggiuntive, la configurazione descritta sopra è sufficiente. Se sono necessarie ulteriori configurazioni, queste verranno inserite all'interno delle parentesi graffe.
+
+Prendiamo il nostro file di esempio:
+
+```lua
+return {
+  ["neovim/nvim-lspconfig"] = {
+    config = function()
+      require "plugins.configs.lspconfig"
+      require "custom.plugins.lspconfig"
+    end,
+    },
+  ["kdheepak/lazygit.nvim"] = {},
+  ['folke/which-key.nvim'] = { disable = false  },
+}
+```
+
+In questa configurazione abbiamo incluso solo i due plugin necessari *nvim-lspconfig* e *che-key*, più uno che non richiede alcuna configurazione aggiuntiva come esempio. I due plugin sono necessari perché senza la loro configurazione non avremo il supporto per gli LSP (server linguistici), anche se sono installati. La funzionalità di *which-key* è disabilitata per impostazione predefinita e vogliamo abilitarla qui.
+
+Come possiamo vedere, il primo plugin chiama la funzione di configurazione e legge prima il file `nvim/lua/plugins/configs/lspconfig.lua` e poi il *nostro* file `nvim/lua/custom/plugins/lspconfig.lua`. In questo caso viene utilizzato un file aggiuntivo per le configurazioni personali. La scelta dipende dal numero di modifiche da apportare.
+
+Il secondo è un esempio di plugin che non necessita di alcuna configurazione aggiuntiva. Una volta installato, consente di accedere alla gestione dei repository Git direttamente dall'editor con il comando <kbd>SHIFT</kbd> + <kbd>:LazyGit</kbd>. Per l'installazione di LazyGit si può fare riferimento alla pagina [Software aggiuntivo](../../additional_software.md).
+
+Il terzo è un esempio di inserimento delle configurazioni da sovrascrivere direttamente nel file. In questo caso, l'unica modifica è la riattivazione del plugin disattivato di default (which-key). Questo plugin è racchiuso da due apici singoli che possono sostituire gli apici doppi. Le due notazioni sono equivalenti.
+
+Una volta terminata la configurazione del file e di tutti i file di configurazione correlati, è necessario attivarli. A tal fine, è necessario uscire dall'editor, rientrare e quindi eseguire un comando <kbd>SHIFT</kbd> + <kbd>:PackerSync</kbd>.
+
+In breve possiamo dire che questo file è il motore di tutti i nostri plugin personali. È qui che viene configurata la maggior parte delle funzionalità aggiuntive del nostro IDE.
diff --git a/docs/books/nvchad/custom/plugins/lspconfig_lua.it.md b/docs/books/nvchad/custom/plugins/lspconfig_lua.it.md
@@ -0,0 +1,43 @@
+---
+title: Server Lingua
+author: Franco Colussi
+contributors: Steven Spencer, Franco Colussi
+tested with: 8.6, 9.0
+tags:
+  - nvchad
+  - coding
+  - editor
+---
+
+# lspconfig.lua
+
+Questo file di configurazione assegna le funzionalità definite in `nvim/lua/plugins/configs/lspconfig.lua` ai server linguistici installati con `Mason`. I server linguistici devono essere collocati nei server locali secondo questo formato:
+
+```lua
+local servers = { "html", "marksman", "yamlls"}
+```
+
+Come sottolineato in precedenza, non c'è bisogno di un supporto esplicito per Lua, in quanto è abilitato di default da NvChad; tuttavia, il _lua-language-server_ deve essere installato con _Mason_ per essere disponibile nell'IDE.
+
+Diamo quindi un'occhiata al nostro file `lspconfig.lua`:
+
+```lua
+local on_attach = require("plugins.configs.lspconfig").on_attach
+local capabilities = require("plugins.configs.lspconfig").capabilities
+
+local lspconfig = require "lspconfig"
+local servers = { "html", "marksman", "yamlls"}
+
+for _, lsp in ipairs(servers) do
+  lspconfig[lsp].setup {
+    on_attach = on_attach,
+    capabilities = capabilities,
+  }
+end
+```
+
+Le prime due istruzioni importano le funzioni `on_attach` e `capabilities` dal file `lspconfig.lua` di NvChad. Segue la configurazione dei server linguistici per fornire le funzionalità. Infine, viene richiamata la routine che associa le caratteristiche ai LSP impostati.
+
+Dopo la prima configurazione, è consigliabile uscire e rientrare nell'editor prima di eseguire <kbd>SHIFT</kbd> + <kbd>:PackerSync</kbd>. Le voci successive del server linguistico nella configurazione possono essere registrate con <kbd>SHIFT</kbd> + <kbd>:LspRestart</kbd> senza dover ricaricare la configurazione. La prossima volta che si apre un file supportato, verrà visualizzata un'icona in basso con l'LSP associato e il server linguistico utilizzato. Questo conferma che l'LSP funziona correttamente.
+
+Riassumendo, il file `lspconfig.lua` configura le funzionalità dei server che installiamo. È un file che, dopo la prima configurazione, non avrà bisogno di molte modifiche, finché scriveremo la documentazione in Markdown. Per ulteriori informazioni sul **L**anguage **S**erver **P**rotocol è possibile consultare la [pagina dedicata](../lsp.md).
diff --git a/docs/books/nvchad/custom/plugins/md_preview.it.md b/docs/books/nvchad/custom/plugins/md_preview.it.md
@@ -0,0 +1,103 @@
+---
+title: Anteprima Markdown
+author: Franco Colussi
+contributors: Steven Spencer, Franco Colussi
+tested with: 8.6, 9.0
+tags:
+  - nvchad
+  - coding
+  - editor
+---
+
+# markdown-preview.nvim
+
+Per scrivere documentazione Markdown con NvChad è essenziale conoscere i _tag_ del linguaggio, poiché l'editor, essendo basato sul testo, non dispone di una modalità WYSIWYG per la scrittura del documento. Questo può essere difficile durante le prime esperienze con l'editor e per aiutarsi può essere utile utilizzare un'anteprima del documento che si sta scrivendo. In questo modo è possibile verificare ciò che si è scritto e sperimentare con il codice Markdown durante l'apprendimento.
+
+Il plugin `iamcco/markdown-preview.nvim` consente di avere un'anteprima del documento in una pagina del browser che si aggiorna in tempo reale. L'anteprima fornisce un'eccellente rappresentazione di ciò che stiamo scrivendo, il che può certamente essere d'aiuto durante l'apprendimento del codice, ma può anche essere utile ai più esperti.
+
+## Software Richiesto
+
+Per funzionare correttamente, il plugin ha bisogno dei pacchetti [_Node.js_](https://nodejs.org/en/) (un ambiente runtime JavaScript open source e multipiattaforma) e [_yarn_](https://yarnpkg.com/) (un gestore di pacchetti JavaScript open source), entrambi installabili dai repository ufficiali di Rocky Linux. I pacchetti possono essere installati con il comando:
+
+```bash
+dnf install nodejs yarnpkg
+```
+
+Essi verranno utilizzati per installare i componenti JavaScript aggiuntivi necessari per il suo funzionamento durante la prima installazione e per gli aggiornamenti successivi.
+
+## Installazione
+
+L'installazione del plugin passa, come per tutti i plugin, da una modifica del file `custom/plugins/init.lua`. Il codice da inserire è il seguente:
+
+```lua
+  ["iamcco/markdown-preview.nvim"] = {
+    ft = { "markdown" },
+    run = "cd app && yarn install",
+  },
+```
+
+Analizzando il codice si può dire che la prima riga istruisce _Packer_ sul plugin da installare, la seconda specifica il tipo di file che deve essere caricato e la terza esegue una serie di comandi post-installazione. In particolare, l'opzione `run`, in questo caso, esegue il comando come un comando di shell (impostato nella variabile di sistema $SHELL). Il comando `run`, per impostazione predefinita, utilizza sempre la cartella dei plugin come origine, quindi in questo caso si posiziona nella cartella _app_ e successivamente esegue il comando `yarn install`.
+
+Una volta apportate le modifiche, occorre chiudere l'editor e riaprirlo. Questo per dare la possibilità di ricaricare la configurazione. Ora è possibile installare e configurare il _plugin_ con il comando `:PackerSync`.
+
+## Usare il plugin
+
+![Comandi di Anteprima](../../images/preview_commands.png){ align=right }
+
+Una volta installato, avremo a disposizione tre comandi per gestire l'anteprima. I comandi saranno attivi solo se abbiamo un file _markdown_ nel buffer e sono i seguenti:
+
+- **:MarkdownPreview** con questo comando viene avviata l'anteprima, viene aperta una pagina del browser predefinito e viene avviato un server _html_
+- **:MarkdownPreviewStop** il comando termina l'anteprima e la pagina del browser viene chiusa
+- **:MarkdownPreviewToggle** consente di passare dalla visualizzazione _chiara_ a quella _scura_
+
+L'anteprima viene chiusa anche se si chiude il buffer corrispondente (ad esempio, con <kbd>Spazio</kbd> + <kbd>x</kbd>).
+
+## Mappatura
+
+Il plugin può essere facilmente integrato in NvChad con una mappatura personalizzata. Per farlo, possiamo inserire il seguente codice nel file `custom/mapping.lua`:
+
+```lua
+M.mdpreview = {
+  n = {
+    ["<leader>pw"] = { "<cmd> MarkdownPreview<CR>", "Open Markdown Preview" },
+    ["<leader>px"] = { "<cmd> MarkdownPreviewStop<CR>", "Close Markdown Preview" },
+  },
+
+  i = {
+    ["<A-p>"] = { "<cmd> MarkdownPreview<CR>" },
+    ["<A-x>"] = { "<cmd> MarkdownPreviewStop<CR>" },
+  },
+}
+```
+
+Il primo array imposta le scorciatoie per la modalità NORMAL ( `n = {` ) e consente di selezionare i due comandi di _markdown-preview.nvim_ digitando <kbd>Spazio</kbd> + <kbd>p</kbd> seguito dalla lettera corrispondente al comando desiderato.
+
+![Anteprima della mappatura](../../images/preview_mapping.png)
+
+Il secondo array li imposta per la modalità INSERT ( `i = {` ), consentendo di attivarla durante la modifica del documento. Poiché in modalità INSERT il tasto <kbd>Spazio</kbd> non può essere utilizzato per la scorciatoia, abbiamo spostato il comando su <kbd>Alt</kbd>. Il tasto <kbd>Spazio</kbd> in modalità INSERT viene interpretato come uno spazio da inserire all'interno del documento e pertanto non può essere utilizzato nei collegamenti.
+
+Attiveremo quindi l'anteprima con la combinazione <kbd>Alt</kbd> + <kbd>p</kbd> e la chiuderemo con <kbd>Alt</kbd> + <kbd>x</kbd>.
+
+## Visualizzazione
+
+Gli sviluppatori del plugin hanno incluso due temi nel foglio di stile css utilizzato: uno chiaro e uno scuro. Per selezionare il tema desiderato c'è un pulsante nascosto in alto a destra della pagina. Portando il mouse in quella posizione, il pulsante dovrebbe apparire come mostrato nella schermata seguente.
+
+![Pulsante Anteprima](../../images/preview_dark.png)
+
+Selezionando il tema scuro si passa alla visualizzazione:
+
+![Anteprima Dark](../../images/preview_dark_on.png)
+
+Esiste anche la possibilità di utilizzare il proprio foglio di stile css per avere una visualizzazione il più possibile simile al documento che si sta scrivendo. Il percorso dei proprio _css_ deve essere impostato nella variabile `mkdp_markdown_css` e si può anche specificare il proprio file _css_ per l'evidenziazione del codice in `mkdp_highlight_css`. Entrambi i percorsi devono essere assoluti (es. /home/user/your_css.css).
+
+Per una modifica temporanea possiamo impostare il tema scuro direttamente in _NvChad_ inserendo il seguente comando nella statusline:
+
+```text
+:let g:mkdp_theme = 'dark'
+```
+
+## Conclusione
+
+Il plugin _iamcco/markdown-preview.nvim_ fornisce un'anteprima del documento markdown che stiamo scrivendo, consentendoci di verificare il risultato in tempo reale. I comandi possono essere facilmente integrati nella mappatura NvChad per un flusso di lavoro più rapido. Esiste anche la possibilità di personalizzare la visualizzazione dell'anteprima utilizzando il proprio foglio di stile css. Ulteriori informazioni sono disponibili nella [pagina del progetto](https://github.com/iamcco/markdown-preview.nvim).
+
+![Anteprima Laterale](../../images/markdown_preview_side.png)