Table of Contents
Una tabla de contenidos creada a partir de los encabezados de cada entrada, con enlaces de salto. Nada que insertar mientras se escribe.
Extensión
Table of Contents
Una tabla de contenidos creada a partir de los encabezados de cada entrada, con enlaces de salto. Nada que insertar mientras se escribe.
Instalación
Dos pasos
- En la administración de EmDash abra Registry, busque Table of Contents y haga clic en Install. No pide ningún permiso.
- Abra Table of Contents en el menú de la izquierda, vaya a la pestaña Setup y pegue el breve bloque que muestra en el head de su diseño base, normalmente
src/layouts/Base.astro. Si otra persona creó su sitio, envíele ese bloque.
Eso es todo. Cada entrada o página con suficientes encabezados obtiene una tabla de contenidos, y los redactores no hacen nada. La pestaña Settings establece el título, qué encabezados cuentan, dónde se sitúa la lista y si empieza contraída.
Para elegir usted mismo el lugar exacto, ponga “ en la plantilla de su entrada. Para dejar fuera un encabezado, déle data-toc-skip.
Preguntas frecuentes
¿Qué hace este plugin?
Lee los encabezados de una entrada o página en el navegador del lector y muestra arriba una lista de enlaces de salto. Al hacer clic en una línea se desplaza a esa sección, la sección actual se marca mientras se lee, y la barra de direcciones recibe el enlace de la sección para que pueda compartirse. Los redactores no insertan nada.
¿Qué encabezados se usan?
A su elección: solo H2, H2 y H3, o H2 a H4. Las líneas H3 quedan bajo su H2. H1 nunca se usa, porque es el título de la entrada.
Mis encabezados no tienen id. ¿Funciona igualmente?
Sí. El plugin da a cada encabezado un id creado a partir de su texto cuando no lo tiene, así que los enlaces funcionan en cualquier tema.
¿Puedo desactivarlo en una entrada corta?
La lista solo aparece cuando una página tiene al menos el número de encabezados que usted establezca, tres por defecto. Para toda un área del sitio, use Show on con el inicio de una dirección como /posts.
¿Dónde se coloca?
Antes del primer encabezado, después del primer párrafo o en la parte superior del área de contenido. Si la quiere en otro sitio, ponga un elemento vacío con data-toc en su plantilla y irá allí.
Un encabezado queda oculto bajo mi menú fijo después de un salto
Establezca Sticky header height en Settings con la altura de su barra de menú en píxeles.
¿Recopila algo?
No. El plugin no tiene acceso a su contenido y no hace solicitudes fuera de su sitio. La única llamada es la de su sitio obteniendo sus propios ajustes.
¿Ralentiza el sitio?
El script pesa unos 5 KB, se carga cuando la página está lista y se almacena en caché durante un minuto. No se carga nada desde otros servidores.
Registro de cambios
0.1.0
- Primera versión. Una tabla de contenidos creada a partir de los encabezados de cada entrada o página, con enlaces de salto, desplazamiento suave y la sección actual marcada.
- Ajustes: título, qué niveles de encabezado cuentan, número mínimo de encabezados, posición, numeración, empezar contraída, mostrar en todas partes o en las direcciones que empiezan por una ruta, altura del encabezado fijo, área de contenido.
- Colóquela usted mismo con
data-toc. Deje fuera un encabezado condata-toc-skip. - La pestaña Setup muestra si el sitio está cargando la tabla de contenidos.