Criar no Gerador

Comece com um modelo

Crie um modelo em Modelos na sua conta ou abra um existente no Gerador. Use Recursos para adicionar texto, títulos, tabelas, imagens ou gráficos. Selecionar um elemento na tela exibe suas configurações no Inspetor.

Layout e espaço disponível

Use Layout para posição, tamanho e alinhamento, e Estilo para tipografia e preenchimento. O fluxo segue a ordem do documento; o posicionamento absoluto serve a elementos com posição específica. Prefira fluxo para relatórios crescentes e verifique quebras de página com dados longos.

Tamanho, margens e preenchimento

Uma largura de 100% ocupa a área contenedora, não a folha inteira. Margens reduzem a área útil do documento e o preenchimento reduz o espaço dentro de um elemento. Tabelas e gráficos em colunas também são limitados pela largura da coluna.

Faça o mesmo pela API

O editor grava a definição do modelo pelo mesmo endpoint que você pode chamar. Leia a definição atual, altere-a e grave-a com a versão que leu, para não sobrescrever acidentalmente uma alteração publicada por outra pessoa nesse intervalo.

# 1 - Baixar a definição usada pelo editor
curl -s https://api.pdfgine.com/api/v1/templates/invoice \
  -H "X-PDFgine-Key: $PDFGINE_KEY" > invoice.json

# 2 - Editar o objeto "definition" em invoice.json

# 3 - Gravar com o mesmo número de versão
curl -X POST https://api.pdfgine.com/api/v1/templates \
  -H "X-PDFgine-Key: $PDFGINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "code": "invoice",
        "name": "Invoice",
        "saveMode": "manual",
        "expectedVersion": 1,
        "changeReason": "Logotipo movido para a margem direita.",
        "definition": { "page": { "size": "A4", "orientation": "portrait" }, "elements": [] }
      }'

expectedVersion torna isso seguro. Se o modelo mudou, a gravação é recusada com 409 e a resposta inclui a versão atual; leia novamente, reaplique sua alteração e grave outra vez.

Salvar e verificar as saídas

Salve as alterações e confira a Prévia e a saída PDF ou Word necessária. Um exemplo que cabe na tela pode criar mais páginas com dados reais longos. Revise títulos, tabelas, etiquetas dos gráficos e quebras de página juntos antes de publicar.

Os problemas mais comuns

• O que você vê no editor é o rascunho. Até publicar, toda renderização de produção continua usando a versão publicada anterior.
• Dados de exemplo são menores que dados reais. Um layout que cabe na tela pode avançar para uma segunda página com nome real de cliente, endereço e trinta linhas.
• 100% se refere à área contenedora, não à folha. Margens e preenchimentos são descontados antes de definir a largura do elemento.
• O posicionamento absoluto não abre espaço. Um elemento em coordenadas fixas permanece no lugar enquanto o conteúdo em fluxo cresce; use flow para tudo que pode ocupar várias páginas.
• Duas pessoas na mesma versão do modelo geram 409, não uma mesclagem. A gravação inclui a versão inicial e é recusada se ela mudou.