Arquivos HTML aparecem como páginas da web salvas, relatórios exportados, modelos de e-mail e notas geradas por sistemas. Abri-los depende de um navegador e muitas vezes de arquivos que já não estão junto deles. HTML para PDF renderiza um arquivo HTML em páginas fixas, respeitando o CSS e os estilos de impressão, para que o documento possa ser arquivado, impresso ou enviado como um único arquivo independente.
Como usar: HTML para PDF
- Adicione o arquivo .html ou .htm.
- Clique em Converter para PDF.
- Baixe o PDF.
- Veja se faltam imagens ou fontes que o HTML carregava de outro lugar.
Como o HTML é renderizado
O VelloDoc usa o WeasyPrint, um mecanismo de diagramação criado especificamente para transformar HTML e CSS em documentos paginados. Ele aplica as folhas de estilo da página, incluindo regras de impressão como tamanho e margens de @page, controles de quebra de página e estilos @media print, o que o torna ótimo para notas e relatórios feitos para impressão. Estilos escritos dentro do arquivo e imagens incorporadas como data URI são renderizados normalmente.
O que é removido por segurança
Um HTML enviado pode conter código e referências que nunca deveriam rodar em um servidor. Tags script são removidas antes da renderização, o WeasyPrint não executa JavaScript de jeito nenhum, e requisições para endereços remotos da web e arquivos locais são bloqueadas. Por isso, imagens, fontes e folhas de estilo que o HTML carrega da internet vão faltar no PDF. Para mantê-las, incorpore-as no arquivo ou use o Página web para PDF para páginas que estão publicadas na internet.
Arquivo HTML ou página da web?
Use HTML para PDF para arquivos que você tem, como relatórios exportados ou modelos salvos, e Página web para PDF quando o conteúdo está em um endereço público. Páginas que montam o conteúdo com JavaScript ficam ruins nos dois, porque nenhum deles executa scripts; nesse caso, é melhor imprimir em PDF pelo seu próprio navegador. Para arquivos em Markdown, o Markdown para PDF é mais simples. O guia de formatos trata da escolha de formatos de forma mais ampla.
Quando usar: HTML para PDF
Notas e recibos gerados por sistemas
Transforme notas em HTML geradas pelo sistema de faturamento em PDFs para clientes e registros contábeis.
Páginas da web salvas como registro
Converta uma página salva pelo navegador em um único arquivo, mais fácil de arquivar que um HTML com uma pasta ao lado.
Modelos de e-mail e relatórios
Veja como um modelo HTML fica impresso, ou compartilhe-o com revisores que não trabalham com HTML.
Limitações importantes
HTML para PDF remove os scripts e não executa JavaScript. Com HTML enviado ou colado, recursos remotos e locais são bloqueados, então imagens, fontes e folhas de estilo externas vão faltar, e parte do CSS específico de navegadores aparece diferente. O servidor precisa ter o WeasyPrint instalado.
HTML para PDF: perguntas frequentes
Por que faltam imagens no meu PDF?
Imagens carregadas de endereços da web, ou de arquivos guardados ao lado do HTML, não ficam disponíveis: requisições remotas são bloqueadas e só o arquivo HTML é enviado. Incorpore as imagens como data URI para incluí-las.
O JavaScript é executado?
Não. As tags script são removidas e o renderizador não executa JavaScript, então conteúdo criado por scripts não aparece.
Posso controlar o tamanho da página e as margens?
Sim. Escolha o tamanho de papel, a orientação e as margens nas configurações, ou deixe isso para uma regra @page no CSS do próprio arquivo. Também dá para montar a página com a largura de uma tela de computador ou como uma única página longa.
Por que o layout é diferente do meu navegador?
O WeasyPrint é um mecanismo de diagramação para impressão, e não um navegador, então alguns recursos de CSS específicos de navegadores ou muito recentes são renderizados de outro jeito. CSS pensado para impressão dá os resultados mais previsíveis.
Por que esta ferramenta não está disponível em alguns servidores?
Ela precisa da biblioteca WeasyPrint. Quando o servidor não a tem instalada, a ferramenta avisa claramente.