Configuración de la generación de salida id181AI0B0E30

AEM Guides incluye muchas opciones de configuración para que personalice el proceso de generación de resultados. Este tema cubre todas las configuraciones y personalizaciones que le ayudarán a configurar su proceso de generación de resultados.

Configure la ficha Línea base en el tablero de mandos de asignación DITA id223MD0D0YRM

Puede configurar y ocultar la pestaña Línea base disponible en el panel de mapas.

La opción Ocultar ficha de línea de base no está habilitada de manera predeterminada y debe habilitarla desde configMgr. Realice los siguientes pasos para habilitar la opción de forma predeterminada en el Editor web:

Configuración del FrameMaker Publishing Server id1678G0Z0TN6

Puede utilizar el FrameMaker Publishing Server (FMPS) para generar resultados para el contenido DITA. La configuración de FMPS le permite generar salidas en varios formatos compatibles con FMPS.

Para configurar AEM Guides para que utilice FMPS, actualice las siguientes propiedades del paquete com.adobe.fmdita.config.ConfigManager en la consola web.

AEM Configuración de la publicación combinada en un sitio de existente id1691I0V0MGR

AEM AEM Si dispone de un sitio de que contiene contenido DITA, puede configurar la salida del sitio de la aplicación para que publique contenido DITA en una ubicación predefinida dentro del sitio. AEM Por ejemplo, en la siguiente captura de pantalla de una página de sitio de la, el nodo ditacontent está reservado para almacenar contenido DITA:

AEM Los nodos restantes de la página se crean directamente desde el editor del sitio de la. La configuración de publicación para publicar contenido DITA en una ubicación predefinida garantiza que el proceso de publicación de AEM Guides no modifique ningún contenido que no sea DITA.

Es necesario realizar las siguientes configuraciones en el sitio existente para permitir la publicación de contenido DITA en un nodo predefinido:

Realice los siguientes pasos para configurar las propiedades de plantilla del sitio existente:

La siguiente captura de pantalla muestra las propiedades agregadas en el nodo de plantilla predeterminado de AEM Guides:

La próxima vez que publique contenido DITA con las configuraciones de plantilla del sitio, el contenido se publicará en los nodos especificados en las propiedades topicContentNode y topicHeadNode.

Sin embargo, para los sitios existentes, debe agregar manualmente los nodos topicContentNode y topicHeadNode.

Realice los siguientes pasos para agregar los nodos necesarios al sitio existente:

AEM Personalizar salida del sitio id166TG0B30WR

AEM Guides admite la creación de salidas en los siguientes formatos:

AEM Para la salida del sitio de la, puede asignar diferentes plantillas de diseño con diferentes tareas de salida. Estas plantillas de diseño pueden representar el contenido DITA en diferentes diseños. Por ejemplo, puede especificar distintas plantillas de diseño para audiencias internas y externas.

También puede utilizar complementos personalizados de DITA Open Toolkit (DITA-OT) con AEM Guides. Puede cargar estos complementos DITA-OT personalizados para generar salidas de PDF de una forma específica.

Personalizar la plantilla de diseño para generar resultados customize_xml-add-on

AEM Guides AEM utiliza un conjunto de plantillas de diseño predefinidas para generar la salida del sitio de la. Puede personalizar las plantillas de diseño de AEM Guides para generar la salida que se ajuste a su marca corporativa. Una plantilla de diseño es una colección de varios estilos (CSS), secuencias de comandos (del lado del servidor y del lado del cliente), recursos (imágenes, logotipos y otros recursos) y nodos JCR que unen todos estos recursos. Una plantilla de diseño puede ser tan sencilla como un único script del lado del servidor con solo un par de nodos JCR o una combinación compleja de estilos, recursos y nodos JCR. Las plantillas de diseño se utilizan en el subsistema de publicación de AEM Guides AEM mientras se genera la salida del sitio, y controlan la estructura, el aspecto y la presentación de la salida generada.

No hay restricciones en cuanto a la ubicación de los recursos de la plantilla de diseño en el servidor, pero suelen estar organizados lógicamente según su función. Por ejemplo, la plantilla predeterminada tiene todos sus archivos JavaScript y CSS almacenados en la carpeta /etc/designs/fmdita/clientlibs/siteoutput/default. Dondequiera que se encuentren estos archivos, se vinculan entre sí mediante una colección de nodos JCR. Juntos, estos nodos JCR y los archivos constituyen la plantilla de diseño completa.

La plantilla de diseño predeterminada enviada con AEM Guides le permite personalizar los componentes de página de aterrizaje, tema y búsqueda. Se puede realizar una copia del diseño por defecto y de las plantillas de referencia correspondientes, así como especificar diferentes componentes para generar la salida deseada.

AEM Realice los siguientes pasos para especificar su propia plantilla de diseño para utilizarla en la generación de resultados del sitio de la red de distribución de contenido ():

Para obtener más información, consulte Creación de su primer sitio web de Adobe Experience Manager AEM 6.3 y Aspectos básicos del desarrollo de su propio sitio web en la.

AEM Utilizar el título del documento para generar la salida del sitio de

AEM Al generar la salida del sitio de, la forma en que se generan las direcciones URL desempeña un papel importante en la capacidad de detección del contenido. Si utiliza nombres de archivo basados en UUID, la generación de direcciones URL basadas en el UUID de sus archivos no sería fácil de buscar. AEM Como administrador o editor, tiene el control sobre cómo desea generar las direcciones URL para la salida del sitio de la. AEM Guides AEM le proporciona una configuración a través de la cual puede elegir generar las direcciones URL de salida del sitio mediante el título del archivo en lugar de utilizar nombres de archivo basados en UUID. De forma predeterminada, para sistemas de archivos basados en UUID, esta opción está activada. AEM Esto implica que, cuando se genera la salida del sitio de la aplicación para sistemas de archivos basados en UUID, los títulos del archivo se utilizan para generar las direcciones URL y no los UUID de los archivos.

AEM Al generar la salida del sitio de, la forma en que se generan las direcciones URL desempeña un papel importante en la capacidad de detección del contenido. AEM En el caso de los sistemas de archivos no basados en UUID, la salida del sitio de la se genera utilizando los nombres de archivo y no los títulos del archivo. AEM Como administrador o editor, tiene el control sobre cómo desea generar las direcciones URL para la salida del sitio de la. AEM Guides AEM le proporciona una configuración a través de la cual puede elegir generar las direcciones URL de la salida del sitio utilizando el título del archivo en lugar de los nombres de archivo. Esta opción está desactivada de forma predeterminada. AEM Esto implica que, cuando se genera la salida del sitio de la página, los nombres de archivo se utilizan para generar las direcciones URL y no para generar el título del archivo. Puede optar por generar las direcciones URL basadas en los títulos del archivo activando esta opción.

AEM Para configurar la generación de direcciones URL en la salida de sitio de la aplicación, realice los siguientes pasos:

AEM Configure las reglas de saneamiento de nombres de archivo para crear temas y publicar resultados del sitio de la id2164D0KD0XA

AEM Como administrador, puede definir una lista de caracteres especiales válidos permitidos en los nombres de archivo, que finalmente forman la dirección URL de la salida de un sitio de. En versiones anteriores, se permitía a los usuarios definir nombres de archivo que contenían caracteres especiales como @, $, >, etc. AEM Estos caracteres especiales daban como resultado una dirección URL codificada en la generación de páginas del sitio de la.

A partir de la versión 3.8, se han añadido configuraciones para definir una lista de caracteres especiales permitidos en los nombres de archivo. De manera predeterminada, la configuración de nombre de archivo válida contiene "a-z A-Z 0-9 - _". Esto implica que, al crear un archivo, puede tener cualquier carácter especial en el título del archivo, pero internamente se reemplazará con un guión (-) en el nombre del archivo. Por ejemplo, puede tener el título del archivo como Introducción 1 o Introduction@1, el nombre de archivo correspondiente generado para ambos casos sería Introducción-1.

Cuando defina una lista de caracteres válidos, recuerde que estos caracteres "*/:[\]|#%{}?&<>"/+" y a space se reemplazarán siempre con un guión (-).

AEM Para configurar los caracteres especiales válidos en los nombres de archivo y en la salida del sitio de la, realice los siguientes pasos:

AEM Configuración del acoplamiento de la estructura de nodos del sitio de la

AEM Cuando se genera la salida del sitio de, se crea internamente un nodo para cada elemento de los temas. Para un mapa DITA con miles de temas, esta estructura de nodos puede llegar a ser demasiado profunda. Este tipo de estructura de nodos profundamente anidados puede tener problemas de rendimiento para sitios más grandes. AEM La siguiente instantánea muestra la estructura de nodos profundamente anidados para una salida de sitio de la:

En la instantánea anterior, observe que hay un nodo creado para cada elemento p y sus subelementos subsiguientes, y que se crea una estructura similar para todos los demás elementos utilizados en el tema.

AEM Guides AEM le permite configurar cómo se crea internamente la estructura de nodos de la salida del sitio de la manera que lo hace. Puede aplanar la estructura del nodo en elementos especificados, lo que significa que puede definir un elemento que se considerará como el elemento principal y todos los subelementos dentro de él se combinarán con el elemento principal. Por ejemplo, si decide acoplar el elemento p, cualquier elemento que aparezca dentro del elemento p se combinará con el elemento principal p. No se crearía una nota independiente para ningún subelemento dentro del elemento p. La siguiente instantánea muestra la estructura de nodos acoplada en el elemento p:

AEM Para acoplar la estructura de nodos del sitio de la, realice los siguientes pasos:

AEM Ahora, cuando genere la salida del sitio de la, los nodos dentro del elemento p se acoplan y almacenan dentro del propio elemento p. Puede encontrar las nuevas propiedades de acoplamiento para el elemento p en CRXDE.

AEM Impedir el aplanamiento de la estructura de notas del sitio de la

AEM De forma similar a especificar el nodo que se va a acoplar en la salida del sitio de la aplicación, también se puede especificar un elemento que desee excluir de esta configuración. Por ejemplo, si desea acoplar nodos en el elemento body, pero no desea acoplar ningún elemento table dentro de body, puede agregar la propiedad de exclusión dentro de la definición del elemento table.

Para excluir el elemento table del acoplamiento, agregue la siguiente propiedad a la definición del elemento table:

<preventancestorflattening>true|false</preventancestorflattening>

AEM Configurar el control de versiones de las páginas eliminadas en la salida del sitio de

AEM Cuando genera la salida del sitio de la con la opción Eliminar y Crear ​ ​seleccionada para la configuración Páginas de salida existentes, se crea una versión para las páginas que se están eliminando. Puede configurar el sistema para que detenga la creación de una versión antes de la eliminación.

Realice los siguientes pasos para detener la creación de una versión para la página que se está eliminando:

Usar metadatos en la salida de publicación mediante DITA-OT id191LF0U0TY4

AEM Guides proporciona una forma de pasar metadatos personalizados al publicar resultados mediante DITA-OT. Como administrador y publicador, deberá realizar las siguientes tareas para configurar y utilizar metadatos personalizados en el resultado publicado:

Para añadir los metadatos necesarios en el sistema, realice los siguientes pasos:

El nuevo parámetro aparece ahora en la página Propiedades para todos los mapas DITA.

A continuación, es necesario que los metadatos personalizados estén disponibles en la consola de mapas DITA. Realice los siguientes pasos para que los metadatos personalizados estén disponibles en el tablero de mandos de mapa DITA:

Ahora los metadatos personalizados se mostrarán en la lista desplegable Propiedades de la consola de mapas DITA.

Por último, como editor, debe incluir los metadatos personalizados en el resultado publicado. Para procesar los metadatos personalizados mientras se genera la salida, realice los siguientes pasos:

Las propiedades/metadatos seleccionados se pasan al proceso de publicación y están disponibles en la salida final.

AEM Personalización de la asignación de elementos DITA con componentes de id1679J600HEL

Los elementos DITA de AEM Guides AEM se asignan a sus correspondientes componentes de. AEM Guides AEM utiliza esta asignación en flujos de trabajo como la publicación y la revisión para convertir un elemento DITA en un componente de correspondiente. La asignación se define en el archivo elementmapping.xml, al cual se puede tener acceso desde el modo CRXDE Lite. Acceda a la siguiente URL en el modo CRXDE Lite:

/libs/fmdita/config/elementmapping.xml

AEM Se pueden utilizar las asignaciones de elementos DITA predefinidas o se pueden asignar elementos DITA a los componentes personalizados de la aplicación de la aplicación de la aplicación de la aplicación de la aplicación de la aplicación de la aplicación de la. AEM Para utilizar los componentes de la personalizada, debe comprender la estructura del archivo elementmapping.xml.

estructura de elementmapping.xml

A continuación se explica una descripción general de alto nivel de la estructura de elementmapping.xml:

Esquema de elemento DITA

A continuación se muestra un ejemplo del esquema de elementos DITA en el archivo elementmapping.xml:

<ditaelement>
    <name>element_name</name>
    <class>element_class</class>
    <componentpath>fmdita/components/dita/component_name</componentpath>
    <type>COMPOSITE|STANDALONE</type>
    <attributeprop>propname_a</attributeprop>
    <textprop>propname_t</textprop>
    <xmlprop>propname_x</xmlprop>
    <xpath>xpath expression string</xpath>
    <target>head|para</target>
    <wrapelement>div</wrapelement>
    <wrapclass>class_name</wrapclass>
    <attributemap>
    <attribute from="attrname" to="propname" ispath="true|false" rel="source|target" />
    </attributemap>
    <skip>true|false</skip>
</ditaelement>

En la tabla siguiente se describen los elementos del esquema de elementos DITA:

Notas adicionales

Personalizar la consola de mapas DITA id188HC08M0CZ

AEM Guides le ofrece la flexibilidad de ampliar las capacidades de la consola de mapas DITA. Por ejemplo, si tiene un conjunto de informes que son diferentes de los disponibles en AEM Guides, puede agregar dichos informes a la consola de mapas. AEM Para personalizar la consola de asignaciones, debe crear una biblioteca de cliente de la biblioteca (o ClientLib) que contenga el código para realizar la funcionalidad que necesita.

AEM Guides proporciona la categoría apps.fmdita.dashboard-extn para personalizar la consola de mapas. Cada vez que se carga la consola de mapas, se ejecuta y carga la funcionalidad creada en la categoría apps.fmdita.dashboard-extn.

Controlar la representación de imágenes durante la generación de salida id177BF0G0VY4

AEM viene con un conjunto de flujos de trabajo predeterminados y controladores de medios para procesar recursos. AEM En la práctica, hay flujos de trabajo predefinidos para gestionar el procesamiento de recursos para los tipos MIME más comunes. AEM Normalmente, para cada imagen que carga, se crean varias representaciones de la misma en formato binario, lo que hace que la imagen se cree más de una vez. Estas representaciones pueden tener un tamaño diferente, con una resolución diferente, con una marca de agua agregada o cualquier otra característica modificada. AEM Para obtener más información acerca de cómo administra los recursos los recursos, vea Procesar Assets AEM mediante controladores de medios y flujos de trabajo en la documentación de la documentación de.

AEM Guides le permite configurar qué representación de imágenes utilizar en el momento de generar la salida de sus documentos. Por ejemplo, puede elegir una de las representaciones de imágenes predeterminadas o crear una y utilizar la misma para publicar los documentos. La asignación de representación de imágenes para publicar los documentos se almacena en el archivo /libs/fmdita/config/ **renditionmap.xml**. Un fragmento del archivo renditionmap.xml es el siguiente:

<renditionmap>
   <mapelement>
      <mimetype>image/png</mimetype>
      <rendition output="AEMSITE">cq5dam.web.1280.1280.jpeg</rendition>
      <rendition output="PDF">original</rendition>
      <rendition output="HTML5">cq5dam.web.1280.1280.jpeg</rendition>
      <rendition output="EPUB">cq5dam.web.1280.1280.jpeg</rendition>
      <rendition output="CUSTOM">cq5dam.web.1280.1280.jpeg</rendition>
   </mapelement>
...
</renditionmap>

El elemento mimetype especifica el tipo MIME del formato de archivo. El elemento rendition output especifica el tipo de formato de salida y el nombre de la representación (por ejemplo, cq5dam.web.1280.1280.jpeg) que se debe utilizar para publicar el resultado especificado. Puede especificar las representaciones de imágenes que se utilizarán para todos los formatos de salida admitidos: AEMSITE, PDF, HTML5, EPUB y PERSONALIZADO.

Si la representación especificada no está presente, el proceso de publicación de AEM Guides busca primero la representación web de la imagen dada. Si no se encuentra ni siquiera la representación web, se utiliza la representación original de la imagen.

Configurar el período de depuración automática para el historial de salida id19AAI070V8Q

Cuando se genera una salida, esta se crea junto con los registros de salida. Para mapas DITA grandes, estos registros pueden ocupar una gran cantidad de espacio en el repositorio. De forma predeterminada, los registros se almacenan en la siguiente ubicación del repositorio:

/var/dxml/metadata/outputHistory/

Durante un período de tiempo, el tamaño colectivo de todos los archivos de registro podría alcanzar los GB. AEM Guides le permite configurar un periodo de tiempo para mantener estos archivos de registro en el repositorio. Después del período de tiempo especificado, los registros junto con el historial de generación de salida se eliminan del repositorio.

La configuración de la función de depuración del historial afecta a la generación de resultados para todas las asignaciones DITA del repositorio. En la ficha Salidas de un mapa DITA, el historial se depura después del número de días especificado y a la hora especificada en la configuración.

Realice los siguientes pasos para establecer un día y una hora para purgar el historial y los registros de salida:

Cambiar el límite de lista de resultados generados recientemente id1679JH0H0O2

Se puede cambiar el número máximo de salidas generadas que se muestran en la ficha Salidas para un mapa DITA. De forma predeterminada, se muestra una lista de las últimas 25 salidas generadas. Para cambiar el número de salidas que se mostrarán en la lista, actualice la configuración Límite de lista de salidas en el paquete com.adobe.fmdita.config.ConfigManager.

Optimización del rendimiento de generación de salida id176LB050VUI

AEM Guides permite configurar el tamaño del grupo de procesos de generación de salida que controla el número de procesos de generación de salida que se ejecutan simultáneamente. De forma predeterminada, el tamaño del grupo de procesos está establecido en el número de núcleos de procesamiento disponibles en el sistema más uno. Puede que desee cambiar este valor a 1 si desea una publicación secuencial. En este caso, se ejecuta la primera tarea de publicación y la siguiente tarea de publicación se almacena en la cola de publicación.

Para cambiar el tamaño del grupo de procesamiento de generación de salida, actualice el valor Tamaño del grupo de generación en el paquete com.adobe.fmdita.publish.manager.PublishThreadManagerImpl.