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
# crea un nuovo progetto con pnpm
pnpm create astro --template starlight
# crea un nuovo progetto con yarn
yarn create astro --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
# aggiorna Starlight con pnpm
pnpm upgrade @astrojs/starlight --latest
# aggiorna Starlight con yarn
yarn upgrade @astrojs/starlight --latest
Puoi esplorare tutte le modifiche effettuate in ogni aggiornamento nel changelog Starlight.