Struttura del progetto
Questa guida ti mostrerà come un progetto Starlight è organizzato e cosa i file nel progetto fanno.
I progetti Starlight seguono generalmente la stessa struttura di file e cartelle come altri progetti Astro. Vedi la documentazione sulla struttura dei progetti Astro per più dettagli.
File e cartelle
astro.config.mjs— Il file di configurazione di Astro; include l’integrazione Starlight e la sua configurazione.src/content/config.ts— File di configurazione delle collezioni; aggiunge il frontmatter di Starlight al tuo progetto.src/content/docs/— File dei contenuti. Starlight trasforma i file.md,.mdxo.mdocin questa cartella in una pagina del tuo sito.src/content/i18n/(opzionale) — Supporto all’internazionalizzazione.src/— Altri file (componenti, stili, immagini, ecc.) che aggiungi al progetto.public/— Asset statici (font, favicon, PDF, etc.) che non saranno processati da Astro.
Esempio struttura di un progetto
La struttura di un progetto Starlight potrebbe essere questa:
Directorypublic/
- favicon.svg
Directorysrc/
Directoryassets/
- logo.svg
- screenshot.jpg
Directorycomponents/
- CustomButton.astro
- InteractiveWidget.jsx
Directorycontent/
Directorydocs/
Directoryguides/
- 01-getting-started.md
- 02-advanced.md
- index.mdx
- config.ts
- env.d.ts
- astro.config.mjs
- package.json
- tsconfig.json