From eaae90c10e49a05098c58c51bd7b65affc7be185 Mon Sep 17 00:00:00 2001
From: casungo
Date: Tue, 20 Feb 2024 11:17:39 +0100
Subject: i18n(it): Updated getting-started.mdx, components.mdx, i18n.mdx &
 manual-setup.mdx and added pages.mdx (#1518)

Co-authored-by: Chris Swithinbank <swithinbank@gmail.com>
---
 docs/src/content/docs/it/getting-started.mdx   |  39 +------
 docs/src/content/docs/it/guides/components.mdx |  75 +++++++++---
 docs/src/content/docs/it/guides/i18n.mdx       |  13 ++-
 docs/src/content/docs/it/guides/pages.mdx      | 153 +++++++++++++++++++++++++
 docs/src/content/docs/it/manual-setup.mdx      |   5 +-
 5 files changed, 229 insertions(+), 56 deletions(-)
 create mode 100644 docs/src/content/docs/it/guides/pages.mdx

diff --git a/docs/src/content/docs/it/getting-started.mdx b/docs/src/content/docs/it/getting-started.mdx
index 44f50794..b61397fd 100644
--- a/docs/src/content/docs/it/getting-started.mdx
+++ b/docs/src/content/docs/it/getting-started.mdx
@@ -83,43 +83,9 @@ Apri questo URL per iniziare a navigare nel tuo sito.
 
 Starlight è pronto per aggiungere nuovi contenuti o portare i tuoi file esistenti!
 
-#### Formato dei file
+Aggiungi nuove pagine al tuo sito creando file Markdown nella directory `src/content/docs/`.
 
-Starlight supporta la creazione di contenuti in Markdown e MDX senza necessità di configurazione.
-Puoi aggiungere il supporto per Markdoc installando l'[integrazione Astro Markdoc sperimentale](https://docs.astro.build/it/guides/integrations-guide/markdoc/).
-
-#### Aggiungi pagine
-
-Aggiungi nuove pagine al tuo sito creando file `.md` o `.mdx` in `src/content/docs/`.
-Usa le sottocartelle per organizzare i tuoi file e per creare più segmenti di percorso.
-
-Ad esempio, la seguente struttura di file genererà le pagine `example.com/hello-world` e `example.com/guides/faq`:
-
-import FileTree from '~/components/file-tree.astro';
-
-<FileTree>
-
-- src/
-  - content/
-    - docs/
-      - guides/
-        - faq.md
-      - hello-world.md
-
-</FileTree>
-
-#### Frontmatter type-safe
-
-Tutte le pagine di Starlight condividono un insieme [comune di proprietà frontmatter](/it/reference/frontmatter/) personalizzabili per controllare il modo in cui viene visualizzata la pagina:
-
-```md
----
-title: Ciao Mondo!
-description: Questa è una pagina nel mio sito potenziato da Starlight
----
-```
-
-Se dimentichi qualcosa di importante, Starlight te lo farà sapere.
+Leggi di più sulla navigazione basata su file e sul supporto per i file MDX e Markdoc nella guida [“Pagine”](/it/guides/pages/).
 
 ### Prossimi passi
 
@@ -172,3 +138,4 @@ Se la tua risposta non può essere trovata in questa documentazione, visita la [
 La tua domanda potrebbe trovare risposta comprendendo il funzionamento generale di Astro, sotto questo tema Starlight.
 
 Puoi anche controllare eventuali [problemi noti di Starlight su GitHub](https://github.com/withastro/starlight/issues) e ottenere aiuto nel [Discord di Astro](https://astro.build/chat/) dalla nostra comunità attiva e amichevole! Pubblica domande nel nostro forum `#support` con il tag "starlight" o visita il nostro canale dedicato `#starlight` per discutere degli sviluppi attuali e di altro ancora!
+
diff --git a/docs/src/content/docs/it/guides/components.mdx b/docs/src/content/docs/it/guides/components.mdx
index 603510bf..df08260a 100644
--- a/docs/src/content/docs/it/guides/components.mdx
+++ b/docs/src/content/docs/it/guides/components.mdx
@@ -30,7 +30,7 @@ import AnotherComponent from '../../components/AnotherComponent.astro';
 </AnotherComponent>
 ```
 
-Siccome Starlight è integrato con Astro, puoi aggiungere componenti costruiti con qualsiasi [UI framework supportato (React, Preact, Svelte, Vue, Solid, Lit, and Alpine)](https://docs.astro.build/it/core-concepts/framework-components/).
+Siccome Starlight è integrato con Astro, puoi aggiungere componenti costruiti con qualsiasi [UI framework supportato (React, Preact, Svelte, Vue, Solid, Lit, and Alpine)](https://docs.astro.build/it/core-concepts/framework-components/) nei tuoi file MDX.
 Vedi di più su come [usare componenti in MDX](https://docs.astro.build/it/guides/markdown-content/#using-components-in-mdx) nella documentazione Astro.
 
 ### Compatibilità con gli stili di Starlight
@@ -71,7 +71,7 @@ import { Tabs, TabItem } from '@astrojs/starlight/components';
 </Tabs>
 ```
 
-Il codice precedente genera quanto segue nella pagina:
+Il codice sopra genera quanto segue nella pagina:
 
 <Tabs>
 	<TabItem label="Stelle">Sirius, Vega, Betelgeuse</TabItem>
@@ -104,7 +104,7 @@ import { Card, CardGrid } from '@astrojs/starlight/components';
 </CardGrid>
 ```
 
-Il codice precedente genera quanto segue nella pagina:
+Il codice sopra genera quanto segue nella pagina:
 
 <Card title="Guarda qui">Contenuti interessanti da evidenziare.</Card>
 
@@ -149,15 +149,12 @@ import { LinkCard, CardGrid } from '@astrojs/starlight/components';
 />
 
 <CardGrid>
-	<LinkCard
-		title="Creazione di Markdown"
-		href="/it/guides/authoring-content/"
-	/>
+	<LinkCard title="Creazione di contenuti in Markdown" href="/it/guides/authoring-content/" />
 	<LinkCard title="Componenti" href="/it/guides/components/" />
 </CardGrid>
 ```
 
-Il codice precedente genera quanto segue nella pagina:
+Il codice sopra genera quanto segue nella pagina:
 
 import { LinkCard } from '@astrojs/starlight/components';
 
@@ -168,13 +165,65 @@ import { LinkCard } from '@astrojs/starlight/components';
 />
 
 <CardGrid>
-	<LinkCard
-		title="Creazione di Markdown"
-		href="/it/guides/authoring-content/"
-	/>
+	<LinkCard title="Creazione di contenuti in Markdown" href="/it/guides/authoring-content/" />
 	<LinkCard title="Componenti" href="/it/guides/components/" />
 </CardGrid>
 
+### Avvisi
+
+Gli avvisi sono utili per indicare contenuti secondari insieme ai contenuti principali.
+
+`<Aside>` può avere un `type` opzionale di `note` (il valore predefinito), `tip`, `caution` o `danger`. Impostando un attributo `title` si sovrascrive il titolo predefinito dell'avviso.
+
+````mdx
+# src/content/docs/example.mdx
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside>Un avviso predefinito senza un titolo personalizzato.</Aside>
+
+<Aside type="caution" title="Attenzione!">
+	Un avviso *con* un titolo personalizzato.
+</Aside>
+
+<Aside type="tip">
+
+Altri contenuti sono supportati anche negli avvisi.
+
+```js
+// Un pezzo di codice, per esempio.
+```
+
+</Aside>
+
+<Aside type="danger">Non dare la tua password a nessuno.</Aside>
+````
+
+Il codice sopra genera quanto segue nella pagina:
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside>Un avviso di default senza un titolo personalizzato</Aside>
+
+<Aside type="caution" title="Attenzione!">
+	Un avviso di cautela con un titolo personalizzato.
+</Aside>
+
+<Aside type="tip">
+
+Altri contenuti sono supportati anche negli avvisi.
+
+```js
+// Un pezzo di codice, per esempio.
+```
+
+</Aside>
+
+<Aside type="danger">Non dare la tua password a nessuno.</Aside>
+
+Starlight fornisce anche una sintassi personalizzata per mostrare gli avvisi in Markdown e MDX come alternativa al componente `<Aside>`.
+Consulta la guida [“Creazione di contenuti in Markdown”](/it/guides/authoring-content/#avvisi) per i dettagli sulla sintassi personalizzata.
+
 ### Icone
 
 import { Icon } from '@astrojs/starlight/components';
@@ -192,7 +241,7 @@ import { Icon } from '@astrojs/starlight/components';
 <Icon name="star" color="goldenrod" size="2rem" />
 ```
 
-Il codice precedente genera quanto segue nella pagina:
+Il codice sopra genera quanto segue nella pagina:
 
 <Icon name="star" color="goldenrod" size="2rem" />
 
diff --git a/docs/src/content/docs/it/guides/i18n.mdx b/docs/src/content/docs/it/guides/i18n.mdx
index cc47cbc1..aa00432f 100644
--- a/docs/src/content/docs/it/guides/i18n.mdx
+++ b/docs/src/content/docs/it/guides/i18n.mdx
@@ -5,7 +5,7 @@ description: Impara come configurare il tuo sito Starlight per supportare più l
 
 import FileTree from '~/components/file-tree.astro';
 
-Starlight offre il supporto per siti multilingua, compreso di indirizzamento, contenuti fallback e completo supporto per lingue scritte da destra a sinistra (RTL).
+Starlight offre il supporto per siti multilingua, compreso di indirizzamento, contenuti di riserva e completo supporto per lingue scritte da destra a sinistra (RTL).
 
 ## Configurare i18n
 
@@ -43,7 +43,7 @@ Starlight offre il supporto per siti multilingua, compreso di indirizzamento, co
    });
    ```
 
-   Il `defaultLocale` sarà utilizzato come fallback per contenuti ed interfaccia, quindi scegli il linguaggio per cui c'è più probabilità di iniziare a scrivere o già hai contenuti.
+   Il `defaultLocale` sarà utilizzato come riserva per contenuti ed interfaccia, quindi scegli il linguaggio per cui c'è più probabilità di iniziare a scrivere o già hai contenuti.
 
 2. Creare una cartella per ogni lingua in `src/content/docs/`.
    Per esempio, per la configurazione di sopra:
@@ -59,7 +59,7 @@ Starlight offre il supporto per siti multilingua, compreso di indirizzamento, co
 
    </FileTree>
 
-3. Puoi ora aggiungere file nelle cartelle. Usa file con lo stesso nome per associare pagine tra i linguaggi e sfruttare le funzionalità di Starlight per i18n, compresi i contenuti di fallback, avvisi di traduzione e altro.
+3. Puoi ora aggiungere file nelle cartelle. Usa file con lo stesso nome per associare pagine tra i linguaggi e sfruttare le funzionalità di Starlight per i18n, compresi i contenuti di riserva, avvisi di traduzione e altro.
 
    Per esempio, crea `ar/index.md` e `en/index.md` per rappresentare la homepage rispettivamente in arabo e inglese.
 
@@ -133,11 +133,11 @@ export default defineConfig({
 
 Questo ti permette di sovrascrivere le impostazione predefinite di Starlight per la lingua senza abilitare l'internazionalizzazione.
 
-## Contenuti fallback
+## Contenuti di riserva
 
-Starlight si aspetta che crei pagine equivalenti per tutte le lingue impostate. Per esempio, se hai un file `en/about.md`, crea un `about.md` per ogni altra lingua impostata. Questo permette a Starlight di avere contenuti fallback per le pagine che non hai ancora tradotto.
+Starlight si aspetta che crei pagine equivalenti per tutte le lingue impostate. Per esempio, se hai un file `en/about.md`, crea un `about.md` per ogni altra lingua impostata. Questo permette a Starlight di avere contenuti di riserva per le pagine che non hai ancora tradotto.
 
-Se una traduzione non è ancora disponibile per una lingua, Starlight mostrerà ai lettori i contenuti per quella pagina nel linguaggio predefinito (impostato da `defaultLocale`). Per esempio, se non hai ancora creato una versione italiana della pagina About e la lingua predefinita è inglese, gli utenti per `/it/about` vedranno i contenuti in inglese di `/en/about` con un avviso che la pagina non è stata ancora tradotta.
+Se una traduzione non è ancora disponibile per una lingua, Starlight mostrerà ai lettori i contenuti per quella pagina nel linguaggio predefinito (impostato da `defaultLocale`). Per esempio, se non hai ancora creato una versione italiana della pagina About e la lingua predefinita è inglese, gli utenti che visiteranno `/it/about` vedranno i contenuti in inglese di `/en/about` con un avviso che la pagina non è stata ancora tradotta.
 
 ## Tradurre l'interfaccia Starlight
 
@@ -262,3 +262,4 @@ export const collections = {
 ```
 
 Per saperne di più sugli schemi di raccolta dei contenuti, consulta [ "Definire uno schema di raccolta"](https://docs.astro.build/it/guides/content-collections/#defining-a-collection-schema) nella documentazione di Astro.
+
diff --git a/docs/src/content/docs/it/guides/pages.mdx b/docs/src/content/docs/it/guides/pages.mdx
new file mode 100644
index 00000000..d73d86a0
--- /dev/null
+++ b/docs/src/content/docs/it/guides/pages.mdx
@@ -0,0 +1,153 @@
+---
+title: Pagine
+description: Scopri come creare e gestire le pagine del tuo sito di documentazione con Starlight.
+sidebar: 
+  order: 1
+---
+
+Starlight genera le pagine HTML del tuo sito in base ai tuoi contenuti, con opzioni flessibili fornite tramite frontmatter Markdown.
+Inoltre, i progetti Starlight hanno pieno accesso agli [potenti strumenti di generazione delle pagine di Astro](https://docs.astro.build/it/basics/astro-pages/).
+Questa guida mostra come funziona la generazione delle pagine in Starlight.
+
+## Pagine generate da contenuti
+
+### Formati dei file
+
+Starlight supporta la creazione di contenuti in Markdown e MDX senza bisogno di configurazione.
+Puoi aggiungere il supporto per Markdoc installando la [integrazione sperimentale Markdoc di Astro](https://docs.astro.build/it/guides/integrations-guide/markdoc/).
+
+### Aggiungi pagine
+
+Aggiungi nuove pagine al tuo sito creando file `.md` o `.mdx` in `src/content/docs/`.
+Usa le sottocartelle per organizzare i tuoi file e per creare più segmenti di percorso.
+
+Per esempio, la seguente struttura di file genererà pagine su `example.com/hello-world` e `example.com/reference/faq`:
+
+import FileTree from '~/components/file-tree.astro';
+
+<FileTree>
+
+- src/
+  - content/
+    - docs/
+      - hello-world.md
+      - reference/
+        - faq.md
+
+</FileTree>
+
+### Frontmatter type-safe 
+
+Tutte le pagine Starlight condividono un [insieme comune di proprietà frontmatter](/it/reference/frontmatter/) personalizzabili per controllare come appare la pagina:
+
+```md
+---
+title: Ciao Mondo!
+description: Questa è una pagina nel mio sito creato con Starlight
+---
+```
+
+Se dimentichi qualcosa di importante, Starlight te lo farà sapere.
+
+## Pagine personalizzate
+
+Per casi d'uso avanzati, puoi aggiungere pagine personalizzate creando una directory `src/pages/`.
+La directory `src/pages/` utilizza il [routing basato su file di Astro](https://docs.astro.build/it/basics/astro-pages/#file-based-routing) e include il supporto per file `.astro` tra gli altri formati di pagina.
+Questo è utile se hai bisogno di costruire pagine con un layout completamente personalizzato o generare una pagina da una fonte di dati alternativa. 
+
+Per esempio, questo progetto mischia contenuti Markdown in `src/content/docs/` con route Astro e HTML in `src/pages/`:
+
+<FileTree>
+
+- src/
+  - content/
+    - docs/
+      - hello-world.md
+  - pages/
+    - custom.astro
+    - archived.html
+
+</FileTree>
+
+Leggi di più nella guida ["Pagine" nella documentazione di Astro](https://docs.astro.build/it/basics/astro-pages/).
+
+### Utilizzo del design di Starlight nelle pagine personalizzate
+
+Per utilizzare il layout Starlight nelle pagine personalizzate, metti il contenuto della tua pagina dentro al componente `<StarlightPage />`.
+Questo può essere utile se stai generando contenuti dinamicamente ma vuoi comunque utilizzare il design di Starlight.
+
+```astro
+---
+// src/pages/custom-page/example.astro
+import StarlightPage from '@astrojs/starlight/components/StarlightPage.astro';
+import CustomComponent from './CustomComponent.astro';
+---
+
+<StarlightPage frontmatter={{ title: 'La mia pagina personalizzata' }}>
+	<p>Questa è una pagina personalizzata con un componente personalizzato:</p>
+	<CustomComponent />
+</StarlightPage>
+```
+
+#### Props
+
+Il componente `<StarlightPage />` accetta le seguenti props.
+
+##### `frontmatter` (required)
+
+**tipo:** `StarlightPageFrontmatter`
+
+Imposta le [proprietà del frontmatter](/it/reference/frontmatter/) per questa pagina, simili al frontmatter nelle pagine Markdown.
+La proprietà [`title`](/it/reference/frontmatter/#title-obbligatorio) è obbligatoria e tutte le altre proprietà sono opzionali.
+
+Le seguenti proprietà differiscono dal frontmatter di Markdown:
+
+- La proprietà [`slug`](/it/reference/frontmatter/#slug) non è supportata e viene impostata automaticamente in base all'URL della pagina personalizzata.
+- L'opzione [`editUrl`](/it/reference/frontmatter/#editurl) richiede un URL per visualizzare un link di modifica.
+- La proprietà [`sidebar`](/it/reference/frontmatter/#sidebar) non è supportata. Nel frontmatter di Markdown, questa opzione consente la personalizzazione dei [gruppi di link generati automaticamente](/it/reference/configuration/#sidebar), che non è applicabile alle pagine che utilizzano il componente `<StarlightPage />`.
+
+{/* ##### `sidebar` */}
+
+{/* **tipo:** `SidebarEntry[] | undefined` */}
+{/* **predefinito:** la barra laterale generata in base alla [configurazione globale `sidebar`](/reference/configuration/#sidebar) */}
+
+{/* Fornisce una barra laterale di navigazione personalizzata per questo sito. */}
+{/* Se non impostato, la pagina utilizzerà la barra laterale globale predefinita. */}
+
+##### `hasSidebar`
+
+**tipo:** `boolean`  
+**predefinito:** `false` se [`frontmatter.template`](/it/reference/frontmatter/#template) è `'splash'`, altrimenti `true`
+
+Controlla se la barra laterale viene essere visualizzata su questa pagina.
+
+##### `headings`
+
+**tipo:** `{ depth: number; slug: string; text: string }[]`
+**predefinito:** `[]`
+
+Fornisce un array di tutti i titoli su questa pagina.
+Starlight genererà la tabella dei contenuti della pagina da questi titoli se forniti.
+
+##### `dir`
+
+**tipo:** `'ltr' | 'rtl'`  
+**predefinito:** la direzione di scrittura per la lingua corrente
+
+Imposta la direzione di scrittura per il contenuto di questa pagina.
+
+##### `lang`
+
+**tipo:** `string`  
+**predefinito:** la lingua della lingua corrente
+
+Imposta il tag di lingua BCP-47 per il contenuto di questa pagina, ad es. `en`, `zh-CN`, o `pt-BR`.
+
+##### `isFallback`
+
+**tipo:** `boolean`  
+**predefinito:** `false`
+
+Indica se questa pagina sta utilizzando [contenuti di riserva](/it/guides/i18n/#contenuti-di-riserva) perché non c'è una traduzione per la lingua corrente.
+
+
diff --git a/docs/src/content/docs/it/manual-setup.mdx b/docs/src/content/docs/it/manual-setup.mdx
index f792929c..2e4fe9c3 100644
--- a/docs/src/content/docs/it/manual-setup.mdx
+++ b/docs/src/content/docs/it/manual-setup.mdx
@@ -125,4 +125,7 @@ In futuro, prevediamo di supportare meglio questo caso d'uso per evitare la nece
 
 ### Usa Starlight con SSR
 
-Attualmente, Starlight non supporta [distribuzione SSR](https://docs.astro.build/it/guides/server-side-rendering/) utilizzando gli adattatori server di Astro. Speriamo di poterlo supportare presto.
+Puoi utilizzare Starlight insieme a pagine personalizzate renderizzate su richiesta nel tuo progetto seguendo la guida [“Adattatori di rendering su richiesta”](https://docs.astro.build/it/guides/server-side-rendering/) nella documentazione di Astro.
+
+Attualmente, le pagine di documentazione generate da Starlight sono sempre prerenderizzate indipendentemente dalla modalità di output del tuo progetto. Speriamo di poter supportare presto il rendering su richiesta per le pagine di Starlight.
+
-- 
cgit