From a59a77b8e7232d4db4b04d96787ba62d62d7b656 Mon Sep 17 00:00:00 2001 From: Federico Gerardi Date: Tue, 26 Jan 2021 17:07:10 +0100 Subject: [PATCH 1/2] TSConfig Italian translation: init --- docs/tsconfig/it/intro.md | 5 +++ docs/tsconfig/it/options/allowJs.md | 31 +++++++++++++++ docs/tsconfig/it/options/checkJs.md | 40 ++++++++++++++++++++ docs/tsconfig/it/options/composite.md | 16 ++++++++ docs/tsconfig/it/options/declaration.md | 32 ++++++++++++++++ docs/tsconfig/it/options/declarationMap.md | 9 +++++ docs/tsconfig/it/sections/compilerOptions.md | 3 ++ docs/tsconfig/it/sections/top_level.md | 3 ++ docs/tsconfig/it/sections/watchOptions.md | 0 9 files changed, 139 insertions(+) create mode 100644 docs/tsconfig/it/intro.md create mode 100644 docs/tsconfig/it/options/allowJs.md create mode 100644 docs/tsconfig/it/options/checkJs.md create mode 100644 docs/tsconfig/it/options/composite.md create mode 100644 docs/tsconfig/it/options/declaration.md create mode 100644 docs/tsconfig/it/options/declarationMap.md create mode 100644 docs/tsconfig/it/sections/compilerOptions.md create mode 100644 docs/tsconfig/it/sections/top_level.md create mode 100644 docs/tsconfig/it/sections/watchOptions.md diff --git a/docs/tsconfig/it/intro.md b/docs/tsconfig/it/intro.md new file mode 100644 index 00000000..e5c284c3 --- /dev/null +++ b/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`. \ No newline at end of file diff --git a/docs/tsconfig/it/options/allowJs.md b/docs/tsconfig/it/options/allowJs.md new file mode 100644 index 00000000..b9f8bf8b --- /dev/null +++ b/docs/tsconfig/it/options/allowJs.md @@ -0,0 +1,31 @@ +--- +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 +// @filename: index.ts +import { seme } from "./carta"; + +console.log(seme); +``` + +Ma verrà importato senza errori con `allowJs` abilitato: + +```js twoslash +// @filename: index.ts +import { seme } from "./carta"; + +console.log(mazzodiCarteDefault); +``` + +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. \ No newline at end of file diff --git a/docs/tsconfig/it/options/checkJs.md b/docs/tsconfig/it/options/checkJs.md new file mode 100644 index 00000000..6ee7b4f3 --- /dev/null +++ b/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); +``` + diff --git a/docs/tsconfig/it/options/composite.md b/docs/tsconfig/it/options/composite.md new file mode 100644 index 00000000..4decf62e --- /dev/null +++ b/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). \ No newline at end of file diff --git a/docs/tsconfig/it/options/declaration.md b/docs/tsconfig/it/options/declaration.md new file mode 100644 index 00000000..369891f8 --- /dev/null +++ b/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. diff --git a/docs/tsconfig/it/options/declarationMap.md b/docs/tsconfig/it/options/declarationMap.md new file mode 100644 index 00000000..7c5e7965 --- /dev/null +++ b/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. diff --git a/docs/tsconfig/it/sections/compilerOptions.md b/docs/tsconfig/it/sections/compilerOptions.md new file mode 100644 index 00000000..39cc3c7e --- /dev/null +++ b/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. \ No newline at end of file diff --git a/docs/tsconfig/it/sections/top_level.md b/docs/tsconfig/it/sections/top_level.md new file mode 100644 index 00000000..82e9d5de --- /dev/null +++ b/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. \ No newline at end of file diff --git a/docs/tsconfig/it/sections/watchOptions.md b/docs/tsconfig/it/sections/watchOptions.md new file mode 100644 index 00000000..e69de29b From 991225310fbf48d5f4150c4fd2e27727a30f52b1 Mon Sep 17 00:00:00 2001 From: Federico Gerardi Date: Tue, 26 Jan 2021 19:45:58 +0100 Subject: [PATCH 2/2] allowJs fix --- docs/tsconfig/it/options/allowJs.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/docs/tsconfig/it/options/allowJs.md b/docs/tsconfig/it/options/allowJs.md index b9f8bf8b..a6e029a6 100644 --- a/docs/tsconfig/it/options/allowJs.md +++ b/docs/tsconfig/it/options/allowJs.md @@ -13,6 +13,10 @@ 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"; @@ -22,10 +26,14 @@ 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(mazzodiCarteDefault); +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. \ No newline at end of file