Skip to content

Commit

Permalink
Add ad-hoc translations and re-translate first 10 chapters
Browse files Browse the repository at this point in the history
  • Loading branch information
Occhioverde committed Oct 24, 2024
1 parent b7ebb24 commit 68eaf3f
Show file tree
Hide file tree
Showing 43 changed files with 2,688 additions and 3,123 deletions.
9 changes: 5 additions & 4 deletions gptmdt_settings.toml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,11 @@
gptmodel = "gpt-4o"

# The default prompt with an additional clause to avoid getting the source code (or examples' output) translated
sysprompt = "You shall translate the following markdown to Italian, preserving the existing formatting and avoiding any other output. Please refrain from translating anything inside a Markdown Code Block."
sysprompt = """
You shall translate the following markdown to Italian, preserving the existing formatting and avoiding any other output. \
Please refrain from translating anything inside a Markdown Code Block. \
The word \"Arm\" shall be replaced with \"Ramo\", \"Body of the function\" with \"Blocco\" while \"Scope\" (of a variable/lifetime) shall be kept as-is. \
"""

# List of domain-specific terms that GPT shouldn't translate
ignorelist = [
Expand Down Expand Up @@ -50,7 +54,6 @@ ignorelist = [
"Hello, world",
"Rustacean",
"Rustaceans",
"Scope",
"Failed",
"Guess",
"Unsigned",
Expand All @@ -65,8 +68,6 @@ ignorelist = [
"Wrapping",
"Wrapped",
"Wrap",
"Arm",
"Arms",
"Host",
"Swallow Copy",
"Deep Copy",
Expand Down
181 changes: 57 additions & 124 deletions src/ch00-00-introduction.md

Large diffs are not rendered by default.

4 changes: 2 additions & 2 deletions src/ch01-00-getting-started.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# Iniziare

Iniziamo il tuo viaggio con Rust! C'è molto da imparare, ma ogni viaggio inizia
da qualche parte. In questo capitolo, discuteremo:
da qualche parte. In questo capitolo, discuteremo di:

* Installare Rust su Linux, macOS e Windows
* Scrivere un programma che stampa `Hello, world!`
* Utilizzare `cargo`, il gestore di pacchetti e sistema di build di Rust
* Utilizzare `cargo`, il gestore dei pacchetti e il sistema di build di Rust
87 changes: 50 additions & 37 deletions src/ch01-01-installation.md
Original file line number Diff line number Diff line change
@@ -1,83 +1,90 @@
## Installazione

Il primo passo è installare Rust. Scaricheremo Rust tramite `rustup`, uno
strumento da linea di comando per gestire le versioni di Rust e gli strumenti associati. Avrai bisogno di una connessione internet per il download.
strumento da riga di comando per gestire le versioni di Rust e gli strumenti associati. Avrai bisogno
di una connessione internet per il download.

> Nota: Se preferisci non utilizzare `rustup` per qualche motivo, consulta la
> Nota: Se preferisci non usare `rustup` per qualche motivo, per favore consulta la
> [pagina Altri Metodi di Installazione di Rust][otherinstall] per altre opzioni.
I seguenti passi installano l'ultima versione stabile del compilatore Rust.
I seguenti passaggi installano l'ultima versione stabile del compilatore Rust.
Le garanzie di stabilità di Rust assicurano che tutti gli esempi nel libro che
compilano continueranno a compilare con le versioni più recenti di Rust. L'output potrebbe
variare leggermente tra le versioni poiché Rust spesso migliora i messaggi di errore e
di avvertimento. In altre parole, qualsiasi nuova versione stabile di Rust installata
seguendo questi passi dovrebbe funzionare come previsto con il contenuto di questo libro.
differire leggermente tra le versioni perché Rust spesso migliora i messaggi di errore e
avvisi. In altre parole, qualsiasi versione stabile più recente di Rust che installi utilizzando
questi passaggi dovrebbe funzionare come previsto con il contenuto di questo libro.

> ### Notazione della Linea di Comando
> ### Notazione della Riga di Comando
>
> In questo capitolo e in tutto il libro, mostreremo alcuni comandi usati nel
> terminale. Le righe che dovresti inserire in un terminale iniziano tutte con `$`. Non hai bisogno di digitare il carattere `$`; è il prompt della linea di comando mostrato per
> indicare l'inizio di ciascun comando. Le righe che non iniziano con `$` tipicamente
> In questo capitolo e in tutto il libro, mostreremo alcuni comandi utilizzati nel
> terminale. Le righe che dovresti inserire in un terminale iniziano tutte con `$`. Non
> è necessario digitare il carattere `$`; è il prompt della riga di comando mostrato per
> indicare l'inizio di ciascun comando. Le righe che non iniziano con `$` di solito
> mostrano l'output del comando precedente. Inoltre, gli esempi specifici di PowerShell
> useranno `>` anziché `$`.
> utilizzeranno `>` anziché `$`.
### Installare `rustup` su Linux o macOS
### Installazione di `rustup` su Linux o macOS

Se stai usando Linux o macOS, apri un terminale e inserisci il seguente comando:
Se utilizzi Linux o macOS, apri un terminale ed inserisci il seguente comando:

```console
$ curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf | sh
```

Il comando scarica uno script e avvia l'installazione dello strumento `rustup`,
che installa l'ultima versione stabile di Rust. Potresti essere invitato a
fornire la tua password. Se l'installazione è riuscita, verrà visualizzata la seguente riga:
che installa l'ultima versione stabile di Rust. Potrebbe essere richiesto di
inserire la tua password. Se l'installazione riesce, apparirà la seguente riga:

```text
Rust is installed now. Great!
```

Avrai anche bisogno di un *linker*, che è un programma che Rust utilizza per unire i suoi
output compilati in un unico file. È probabile che tu ne abbia già uno. Se ottieni
errori di linker, dovresti installare un compilatore C, che includerà tipicamente un
linker. Un compilatore C è anche utile perché alcuni pacchetti Rust comuni dipendono dal
codice C e avranno bisogno di un compilatore C.
Avrai bisogno anche di un *linker*, che è un programma che Rust utilizza per unire i
suoi output compilati in un unico file. È probabile che tu ne abbia già uno. Se ottieni
errori di linker, dovresti installare un compilatore C, che tipicamente includerà un
linker. Un compilatore C è utile anche poiché alcuni comuni pacchetti di Rust dipendono
dal codice C e avranno bisogno di un compilatore C.

Su macOS, puoi ottenere un compilatore C eseguendo:

```console
$ xcode-select --install
```

Gli utenti Linux dovrebbero generalmente installare GCC o Clang, in base alla
documentazione della loro distribuzione. Ad esempio, se usi Ubuntu, puoi installare il pacchetto `build-essential`.
Gli utenti Linux dovrebbero generalmente installare GCC o Clang, secondo la documentazione
della loro distribuzione. Ad esempio, se utilizzi Ubuntu, puoi installare il pacchetto `build-essential`.

### Installare `rustup` su Windows
### Installazione di `rustup` su Windows

Su Windows, vai a [https://www.rust-lang.org/tools/install][install] e segui
le istruzioni per installare Rust. Ad un certo punto dell'installazione, ti verrà chiesto di installare Visual Studio. Questo fornisce un linker e le librerie native necessarie per compilare i programmi. Se hai bisogno di ulteriore assistenza con questo passaggio, consulta [https://rust-lang.github.io/rustup/installation/windows-msvc.html][msvc]
Su Windows, vai su [https://www.rust-lang.org/tools/install][install] e segui
le istruzioni per installare Rust. Ad un certo punto nell'installazione, ti verrà
chiesto di installare Visual Studio. Questo fornisce un linker e le librerie native
necessarie per compilare i programmi. Se hai bisogno di ulteriore aiuto con questo passaggio, vedi
[https://rust-lang.github.io/rustup/installation/windows-msvc.html][msvc]

Il resto di questo libro utilizza comandi che funzionano sia in *cmd.exe* che in PowerShell.
Se ci sono differenze specifiche, spiegheremo quale usare.
Se ci sono differenze specifiche, spiegheremo quale utilizzare.

### Risoluzione dei Problemi

Per verificare se hai installato correttamente Rust, apri una shell e inserisci questa
Per verificare se hai installato correttamente Rust, apri una shell ed inserisci questa
riga:

```console
$ rustc --version
```

Dovresti vedere il numero di versione, l'hash del commit e la data del commit per l'ultima versione stabile rilasciata, nel seguente formato:
Dovresti vedere il numero di versione, l'hash del commit, e la data del commit per l'ultima
versione stabile che è stata rilasciata, nel seguente formato:

```text
rustc x.y.z (abcabcabc yyyy-mm-dd)
```

Se vedi queste informazioni, hai installato correttamente Rust! Se non vedi queste informazioni, verifica che Rust sia nella variabile di sistema `%PATH%` come segue.
Se vedi queste informazioni, hai installato Rust con successo! Se non vedi queste informazioni,
controlla che Rust sia nella tua variabile di sistema `%PATH%` come segue.

In CMD di Windows, usa:
In Windows CMD, usa:

```console
> echo %PATH%
Expand All @@ -95,31 +102,37 @@ In Linux e macOS, usa:
$ echo $PATH
```

Se tutto ciò è corretto e Rust non funziona ancora, ci sono vari posti dove puoi ottenere aiuto. Scopri come entrare in contatto con altri Rustaceans (un soprannome scherzoso che ci diamo) sulla [pagina della comunità][community].
Se tutto è corretto e Rust continua a non funzionare, ci sono diversi posti
dove puoi ottenere aiuto. Scopri come metterti in contatto con altri Rustaceans (un
soprannome scherzoso che ci chiamiamo) sulla [pagina della community][community].

### Aggiornamento e Disinstallazione

Una volta che Rust è installato tramite `rustup`, aggiornare a una versione rilasciata di recente è semplice. Dalla tua shell, esegui il seguente script di aggiornamento:
Una volta installato Rust tramite `rustup`, aggiornare ad una versione rilasciata di recente è
facile. Dal tuo shell, esegui il seguente script di aggiornamento:

```console
$ rustup update
```

Per disinstallare Rust e `rustup`, esegui il seguente script di disinstallazione dalla tua shell:
Per disinstallare Rust e `rustup`, esegui il seguente script di disinstallazione dal tuo
shell:

```console
$ rustup self uninstall
```

### Documentazione Locale

L'installazione di Rust include anche una copia locale della documentazione in modo che tu possa leggerla offline. Esegui `rustup doc` per aprire la documentazione locale nel tuo browser.
L'installazione di Rust include anche una copia locale della documentazione in modo
che tu possa leggerla offline. Esegui `rustup doc` per aprire la documentazione
locale nel tuo browser.

Ogni volta che un tipo o una funzione è fornita dalla libreria standard e non sei
sicuro di cosa faccia o di come usarla, usa la documentazione dell'interfaccia di programmazione delle applicazioni (API) per approfondire!
Ogni volta che un tipo o una funzione viene fornito dalla libreria standard e non sei
sicuro di cosa faccia o di come usarlo, usa la documentazione dell'interfaccia di programmazione
dell'applicazione (API) per scoprirlo!

[otherinstall]: https://forge.rust-lang.org/infra/other-installation-methods.html
[install]: https://www.rust-lang.org/tools/install
[msvc]: https://rust-lang.github.io/rustup/installation/windows-msvc.html
[community]: https://www.rust-lang.org/community

Loading

0 comments on commit 68eaf3f

Please sign in to comment.