From ae9131e062e9594f42d5175788d04af4c6ee5778 Mon Sep 17 00:00:00 2001 From: casungo Date: Tue, 6 Feb 2024 15:53:17 +0100 Subject: i18n(it): Updated getting-started, index and manual-setup (#1455) Co-authored-by: Chris Swithinbank --- docs/src/content/docs/it/getting-started.mdx | 135 ++++++++++++++++++--------- docs/src/content/docs/it/index.mdx | 120 ++++++++++++++++++++++-- docs/src/content/docs/it/manual-setup.mdx | 4 +- 3 files changed, 206 insertions(+), 53 deletions(-) diff --git a/docs/src/content/docs/it/getting-started.mdx b/docs/src/content/docs/it/getting-started.mdx index dd7bbb9a..2bbe3ab8 100644 --- a/docs/src/content/docs/it/getting-started.mdx +++ b/docs/src/content/docs/it/getting-started.mdx @@ -1,21 +1,24 @@ --- -title: Iniziamo -description: Impara come iniziare a costruire il tuo prossimo sito per documentazione con Starlight per Astro. +title: Come iniziare +description: Scopri come iniziare a costruire il tuo prossimo sito di documentazione con Starlight di Astro. --- import { Tabs, TabItem } from '@astrojs/starlight/components'; -## Creare un nuovo progetto +Starlight è un tema di documentazione completo di funzionalità costruito sulla base del framework [Astro](https://astro.build/it/). +Questa guida ti aiuterà a iniziare con un nuovo progetto. +Consulta le [istruzioni di configurazione manuale](/it/manual-setup/) per aggiungere Starlight a un progetto Astro esistente. -Starlight è un tema per documentazione completo di funzionalità costruito su [Astro](https://astro.build). +## Avvio Rapido -Puoi creare un nuovo progetto Astro + Starlight usando il comando: +### Crea un nuovo progetto + +Crea un nuovo progetto Astro + Starlight eseguendo il seguente comando nel tuo terminale: ```sh -# crea un nuovo progetto con npm npm create astro@latest -- --template starlight ``` @@ -23,7 +26,6 @@ npm create astro@latest -- --template starlight ```sh -# crea un nuovo progetto con pnpm pnpm create astro --template starlight ``` @@ -31,99 +33,142 @@ pnpm create astro --template starlight ```sh -# crea un nuovo progetto con yarn yarn create astro --template starlight ``` -Questo creerà una nuova [cartella del progetto](/it/guides/project-structure/) con tutti i file e configurazioni necessarie per il tuo sito. +Questo creerà una nuova [directory di progetto](/it/guides/project-structure/) con tutti i file e le configurazioni necessari per il tuo sito. -:::tip[Guardalo in azione] -Prova Starlight nel browser: -[apri il template su StackBlitz](https://stackblitz.com/github/withastro/starlight/tree/main/examples/basics). +:::tip[Vedilo in azione] +Prova Starlight nel tuo browser: +[apri il modello su StackBlitz](https://stackblitz.com/github/withastro/starlight/tree/main/examples/basics). ::: -## Creare contenuti con Starlight +### Avvia il server di sviluppo -Starlight è pronto per aggiungere nuovi contenuti, compresi i tuoi file! +Quando lavori in locale, il [server di sviluppo di Astro](https://docs.astro.build/it/reference/cli-reference/#astro-dev) ti consente di visualizzare in anteprima il tuo lavoro e aggiorna automaticamente il browser quando apporti modifiche. -### Formati dei file +All'interno della directory del progetto, esegui il seguente comando per avviare il server di sviluppo: -Starlight supporta la creazione di contenuti in Markdown e MDX. (Puoi aggiungere il supporto per Markdoc installando l'integrazione sperimentale [Astro Markdoc](https://docs.astro.build/en/guides/integrations-guide/markdoc/)). + + -### Aggiungere pagine +```sh +npm run dev +``` -Aggiungi pagine automaticamente creando file `.md` o `.mdx` in `src/content/docs/`. Aggiungi sotto-cartelle per organizzare i file e creare percorsi multipli: + + +```sh +pnpm dev ``` -src/content/docs/hello-world.md => il-tuo-sito.com/hello-world -src/content/docs/guides/faq.md => il-tuo-sito.com/guides/faq + + + + +```sh +yarn dev ``` -### Type-safe frontmatter + + + +Questo registrerà un messaggio nel tuo terminale con l'URL dell'anteprima locale. +Apri questo URL per iniziare a navigare nel tuo sito. + +### Aggiungi contenuti + +Starlight è pronto per aggiungere nuovi contenuti o portare i tuoi file esistenti! + +#### Formato dei file + +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`: -Tutte le pagine Starlight condividono un [insieme comune di proprietà](/it/reference/frontmatter/) personalizzabile per controllare come la pagina deve apparire: +import FileTree from '~/components/file-tree.astro'; + + + +- src/ + - content/ + - docs/ + - guides/ + - faq.md + - hello-world.md + + + +#### 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 Starlight. +description: Questa è una pagina nel mio sito potenziato da Starlight --- ``` -Se dovessi dimenticare qualcosa di importante, Starlight te lo farà sapere. - -## Pubblicare il sito Starlight +Se dimentichi qualcosa di importante, Starlight te lo farà sapere. -Una volta creato e personalizzato il tuo sito Starlight, puoi pubblicarlo in una piattaforma a tua scelta, inclusi Netlify, Vercel, GitHub Pages e molti altri. +### Prossimi passi -[Impara come pubblicare un sito nella documentazione Astro](https://docs.astro.build/en/guides/deploy/) +- **Configura:** scopri le opzioni comuni in ["Personalizzazione di Starlight"](/it/guides/customization/). +- **Naviga:** configura la tua barra laterale con la guida ["Navigazione laterale"](/it/guides/sidebar/). +- **Componenti:** scopri schede incorporate, tabulazioni e altro nella guida ["Componenti"](/it/guides/components/). +- **Distribuisci:** pubblica il tuo lavoro con la guida ["Distribuisci il tuo sito"](https://docs.astro.build/it/guides/deploy/) nella documentazione di Astro. -## Aggiornare Starlight +## Aggiorna Starlight -:::tip[Suggerimento] -Siccome Starlight è un software ancora beta, ci sarano frequentemente aggiornamenti e miglioramenti. Ricordati di aggiornare regolarmente! +:::tip +Poiché Starlight è un software beta, ci saranno frequenti aggiornamenti e miglioramenti. +Assicurati di aggiornare regolarmente Starlight! ::: -Starlight è un'integrazione per Astro, si aggiorna come qualsiasi integrazione `@astrojs/*`: +Starlight è un'integrazione Astro. Puoi aggiornarlo e aggiornare altri pacchetti Astro eseguendo il seguente comando nel tuo terminale: ```sh -# aggiorna Starlight con npm -npm install @astrojs/starlight@latest +npx @astrojs/upgrade ``` ```sh -# aggiorna Starlight con pnpm -pnpm upgrade @astrojs/starlight --latest +pnpm dlx @astrojs/upgrade ``` ```sh -# aggiorna Starlight con yarn -yarn upgrade @astrojs/starlight --latest +yarn dlx @astrojs/upgrade ``` -Puoi esplorare tutte le modifiche effettuate in ogni aggiornamento nel [changelog Starlight](https://github.com/withastro/starlight/blob/main/packages/starlight/CHANGELOG.md). - -## Risoluzione dei problemi relativi a Starlight +Consulta il [changelog di Starlight](https://github.com/withastro/starlight/blob/main/packages/starlight/CHANGELOG.md) per un elenco completo delle modifiche apportate in ogni versione. -Sia le informazioni sulla [configurazione del progetto](/it/reference/configuration/) che sulla [configurazione del frontmatter della singola pagina](/it/reference/frontmatter/) di Starlight sono disponibili nella sezione Riferimenti di questo sito. Utilizza queste pagine per assicurarti che il tuo sito Starlight sia configurato e funzioni correttamente. +## Risoluzione dei problemi di Starlight -Consulta l'elenco crescente di guide nella barra laterale per ricevere assistenza nell'aggiunta di contenuti e nella personalizzazione del tuo sito Starlight. +Usa le pagine di riferimento della [configurazione del progetto](/it/reference/configuration/) e della [configurazione frontmatter della singola pagina](/it/reference/frontmatter/) per assicurarti che il tuo sito Starlight sia configurato e funzionante correttamente. +Consulta le guide nella barra laterale per aiutarti ad aggiungere contenuti e personalizzare il tuo sito Starlight. -Se non è possibile trovare la risposta in questi documenti, visitare la [documentazione completa di Astro](https://docs.astro.build) per la documentazione completa di Astro. È possibile rispondere alla tua domanda comprendendo come funziona Astro in generale, sotto questo tema Starlight. +Se la tua risposta non può essere trovata in questa documentazione, visita la [documentazione completa di Astro](https://docs.astro.build/it/) per la documentazione completa di Astro. +La tua domanda potrebbe trovare risposta comprendendo il funzionamento generale di Astro, sotto questo tema Starlight. -Puoi anche verificare eventuali [problemi di Starlight noti su GitHub](https://github.com/withastro/starlight/issues) e ottenere assistenza nella sezione [Astro Discord](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 dello sviluppo attuale e altro ancora! +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/index.mdx b/docs/src/content/docs/it/index.mdx index 2a161c75..65a02c43 100644 --- a/docs/src/content/docs/it/index.mdx +++ b/docs/src/content/docs/it/index.mdx @@ -24,18 +24,19 @@ hero: import { CardGrid, Card } from '@astrojs/starlight/components'; import AboutAstro from '~/components/about-astro.astro'; +import TestimonialGrid from '~/components/testimonial-grid.astro'; +import Testimonial from '~/components/testimonial.astro'; - Include: Navigazione, ricerca, internazionalizzazione, ottimizzazione del - motore di ricerca, caratteri facili da leggere, evidenziazione del codice, - tema scuro e altro. + Include: Navigazione, ricerca, internazionalizzazione, SEO, caratteri + facili da leggere, evidenziazione del codice, tema scuro e altro. Sfrutta la potenza di Astro. Estendi Starlight con le tue integrazioni e librerie preferite. - + Utilizza il tuo linguaggio markup preferito. Starlight fornisce validazione frontmatter con TypeScript. @@ -45,10 +46,117 @@ import AboutAstro from '~/components/about-astro.astro'; + + + Il team di Astro ha FATTO EVOLVERE il modo in cui la documentazione può essere realizzata e puoi ottenerla tutta out-of-the-box con il loro progetto Starlight. + + + Lo starter kit ufficiale di Astro Starlight è uno strumento davvero incredibile per costruire un sito web di documentazione + + + Starlight è il nostro esempio di riferimento di una grande esperienza utente: la velocità, la comodità e + l'attenzione ai dettagli è fonte di ispirazione. Si occupa della parte tecnica e dell'aspetto, + in modo che tu possa concentrarti sui tuoi contenuti 👏 + + Il team di StackBlitz lo adora assolutamente! + + + Starlight è stato un game changer per me, permettendomi di concentrarmi sulla creazione di contenuti. + + Il suo design intuitivo non solo ottimizza il mio flusso di lavoro ma riduce anche il tempo di onboarding per gli sviluppatori open source. + + + + Ho trascorso un po' più di tempo con Starlight per la documentazione di Course Builder ed è stato ottimo finora. Molte funzionalità utili e in più posso concentrarmi sulla scrittura in Markdown e non smanettare con il sito. + + + Ho iniziato a giocare con Starlight. Devo dire che sono molto colpito dalle prestazioni out-of-the-box. + + 💯💯💯💯 + + + + Starlight è il modo migliore per iniziare con la documentazione, tra + la potenza e la velocità di Astro, e gli strumenti di Starlight, è un match in + paradiso. + + È stato il mio riferimento per un po' di tempo, e continuo ad amarlo! + + + + Ho usato Starlight nel mio ultimo lavoro e mi è piaciuto molto. Ottimi componenti, design + intuitivo e community super-reattiva (ogni volta che qualcuno aveva bisogno di qualcosa, + loro lo avrebbero implementato quasi subito oppure ti avrebbero detto una soluzione alternativa). Esperienza molto piacevole. + + + La documentazione sul mio sito monorepo sembra migliore che mai grazie a Starlight. È estremamente facile da usare senza perdere tutta la potenza di Astro. Grazie per averci lavorato! + + + Starlight è il mio strumento di riferimento per la documentazione. Ha reso super facile aggiungere la documentazione al mio sito web di prodotto fatto con Astro, rispetto alla necessità di usare un sottodominio con un altro strumento. + + + Sto ricostruendo la documentazione della piattaforma WPEngine Atlas. Credimi quando dico che Starlight ha tutto ciò di cui hai bisogno per creare una piattaforma di documentazione di classe A 🙌 + + + Prova Starlight! + + Lo uso per alcuni dei miei siti ed è fantastico. + + + + -Astro è il framework completo progettato per essere veloce. +Astro è un framework completo progettato per essere veloce. Prendi i tuoi contenuti da dove preferisci e pubblica dove vuoi, il tutto con i tuoi componenti UI e librerie preferite. -[Impara Astro](https://astro.build/) +[Impara di più su Astro](https://astro.build/) diff --git a/docs/src/content/docs/it/manual-setup.mdx b/docs/src/content/docs/it/manual-setup.mdx index fffcbf00..f792929c 100644 --- a/docs/src/content/docs/it/manual-setup.mdx +++ b/docs/src/content/docs/it/manual-setup.mdx @@ -5,7 +5,7 @@ description: Scopri come configurare manualmente Starlight per aggiungerlo a un import { Tabs, TabItem } from '@astrojs/starlight/components'; -Il modo più rapido per creare un nuovo sito Starlight è utilizzare `create astro` come mostrato nella [guida introduttiva](/it/getting-started/#creare-un-nuovo-progetto). +Il modo più rapido per creare un nuovo sito Starlight è utilizzare `create astro` come mostrato nella [guida introduttiva](/it/getting-started/#crea-un-nuovo-progetto). Se desideri aggiungere Starlight a un progetto Astro esistente, questa guida spiegherà come. ## Configura Starlight @@ -44,7 +44,7 @@ L'integrazione Starlight è configurata nel file `astro.config.mjs`. Aggiungi un `title` per iniziare: -```js {7-9} +```js ins={8} // astro.config.mjs import { defineConfig } from 'astro/config'; import starlight from '@astrojs/starlight'; -- cgit