Merge pull request #15 from PyGera/main

Start of Italian

Author: Orta Therox

docs/tsconfig/it/intro.md

@@ -0,0 +1,5 @@
+## Introduzione alla TSConfig Reference
+
+Un file TSConfig in una cartella indica che la cartella in questione è la root di un progetto TypeScript o JavaScript. Il file TSConfig può essere sia un `tsconfig.json` che `jsconfig.json`, entrambi hanno la stessa forma e le stesse variabili di configurazione.
+
+Questa pagina copre tutte le diverse variabili disponibili in un file TSConfig. Esso inizia con un introduzione su ogni variabile, poi si addentra negli attributi principali del file JSON, poi prosegue con il `compilerOptions` che comprende la maggior parte delle opzioni e delle conclusioni con `watchOptions`.

docs/tsconfig/it/options/allowJs.md

@@ -0,0 +1,39 @@
+---
+display: "Consentire JS"
+oneline: "Consentire di importare i file .js"
+---
+
+Si può consentire ai file JavaScript di poter essere importati nel tuo progetto TypeScript. Per esempio, questo file JS:
+
+```js twoslash
+// @filename: carta.js
+export const seme = 'Cuori';
+```
+
+Quando lo importi in un file TypeScript ti uscirà un errore:
+
+```js twoslash
+// @errors: 2307
+// @filename: carta.js
+module.exports.seme = "Cuori";
+// ---cut---
+// @filename: index.ts
+import { seme } from "./carta";
+
+console.log(seme);
+```
+
+Ma verrà importato senza errori con `allowJs` abilitato:
+
+```js twoslash
+// @filename: carta.js
+module.exports.seme = "Cuori";
+// ---cut---
+// @allowJs
+// @filename: index.ts
+import { seme } from "./carta";
+
+console.log(seme);
+```
+
+Questa opzione può essere usata come metodo per aggiungere file TypeScript in progetti JS permettendo ai file `.ts` e `.tsx` di coesistere con i file JavaScript esistenti.

docs/tsconfig/it/options/checkJs.md

@@ -0,0 +1,40 @@
+---
+display: "Controllo JS"
+oneline: "Eseguire o verificare i tipi nel file .js del progetto"
+---
+
+Funziona insieme a `allowJs`. Quando `checkJs` è abilitato gli errori sono segnalati all'interno del file JavaScript. Questo sarebbe l'equivalente di includere `// @ts-check` all'inizio di ogni file JavaScript che è incluso nel tuo progetto.
+
+Per esempio, questo codice JavaScript è errato secondo la definizione del tipo `parseFloat` che è presente su TypeScript:
+
+```js
+// parseFloat riceve solo una stringa
+module.exports.pi = parseFloat(3.124)
+```
+
+Quando viene importato in un modulo TypeScript:
+
+```ts twoslash
+// @allowJs
+// @filename: costanti.js
+module.exports.pi = parseFloat(3.124);
+
+// @filename: index.ts
+import { pi } from "./costanti";
+console.log(pi);
+```
+
+Non verranno segnalati errori. Tuttavia, se abiliti `checkJs` riceverai un messaggio di errore dal file JavaScript.
+
+```ts twoslash
+// @errors: 2345
+// @allowjs: true
+// @checkjs: true
+// @filename: costanti.js
+module.exports.pi = parseFloat(3.124);
+
+// @filename: index.ts
+import { pi } from "./costanti";
+console.log(pi);
+```
+

docs/tsconfig/it/options/composite.md

@@ -0,0 +1,16 @@
+---
+display: "Componi"
+oneline: "Usato per creare varie build dello stesso progetto"
+---
+
+L'opzione `composite` applica delle regole che permettono agli strumenti di build (incluso Typescript stesso, sotto `--build` mode) di determinare velocemente se un progetto è già stato compilato.
+
+Quando esso è attivato:
+
+- L'opzione `rootDir`, se non impostata esplicitamente, imposta in modo predefinito la cartella in cui si trova il `tsconfig.json` file.
+
+- Tutti i file implementati devono corrispondere ad un `include` o devono essere indicati nell'array `files`.  Se questa regola non viene rispettata, `tsc` ti informerà su quali file non sono stati specificati.
+
+- `declaration` è predefinito su `true`
+
+Puoi trovare la documentazione sui progetti TypeScript nella [guida](https://www.typescriptlang.org/docs/handbook/project-references.html).

docs/tsconfig/it/options/declaration.md

@@ -0,0 +1,32 @@
+---
+display: "Dichiarazione"
+oneline: "Creazione di file d.ts per gestire le importazioni di un progetto"
+---
+
+Si possono creare dei file `.d.ts` per ogni file TypeScript o JavaScript all'interno del tuo progetto. 
+Questi file `.d.ts` contengono delle definizioni dei file che descrivono l'API esterna al tuo modulo. 
+Con i file `.d.ts`, strumenti come TypeScript possono dare intellisense e suggerimenti sui tipi per il codice senza tipo.
+
+Quando `declaration` è impostato su `true`, eseguendo il compilatore con questo codice TypeScript:
+
+```ts twoslash
+export let ciaoMondo = "Ciao!";
+```
+
+Esso genererà un file `index.js` come questo:
+
+```ts twoslash
+// @showEmit
+export let ciaoMondo = "Ciao!";
+```
+
+Con un corrispondente `ciaoMondo.d.ts`:
+
+```ts twoslash
+// @showEmittedFile: index.d.ts
+// @showEmit
+// @declaration
+export let ciaoMondo: string;
+```
+
+Quando si lavora con i file `.d.ts` insieme ai file JavaScript potresti voler usare [`emitDeclarationOnly`](#emitDeclarationOnly) o [`outDir`](#outDir) per essere sicuro che i file JavaScript non vengano sovrascritti.

docs/tsconfig/it/options/declarationMap.md

@@ -0,0 +1,9 @@
+---
+display: "Mappa delle dichiarazioni"
+oneline: "Crea una source map per tutti i file .d.ts"
+---
+
+Crea una source map per i file `.d.ts` che riportano al file originale `.ts`.
+Questo permetterà agli editor come ad esempio VS Code di andare nel file `.ts` originale quando si usano funzioni tipo _Vai alla definizione_.
+
+Dovresti prendere seriamente in considerazione di abilitare questa funzione se stai usando le project references.

docs/tsconfig/it/sections/compilerOptions.md

@@ -0,0 +1,3 @@
+### Opzioni del Compilatore
+
+Queste opzioni espicitano la configurazione di TypeScript e spiegano come il linguaggio dovrebbe funzionare.

docs/tsconfig/it/sections/top_level.md

@@ -0,0 +1,3 @@
+### Campi principali
+
+Le principali opzioni sono nel TSConfig - queste opzioni spiegano come il tuo progetto TypeScript o JavaScript è impostato.