Table of Contents
Um índice criado a partir dos títulos de cada artigo, com ligações de salto. Nada para inserir enquanto escreve.
Extensão
Table of Contents
Um índice criado a partir dos títulos de cada artigo, com ligações de salto. Nada para inserir enquanto escreve.
Instalação
Dois passos
- Na administração do EmDash abra Registry, pesquise Table of Contents e clique em Install. Não pede nenhuma permissão.
- Abra Table of Contents no menu da esquerda, vá ao separador Setup e cole o pequeno bloco que mostra no head do seu layout base, normalmente
src/layouts/Base.astro. Se outra pessoa criou o seu site, envie-lhe esse bloco.
É tudo. Cada artigo ou página com títulos suficientes recebe um índice, e os redatores não fazem nada. O separador Settings define o título, que títulos contam, onde fica a lista e se começa recolhida.
Para escolher você mesmo o local exato, coloque “ no modelo do seu artigo. Para deixar um título de fora, dê-lhe data-toc-skip.
Perguntas frequentes
O que faz este plugin?
Lê os títulos de um artigo ou página no navegador do leitor e mostra no topo uma lista de ligações de salto. Clicar numa linha desloca para essa secção, a secção atual é marcada durante a leitura, e a barra de endereços recebe a ligação da secção para que possa ser partilhada. Os redatores não inserem nada.
Que títulos são usados?
À sua escolha: apenas H2, H2 e H3, ou H2 a H4. As linhas H3 ficam por baixo do seu H2. O H1 nunca é usado, porque é o título do artigo.
Os meus títulos não têm id. Funciona na mesma?
Sim. O plugin dá a cada título um id criado a partir do seu texto quando não o tem, por isso as ligações funcionam em qualquer tema.
Posso desativá-lo num artigo curto?
A lista só aparece quando uma página tem pelo menos o número de títulos que definir, três por predefinição. Para toda uma área do site, use Show on com o início de um endereço como /posts.
Onde fica?
Antes do primeiro título, depois do primeiro parágrafo ou no topo da área de conteúdo. Se a quiser noutro sítio, coloque um elemento vazio com data-toc no seu modelo e ela vai para lá.
Um título fica escondido por baixo do meu menu fixo depois de um salto
Defina Sticky header height em Settings com a altura da sua barra de menu em píxeis.
Recolhe alguma coisa?
Não. O plugin não tem acesso ao seu conteúdo e não faz pedidos fora do seu site. A única chamada é o seu site a obter as suas próprias definições.
Abranda o site?
O script tem cerca de 5 KB, carrega depois de a página estar pronta e fica em cache durante um minuto. Nada é carregado de outros servidores.
Registo de alterações
0.1.0
- Primeira versão. Um índice criado a partir dos títulos de cada artigo ou página, com ligações de salto, deslocação suave e a secção atual marcada.
- Definições: título, que níveis de título contam, número mínimo de títulos, posição, numeração, começar recolhido, mostrar em todo o lado ou nos endereços que começam por um caminho, altura do cabeçalho fixo, área de conteúdo.
- Coloque-o você mesmo com
data-toc. Deixe um título de fora comdata-toc-skip. - O separador Setup mostra se o site está a carregar o índice.