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, .mdx o .mdoc in 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