Salta ai contenuti

Iniziamo

Creare un nuovo progetto

Starlight è un tema per documentazione completo di funzionalità costruito su Astro.

Puoi creare un nuovo progetto Astro + Starlight usando il comando:

# crea un nuovo progetto con npm
npm create astro@latest -- --template starlight

Questo creerà una nuova cartella del progetto con tutti i file e configurazioni necessarie per il tuo sito.

Creare contenuti con Starlight

Starlight è pronto per aggiungere nuovi contenuti, compresi i tuoi file!

Formati dei file

Starlight supporta la creazione di contenuti in Markdown e MDX. (Puoi aggiungere il supporto per Markdoc installando l’integrazione sperimentale Astro Markdoc).

Aggiungere pagine

Aggiungi pagine automaticamente creando file .md o .mdx in src/content/docs/. Aggiungi sotto-cartelle per organizzare i file e creare percorsi multipli:

src/content/docs/hello-world.md => il-tuo-sito.com/hello-world
src/content/docs/guides/faq.md => il-tuo-sito.com/guides/faq

Type-safe frontmatter

Tutte le pagine Starlight condividono un insieme comune di proprietà personalizzabile per controllare come la pagina deve apparire:

---
title: Ciao Mondo!
description: Questa è una pagina nel mio sito Starlight.
---

Se dovessi dimenticare qualcosa di importante, Starlight te lo farà sapere.

Pubblicare il sito Starlight

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.

Impara come pubblicare un sito nella documentazione Astro

Aggiornare Starlight

Starlight è un’integrazione per Astro, si aggiorna come qualsiasi integrazione @astrojs/*:

# aggiorna Starlight con npm
npm install @astrojs/starlight@latest

Puoi esplorare tutte le modifiche effettuate in ogni aggiornamento nel changelog Starlight.

Risoluzione dei problemi relativi a Starlight

Sia le informazioni sulla configurazione del progetto che sulla configurazione del frontmatter della singola pagina 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.

Consulta l’elenco crescente di guide nella barra laterale per ricevere assistenza nell’aggiunta di contenuti e nella personalizzazione del tuo sito Starlight.

Se non è possibile trovare la risposta in questi documenti, visitare la documentazione completa di Astro per la documentazione completa di Astro. È possibile rispondere alla tua domanda comprendendo come funziona Astro in generale, sotto questo tema Starlight.

Puoi anche verificare eventuali problemi di Starlight noti su GitHub e ottenere assistenza nella sezione Astro Discord 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!