Table of Contents
Un indice dei contenuti costruito dai titoli di ogni articolo, con link di salto. Niente da inserire durante la scrittura.
Estensione
Table of Contents
Un indice dei contenuti costruito dai titoli di ogni articolo, con link di salto. Niente da inserire durante la scrittura.
Installazione
Due passaggi
- Nell’amministrazione di EmDash apri Registry, cerca Table of Contents e fai clic su Install. Non richiede alcuna autorizzazione.
- Apri Table of Contents nel menu a sinistra, vai alla scheda Setup e incolla il breve blocco che mostra nell’head del tuo layout di base, di solito
src/layouts/Base.astro. Se il tuo sito è stato creato da qualcun altro, mandagli quel blocco.
Ecco tutto. Ogni articolo o pagina con abbastanza titoli ottiene un indice dei contenuti, e gli autori non devono fare nulla. La scheda Settings imposta il titolo, quali titoli contano, dove si trova l’elenco e se parte compresso.
Per scegliere tu stesso il punto esatto, metti “ nel template dell’articolo. Per escludere un titolo, assegnagli data-toc-skip.
FAQ
Cosa fa questo plugin?
Legge i titoli di un articolo o di una pagina nel browser del lettore e mostra in alto un elenco di link di salto. Facendo clic su una riga si scorre fino a quella sezione, la sezione corrente viene evidenziata durante la lettura e la barra degli indirizzi riceve il link alla sezione così da poterlo condividere. Gli autori non inseriscono nulla.
Quali titoli vengono usati?
A tua scelta: solo H2, H2 e H3, oppure da H2 a H4. Le righe H3 stanno sotto il loro H2. H1 non viene mai usato, perché è il titolo dell’articolo.
I miei titoli non hanno id. Funziona comunque?
Sì. Il plugin assegna a ogni titolo che non ne ha un id ricavato dal suo testo, quindi i link funzionano con qualsiasi tema.
Posso disattivarlo su un articolo breve?
L’elenco compare solo quando una pagina ha almeno il numero di titoli che hai impostato, tre per impostazione predefinita. Per un’intera area del sito, usa Show on con l’inizio di un indirizzo come /posts.
Dove si colloca?
Prima del primo titolo, dopo il primo paragrafo, o in cima all’area del contenuto. Se lo vuoi altrove, metti un elemento vuoto con data-toc nel tuo template e andrà lì.
Un titolo si nasconde sotto il mio menu fisso dopo un salto
Imposta Sticky header height in Settings all’altezza della tua barra del menu in pixel.
Raccoglie qualcosa?
No. Il plugin non ha accesso ai tuoi contenuti e non effettua richieste al di fuori del tuo sito. L’unica chiamata è il tuo sito che recupera le proprie impostazioni.
Rallenta il sito?
Lo script pesa circa 5 KB, si carica quando la pagina è pronta e viene messo in cache per un minuto. Non viene caricato nulla da altri server.
Registro delle modifiche
0.1.0
- Prima versione. Un indice dei contenuti costruito dai titoli di ogni articolo o pagina, con link di salto, scorrimento fluido e sezione corrente evidenziata.
- Impostazioni: titolo, quali livelli di titolo contano, numero minimo di titoli, posizione, numerazione, partenza compressa, mostra ovunque o sugli indirizzi che iniziano con un percorso, altezza dell’header fisso, area del contenuto.
- Posizionalo tu stesso con
data-toc. Escludi un titolo condata-toc-skip. - La scheda Setup mostra se il sito sta caricando l’indice dei contenuti.