Salida de PDF de Publish
Con AEM Guides, puede generar PDF de temas individuales o un archivo de mapa completo. Puede publicar el contenido en formato de PDF mediante uno de los tres métodos siguientes:
- DITA-OT
Utilice este método para generar una salida de PDF para un mapa desde el panel de mapas. Puede establecer las propiedades de publicación antes de generar el PDF creando un ajuste preestablecido de salida para el mapa que está abierto en el panel de mapas. Para crear o editar un ajuste preestablecido de salida, consulte la sección Explicación de los ajustes preestablecidos de salida en la Guía del usuario as a Cloud Service de AEM Guides.
Para obtener más información acerca de cómo generar un PDF mediante el método DITA-OT, vea Generar PDF mediante DITA-OT.
- FrameMaker Publishing Server (FMPS)
Utilice este método para generar una salida de PDF no sólo a partir del contenido DITA, sino también de los documentos de FrameMaker AEM (.book y .fm) disponibles en el repositorio de la. El PDF se puede crear configurando un ajuste preestablecido de salida y publicarlo mediante FrameMaker Publishing Server (FMPS). Puede diseñar y configurar el aspecto de la salida para PDF y otros formatos, y almacenarla en un archivo de configuración (.sts). Este fichero de configuración lo utiliza FMPS para generar la salida de un fichero .book o de mapa DITA. Para crear o editar un ajuste preestablecido de salida, consulte la sección Explicación de los ajustes preestablecidos de salida en la Guía del usuario as a Cloud Service de AEM Guides.
Para obtener más información sobre la configuración de FMPS, consulte Generar resultados a partir de documentos de FrameMaker.
- Publicación de PDF nativo
Utilice este método para generar una salida de PDF con numerosas funciones basada en los estándares de medios paginados CSS3 y CSS del W3C. Con la publicación de PDF nativos, puede utilizar plantillas para establecer el diseño y el estilo del contenido y aplicar varias configuraciones para ajustar el PDF. Además, puede modificar y crear sus propias plantillas con el editor de plantillas.
Para obtener más información sobre la publicación de PDF nativos, consulte Uso de la publicación de PDF nativos.
Uso de la publicación de PDF nativa native-pdf-publishing
Al crear contenido, es esencial asegurarse de que el contenido esté optimizado para su visualización, edición e impresión. Mediante estándares como W3C CSS3 para el estilo de contenido y los estándares de medios paginados CSS para las propiedades de definición de página como tamaño, márgenes, orientación, saltos de página, encabezados, pies de página y numeración de páginas, puede establecer la vista y el diseño del documento de PDF, lo que garantiza la coherencia y la facilidad de uso. La función de publicación PDF nativo utiliza estos estándares para generar un PDF.
Con la publicación nativa de PDF, puede utilizar plantillas predefinidas para garantizar la coherencia en el diseño y la estructura del contenido, aplicar hojas de estilo para modificar el aspecto de la salida, optimizar el PDF, establecer marcas de impresora, permitir la compatibilidad con lectores de pantalla, establecer la conformidad del PDF, incrustar fuentes y mucho más.
La generación de un PDF mediante la publicación de un PDF nativo tiene dos aspectos:
-
Uso de plantillas para aplicar estilo al contenido, establecer diseños de página y varias configuraciones para ajustar el PDF. Los autores pueden elegir utilizar o modificar las plantillas de ejemplo proporcionadas o crear plantillas personalizadas y establecer las opciones de configuración avanzadas que utilizan los editores y desarrolladores.
-
Cree o configure un ajuste preestablecido de salida de PDF para controlar la configuración del PDF. Una vez creado un ajuste preestablecido de salida de PDF, puede generar el PDF.
Para obtener más información, vea Generar una salida de PDF.
Crear un ajuste preestablecido de salida de PDF create-output-preset
El primer paso para generar una salida de PDF es crear un ajuste preestablecido de salida de PDF, que es una colección de propiedades de publicación asignadas a un mapa. Puede crear un ajuste preestablecido de salida para cualquier mapa que esté abierto en el panel Vista de mapa o configurar un ajuste preestablecido existente para generar rápidamente un PDF para el mismo mapa.
En el ajuste preestablecido de salida del PDF puede seleccionar una plantilla, aplicar condiciones, establecer restricciones para controlar cómo interactúa un usuario con el PDF, configurar ajustes avanzados como compresión, conformidad y mucho más.
Para crear o configurar un ajuste preestablecido de salida de PDF:
-
En la pestaña Salida, haga clic en Ajustes preestablecidos en la barra lateral izquierda.
Se abrirá el panel Ajuste preestablecido.
-
En el panel Ajustes preestablecidos de salida, realice una de las siguientes acciones:
- Haga doble clic en un ajuste preestablecido de salida de PDF predefinido para verlo.
- Haga clic en el icono + de Ajustes preestablecidos para agregar un nuevo ajuste preestablecido de salida de Tipo: PDF
-
Para configurar los ajustes de un ajuste preestablecido de PDF existente:
- Haga clic en el icono Opciones
Puede usar la siguiente configuración en las pestañas General, Metadatos, Diseño, Seguridad y Avanzado para configurar un ajuste preestablecido de salida del PDF:
- Haga clic en el icono Opciones
General
Utilice para especificar la configuración básica de salida, como la ruta de acceso de salida, el nombre del archivo del PDF, etc.
También puede utilizar las siguientes variables integradas para definir la ruta de acceso de salida. Puede utilizar una sola variable o una combinación de ellas para definir esta opción.
${map_filename}: utiliza el nombre de fichero de mapa DITA para crear la ruta de destino.${map_title}: utiliza el título de mapa DITA para crear la ruta de destino.${preset_name}: utiliza el nombre del ajuste preestablecido de salida para crear la ruta de destino.${language_code}: utiliza el código de idioma donde se encuentra el archivo de asignación para crear la ruta de acceso de destino.${map_parentpath}: utiliza la ruta completa del archivo de asignación para crear la ruta de destino.${path_after_langfolder}: utiliza la ruta del archivo de asignación después de la carpeta de idioma para crear la ruta de destino.También puede utilizar las siguientes variables integradas para definir el archivo PDF. Puede utilizar una sola variable o una combinación de ellas para definir esta opción.
${map_filename}${map_title}${preset_name}${language_code}.Para el contenido condicionado, elija entre las siguientes opciones para generar una salida de PDF basada en esas condiciones:
- Ninguno aplicado Seleccione esta opción si no desea aplicar ninguna condición en el mapa y en el contenido de origen.
- Archivo Ditaval Seleccione un archivo DITAVAL para generar contenido condicionado. Para seleccionar, haga clic en Ajuste preestablecido de condición y busque el archivo.
- Ajuste preestablecido de condición Seleccione un ajuste preestablecido de condición en la lista desplegable para aplicar una condición al publicar la salida. Esta opción está visible si se ha añadido una condición para el fichero de mapa DITA. La configuración condicional está disponible en la ficha Ajustes preestablecidos de condición de la consola de mapas DITA. Para obtener más información sobre los ajustes preestablecidos de condición, consulte Usar ajustes preestablecidos de condición.
Utilice las siguientes opciones para crear un PDF que muestre las diferencias de contenido entre dos versiones con barras de cambios:
- Línea de base de la versión anterior Elija la versión de línea de base que desea comparar con la versión actual u otra línea de base. Aparecerá una barra de cambios en el PDF para indicar el contenido modificado. Una barra de cambios es una línea vertical que identifica visualmente el contenido nuevo o revisado. La barra de cambios aparece a la izquierda del contenido que se ha insertado, modificado o eliminado.
Nota: Si selecciona Usar línea de base y elige una línea de base para publicar, la comparación se realizará entre las dos versiones de línea de base seleccionadas. Por ejemplo, si elige la línea de base Versión 1.3 en Usar línea de base y Versión 1.1 en Línea de base de la versión anterior, la comparación se realizará entre la línea de base Versión 1.1 y la línea de base Versión 1.3. - Mostrar texto agregado Seleccione esta opción para mostrar el texto insertado en color verde y subrayado. Esta opción está seleccionada de forma predeterminada.
- Mostrar texto eliminado Seleccione esta opción para mostrar el texto eliminado en color rojo y marcado con un tachado. Esta opción está seleccionada de forma predeterminada.
Nota También puede personalizar el estilo de la barra de cambios, el contenido insertado o el contenido eliminado mediante la hoja de estilo.
Metadatos
Los metadatos son la descripción o definición del contenido. Los metadatos ayudan en la administración de contenido y en la búsqueda de archivos en Internet.
Utilice la pestaña Metadatos para establecer los campos de metadatos como el nombre del autor, el título del documento, las palabras clave, la información de copyright y otros campos de datos para la salida del PDF. También puede agregar metadatos personalizados para la salida del PDF.
Estos metadatos se han asignado a los metadatos de la ficha Descripción dentro de las Propiedades del documento del PDF de salida.
En los ajustes preestablecidos de salida, seleccione PDF > PDF nativo > Metadatos para agregar y personalizar las opciones de metadatos.
-
Usar metadatos agregados en topicmeta
Esta opción está seleccionada de forma predeterminada. Se pueden utilizar los metadatos añadidos en el elemento topicmeta del mapa DITA para rellenar los campos de metadatos de la salida del PDF.
-
XMP Proporcionar archivo de
XMP También puede rellenar directamente los campos de metadatos importando el archivo 🔗 (Plataforma de metadatos extensible). XMP Puede descargar un archivo de muestra de la aplicación desde aquí.
XMP Como alternativa, puede generar un archivo de mediante Adobe Acrobat.
- Haga clic en Archivo > Propiedades en Acrobat.
- En Descripción, haga clic en Metadatos adicionales.
- En el panel izquierdo, seleccione Avanzado.
- Haz clic en Guardar.
XMP Se ha guardado el archivo de en el dispositivo.
-
Proporcionar nombres y valores de metadatos
- Añada un nombre seleccionándolo en la lista desplegable o agregue metadatos personalizados escribiendo directamente en el campo de nombre.
- Introduzca el valor de los metadatos y haga clic en el icono "+".
Los metadatos se añaden a la lista de metadatos del PDF.
También puede utilizar variables para definir los valores de los metadatos. Se pueden utilizar los metadatos definidos para el mapa DITA o el fichero bookmap como variables. Los metadatos se encuentran en el nodo /jcr:content/metadata del mapa DITA o del archivo bookmap.
Cuando se utiliza una variable, su valor se selecciona de las propiedades de metadatos.
Para utilizar una variable, debe definirla en el formato ${<variable>}.
Por ejemplo, una de las propiedades de metadatos definidas en el nodo /jcr:content/metadata esdc:title. Puede especificar ${dc:title}, y el valor del título se utilizará en el resultado final.
Puede utilizar una sola variable o una combinación de ellas para definir los metadatos. Por ejemplo, ${dc:title} ${dc:docstate}. También puede utilizar la combinación de una variable y una cadena. Por ejemplo, View ${dc:title} in ${dc:language}.
Utilice variables de idioma para definir el valor localizado de las propiedades de los metadatos. Según el idioma elegido, el valor localizado se selecciona automáticamente en la salida del PDF. Por ejemplo, puede imprimir "Autor" como el valor de los metadatos en inglés y "Autor" en alemán.
Formato: ${lng:<variable name>}. Por ejemplo, ${lng:author-label} donde author-label es una variable de idioma.
Pase el ratón sobre
Diseño
Utilice para definir los diseños de página y especificar las opciones de vista de página para la salida del PDF, como Visualización de página (Page Display) y definir los niveles de zoom.
También puede seleccionar Examinar plantilla
Utilice la Visualización de página para la vista de página que muestra cómo se muestra el PDF cuando se abre. Seleccione en las opciones desplegables de Visualización de página para elegir una vista preferida.
- Predeterminado se muestra según la configuración predeterminada del visor de PDF en el equipo de un usuario.
- Vista de página única muestra una página cada vez.
- Desplazamiento de página única Muestra una sola página en una columna vertical continua.
- Vista de dos páginas muestra dos páginas en paralelo a la vez. .
- Desplazamiento de dos páginas Muestra un pliego de dos páginas en paralelo con desplazamiento continuo.
Seleccione para cambiar el tamaño de la vista de página que muestra cómo se muestra el PDF cuando se abre.
- Predeterminado se muestra según la configuración predeterminada del visor de PDF en el equipo de un usuario
- 100% Hace que la página aparezca en su tamaño real.
- Ajustar página Hace que el ancho y el alto de la página se ajusten al panel del documento. .
- Ajustar ancho de página Hace que el ancho de la página llene el ancho del panel del documento.
- Ajustar alto de página Hace que el alto de la página ocupe el alto del panel del documento.
Seguridad
Protect el PDF agregando restricciones para abrir y leer el archivo. Utilice las siguientes opciones para evitar el acceso no autorizado.
Seleccione esta opción para restringir la forma en que los usuarios pueden interactuar con el PDF. Especifique una contraseña en el campo Contraseña de propietario para que funcione la siguiente configuración de restricción.
- Impresión Seleccione esta opción para permitir que un usuario imprima el PDF.
- Impresión de calidad de borrador Seleccione esta opción para permitir que un usuario imprima el PDF en una resolución inferior.
- Copia de contenido Seleccione esta opción para permitir que un usuario copie contenido del PDF.
- Anotaciones Seleccione esta opción para permitir que un usuario agregue una nota o comentario en el PDF.
- Modificaciones de contenido Seleccione esta opción para permitir que un usuario modifique el contenido en el PDF.
- Copia de contenido para accesibilidad Seleccione esta opción para permitir que los lectores de pantalla lean y naveguen por el contenido en el PDF.
Ensamblado de documento Seleccione esta opción para permitir que los usuarios inserten páginas en el PDF.
Nota: los usuarios deben escribir la contraseña de propietario para cambiar las restricciones de Archivo > Propiedades en Adobe Acrobat.
Avanzado
Utilice las siguientes opciones para especificar la configuración avanzada para combinar PDF, utilizar compresión, seleccionar el estándar de conformidad y mucho más.
Nota: una fuente solo se puede incrustar si contiene una configuración del proveedor de fuentes que permita su incrustación. Asegúrese de tener la configuración o licencia necesarias antes de incrustar una fuente.
Use texto estático o variables de idioma para publicar la versión localizada de la marca de agua. Según el idioma elegido, el valor localizado se selecciona automáticamente en la salida del PDF. Por ejemplo, puede imprimir "Publicador" como marca de agua en inglés y "Auteure" en francés. Formato
:
${lng:<variable name>}. Por ejemplo, $ {lng:publisher-label} donde publisher-label es una variable de idioma.pasar el ratón por encima
dc:description, dc:language, dc:title y docstate son las propiedades predeterminadas, mientras que puede tener author como propiedad personalizada. Las propiedades de metadatos seleccionadas se pasan al archivo de PDF generado mediante el PDF nativo.Estas propiedades se seleccionaron del archivo
metadataList disponible en:/libs/fmdita/config/metadataList.Este archivo se puede superponer en:
/apps/fmdita/config/metadataList.Generar una salida de PDF generate-pdf-output
Una vez que haya configurado el ajuste preestablecido de salida, puede generar salida desde el panel Ajustes preestablecidos, utilizando la función Generar ajuste preestablecido.
-
En la ficha Autor, seleccione la vista Repositorio.
Se abrirá el panel Repositorio. -
En el panel Repositorio, abra el archivo de mapa DITA en Vista de mapa.
-
En la ficha Salida, haga clic en Ajustes preestablecidos para ver el panel Ajustes preestablecidos.
Para crear o configurar un ajuste preestablecido de salida, consulte Crear un ajuste preestablecido de salida de PDF. -
Para guardar la configuración, haga clic en el icono Guardar todo
-
Haga clic en el icono Generar ajuste preestablecido
Puede ver una barra de progreso junto al ajuste preestablecido de salida seleccionado en el panel Valores de salida. -
Una vez que finalice la generación de resultados, haga clic en el icono Ver resultados
Un cuadro de diálogo Correcto está visible en la esquina inferior derecha de la pantalla.
Si una salida no se realiza correctamente, se muestra el siguiente mensaje de error.
Para ver el registro de errores, haga clic en Descartar, pase el ratón sobre la pestaña del ajuste preestablecido seleccionado y haga clic en
Descargar archivos temporales después de generar la salida del PDF nativo
Si selecciona la opción Descargar archivos temporales en la configuración avanzada, también puede descargar los archivos de HTML provisionales creados al generar la salida del PDF nativo. Una vez que hayas generado el resultado, puedes descargar los archivos temporales usando el icono Descargar archivos temporales
Usar variables de idioma
AEM Guides también es compatible con variables de idioma. Seleccionar variables de idioma
Compatibilidad con documentos de Markdown
Experience Manager Guides también es compatible con sus documentos de Markdown. Los archivos Markdown son fáciles de crear y también
proporciona diversas opciones de formato. Aprenda a crear documentos de Markdown desde el Editor web.
Se pueden añadir temas de Markdown al mapa DITA y generar la salida del PDF mediante los ajustes preestablecidos de salida del PDF nativo. Aprenda a configurar o crear un ajuste preestablecido de salida de PDF.