htmlElementoDesde: 0.13.0Requiere la característica html
El formato de exportación a HTML de Typst (experimental).
--features html o estableciendo la variable de entorno TYPST_FEATURES en html. En la app web, podés habilitarla igualmente como característica experimental. Visitá el issue de seguimiento para seguir el progreso de la exportación a HTML y conocer más sobre las características planeadas.Los archivos HTML describen un documento de forma estructural. El objetivo de la exportación a HTML de Typst es capturar la estructura de un documento de entrada y producir HTML semánticamente rico que conserve esa estructura. El HTML resultante debería ser accesible, legible por personas y editable a mano y con herramientas posteriores.
La exportación a PDF, PNG y SVG, en cambio, producen todas representaciones visuales de un documento totalmente dispuesto. Esta divergencia en las intenciones de los formatos significa que Typst no puede simplemente producir HTML perfecto para tus documentos de Typst existentes. No siempre puede saber cuál es la mejor representación semántica en HTML de tu contenido.
En cambio, te da a vos el control total: podés comprobar el formato de exportación actual mediante la función target y, cuando está establecido en HTML, generar elementos HTML sin procesar. El uso principal previsto de estos elementos es en plantillas y reglas show. De esta manera, el contenido del documento puede ser totalmente independiente del destino de exportación y el contenido se puede compartir entre la exportación a PDF y a HTML.
En el formato de exportación html, Typst producirá un único archivo HTML. También podés usar Typst para crear un sitio web que conste de varios documentos HTML y recursos adicionales. Typst llama a esa colección un bundle y admite este caso de uso con el destino bundle dedicado. Consultá su documentación para aprender más. Tené en cuenta que, tanto en el destino html como en el destino bundle, Typst actualmente siempre emitirá un archivo HTML independiente. Está planeado para el futuro admitir la emisión de fragmentos que se puedan integrar en otros documentos HTML.
Typst actualmente no produce hojas de estilo CSS, sino que se centra en emitir marcado semántico. Por supuesto, podés escribir tus propios estilos CSS y aun así beneficiarte de compartir tu contenido entre PDF y HTML. Para el futuro, planeamos darte la opción de emitir CSS automáticamente, teniendo en cuenta más de tus reglas set existentes.
Exportar como HTML
Línea de comandos
Pasá --format html al subcomando compile o watch, o proporcioná un nombre de archivo de salida que termine en .html. Tené en cuenta que también tenés que pasar --features html o establecer TYPST_FEATURES=html para habilitar este destino de exportación experimental.
Al usar typst watch, Typst lanzará un servidor HTTP con recarga en vivo. Podés configurarlo así:
- Pasá
--portpara cambiar el puerto. (Por defecto, el primer puerto libre del rango 3000-3005.) - Pasá
--no-reloadpara desactivar la inyección de un script de recarga en vivo. (El HTML que se escribe en el disco no se ve afectado en ningún caso.) - Pasá
--no-servepara desactivar por completo el servidor.
App web
La exportación a HTML se puede habilitar como característica experimental en la app web.
Funcionalidad específica de HTML
Typst expone la funcionalidad específica de HTML en el elemento global html. Mirá abajo las definiciones y opciones que contiene.
Parámetros
prettyPor defecto: false
Si se da formato legible al documento HTML producido.
Esto da formato a la salida de una manera más legible para las personas, pero menos eficiente en espacio.