Salta ai contenuti
understanding astro

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.