DocumentaçãoAEM GuidesDocumentação do AEM Guides

Trabalhar com o mecanismo nativo do PDF v2

Última atualização: 17 de junho de 2026

Criado para:

  • {"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"}

O novo mecanismo de publicação Mecanismo nativo do PDF v2, é baseado em uma estrutura de geração do PDF atualizada e inclui alterações no manuseio de fontes, processamento de CSS e comportamento de renderização.

Como resultado, a saída de PDF gerada com o novo mecanismo de publicação pode ser diferente da saída gerada com o mecanismo PDF existente (Mecanismo PDF nativo v1). As diferenças podem ser visíveis em áreas como layout de texto, espaçamento, estilo, renderização de imagem e formatação de nota de rodapé.

Por exemplo, o mecanismo Native PDF v2 oferece suporte a OpenType fontes, enquanto o mecanismo Native PDF v1 depende principalmente de TrueType fontes. Aprimoramentos de renderização semelhantes podem afetar a aparência geral dos PDFs gerados.

Para obter detalhes sobre como habilitar o mecanismo nativo do PDF v2 em seu ambiente, consulte Configurar o novo mecanismo de publicação para o PDF nativo.

Atualizações de CSS recomendadas para o novo mecanismo de publicação

Se você quiser restaurar a aparência da saída do PDF gerada pelo mecanismo nativo do PDF v1 ao usar o mecanismo nativo do PDF v2, talvez seja necessário atualizar seu CSS personalizado. As alterações de CSS recomendadas descritas abaixo podem ajudar a manter a consistência da saída após ativar a nova configuração.

Descrição
Atualização de CSS recomendada
Imagens dimensionadas podem parecer diferentes devido a alterações no comportamento de renderização da imagem.
Para restaurar o comportamento de renderização da imagem, adicione:

image-rendering: pixelated
O alinhamento da guia do índice pode parecer um pouco diferente devido a alterações no comportamento de renderização da guia.
Para restaurar o alinhamento da guia do índice, ajuste o estilo dos elementos da guia do índice na folha de estilos personalizada. As alterações de CSS necessárias podem variar dependendo do layout e da formatação do índice.
O espaçamento e a quebra automática de linha do texto podem diferir devido a alterações na renderização de fonte e no processamento do layout do glifo.
Se sua folha de estilos usar a família de fontes sans-serif ou as fontes que exibem diferenças de espaçamento, adicione:

-ro-glyph-layout-mode: quality;
As referências de nota de rodapé podem não aparecer mais como marcadores sobrescritos devido a alterações no estilo padrão da nota de rodapé.
Para restaurar marcadores de nota de rodapé de estilo sobrescrito, adicione:

.fn::footnote-marker
{ content: counter(footnote) " ";
vertical-align: super;
font-size: 65%;}
O texto sublinhado pode aparecer com mais espaço entre ele e o sublinhado devido a alterações no posicionamento do sublinhado.
Para restaurar o posicionamento de sublinhado, use a propriedade text-underline-offset e ajuste o valor de deslocamento conforme necessário. Por exemplo:

text-decoration: underline;
text-underline-offset: -0.1em;
O espaçamento entre os marcadores de lista e o texto do item de lista pode ser diferente devido a alterações no comportamento de renderização da lista.
Para restaurar o espaçamento, aumente o preenchimento esquerdo para os itens da lista. Por exemplo:

.step {
margin-top: 0.3rem;
margin-bottom: 0.5rem;
padding-left: calc(1.5rem + 1ch);}
O espaçamento antes dos cabeçalhos pode ser diferente devido a alterações no comportamento de recolhimento de margem.
Para restaurar o espaçamento, revise as margens dos elementos adjacentes e reduza ou remova as margens superiores e inferiores sobrepostas, quando necessário. Por exemplo:

h1.chapter {
margin-top: 0;
}
chaptoc-body { margin-bottom: 0;
}
Os marcadores de seleção gerados com CSS podem aparecer com tamanhos ou estilos diferentes, pois são renderizados usando fontes de fallback diferentes.
Para renderizar marcadores de forma consistente, use uma família de fontes que contenha ambos os glifos. Por exemplo:

::marker {
font-family: -ro-symbols !important;}
Os marcadores de lista circular gerados por CSS podem aparecer parcialmente cortados ou truncados devido a alterações no comportamento de posicionamento do marcador.
Para restaurar a aparência dos marcadores de lista circular, evite usar o posicionamento absoluto para o marcador. Se o posicionamento absoluto for necessário, especifique explicitamente um valor top apropriado para posicionar corretamente o marcador.
A ordem de leitura dos itens de lista na saída PDF/UA pode ser diferente quando os itens de lista usam estilos de posicionamento como position: relative.
Para fazer com que a ordem de leitura siga a estrutura do documento de origem mais de perto, aplique a seguinte propriedade CSS aos itens da lista:

li {
-ro-paint-reordering: avoid;}

Soluções alternativas para problemas conhecidos

As soluções alternativas a seguir podem ajudar a resolver problemas conhecidos na saída gerada do PDF ao usar o mecanismo PDF v2 nativo.

  • text-decoration propriedades css aplicadas ao conteúdo da tabela não são renderizadas na saída do PDF.

    Solução alternativa: aplique as propriedades de decoração de texto aos elementos span dentro do conteúdo da tabela, em vez de aplicá-los diretamente aos elementos da tabela.

  • As propriedades CSS -ro-colorbar-top-left e -ro-colorbar-top-right não afetam a barra de cores na saída do PDF.

    Solução alternativa: remova os valores correspondentes da folha de estilos do usuário em mergedHTML.json ou adicione !important aos valores de propriedade no documento CSS para que eles não sejam substituídos pela folha de estilos do usuário.

  • Barras de cores podem aparecer mescladas quando a largura da página é restrita, pois as barras de cores não são dimensionadas para baixo com o tamanho da página na saída do PDF.

    Solução alternativa: exibir as barras cinza e colorida em diferentes lados da página ou ajustar as configurações da barra de cores para que elas não se sobreponham em larguras de página menores.

Correção de problemas com o novo mecanismo de publicação

Os seguintes problemas na saída do PDF gerada com o Mecanismo Nativo do PDF v1 foram corrigidos no Mecanismo Nativo do PDF v2:

  • Ao gerar uma saída Native PDF para determinado conteúdo, somente a primeira página é renderizada no PDF, apesar do HTML intermediário que contém o conteúdo completo em várias páginas. (GUIDES-28270)
  • A ordem de leitura do conteúdo na saída nativa do PDF com as configurações de acessibilidade ativadas está incorreta. Os números de página dos rodapés são lidos antes do conteúdo principal em vez de no final. (GUIDES-27790)
  • A barra de cores na saída do PDF nativo não se alonga pela largura total da página e se sobrepõe quando o tamanho da página é personalizado, fazendo com que algumas caixas de cores fiquem ocultas. (GUIDES-15505)
  • O seletor CSS:is()pseudo-class não é respeitado na saída do PDF nativo, resultando em diferenças de estilo em comparação à renderização do navegador. (GUIDES-11328)
recommendation-more-help
experience-manager-guides-help-product-guide