¿Existe una forma 'nativa' de incluir su propia página HTML, CSS y Javascript en un sitio generado por Antora?
Incluir un archivo HTML en la fuente Asciidoc con estilo CSS en línea funciona solo para HTML y CSS como este (vea la imagen adjunta para ver el resultado):
++++ include::partial$test.html[] ++++Sin embargo, si tuviera que separar el CSS y agregar Javascript, los archivos .css y .js no se publicarán, ya que no se incluyen directamente en ninguna parte y el HTML incluido sigue el estilo definido por el paquete de la interfaz de usuario.
La copia manual de los archivos CSS y Javascript en el lugar correcto en los archivos de compilación funciona como se esperaba (la página de Antora tiene el estilo y ejecuta .js como se esperaba)
Creo que la mayoría de la documentación de Antora es el producto de alguna canalización de CI/CD, por lo que probablemente podría agregar CSS y Javascript a los archivos de compilación como parte de la canalización, pero esa es una solución complicada.
Lo que realmente se requiere es una forma de obligar a Antora a publicar algunos archivos o carpetas 'extra'.
Entiendo que el objetivo de Antora es hacer una documentación con estilo y formato consistentes. La razón para querer hacer esto es incluir gráficos interactivos generados por Plotly o Bokeh en la documentación.
También abre la posibilidad de incluir cualquier tipo de ventana interactiva, como un botón para reproducir música. En mi caso quiero tener un 'libro de acordes interactivo' que toque y resalte las notas en acordes musicales.
Su bloque de transferencia de muestra funciona porque el archivo incluido se inserta en el flujo de contenido en esa posición. El archivo test.html no se publica en sí mismo, pero su contenido existe dentro del archivo mediante la macro de include .
De manera similar, si usó este bloque parcial:
++++ include::partial$test.js[] ++++ El contenido de test.js se inyecta en el flujo de contenido en ese punto. test.js en sí mismo no necesita ser publicado si simplemente está incrustando algunas líneas de código.
Si necesita que se publique test.js , tiene tres opciones:
Almacene test.js en la carpeta de attachments del módulo (en lugar de partials . La carpeta de partials está diseñada para contener documentos Asciidoc "pequeños" que se usan varias veces). include::attachment$test.js[] , pero ese archivo se copia en la carpeta de compilación.
Utilice archivos_suplementarios: https://docs.antora.org/antora/latest/playbook/ui-supplemental-files/ Los archivos supplemental_files le permiten personalizar los activos en la interfaz de usuario.
Bifurque la interfaz de usuario y agregue sus personalizaciones directamente.
Los dos últimos enfoques serían preferibles. Actualmente, Antora solo publica HTML. En el futuro, es posible que se publique en otros formatos de salida, incluido PDF. Los archivos PDF no funcionarán bien con HTML, CSS o JavaScript incrustados, por lo que la personalización de la interfaz de usuario es el enfoque preferido. (La generación de PDF probablemente tendrá un soporte de tema distinto, similar a asciidoctor-pdf ).