Editor visual
O portal pode montar um template para você. Você coloca blocos numa página, preenche com texto e campos, e o editor escreve o HTML e a sintaxe de template por trás. O que aparece na página é o que o serviço gera.
Um template é visual ou código. O template visual guarda o desenho, e o editor reescreve o código a partir dele a cada mudança. O template em código é HTML puro, que você edita à mão.
Começando um template
Seção intitulada “Começando um template”A janela Novo template oferece duas formas de começar:
- Página em branco ou Código, sem nada dentro.
- Um template pronto da galeria, que você então altera: uma fatura, um orçamento, um certificado em página retrato, um certificado em página paisagem e uma fatura escrita em HTML.
Os templates prontos vêm com dados de exemplo no idioma do portal, então já mostram um documento completo. São os mesmos documentos dos exemplos da página inicial.
A aba Blocos adiciona as peças da página. Clique para adicionar no fim, ou arraste um bloco para a página, ou para a lista, no lugar que quiser. Selecione um bloco para alterá-lo na direita.
| Bloco | O que é |
|---|---|
| Título | Um título, em três tamanhos. |
| Texto | Um parágrafo, com tamanho, peso, cor e alinhamento. |
| Lista | Marcadores ou números, escritos à mão ou repetidos para cada item de uma lista dos seus dados. |
| Imagem | Uma imagem enviada, ou uma cujo endereço é um campo dos seus dados. |
| Detalhes | Pares de rótulo e valor. |
| Tabela | Colunas e linhas, escritas à mão ou repetidas para cada item de uma lista. |
| QR / código de barras | Um QR code ou um código de barras Code 128 de um texto ou de um campo. |
| Colunas | Blocos lado a lado, com uma largura para cada coluna. |
| Linha | Um filete atravessando a página. |
| Espaço | Altura vazia. |
| Quebra de página | Começa uma nova página. |
A lista abaixo da paleta, Na página, mostra os blocos em ordem. Arraste um bloco da página, ou uma linha da lista, para colocá-lo em outro lugar.
Um texto ou um título tem a sua própria fonte, escolhida na lista de famílias do Google Fonts, cada uma desenhada com as próprias letras, e também aceita um estilo: letras maiúsculas, espaçamento entre letras, uma linha acima, abaixo ou à esquerda, e o espaço ao redor.
Campos e dados de exemplo
Seção intitulada “Campos e dados de exemplo”Em qualquer lugar em que você digita texto, pode inserir um campo que lê dos seus
dados, como {{ customer.name }}. A aba Dados guarda o JSON de exemplo com que a página
é desenhada, para o editor mostrar valores reais enquanto você trabalha. Os mesmos nomes são
os que você envia em data ao gerar o template.
Um campo pode ser formatado com currency, number ou date, como em
{{ total | currency }}. A moeda é a definida na página, ou o valor de um campo dos seus
dados quando a página indica um, então um só template atende várias moedas. O idioma da
geração decide como o valor é escrito; um texto pode ter um idioma próprio, para uma data
ou um valor que deve ser lido de outro jeito. Veja Idiomas e formatação.
Campos que os dados de exemplo não têm aparecem em vermelho, para que um erro de digitação seja fácil de ver.
Tabelas que se repetem
Seção intitulada “Tabelas que se repetem”Uma tabela pode tirar suas linhas de uma lista dos seus dados. Escolha a lista, por exemplo
items, e escreva o que cada coluna mostra com item, como em {{ item.name }} e
{{ item.amount | currency }}. Uma coluna também pode ter uma segunda linha menor, como uma
descrição sob um nome. A tabela pode terminar com uma linha de total, e os cabeçalhos podem
ser ocultados ou desenhados em versalete.
Condições e repetições
Seção intitulada “Condições e repetições”Qualquer bloco pode ser mostrado só quando um campo tem valor, está vazio, é igual ou diferente de um texto, ou é maior ou menor que um número. Um texto é comparado como está escrito, então o número 5 e o texto “5” são iguais; um número é comparado como número, também quando os seus dados o escrevem como texto. No canvas, um bloco deixado de fora pela condição aparece como uma nota tracejada, para que você ainda possa selecioná-lo.
Um bloco com palavras, imagem, detalhes ou colunas também pode ser escrito uma vez para cada
item de uma lista. Dentro dele, item é o item. Uma tabela ou lista dentro dele pode ler uma
lista que o item tem, como item.lines, e outer é o item do bloco que se repete.
Colocando as coisas livremente
Seção intitulada “Colocando as coisas livremente”Ligue Mover livremente e arraste qualquer bloco para qualquer lugar da página. Ele vira uma caixa com posição e largura, com uma alça na borda direita para a largura e os números nas configurações, e Voltar ao fluxo o devolve à ordem. Os blocos do fluxo fecham o espaço que ele deixa. Um bloco colocado assim fica só na primeira página.
Enquanto você move, linhas tracejadas mostram o que se alinha com as bordas e o meio das outras coisas e da área que o conteúdo ocupa, e o espaço até as coisas mais próximas é desenhado com o tamanho em milímetros. Segure Alt, Ctrl ou Cmd para mover sem alinhar. Os botões Réguas e Grade acrescentam réguas em centímetros ao longo da página e uma grade de cinco milímetros em que o que você move encaixa.
Selecionando várias coisas
Seção intitulada “Selecionando várias coisas”Shift+clique soma uma coisa ao que está selecionado, e Ctrl+A seleciona tudo. O que se faz com uma, faz-se com todas: apagar, copiar, bloquear, ocultar. Quando as coisas estão colocadas por posição, as configurações também oferecem alinhá-las à esquerda, ao centro ou à direita, ao topo, ao meio ou embaixo, distribuir três ou mais com espaços iguais e agrupá-las, para que sejam selecionadas e movidas como uma só. Uma coisa sozinha alinha com a página.
| Tecla | O que faz |
|---|---|
| Delete | Apaga o que está selecionado. |
| Ctrl+D | Copia ao lado do original. |
| Setas | Movem o que está colocado por posição de um milímetro, dez com Shift; nos blocos do fluxo, cima e baixo mudam a ordem. |
| Ctrl+C, Ctrl+X, Ctrl+V | Copiar, recortar e colar, também em outro template. |
| Ctrl+Z, Ctrl+Shift+Z | Desfazer e refazer. |
| Esc | Tira a seleção. |
| Ctrl+S | Salva. |
Um bloco ou item bloqueado pode ser selecionado, mas não movido nem alterado no canvas, e um oculto fica fora do documento. O cadeado e o olho estão nas configurações, e as listas mostram uma marca.
Estilos de texto
Seção intitulada “Estilos de texto”Salve o visual de um texto como um estilo com nome: tamanho, peso, cor, fonte, espaçamento e o resto. Dê-o a outro texto pela lista das configurações dele, e quando você mudar um texto que tem o estilo, pode atualizar o estilo, o que atualiza todos os textos que o têm. Desvincular o estilo de um texto mantém o visual dele, e apagar o estilo também. A aba Página lista os estilos.
QR codes e códigos de barras
Seção intitulada “QR codes e códigos de barras”O bloco QR / código de barras guarda um texto com campos, como
https://example.com/pay/{{ number }}, e o desenha como QR code ou como código de barras
Code 128, com o tamanho e, no QR code, o nível de correção de erros. O código é feito quando o
documento é, a partir dos dados desse documento, em formas vetoriais, então fica nítido. Um QR
code guarda até 1000 bytes de texto; um código de barras guarda até 80 letras, dígitos e
pontuação, sem acentos. Um campo é usado como está, e um campo ausente não desenha código.
A página e as formas
Seção intitulada “A página e as formas”A aba Página define o tamanho (A4 ou Carta), a orientação, a margem, as fontes, o tamanho do texto, as cores, a moeda e o estilo de data. A numeração de páginas fica desligada até você pedir.
A aba Formas coloca textos, caixas e imagens por posição na primeira página, sobre ou sob os blocos. Arraste um item na página para movê-lo. Use para uma faixa de cor, uma moldura ou um logotipo; os blocos continuam fluindo a partir do topo da página.
Pré-visualização, validação e salvar
Seção intitulada “Pré-visualização, validação e salvar”Validar mostra o que o gerador não conseguiu atender. Pré-visualizar gera o documento
com o serviço de verdade. A pré-visualização é gratuita e limitada, e cada página dela leva a
marca PREVIEW - NOT FOR USE na margem superior: mostra como o documento ficará, e não é um
documento para entregar. Uma geração feita pela API é cobrada e não tem marca.
Salve o template e depois gere-o pelo id. Sair com alterações não salvas pergunta antes.
Histórico
Seção intitulada “Histórico”A cada vez que você salva, a versão que o template tinha é guardada, até as últimas trinta. O botão Histórico as lista com a data. Abrir uma a coloca no editor como uma alteração não salva: você pode ver, mudar, desfazer e salvar para que ocupe o lugar do template.
Passando para código
Seção intitulada “Passando para código”Código mostra o HTML que os blocos produzem, somente leitura. Para alterá-lo à mão, escolha Só código. O template deixa de ser visual e o desenho é descartado, e isso não pode ser desfeito.
O que o editor não faz
Seção intitulada “O que o editor não faz”O editor escreve o que o serviço gera, então tem os mesmos limites de qualquer template; veja HTML e CSS suportados. Uma caixa das formas é um retângulo, de cantos retos, e o que é colocado por posição fica na primeira página. Para lógica além de uma condição sobre um campo e uma repetição sobre uma lista, escreva o template em código.