basic-erp/apps/api/templates/README.md

Plantillas de los reportes HTML

Cada archivo .njk es una plantilla Nunjucks (sintaxis de Jinja2: {{ x }}, {% for %}, {% if %}) de un reporte HTML. Los reportes (código, parámetros y datos) se declaran en src/htmlreports/html-reports.extensions.ts de la rama del cliente, y sus plantillas van aquí, en una carpeta por cliente (templates/<cliente>/etiquetas.njk).

• Los valores se escapan solos. En la plantilla están los datos que arma el reporte y params (los valores de los parámetros).
• {{ asset('<cliente>/fonts/Fuente.ttf') }} entrega un archivo de esta carpeta (fuente, logo) como data: URI, para que el reporte sea un solo documento.
• Para imprimir: @page { size: letter landscape; margin: … } define el papel y los márgenes (Chrome y Edge los respetan con «Márgenes: predeterminados», «Encabezados y pies de página» desactivados y escala 100 %). Conviene fijar line-height, porque cada motor tiene el suyo por defecto.