Ir al contenido

Editor visual

El portal puede armar una plantilla por ti. Colocas bloques en una página, los llenas con texto y campos, y el editor escribe el HTML y la sintaxis de plantilla que hay detrás. Lo que ves en la página es lo que genera el servicio.

Una plantilla es visual o código. La plantilla visual conserva su dibujo, y el editor reescribe el código a partir de él en cada cambio. La plantilla en código es HTML puro, que editas a mano.

La ventana Nueva plantilla ofrece dos maneras de empezar:

  • Página en blanco o Código, sin nada dentro.
  • Una plantilla lista de la galería, que luego cambias: una factura, un presupuesto, un certificado en página vertical, un certificado en página horizontal y una factura escrita en HTML.

Las plantillas listas traen datos de ejemplo en el idioma del portal, así que muestran un documento completo de inmediato. Son los mismos documentos de los ejemplos de la página de inicio.

La pestaña Bloques añade las piezas de la página. Haz clic para añadir al final, o arrastra un bloque a la página, o a la lista, al lugar que quieras. Elige un bloque para cambiarlo a la derecha.

Bloque Qué es
Título Un título, en tres tamaños.
Texto Un párrafo, con tamaño, peso, color y alineación.
Lista Viñetas o números, escritos a mano o repetidos por cada elemento de una lista de tus datos.
Imagen Una imagen subida, o una cuya dirección es un campo de tus datos.
Detalles Pares de etiqueta y valor.
Tabla Columnas y filas, escritas a mano o repetidas por cada elemento de una lista.
QR / código de barras Un código QR o un código de barras Code 128 de un texto o de un campo.
Columnas Bloques lado a lado, con un ancho para cada columna.
Línea Un filete a lo ancho de la página.
Espacio Altura vacía.
Salto de página Empieza una página nueva.

La lista bajo la paleta, En la página, muestra los bloques en orden. Arrastra un bloque de la página, o una fila de la lista, para ponerlo en otro lugar.

Un texto o un título tiene su propia fuente, elegida de la lista de familias de Google Fonts, cada una dibujada con sus propias letras, y también admite un estilo: mayúsculas, espaciado entre letras, una línea arriba, abajo o a la izquierda, y el espacio alrededor.

En cualquier lugar donde escribes texto puedes insertar un campo que lee de tus datos, como {{ customer.name }}. La pestaña Datos guarda el JSON de ejemplo con que se dibuja la página, para que el editor muestre valores reales mientras trabajas. Los mismos nombres son los que envías en data al generar la plantilla.

Un campo se puede formatear con currency, number o date, como en {{ total | currency }}. La moneda es la de la página, o el valor de un campo de tus datos cuando la página indica uno, así que una sola plantilla sirve para varias monedas. El idioma de la generación decide cómo se escribe el valor; un texto puede tener un idioma propio, para una fecha o un importe que deba leerse de otra manera. Consulta Idiomas y formato.

Los campos que los datos de ejemplo no tienen se muestran en rojo, para que un error de escritura se vea fácilmente.

Una tabla puede tomar sus filas de una lista de tus datos. Elige la lista, por ejemplo items, y escribe lo que muestra cada columna con item, como en {{ item.name }} y {{ item.amount | currency }}. Una columna también puede tener una segunda línea más pequeña, como una descripción bajo un nombre. La tabla puede terminar con una fila de total, y los encabezados se pueden ocultar o dibujar en versalitas.

Cualquier bloque puede mostrarse solo cuando un campo tiene valor, está vacío, es igual o distinto de un texto, o es mayor o menor que un número. Un texto se compara tal como está escrito, así que el número 5 y el texto “5” son iguales; un número se compara como número, también cuando tus datos lo escriben como texto. En el canvas, un bloque que la condición deja fuera aparece como una nota discontinua, para que aún puedas elegirlo.

Un bloque con palabras, imagen, detalles o columnas también puede escribirse una vez por cada elemento de una lista. Dentro, item es el elemento. Una tabla o lista dentro puede leer una lista que el elemento tiene, como item.lines, y outer es el elemento del bloque que se repite.

Activa Mover libremente y arrastra cualquier bloque a cualquier lugar de la página. Se convierte en una caja con posición y ancho, con un asa en el borde derecho para el ancho y los números en sus ajustes, y Volver al flujo lo devuelve al orden. Los bloques del flujo cierran el hueco que deja. Un bloque colocado así está solo en la primera página.

Mientras mueves, líneas discontinuas muestran lo que se alinea con los bordes y el centro de otras cosas y del área que ocupa el contenido, y el espacio hasta las cosas más cercanas se dibuja con su tamaño en milímetros. Mantén Alt, Ctrl o Cmd para mover sin alinear. Los interruptores Reglas y Cuadrícula añaden reglas en centímetros a lo largo de la página y una cuadrícula de cinco milímetros en la que encaja lo que mueves.

Shift+clic añade una cosa a lo elegido, y Ctrl+A elige todo. Lo que haces con una, lo haces con todas: borrar, copiar, bloquear, ocultar. Cuando las cosas están colocadas por posición, los ajustes también ofrecen alinearlas a la izquierda, al centro o a la derecha, arriba, en medio o abajo, repartir tres o más con espacios iguales y agruparlas, para que se elijan y se muevan como una. Una cosa sola se alinea con la página.

Tecla Qué hace
Suprimir Borra lo elegido.
Ctrl+D Lo copia junto al original.
Flechas Mueven lo colocado por posición un milímetro, diez con Shift; en los bloques del flujo, arriba y abajo cambian el orden.
Ctrl+C, Ctrl+X, Ctrl+V Copiar, cortar y pegar, también en otra plantilla.
Ctrl+Z, Ctrl+Shift+Z Deshacer y rehacer.
Esc Quita la selección.
Ctrl+S Guarda.

Un bloque o elemento bloqueado se puede elegir, pero no mover ni cambiar en el canvas, y uno oculto queda fuera del documento. El candado y el ojo están en los ajustes, y las listas muestran una marca.

Guarda el aspecto de un texto como un estilo con nombre: tamaño, peso, color, fuente, espaciado y el resto. Dáselo a otro texto desde la lista de sus ajustes, y cuando cambies un texto que tiene el estilo, puedes actualizar el estilo, lo que actualiza todos los textos que lo tienen. Quitar el estilo de un texto conserva su aspecto, y borrar el estilo también. La pestaña Página lista los estilos.

El bloque QR / código de barras guarda un texto con campos, como https://example.com/pay/{{ number }}, y lo dibuja como código QR o como código de barras Code 128, con el tamaño y, en el código QR, el nivel de corrección de errores. El código se hace cuando se hace el documento, a partir de los datos de ese documento, en formas vectoriales, así que se ve nítido. Un código QR guarda hasta 1000 bytes de texto; un código de barras guarda hasta 80 letras, dígitos y puntuación, sin acentos. Un campo se usa tal como está, y uno ausente no dibuja código.

La pestaña Página define el tamaño (A4 o Carta), la orientación, el margen, las fuentes, el tamaño del texto, los colores, la moneda y el estilo de fecha. La numeración de páginas está desactivada hasta que la pidas.

La pestaña Formas coloca textos, cajas e imágenes por posición en la primera página, sobre o bajo los bloques. Arrastra un elemento en la página para moverlo. Úsala para una banda de color, un marco o un logotipo; los bloques siguen fluyendo desde la parte superior de la página.

Validar informa de lo que el generador no pudo atender. Vista previa genera el documento con el servicio real. La vista previa es gratuita y limitada, y cada página lleva la marca PREVIEW - NOT FOR USE en el margen superior: muestra cómo quedará el documento, y no es un documento para entregar. Una generación hecha por la API se cobra y no lleva marca.

Guarda la plantilla y luego genérala por su id. Salir con cambios sin guardar pregunta antes.

Cada vez que guardas, se conserva la versión que tenía la plantilla, hasta las últimas treinta. El botón Historial las lista con su fecha. Abrir una la pone en el editor como un cambio sin guardar: puedes mirarla, cambiarla, deshacerla y guardarla para que ocupe el lugar de la plantilla.

Código muestra el HTML que producen los bloques, de solo lectura. Para cambiarlo a mano, elige Solo código. La plantilla deja de ser visual y el dibujo se descarta, y esto no se puede deshacer.

El editor escribe lo que genera el servicio, así que tiene los mismos límites que cualquier plantilla; consulta HTML y CSS admitidos. Una caja de las formas es un rectángulo, de esquinas rectas, y lo colocado por posición está en la primera página. Para una lógica que vaya más allá de una condición sobre un campo y una repetición sobre una lista, escribe la plantilla como código.