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.
Empezar una plantilla
Sección titulada «Empezar una plantilla»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.
Bloques
Sección titulada «Bloques»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.
Campos y datos de ejemplo
Sección titulada «Campos y datos de ejemplo»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.
Tablas que se repiten
Sección titulada «Tablas que se repiten»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.
Condiciones y repeticiones
Sección titulada «Condiciones y repeticiones»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.
Colocar las cosas libremente
Sección titulada «Colocar las cosas libremente»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.
Elegir varias cosas
Sección titulada «Elegir varias cosas»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.
Estilos de texto
Sección titulada «Estilos de texto»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.
Códigos QR y códigos de barras
Sección titulada «Códigos QR y códigos de barras»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 página y las formas
Sección titulada «La página y las formas»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.
Vista previa, validación y guardar
Sección titulada «Vista previa, validación y guardar»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.
Historial
Sección titulada «Historial»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.
Pasar a código
Sección titulada «Pasar a código»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.
Lo que el editor no hace
Sección titulada «Lo que el editor no hace»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.