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

Para ocultar la ficha Línea base en el tablero de mandos de asignación DITA, realice los siguientes pasos:

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 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.

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 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 el resultado que se ajuste a la 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, consulta Creación de tu primer sitio web de Adobe Experience Manager AEM y Aspectos básicos del desarrollo de tu propio sitio web sobre la creación de sitios web en el sitio web de.

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.

Siga las instrucciones indicadas en Anulaciones de configuración para crear el archivo de configuración. AEM En el archivo de configuración, proporcione los siguientes detalles (property) para configurar la generación de direcciones URL en la salida del sitio de la:

AEM Configure la dirección URL de la salida del sitio de para utilizar el título del documento

AEM Puede utilizar los títulos de los documentos en la dirección URL de la salida del sitio de la. AEM Si el nombre de archivo no existe o contiene todos los caracteres especiales, puede configurar el sistema para que reemplace los caracteres especiales con un separador en la dirección URL de la salida del sitio de la página de la página de la página de la página de la página de la página de la página de la página de la página de la página de salida. También puede configurarlo para que los reemplace por el nombre del primer tema secundario.

Para configurar los nombres de página, realice los siguientes pasos:

Por ejemplo, si el @navtitle de <topichead> tiene todos los caracteres especiales y usted establece la propiedad aemsite.pagetitle en true, de manera predeterminada, usa un separador. Si establece la propiedad nodename.systemDefinedPageName en true, se muestra el nombre del primer tema secundario.

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 (-).

Siga las instrucciones indicadas en Anulaciones de configuración para crear el archivo de configuración. AEM En el archivo de configuración, proporcione los siguientes detalles (property) para configurar los caracteres especiales válidos en los nombres de archivo y en la salida del sitio de la:

También puede configurar otras propiedades, como el uso de minúsculas en los nombres de archivo, el separador para controlar los caracteres no válidos y el número máximo de caracteres permitidos en los nombres de archivo. Para configurar estas propiedades, agregue los siguientes pares de valor clave en el archivo de configuración:

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 Busque una cadena dentro del contenido en la salida de sitio de la red de distribución de datos en la página de salida de sitio de la red

AEM De forma predeterminada, puede buscar una cadena en los títulos solo dentro de la salida del sitio de la. AEM Puede configurar el sistema para que busque una cadena tanto en los títulos como en el contenido o el cuerpo de la salida del sitio de la lista de distribución de contenido ().

AEM Para habilitar la búsqueda, debe configurar el acoplamiento de la estructura de nodos del sitio de la red de distribución de contenido ().

ATENCIÓN:

Puede buscar hasta 1 MB de contenido plano. Por ejemplo, en la captura de pantalla anterior, puede buscar si el contenido de la etiqueta <p> es <= 1Mb.

AEM Impedir el acoplamiento de la estructura de nodos 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:

Configuración del reescritor personalizado con Experience Manager Guides custom-rewriter

Experience Manager Guides tiene un módulo sling rewriter personalizado para administrar los vínculos generados en caso de mapas cruzados (vínculos entre los temas de dos mapas diferentes). Esta configuración de reescritura está instalada en la siguiente ruta:
/apps/fmdita/config/rewriter/fmdita-crossmap-link-patcher.

Si tiene otra reescritura de sling personalizada en la base de código, utilice un valor de 'order' mayor que 50, ya que la reescritura de sling de Experience Manager Guides utiliza 'order' 50. Para anular esto, necesita un valor >50 . Para obtener más información, vea Canalizaciones de reescritura de salida.

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.

Validar el paso de metadatos a DITA-OT para su procesamiento

Para validar los valores de metadatos pasados a DITA-OT, se puede utilizar un entorno local con un JAR preparado para la nube. Dado que no podemos acceder al sistema de archivos local en la nube, la única manera de validar el archivo de metadatos es a través de un JAR listo para la nube.

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 mediante el administrador de paquetes.

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.

Siga las instrucciones indicadas en Anulaciones de configuración para crear el archivo de configuración. En el archivo de configuración, proporcione los siguientes detalles (property) 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.

Siga las instrucciones indicadas en Anulaciones de configuración para crear el archivo de configuración. En el archivo de configuración, proporcione los siguientes detalles (property) para cambiar el número de salidas que se mostrarán en la lista: