Astro Narrow modella una serie come un percorso di lettura ordinato, non come un altro termine di taxonomy. Categorie e tag aiutano i lettori a trovare articoli correlati; una serie definisce l’ordine esatto in cui un gruppo di articoli dovrebbe essere letto.
Crea una voce Series#
Le voci Series vivono in src/content/series/<lingua>/. Ogni voce contiene il proprio titolo pubblico, una breve description, un’introduzione Markdown opzionale e un elenco ordinato di reference tipizzati ad articoli.
---title: "Guida pratica ad Astro Narrow"description: "Dalla scrittura dei contenuti alla personalizzazione fino al deployment."chapters: - it/authoring-content-collections - it/configure-series - it/customize-theme-tokens - it/multilingual-content-routing - it/deploy-github-pages---La posizione in chapters è l’ordine dei capitoli. Riordinare l’array cambia il percorso di lettura senza rinominare i file degli articoli o cambiarne gli URL pubblici.
Mantieni le relazioni in un unico posto#
Gli articoli non ripetono il nome di una serie o il numero di capitolo nel proprio frontmatter. Questo evita valori di ordine in conflitto e differenze di ortografia tra le voci. Lo schema reference('posts') di Astro impedisce anche che progetti o pagine vengano usati come capitoli.
Una serie pubblicata segue un contratto di contenuto rigoroso:
- almeno due capitoli;
- nessun reference a capitolo duplicato;
- tutti i capitoli usano la stessa lingua della serie;
- una serie pubblicata non può fare reference a un articolo in bozza;
- un articolo può appartenere a una sola serie pubblicata.
Questi controlli vengono eseguiti durante il build statico di Astro.
Localizza il percorso di lettura#
Crea una voce separata sotto src/content/series/en/ per la versione inglese. Può usare un titolo, un’introduzione e un elenco di capitoli localizzati. Nomi di file corrispondenti rendono prevedibile il cambio lingua, ma le due voci restano contenuti indipendenti.
Capisci le pagine pubbliche#
/series/ elenca i percorsi di lettura disponibili. /series/<slug>/ renderizza l’introduzione e i capitoli ordinati. Un capitolo mostra un piccolo link alla Series sopra il titolo, e la sua navigazione in fondo segue l’ordine della serie invece delle date di pubblicazione.
L’Archivio resta cronologico e continua a filtrare solo per categorie e tag. L’RSS resta limitato agli articoli, mentre la Ricerca e la Sitemap possono individuare le pagine pubbliche delle Series.