DocumentaciónAEM GuidesDocumentación de AEM Guides

Trabajo con el motor nativo de PDF v2

Última actualización: 17 de junio de 2026

Creado para:

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

El nuevo motor de publicación Native PDF engine v2 se basa en un marco de trabajo actualizado de generación de PDF e incluye cambios en la administración de fuentes, el procesamiento CSS y el comportamiento de procesamiento.

Como resultado, la salida de PDF generada con el nuevo motor de publicación puede diferir de la salida generada con el motor de PDF existente (Motor de PDF nativo v1). Las diferencias pueden ser visibles en áreas como el diseño del texto, el espaciado, el estilo, el procesamiento de imágenes y el formato de notas al pie.

Por ejemplo, el motor nativo PDF v2 admite fuentes OpenType, mientras que el motor nativo PDF v1 se basa principalmente en fuentes TrueType. Mejoras de procesamiento similares pueden afectar al aspecto general de los PDF generados.

Para obtener más información sobre cómo habilitar el motor de publicación nativo de PDF v2 en su entorno, vea Configurar el nuevo motor de publicación para PDF nativo.

Actualizaciones CSS recomendadas para el nuevo motor de publicación

Si desea restaurar el aspecto de la salida de PDF generada por el motor nativo de PDF v1 mientras utiliza el motor nativo de PDF v2, es posible que tenga que actualizar el CSS personalizado. Los cambios CSS recomendados que se describen a continuación pueden ayudar a mantener la coherencia de la salida después de habilitar la nueva configuración.

Descripción
Actualización de CSS recomendada
Las imágenes a escala pueden parecer diferentes debido a los cambios en el comportamiento de procesamiento de las imágenes.
Para restaurar el comportamiento de procesamiento de imágenes, agregue:

image-rendering: pixelated
La alineación de la directriz de la tabla de contenido (TOC) puede aparecer ligeramente diferente debido a los cambios en el comportamiento de la renderización de la directriz.
Para restaurar la alineación de la línea directriz de la TDC, ajuste el estilo de los elementos directrices de la TDC en la hoja de estilo personalizada. Los cambios de CSS necesarios pueden variar según el diseño y el formato de la tabla de contenido.
El espaciado del texto y el ajuste de línea pueden diferir debido a los cambios en la renderización de la fuente y el procesamiento del diseño de glifos.
Si la hoja de estilo usa la familia de fuentes sans-serif o fuentes que muestran diferencias de espaciado, agregue:

-ro-glyph-layout-mode: quality;
Es posible que las referencias a notas al pie ya no aparezcan como marcadores de superíndice debido a los cambios en el estilo predeterminado de las notas al pie.
Para restaurar los marcadores de notas al pie de página de estilo superíndice, agregue:

.fn::footnote-marker
{ content: counter(footnote) " ";
vertical-align: super;
font-size: 65%;}
El texto subrayado puede aparecer con más espacio entre el texto y el subrayado debido a los cambios en la posición del subrayado.
Para restaurar la posición del subrayado, utilice la propiedad text-underline-offset y ajuste el valor de desplazamiento según sea necesario. Por ejemplo:

text-decoration: underline;
text-underline-offset: -0.1em;
El espaciado entre los marcadores de lista y el texto del elemento de lista puede diferir debido a los cambios en el comportamiento de representación de la lista.
Para restaurar el espaciado, aumente el relleno izquierdo de los elementos de la lista. Por ejemplo:

.step {
margin-top: 0.3rem;
margin-bottom: 0.5rem;
padding-left: calc(1.5rem + 1ch);}
El espaciado antes de los títulos puede diferir debido a los cambios en el comportamiento de contracción de los márgenes.
Para restaurar el espaciado, revise los márgenes de los elementos adyacentes y reduzca o quite los márgenes superiores e inferiores superpuestos donde sea necesario. Por ejemplo:

h1.chapter {
margin-top: 0;
}
chaptoc-body { margin-bottom: 0;
}
Los marcadores de verificación generados con CSS pueden aparecer con diferentes tamaños o estilos porque se representan con diferentes fuentes de reserva.
Para representar los marcadores de forma coherente, utilice una familia de fuentes que contenga ambos glifos. Por ejemplo:

::marker {
font-family: -ro-symbols !important;}
Los marcadores de lista circular generados por CSS pueden aparecer parcialmente recortados o truncados debido a los cambios en el comportamiento de colocación de los marcadores.
Para restaurar el aspecto de los marcadores de lista circular, evite utilizar una posición absoluta para el marcador. Si se requiere una posición absoluta, especifique explícitamente un valor top apropiado para colocar correctamente el marcador.
El orden de lectura de los elementos de lista en la salida de PDF/UA puede diferir cuando los elementos de lista utilizan estilos de colocación como position: relative.
Para hacer que el orden de lectura siga más de cerca la estructura del documento de origen, aplique la siguiente propiedad CSS a los elementos de la lista:

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

Soluciones para problemas conocidos

Las siguientes soluciones pueden ayudar a resolver problemas conocidos en la salida de PDF generada al utilizar el motor de PDF nativo v2.

  • text-decoration propiedades css aplicadas al contenido de la tabla no se representan en la salida de PDF.

    Solución alternativa: aplique las propiedades de decoración de texto a span elementos dentro del contenido de la tabla en lugar de aplicarlas directamente a los elementos de la tabla.

  • Las propiedades CSS -ro-colorbar-top-left y -ro-colorbar-top-right no afectan a la barra de color en la salida de PDF.

    Solución alternativa: quite los valores correspondientes de la hoja de estilos de usuario de mergedHTML.json o agregue !important a los valores de las propiedades del documento CSS para que la hoja de estilos de usuario no los anule.

  • Las barras de color pueden aparecer combinadas cuando el ancho de página está restringido porque las barras de color no se reducen con el tamaño de página en la salida de PDF.

    Solución alternativa: muestre las barras grises y de color en diferentes lados de la página o ajuste la configuración de la barra de color para que no se superpongan en anchos de página más pequeños.

Se han corregido problemas con el nuevo motor de publicación

Los siguientes problemas en la salida de PDF generados con Native PDF Engine v1 se han corregido en Native PDF Engine v2:

  • Al generar una salida nativa de PDF para determinado contenido, solo se procesa la primera página en PDF, a pesar de que la HTML intermedia contenga el contenido completo en varias páginas. (GUIDES-28270)
  • El orden de lectura del contenido en la salida nativa de PDF con la configuración de accesibilidad habilitada es incorrecto. Los números de página de los pies de página se leen antes del contenido principal en lugar de al final. (GUIDES-27790)
  • La barra de color de la salida nativa de PDF no se extiende por el ancho de página completo y se superpone cuando se personaliza el tamaño de página, lo que provoca que algunos cuadros de color se oculten. (GUIDES-15505)
  • El selector CSS:is()pseudo-class no se cumple en la salida nativa de PDF, lo que provoca diferencias de estilo en comparación con la representación del explorador. (GUIDES-11328)
recommendation-more-help
experience-manager-guides-help-product-guide