Merge branch 'main' into dx-1028/sidebar-prop

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
 

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>
 
@@ -150,14 +150,14 @@ import { LinkCard, CardGrid } from '@astrojs/starlight/components';
 
 <CardGrid>
 	<LinkCard
-		title="Creazione di Markdown"
+		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';
 
@@ -169,12 +169,67 @@ import { LinkCard } from '@astrojs/starlight/components';
 
 <CardGrid>
 	<LinkCard
-		title="Creazione di Markdown"
+		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 +247,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" />
 

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
 

docs/src/content/docs/it/guides/pages.mdx

@@ -0,0 +1,151 @@
+---
+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.

docs/src/content/docs/it/manual-setup.mdx

@@ -125,4 +125,6 @@ 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.

docs/src/content/docs/ja/guides/customization.mdx

@@ -267,6 +267,25 @@ hero:
 ---
 ```
 
+### デフォルトの404ページを無効にする
+
+完全にカスタマイズされた404レイアウトがプロジェクトに必要な場合は、`src/pages/404.astro`ルートを作成し、Starlightのデフォルトルートを無効にするために[`disable404Route`](/ja/reference/configuration/#disable404route)オプションを設定します。
+
+```js {9}
+// astro.config.mjs
+import { defineConfig } from 'astro/config';
+import starlight from '@astrojs/starlight';
+
+export default defineConfig({
+	integrations: [
+		starlight({
+			title: '404をカスタマイズしたドキュメント',
+			disable404Route: true,
+		}),
+	],
+});
+```
+
 ## カスタムフォント
 
 デフォルトでは、Starlightはユーザーのローカルデバイスで利用可能なサンセリフフォントをすべてのテキストに使用します。これにより、大きなフォントファイルをダウンロードするための余分な帯域幅を必要とせず、各ユーザーに馴染みのあるフォントでドキュメントを高速に読み込むことができます。