summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorcasungo2024-08-13 10:31:50 +0200
committerGitHub2024-08-13 10:31:50 +0200
commit1611f084b051390a176e656d7d281ba075df8d68 (patch)
tree3e305dfcfb62a403fdb4534fd95f0a72e9108df3
parent269a53e790169aaa23e731d03ef549d2ba10aced (diff)
downloadIT.starlight-1611f084b051390a176e656d7d281ba075df8d68.tar.gz
IT.starlight-1611f084b051390a176e656d7d281ba075df8d68.tar.bz2
IT.starlight-1611f084b051390a176e656d7d281ba075df8d68.zip
i18n(it): Updates `reference/configuration.mdx` (#2195)
Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com> Co-authored-by: Chris Swithinbank <swithinbank@gmail.com>
-rw-r--r--docs/src/content/docs/it/reference/configuration.mdx297
1 files changed, 172 insertions, 125 deletions
diff --git a/docs/src/content/docs/it/reference/configuration.mdx b/docs/src/content/docs/it/reference/configuration.mdx
index fce73406..8ba52365 100644
--- a/docs/src/content/docs/it/reference/configuration.mdx
+++ b/docs/src/content/docs/it/reference/configuration.mdx
@@ -1,11 +1,11 @@
---
-title: Riferimenti configurazione
-description: Una panoramica sulle configurazione supportate da Starlight.
+title: Riferimento di Configurazione
+description: Una panoramica di tutte le opzioni di configurazione supportate da Starlight.
---
## Configurare l'integrazione `starlight`
-Starlight è un'integrazione costruita sul framework [Astro](https://astro.build). Puoi configurare il tuo progetto nel file `astro.config.mjs`:
+Starlight è un'integrazione costruita sopra il framework web [Astro](https://astro.build). Puoi configurare il tuo progetto all'interno del file di configurazione `astro.config.mjs`:
```js
// astro.config.mjs
@@ -15,31 +15,43 @@ import starlight from '@astrojs/starlight';
export default defineConfig({
integrations: [
starlight({
- title: 'Il mio bellissimo sito per la documentazione',
+ title: 'Il mio delizioso sito di documentazione',
}),
],
});
```
-Puoi configurare le seguenti opzioni nell'integrazione `starlight`.
+Puoi passare le seguenti opzioni all'integrazione `starlight`.
### `title` (obbligatorio)
-**tipo:** `string`
+**tipo:** `string | Record<string, string>`
+
+Imposta il titolo per il tuo sito web. SarĂ  utilizzato nei metadati e nel titolo della scheda del browser.
-Definisce il titolo del tuo sito. SarĂ  usato nei metadati e nel titolo della finestra.
+Il valore può essere una stringa o, per siti multilingua, un oggetto con valori per ciascuna lingua diversa.
+Quando si utilizza la forma oggetto, le chiavi devono essere tag BCP-47 (ad esempio `en`, `ar`, o `zh-CN`):
+
+```ts
+starlight({
+ title: {
+ en: 'My delightful docs site',
+ it: 'Il mio delizioso sito di documentazione',
+ },
+});
+```
### `description`
**tipo:** `string`
-Definisce la descrizione del tuo sito. Sarà usato nei metadati condivisi con le engine di ricerca nel tag `<meta name="description">` se `description` non è specificato nell'intestazione della pagina.
+Imposta la descrizione per il tuo sito web. Utilizzata nei metadati condivisi con i motori di ricerca nel tag `<meta name="description">` se `description` non è impostata nel frontmatter di una pagina.
### `logo`
**tipo:** [`LogoConfig`](#logoconfig)
-Definisce il logo da rappresentare nella barra di navigazione con o al posto del nome del sito. Puoi definire un singolo `src` o indicare due separate immagini per `light` e `dark`.
+Imposta un'immagine del logo da mostrare nella barra di navigazione insieme o al posto del titolo del sito. Puoi impostare una singola proprietĂ  `src` o impostare sorgenti di immagini separate per `light` e `dark`.
```js
starlight({
@@ -63,13 +75,13 @@ type LogoConfig = { alt?: string; replacesTitle?: boolean } & (
**tipo:** `false | { minHeadingLevel?: number; maxHeadingLevel?: number; }`
**predefinito:** `{ minHeadingLevel: 2; maxHeadingLevel: 3; }`
-Configura la tabella dei contenuti vista a destra di ogni pagina. Per predefinite, i titoli `<h2>` e `<h3>` saranno incluse in essa.
+Configura la tabella dei contenuti mostrata sulla destra di ogni pagina. Per impostazione predefinita, i titoli `<h2>` e `<h3>` saranno inclusi in questa tabella dei contenuti.
### `editLink`
**tipo:** `{ baseUrl: string }`
-Abilita il link "Modifica questa pagina" definendo l'URL base da usare. Il link finale sarĂ  `editLink.baseUrl` + il percorso corrente. Per esempio, per abilitare la possibilitĂ  di modificare la repository `withastro/starlight` su GitHub:
+Abilita i link "Modifica questa pagina" impostando l'URL di base che questi dovrebbero utilizzare. Il link finale sarĂ  `editLink.baseUrl` + il percorso della pagina corrente. Per esempio, per abilitare la modifica delle pagine nel repository `withastro/starlight` su GitHub:
```js
starlight({
@@ -79,39 +91,47 @@ starlight({
});
```
-Con questa configurazione, una pagina `/introduction` avrĂ  un link di modifica a `https://github.com/withastro/starlight/edit/main/src/content/docs/introduction.md`.
+Con questa configurazione, una pagina `/introduction` avrebbe un link di modifica che punta a `https://github.com/withastro/starlight/edit/main/src/content/docs/introduction.md`.
### `sidebar`
**tipo:** [`SidebarItem[]`](#sidebaritem)
-Configura la barra laterale di navigazione del tuo sito.
+Configura gli elementi di navigazione della barra laterale del tuo sito.
+
+Una barra laterale è un array di link e gruppi di link.
+Ad eccezione degli elementi che utilizzano `slug`, ogni elemento deve avere una `label` e una delle seguenti proprietĂ :
-Una barra laterale è un array di collegamenti e gruppi di collegamenti.
-Ogni elemento avente un `label` e una delle seguenti proprietĂ :
+- `link` — un singolo link a un URL specifico, ad esempio `'/home'` o `'https://example.com'`.
-- `link` — un singolo colelgamento a uno specifico URL, ad es. `'/home'` o `'https://example.com'`.
+- `slug` — un riferimento a una pagina interna, ad esempio `'guides/getting-started'`.
-- `items` — an aray contenente più collegamenti della barra laterale e sottogruppi.
+- `items` — un array contenente più link della barra laterale e sottogruppi.
-- `autogenerate` — un oggetto indicante una cartella dei tuoi documenti di cui generare automaticamente i collegamenti.
+- `autogenerate` — un oggetto che specifica una directory della tua documentazione per generare automaticamente un gruppo di link.
+
+I link interni possono anche essere specificati come una stringa invece di un oggetto con una proprietĂ  `slug`.
```js
starlight({
sidebar: [
- // Un singolo elemento chiamato “Home”.
+ // Un singolo elemento di link etichettato "Home".
{ label: 'Home', link: '/' },
- // Un gruppo intitolato "Inizia qui" contenente due link.
+ // Un gruppo etichettato "Inizia Qui" contenente quattro link.
{
- label: 'Inizia qui',
+ label: 'Inizia Qui',
items: [
- { label: 'Introduzione', link: '/intro' },
- { label: 'Prossimi passi', link: '/next-steps' },
+ // Usando `slug` per i link interni.
+ { slug: 'intro' },
+ { slug: 'installation' },
+ // O usando la forma abbreviata per i link interni.
+ 'tutorial',
+ 'next-steps',
],
},
- // Un gruppo che si riferisce a tutte le pagine nella cartella reference.
+ // Un gruppo che collega a tutte le pagine nella directory reference.
{
- label: 'Riferimenti',
+ label: 'Riferimento',
autogenerate: { directory: 'reference' },
},
],
@@ -120,29 +140,26 @@ starlight({
#### Ordinamento
-I gruppi generati automaticamente sono ordinati alfabeticamente.
-Per esempio, una pagina generata da `astro.md` apparirĂ  sopra a quella generata da `starlight.md`.
+I gruppi della barra laterale generati automaticamente sono ordinati alfabeticamente per nome del file.
+Per esempio, una pagina generata da `astro.md` apparirebbe sopra la pagina per `starlight.md`.
#### Gruppi comprimibili
-I gruppi di collegamenti vengono espansi per impostazione predefinita. Puoi modificare questo comportamento impostando la proprietĂ  `collapsed` di un gruppo su `true`.
+I gruppi di link sono espansi per impostazione predefinita. Puoi modificare questo comportamento impostando la proprietĂ  `collapsed` di un gruppo su `true`.
-I sottogruppi generati automaticamente rispettano la proprietĂ  `collapsed` del gruppo principale per impostazione predefinita. Imposta la proprietĂ  `autogenerate.collapsed` per sovrascriverla.
+I sottogruppi generati automaticamente rispettano la proprietĂ  `collapsed` del loro gruppo genitore per impostazione predefinita. Imposta la proprietĂ  `autogenerate.collapsed` per sovrascrivere questo comportamento.
-```js {5,16}
+```js {5,13}
sidebar: [
- // Un gruppo di collegamenti compresso.
+ // Un gruppo di link compresso.
{
- label: 'Collegamenti compressi',
+ label: 'Link Compressi',
collapsed: true,
- items: [
- { label: 'Introduzione', link: '/intro' },
- { label: 'Prossimi passi', link: '/next-steps' },
- ],
+ items: ['intro', 'next-steps'],
},
- // An expanded group containing collapsed autogenerated subgroups.
+ // Un gruppo espanso contenente sottogruppi generati automaticamente compressi.
{
- label: 'Riferimenti',
+ label: 'Riferimento',
autogenerate: {
directory: 'reference',
collapsed: true,
@@ -151,9 +168,9 @@ sidebar: [
],
```
-#### Tradurre i titoli
+#### Traduzione delle etichette
-Se il tuo sito è multilingua, ogni elemento di `label` è considerato come appartenente alla lingua di default. Puoi definire `translations` per fornire i titoli per le altre lingue:
+Se il tuo sito è multilingua, la `label` di ogni elemento è considerata essere nella lingua predefinita. Puoi impostare una proprietà `translations` per fornire etichette per le altre lingue supportate:
```js {5,9,14}
sidebar: [
@@ -180,21 +197,37 @@ sidebar: [
#### `SidebarItem`
```ts
-type SidebarItem = {
- label: string;
- translations?: Record<string, string>;
-} & (
- | {
- link: string;
+type SidebarItem =
+ | string
+ | ({
+ translations?: Record<string, string>;
badge?: string | BadgeConfig;
- attrs?: Record<string, string | number | boolean | undefined>;
- }
- | { items: SidebarItem[]; collapsed?: boolean }
- | {
- autogenerate: { directory: string; collapsed?: boolean };
- collapsed?: boolean;
- }
-);
+ } & (
+ | {
+ // Link
+ link: string;
+ label: string;
+ attrs?: Record<string, string | number | boolean | undefined>;
+ }
+ | {
+ // Link interno
+ slug: string;
+ label?: string;
+ attrs?: Record<string, string | number | boolean | undefined>;
+ }
+ | {
+ // Gruppo di link
+ label: string;
+ items: SidebarItem[];
+ collapsed?: boolean;
+ }
+ | {
+ // Gruppo di link autogenerato
+ label: string;
+ autogenerate: { directory: string; collapsed?: boolean };
+ collapsed?: boolean;
+ }
+ ));
```
#### `BadgeConfig`
@@ -202,17 +235,18 @@ type SidebarItem = {
```ts
interface BadgeConfig {
text: string;
- variant: 'note' | 'tip' | 'caution' | 'danger' | 'success' | 'default';
+ variant?: 'note' | 'tip' | 'caution' | 'danger' | 'success' | 'default';
+ class?: string;
}
```
### `locales`
-**tipo:** <code>\{ \[dir: string\]: [LocaleConfig](#localeconfig) }</code>
+**tipo:** <code>\{ \[dir: string\]: [LocaleConfig](#localeconfig) \}</code>
-[Configura l'internazionalizzazione (i18n)](/it/guides/i18n/) del sito impostando quali `locales` sono supportati.
+[Configura l'internazionalizzazione (i18n)](/it/guides/i18n/) per il tuo sito impostando quali `locales` sono supportati.
-Ogni elemento deve utilizzare come chiave la cartella dove i file della lingua associata si trovano.
+Ogni voce dovrebbe utilizzare la directory in cui sono salvati i file di quella lingua come chiave.
```js
import { defineConfig } from 'astro/config';
@@ -221,20 +255,20 @@ import starlight from '@astrojs/starlight';
export default defineConfig({
integrations: [
starlight({
- title: 'My Site',
- // Imposta inglese come il linguaggio predefinito.
+ title: 'Il Mio Sito',
+ // Imposta l'inglese come lingua predefinita per questo sito.
defaultLocale: 'en',
locales: {
- // La documentazione in inglese si trova in `src/content/docs/en/`
+ // Documentazione in inglese in `src/content/docs/en/`
en: {
label: 'English',
},
- // La documentazione in cinese semplificato si trova in `src/content/docs/zh-cn/`
+ // Documentazione in cinese semplificato in `src/content/docs/zh-cn/`
'zh-cn': {
label: '简体中文',
lang: 'zh-CN',
},
- // La documentazione in arabo si trova in `src/content/docs/ar/`
+ // Documentazione in arabo in `src/content/docs/ar/`
ar: {
label: 'العربية',
dir: 'rtl',
@@ -261,19 +295,19 @@ Puoi impostare le seguenti opzioni per ogni locale:
**tipo:** `string`
-L'etichetta per questa lingua da rappresentare agli utenti, per esempio nel selettore di lingue. Spesso vorrai usare il nome della lingua per come l'utente si aspetta di leggere, per esempio `"English"`, `"العربية"`, o `"简体中文"`.
+L'etichetta per questa lingua da mostrare agli utenti, ad esempio nel selettore di lingua. Nella maggior parte dei casi, vorrai che questo sia il nome della lingua come un utente di quella lingua si aspetterebbe di leggerlo, ad esempio `"English"`, `"العربية"`, o `"简体中文"`.
##### `lang`
**tipo:** `string`
-Il tag BCP-47 per la lingua, per esempio `"en"`, `"ar"`, o `"zh-CN"`. Se non lo imposti sarĂ  utilizzato il nome della cartella.
+Il tag BCP-47 per questa lingua, ad esempio `"en"`, `"ar"`, o `"zh-CN"`. Se non impostato, verrĂ  utilizzato di default il nome della directory della lingua. I tag di lingua con sottotag regionali (ad esempio `"pt-BR"` o `"en-US"`) utilizzeranno le traduzioni dell'interfaccia utente integrate per la loro lingua di base se non vengono trovate traduzioni specifiche per la regione.
##### `dir`
**tipo:** `'ltr' | 'rtl'`
-Il verso di scrittura della lingua; `"ltr"` per sinistra a destra (predefinita) e `"rtl"` per destra a sinistra.
+La direzione di scrittura di questa lingua; `"ltr"` per da sinistra a destra (predefinito) o `"rtl"` per da destra a sinistra.
#### Lingua principale
@@ -299,11 +333,11 @@ Per esempio, questo ti permette di fornire `/getting-started/` come un percorso
**tipo:** `string`
-Definisce la lingua predefinita del sito.
-Il valore deve corrispondere ad una chiave di [`locales`](#locales).
-(Se la lingua predefinita è il [root](#lingua-principale), non è necessario).
+Imposta la lingua predefinita per questo sito.
+Il valore dovrebbe corrispondere a una delle chiavi del tuo oggetto [`locales`](#locales).
+(Se la tua lingua predefinita è il tuo [locale radice](#lingua-principale), puoi saltare questo.)
-VerrĂ  utilizzato come fallback per le pagine non tradotte.
+Il locale predefinito verrĂ  utilizzato per fornire contenuti di fallback dove mancano le traduzioni.
### `social`
@@ -311,7 +345,7 @@ import SocialLinksType from '~/components/social-links-type.astro';
**tipo:** <SocialLinksType />
-Dettagli opzionali per gli account social del sito. Se vengono aggiunti apparirĂ  l'icona corrispondente nella barra superiore.
+Dettagli opzionali sugli account dei social media per questo sito. L'aggiunta di uno qualsiasi di questi li visualizzerĂ  come collegamenti con icone nell'intestazione del sito.
```js
starlight({
@@ -335,26 +369,26 @@ starlight({
**tipo:** `string[]`
-Utilizza file CSS aggiuntivi per personalizzare il sito Starlight.
+Fornisci file CSS per personalizzare l'aspetto e il comportamento del tuo sito Starlight.
-Supporta file CSS locali relativi alla cartella principale del progetto, ad esempio `'/src/custom.css'`, e CSS installato come modulo npm, per esempio `'@fontsource/roboto'`.
+Supporta file CSS locali relativi alla radice del tuo progetto, ad esempio `'./src/custom.css'`, e CSS che hai installato come modulo npm, ad esempio `'@fontsource/roboto'`.
```js
starlight({
- customCss: ['/src/custom-styles.css', '@fontsource/roboto'],
+ customCss: ['./src/custom-styles.css', '@fontsource/roboto'],
});
```
### `expressiveCode`
-**tipo:** `StarlightExpressiveCodeOptions | boolean`
+**tipo:** `StarlightExpressiveCodeOptions | boolean`
**predefinito:** `true`
-Starlight utilizza [Expressive Code](https://github.com/expressive-code/expressive-code/tree/main/packages/astro-expressive-code) per rendere i blocchi di codice e aggiungere il supporto per evidenziare parti di esempi di codice, aggiungere nomi di file ai blocchi di codice e altro ancora.
-Consulta la guida ["Blocchi codice"](/it/guides/authoring-content/#blocco-di-codice) per scoprire come utilizzare la sintassi Expressive Code nel tuo contenuto Markdown e MDX.
+Starlight utilizza [Expressive Code](https://github.com/expressive-code/expressive-code/tree/main/packages/astro-expressive-code) per renderizzare i blocchi di codice e aggiungere supporto per evidenziare parti di esempi di codice, aggiungere nomi di file ai blocchi di codice e altro ancora.
+Consulta la [guida "Blocchi di codice"](/it/guides/authoring-content/#blocco-di-codice) per imparare come utilizzare la sintassi di Expressive Code nel tuo contenuto Markdown e MDX.
-Puoi utilizzare tutte le opzioni di configurazione standard di [Expressive Code](https://github.com/expressive-code/expressive-code/blob/main/packages/astro-expressive-code/README.md#configuration) nonché alcune proprietà specifiche di Starlight, impostandole nell'opzione `expressiveCode` di Starlight.
-Ad esempio, imposta l'opzione `styleOverrides` di Expressive Code per sovrascrivere il CSS predefinito. Ciò consente personalizzazioni come dare ai tuoi blocchi di codice angoli arrotondati:
+Puoi utilizzare qualsiasi delle [opzioni di configurazione standard di Expressive Code](https://github.com/expressive-code/expressive-code/blob/main/packages/astro-expressive-code/README.md#configuration) così come alcune proprietà specifiche di Starlight, impostandole nell'opzione `expressiveCode` di Starlight.
+Ad esempio, imposta l'opzione `styleOverrides` di Expressive Code per sovrascrivere il CSS predefinito. Questo permette personalizzazioni come dare ai tuoi blocchi di codice angoli arrotondati:
```js ins={2-4}
starlight({
@@ -364,7 +398,7 @@ starlight({
});
```
-Se vuoi disabilitare Expressive Code, imposta `expressiveCode: false` nella configurazione di Starlight:
+Se vuoi disabilitare Expressive Code, imposta `expressiveCode: false` nella tua configurazione Starlight:
```js ins={2}
starlight({
@@ -372,66 +406,66 @@ starlight({
});
```
-In aggiunta alle opzioni standard di Expressive Code, puoi anche impostare le seguenti proprietĂ  specifiche di Starlight nella tua configurazione `expressiveCode` per personalizzare ulteriormente il comportamento del tema per i tuoi blocchi di codice:
+Oltre alle opzioni standard di Expressive Code, puoi anche impostare le seguenti proprietĂ  specifiche di Starlight nella tua configurazione `expressiveCode` per personalizzare ulteriormente il comportamento del tema per i tuoi blocchi di codice:
#### `themes`
-**tipo:** `Array<string | ThemeObject | ExpressiveCodeTheme>`
+**tipo:** `Array<string | ThemeObject | ExpressiveCodeTheme>`
**predefinito:** `['starlight-dark', 'starlight-light']`
-Imposta i temi utilizzati per dare stile ai blocchi di codice.
-Consulta la [documentazione `themes` di Expressive Code](https://github.com/expressive-code/expressive-code/blob/main/packages/astro-expressive-code/README.md#themes) per i dettagli dei formati di tema supportati.
+Imposta i temi utilizzati per stilizzare i blocchi di codice.
+Consulta la [documentazione di Expressive Code sui `themes`](https://github.com/expressive-code/expressive-code/blob/main/packages/astro-expressive-code/README.md#themes) per i dettagli sui formati di tema supportati.
-Per impostazione predefinita, Starlight utilizza le varianti chiara e scura del tema [Night Owl](https://github.com/sdras/night-owl-vscode-theme) di Sarah Drasner.
+Starlight utilizza di default le varianti scura e chiara del tema [Night Owl](https://github.com/sdras/night-owl-vscode-theme) di Sarah Drasner.
-Se fornisci almeno un tema chiaro e uno scuro, Starlight sincronizzerĂ  automaticamente il tema del blocco di codice attivo con il tema corrente del sito.
+Se fornisci almeno un tema scuro e uno chiaro, Starlight manterrĂ  automaticamente sincronizzato il tema attivo del blocco di codice con il tema corrente del sito.
Configura questo comportamento con l'opzione [`useStarlightDarkModeSwitch`](#usestarlightdarkmodeswitch).
#### `useStarlightDarkModeSwitch`
-**tipo:** `boolean`
+**tipo:** `boolean`
**predefinito:** `true`
-Quando è impostato su `true`, i blocchi di codice passano automaticamente tra temi chiari e scuri quando cambia il tema del sito.
-Quando è impostato su `false`, devi aggiungere manualmente CSS per gestire il passaggio tra più temi.
+Quando `true`, i blocchi di codice passano automaticamente tra i temi chiari e scuri quando cambia il tema del sito.
+Quando `false`, devi aggiungere manualmente CSS per gestire il passaggio tra piĂą temi.
:::note
-Quando imposti `themes`, devi fornire almeno un tema chiaro e uno scuro affinché il cambio di tema in modalità scura di Starlight funzioni.
+Quando imposti `themes`, devi fornire almeno un tema scuro e uno chiaro affinché il cambio di modalità scura di Starlight funzioni.
:::
#### `useStarlightUiThemeColors`
-**tipo:** `boolean`
+**tipo:** `boolean`
**predefinito:** `true` se `themes` non è impostato, altrimenti `false`
-Quando è impostato su `true`, le variabili CSS di Starlight vengono utilizzate per i colori degli elementi dell'interfaccia utente dei blocchi di codice (sfondi, pulsanti, ombre ecc.), in linea con il [tema di colore del sito](/it/guides/css-and-tailwind/#temi).
-Quando è impostato su `false`, vengono utilizzati i colori forniti dal tema di evidenziazione della sintassi attivo per questi elementi.
+Quando `true`, le variabili CSS di Starlight vengono utilizzate per i colori degli elementi dell'interfaccia utente dei blocchi di codice (sfondi, pulsanti, ombre, ecc.), corrispondenti al [tema di colore del sito](/it/guides/css-and-tailwind/#temi).
+Quando `false`, vengono utilizzati i colori forniti dal tema di evidenziazione della sintassi attivo per questi elementi.
-:::note
-Quando si utilizzano temi personalizzati e si imposta su `true`, è necessario fornire almeno un tema chiaro e uno scuro per garantire un contrasto di colore adeguato.
+:::note
+Quando si utilizzano temi personalizzati e si imposta questo su `true`, è necessario fornire almeno un tema scuro e uno chiaro per garantire un contrasto di colore adeguato.
:::
### `pagefind`
-**tipo:** `boolean`
+**tipo:** `boolean`
**predefinito:** `true`
-Definisce se il provider di ricerca predefinito di Starlight [Pagefind](https://pagefind.app/) è abilitato.
+Definisce se il provider di ricerca predefinito del sito di Starlight [Pagefind](https://pagefind.app/) è abilitato.
-Impostalo su `false` per disabilitare l'indicizzazione del tuo sito con Pagefind.
-Ciò nasconderà anche l'interfaccia di ricerca predefinita, se in uso.
+Imposta su `false` per disabilitare l'indicizzazione del tuo sito con Pagefind.
+Questo nasconderĂ  anche l'interfaccia utente di ricerca predefinita se in uso.
### `head`
**tipo:** [`HeadConfig[]`](#headconfig)
-Aggiunge tag all'`<head>` del sito Starlight.
-Può essere utile per aggiungere script e risorse di terze parti.
+Aggiungi tag personalizzati all'`<head>` del tuo sito Starlight.
+Può essere utile per aggiungere analytics e altri script e risorse di terze parti.
```js
starlight({
head: [
- // Esempio : aggiunge Fathom analytics.
+ // Esempio: aggiungi tag script per Fathom analytics.
{
tag: 'script',
attrs: {
@@ -444,6 +478,9 @@ starlight({
});
```
+Le voci in `head` vengono convertite direttamente in elementi HTML e non passano attraverso l'elaborazione [script](https://docs.astro.build/it/guides/client-side-scripts/#script-processing) o [style](https://docs.astro.build/it/guides/styling/#styling-in-astro) di Astro.
+Se hai bisogno di importare risorse locali come script, stili o immagini, [sovrascrivi il componente Head](/it/guides/overriding-components/#riutilizza-un-componente-integrato).
+
#### `HeadConfig`
```ts
@@ -459,25 +496,25 @@ interface HeadConfig {
**tipo:** `boolean`
**predefinito:** `false`
-Controlla se il piè di pagina mostra quando è stata aggiornata l'ultima volta la pagina.
+Controlla se il footer mostra quando la pagina è stata aggiornata l'ultima volta.
-Per impostazione predefinita, questa funzionalità si basa sulla cronologia Git del repository e potrebbe non essere accurata su alcune piattaforme di distribuzione che eseguono [cloni superficiali](https://git-scm.com/docs/git-clone#Documentation/git-clone.txt---depthltdepthgt). Una pagina può sovrascrivere questa impostazione o la data basata su Git utilizzando il [campo frontmatter `lastUpdated`](/it/reference/frontmatter/#lastupdated).
+Per impostazione predefinita, questa funzionalità si basa sulla cronologia Git del tuo repository e potrebbe non essere accurata su alcune piattaforme di distribuzione che eseguono [cloni superficiali](https://git-scm.com/docs/git-clone#Documentation/git-clone.txt---depthltdepthgt). Una pagina può sovrascrivere questa impostazione o la data basata su Git utilizzando il [campo frontmatter `lastUpdated`](/it/reference/frontmatter/#lastupdated).
### `pagination`
**tipo:** `boolean`
**predefinito:** `true`
-Definisci se il piè di pagina deve includere i collegamenti alla pagina precedente e successiva.
+Definisce se il footer deve includere i link alla pagina precedente e successiva.
-Una pagina può sovrascrivere questa impostazione o il testo del collegamento e/o l'URL utilizzando i campi frontmatter [`prev`](/it/reference/frontmatter/#prev) e [`next`](/it/reference/frontmatter/#next).
+Una pagina può sovrascrivere questa impostazione o il testo del link e/o l'URL utilizzando i campi frontmatter [`prev`](/it/reference/frontmatter/#prev) e [`next`](/it/reference/frontmatter/#next).
### `favicon`
**tipo:** `string`
**predefinito:** `'/favicon.svg'`
-Imposta il percorso della favicon predefinita per il tuo sito web che dovrebbe trovarsi nella directory `public/` ed essere valido (`.ico`, `.gif`, `.jpg`, `.png` o `.svg`) file di icone.
+Imposta il percorso del favicon predefinito per il tuo sito web che dovrebbe essere posizionato nella directory `public/` ed essere un file di icona valido (`.ico`, `.gif`, `.jpg`, `.png`, o `.svg`).
```js
starlight({
@@ -485,22 +522,22 @@ starlight({
}),
```
-Se devi impostare varianti aggiuntive o favicon di fallback, puoi aggiungere tag utilizzando l'[opzione`head`](#head):
+Se hai bisogno di impostare varianti aggiuntive o favicon di fallback, puoi aggiungere tag utilizzando l'[opzione `head`](#head):
```js
starlight({
- favicon: '/images/favicon.svg'.
- head: [
+ favicon: '/images/favicon.svg',
+ head: [
// Aggiungi il fallback della favicon ICO per Safari.
- {
- tag: 'link',
- attrs: {
- rel: 'icon',
- href:'/images/favicon.ico',
- sizes: '32x32',
- },
- },
- ],
+ {
+ tag: 'link',
+ attrs: {
+ rel: 'icon',
+ href: '/images/favicon.ico',
+ sizes: '32x32',
+ },
+ },
+ ],
});
```
@@ -509,23 +546,23 @@ starlight({
**tipo:** `string`
**predefinito:** `'|'`
-Imposta il delimitatore tra il titolo della pagina e il titolo del sito nel tag `<title>` della pagina, visualizzato nelle schede del browser.
+Imposta il delimitatore tra il titolo della pagina e il titolo del sito nel tag `<title>` della pagina, che viene visualizzato nelle schede del browser.
-Per impostazione predefinita, ogni pagina ha un `<title>` di `Titolo della pagina | Titolo del sito`.
-Ad esempio, questa pagina è intitolata "Riferimenti configurazione" e questo sito è intitolato "Starlight", quindi il `<title>` per questa pagina è "Riferimenti configurazione | Starlight".
+Per impostazione predefinita, ogni pagina ha un `<title>` del formato `Titolo Pagina | Titolo Sito`.
+Ad esempio, questa pagina è intitolata "Riferimento di Configurazione" e questo sito è intitolato "Starlight", quindi il `<title>` per questa pagina è "Riferimento di Configurazione | Starlight".
### `disable404Route`
-**tipo:** `boolean`
+**tipo:** `boolean`
**predefinito:** `false`
-Disabilita l'iniezione della [pagina 404](https://docs.astro.build/it/basics/astro-pages/#pagina-di-errore-404-personalizzata) predefinita di Starlight. Per utilizzare un percorso `src/pages/404.astro` personalizzato nel tuo progetto, imposta questa opzione su `true`.
+Disabilita l'iniezione della [pagina 404](https://docs.astro.build/it/core-concepts/astro-pages/#pagina-di-errore-404-personalizzata) predefinita di Starlight. Per utilizzare una route `src/pages/404.astro` personalizzata nel tuo progetto, imposta questa opzione su `true`.
### `components`
**tipo:** `Record<string, string>`
-Fornisci i percorsi ai componenti per sovrascrivere le implementazioni predefinite di Starlight.
+Fornisci i percorsi dei componenti per sovrascrivere le implementazioni predefinite di Starlight.
```js
starlight({
@@ -553,3 +590,13 @@ starlight({
```
Consulta il [Riferimento ai plugin](/it/reference/plugins/) per i dettagli sulla creazione dei tuoi plugin personalizzati.
+
+### `credits`
+
+Abilita la visualizzazione di un link "Costruito con Starlight" nel footer del tuo sito.
+
+```js
+starlight({
+ credits: true,
+});
+```