Footnotes
Proporciona referencias de notas al pie numeradas automáticamente para CKEditor 5 con citas, enlaces de retorno y opciones de agrupación personalizables.
footnotes
Overview
El módulo Footnotes permite a los editores de contenido crear fácilmente referencias de notas al pie numeradas automáticamente en artículos o publicaciones, como referencias a URLs o citas académicas. Proporciona un botón en la barra de herramientas de CKEditor 5 que abre una ventana modal donde los usuarios pueden agregar contenido formateado (negrita, cursiva, enlaces) dentro de las fuentes de las notas al pie.
El módulo crea automáticamente citas en el texto (por ejemplo, [1], [2]) y genera una sección de referencias de notas al pie en la parte inferior del contenido. Cada cita enlaza a su referencia correspondiente, y los enlaces de retorno permiten a los usuarios volver al punto de cita en el texto. Múltiples citas pueden hacer referencia a la misma nota al pie, y las notas idénticas pueden colapsarse en un único número de referencia.
Para diseños complejos con múltiples campos de texto, el módulo proporciona un bloque Footnotes Group que recopila todas las notas al pie de una página y las muestra en una única sección de referencias consolidada. El módulo también se integra con Search API para excluir los marcadores de citas de los índices de búsqueda.
Features
- Botón en la barra de herramientas de CKEditor 5 para insertar notas al pie con una interfaz de diálogo modal
- Numeración automática de notas al pie con valores manuales personalizables
- Enlaces de citas que saltan a la sección de referencias y enlaces de retorno para volver a la cita
- Soporte para múltiples citas que hacen referencia a la misma nota al pie con sufijos alfabéticos (1a, 1b, 1c)
- Opción para colapsar contenido idéntico de notas al pie en un único número de referencia
- Bloque Footnotes Group para consolidar notas al pie de múltiples campos de texto en una sección de referencias
- Agrupación basada en JavaScript para escenarios de contenido con carga diferida
- Opción de modo de diálogo para mostrar el contenido de la nota al pie en una ventana emergente en lugar de saltar a la sección de referencias
- Procesador de Search API para excluir citas de notas al pie de los índices de búsqueda
- Comando Drush para actualizar contenido del formato Footnotes 3.x al 4.x
- Plantillas personalizables para citas, grupos de citas y listas de referencias
- Ruta de actualización automática de CKEditor 4 a CKEditor 5 para la configuración de la barra de herramientas
- Soporte para pegar notas al pie desde documentos de Microsoft Word y LibreOffice
Use Cases
Artículos académicos o de investigación con citas
Use notas al pie para agregar citas de fuentes a contenido académico. Cada cita obtiene un número automático que enlaza a la referencia completa en la parte inferior del artículo. Los lectores pueden hacer clic en las citas para ver las referencias y usar los enlaces de retorno para volver a su posición de lectura.
Documentos legales con referencias
El contenido legal a menudo requiere referencias numeradas a leyes, casos judiciales u otros documentos. El módulo Footnotes proporciona numeración automática y puede colapsar referencias idénticas al mismo número cuando la misma fuente se cita múltiples veces.
Artículos extensos con notas explicativas
Los periodistas y redactores de contenido pueden usar notas al pie para agregar información aclaratoria sin interrumpir la narrativa principal. Habilite la opción de diálogo para mostrar el contenido de la nota al pie en una ventana emergente en lugar de saltar al final de la página.
Páginas con múltiples secciones de contenido
Para páginas que combinan contenido de múltiples campos (como texto del cuerpo y contenido de barra lateral), use el bloque Footnotes Group para recopilar todas las notas al pie en una única sección de referencias consolidada. Coloque el bloque después del área de contenido principal.
Contenido con componentes de carga diferida
Cuando las notas al pie aparecen en contenido de carga diferida (como secciones cargadas por AJAX), habilite la opción 'Agrupar notas al pie usando JavaScript' en el bloque Footnotes Group para asegurar que todas las notas al pie se capturen y numeren correctamente.
Migración de contenido desde otros sistemas
El contenido pegado desde Microsoft Word o LibreOffice que contiene notas al pie puede ser manejado por el módulo. Use el modo de depuración (agregue ?debug=1 a la URL) para solucionar problemas de pegado. El comando de actualización de Drush maneja la migración desde el formato Footnotes 3.x.
Tips
- Copie las plantillas a su directorio de tema y limpie la caché del registro de temas (drush cc theme-registry) para personalizar la apariencia de las notas al pie
- Use la opción 'Colapsar notas al pie con contenido idéntico' para combinar automáticamente citas duplicadas en el mismo número de referencia
- Al usar el bloque Footnotes Group, configure el contexto de entidad a 'node' para asegurar la invalidación de caché apropiada
- Para contenido académico, considere habilitar la opción de diálogo para mejorar la experiencia de usuario mostrando referencias en una ventana emergente
- Pruebe el comando de actualización de Drush exhaustivamente en desarrollo/staging antes de ejecutarlo en contenido de producción
Technical Details
Admin Pages 2
/admin/config/content/formats/manage/{format}
Configurar los ajustes del filtro de Footnotes para un formato de texto específico. Acceder a esto editando cualquier formato de texto que tenga el filtro de Footnotes habilitado.
/admin/config/content/formats/manage/{format}
Configurar la barra de herramientas de CKEditor usada dentro del diálogo modal de Footnotes. Esto usa el formato de texto especial 'Footnote'.
Hooks 1
hook_footnotes_upgrade_3x4x_build_alter
Modifica el render array usado para producir una etiqueta de nota al pie actualizada cuando se actualiza contenido del formato 3.x al 4.x.
Drush Commands 1
drush footnotes:upgrade-3-to-4 <entity_type>
Actualiza el contenido de notas al pie del formato 3.x (etiquetas <fn> y [fn]) al formato 4.x (etiquetas <footnotes> con atributos data). Procesa todas las entidades del tipo especificado que contienen campos de texto formateado con notas al pie.
Troubleshooting 6
Asegúrese de que el filtro de Footnotes esté habilitado en su formato de texto y aparezca antes de los filtros de corrección de HTML. Limpie la caché después de realizar cambios de configuración.
El filtro de Footnotes debe aparecer antes del filtro 'Convertir saltos de línea' en el orden de filtros. El módulo usa un filtro Twig spaceless personalizado para minimizar espacios en blanco.
Habilite la opción 'Agrupar notas al pie usando JavaScript' en la configuración del bloque Footnotes Group. No deshabilite la salida del pie de página de notas al pie cuando use esta opción.
Agregue ?debug=1 a la URL de su página antes de pegar para ver la salida de consola. Verifique que el contenido pegado contenga marcadores de notas al pie reconocibles.
Limpie todas las cachés después de cambiar la configuración 'Deshabilitar salida del pie de página de notas'. Esta configuración afecta cómo se renderiza y almacena en caché el contenido.
Esta es una limitación del núcleo de Drupal - las ventanas modales dentro de ventanas modales no están soportadas. Use enlaces en lugar de medios incrustados dentro de las notas al pie.
Security Notes 3
- El módulo tiene cobertura de seguridad oficial de Drupal
- El contenido de las notas al pie se filtra a través del formato de texto 'footnote' que limita las etiquetas HTML permitidas a br, p, strong, em y enlaces
- El acceso al diálogo de notas al pie requiere el permiso 'use text format footnote'