Ajuste preestablecido de AEM Sites en la consola Mapa
Puede crear ajustes preestablecidos de AEM Sites desde la consola Mapa y configurarlos para generar la salida de AEM Sites. Existen dos formas de crear la salida de AEM Sites:
Usar asignación de componentes compuestos
La asignación de componentes compuestos ofrece una publicación más rápida y escalable en AEM Sites en comparación con la asignación de componentes heredados. Incluye plantillas editables integradas que se pueden personalizar según sus necesidades con el editor de plantillas de AEM. Las plantillas utilizan una combinación de componentes principales de WCM y guides-components especializados para garantizar que los usuarios finales obtengan la mejor experiencia en las páginas de AEM Sites. También puede personalizar las plantillas existentes mediante el método de asignación de componentes compuestos.
Experience Manager Guides proporciona plantillas predefinidas para crear AEM Sites. Estas plantillas le ayudan a garantizar la coherencia en el diseño y la estructura del contenido.
- Crear páginas principales basadas en estas plantillas predefinidas.
- Puede editar plantillas de temas y aplicar estilos según sus necesidades.
- También puede personalizar plantillas de AEM Sites existentes.
Crear ajuste preestablecido de AEM Sites
Realice los siguientes pasos para crear el ajuste preestablecido de AEM Sites mediante la asignación de componentes compuestos:
-
En el panel Ajustes preestablecidos de salida, seleccione el icono + para crear uno de salida.
-
Seleccione AEM Sites de la lista desplegable Type en el cuadro de diálogo Nuevo ajuste preestablecido de salida.
-
Anule la selección de la opción Usar asignación de componentes heredados.
-
Seleccione la opción Agregar al perfil de carpeta actual para crear un ajuste preestablecido de salida dentro del perfil de carpeta actual. El
Obtenga más información sobre Administrar ajustes preestablecidos de salida de perfil global y de carpeta.
-
Seleccione Añadir.
Se crea el ajuste preestablecido de AEM Sites.
Configuración preestablecida de AEM Sites para la asignación de componentes compuestos
- Software On-Premise: Obtenga más información acerca de cómo descargar e instalar plantillas de AEM Sites para software On-Premise.
- Cloud Service: Más información sobre cómo descargar e instalar plantillas de AEM Sites para Cloud Service.
En la consola Mapa, las opciones de configuración preestablecidas para la asignación de componentes compuestos se organizan en las siguientes pestañas:
- General
- Contenido
- Lista de temas
- Referencias entre mapas
General
La ficha General contiene las siguientes opciones de configuración:
También puede utilizar variables al establecer la ruta del sitio. Para obtener información detallada, vea Usar variables para establecer las opciones Ruta de destino, Nombre de sitio o Nombre de archivo
Seleccione Actualizar
AEMG-Docs y la ruta de publicación como aemg-docs-en/docs/product-abc., la salida de AEM Sites se generará en el nodo aemg-docs-en/docs/product-abc/ en crx/de.Título del tema: Utiliza el título del tema DITA para crear los nombres de los sitios Experience Manager.
Supongamos que ha publicado un mapa DITA, que contiene los temas a.dita, b.dita y c.dita. Antes de volver a publicar el mapa, ha eliminado el tema b.dita del mapa. Ahora, si ha seleccionado esta opción, todo el contenido relacionado con b.dita se elimina de la salida de AEM Sites y solo se publican a.dita y c.dita.
Nota: la información sobre las páginas eliminadas también se captura en los registros de generación de salida. Para obtener más información acerca del acceso a los archivos de registro, vea y compruebe el archivo de registro.
Precaución: al eliminar los temas, las páginas dejarán de estar disponibles en el sitio publicado. Por lo tanto, antes de eliminar los temas, aparece una advertencia. Debe confirmar que desea eliminarlos.
- Eliminar todas las páginas creadas por otras fuentes en esta ruta: Si selecciona esta opción, se eliminarán todas las páginas publicadas en esta ruta desde otros mapas, temas individuales o cualquier otro origen. Las páginas tampoco estarán disponibles desde el sitio publicado. Por lo tanto, antes de eliminar los temas, aparece una advertencia. Debe confirmar que desea eliminarlos.
Contenido
La pestaña Content contiene las siguientes opciones de configuración:
Ver Trabajar con línea de base para obtener más detalles.
None: Seleccione esta opción si no desea aplicar ninguna condición en la salida publicada.
Usando DITAVAL: seleccione los archivos DITAVal para generar contenido condicionado. Puede seleccionar varios archivos DITAVal mediante el cuadro de diálogo de exploración o escribiendo la ruta del archivo. Utilice el icono en forma de cruz situado cerca del nombre del archivo para eliminarlo. Los archivos DITAVal se evalúan en el orden especificado, por lo que las condiciones especificadas en el primer archivo tienen prioridad sobre las condiciones coincidentes especificadas en archivos posteriores. Puede mantener el orden de los archivos añadiendo o eliminando archivos. Si el archivo DITAVal se mueve a otra ubicación o se elimina, no se elimina automáticamente del panel de asignaciones. Debe actualizar la ubicación en caso de que los archivos se muevan o eliminen. Puede pasar el ratón sobre el nombre del archivo para ver la ruta en el repositorio de AEM donde está almacenado el archivo. Solo puede seleccionar archivos DITAVal y se muestra un error si selecciona cualquier otro tipo de 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 acerca de los ajustes preestablecidos de condición, vea Usar ajustes preestablecidos de condición.
Propiedades de archivo (Assets)
Nota: las propiedades de metadatos distinguen entre mayúsculas y minúsculas.
Si ha seleccionado una Línea base, los valores de las propiedades se basan en la versión de la Línea base seleccionada. Si no ha seleccionado una Línea de base, los valores de las propiedades se basan en la versión más reciente.
También puede pasar los metadatos a la salida mediante la publicación DITA-OT. Para obtener más información, Pase los metadatos a la salida mediante DITA-OT.
Nota: si no ha definido
cq:tags en la opción Propiedades, los valores de cq:tags se seleccionarán de la copia de trabajo actual aunque haya seleccionado una Línea de base para la publicación.Usar propiedades de mapa como alternativa
Solo las propiedades String, Date o Long (únicas y de varios valores) se pueden pasar a las páginas del sitio de AEM. Los valores de metadatos de una propiedad de tipo cadena no admiten ningún carácter especial (como
@, #, " ").* Esta opción debe usarse junto con la opción
Properties.Lista de temas
La ficha Lista de temas muestra la lista de temas presentes en la copia de trabajo actual del mapa DITA. De forma predeterminada, se incluyen todos los temas. Puede seleccionar temas específicos y generar la salida de AEM Sites solo para ellos. Por ejemplo, se han actualizado algunos temas para poder publicar sólo esos temas en lugar de publicar todo el mapa DITA.
Referencias de mapas cruzados
Esta lista contiene temas que contienen referencias entre mapas con scope ="peer". Puede especificar el contexto de publicación para una lista de referencias de mapas cruzados con scope="peer" a temas disponibles en otras asignaciones DITA. Esta pestaña aparece si utiliza la versión de Experience Manager Guides (UUID).
Para obtener más información, consulte la sección Trabajar con temas vinculados a continuación.
Una vez configurado, guarde los cambios realizados en el ajuste preestablecido y seleccione Generate para generar AEM Sites para el mapa correspondiente.
Usar asignación de componentes heredados
Los pasos para crear el ajuste preestablecido de AEM Sites mediante la asignación de componentes heredados son los mismos que se describen en la sección Asignación de componentes compuestos anterior. Sin embargo, al crear el ajuste preestablecido, asegúrese de seleccionar la opción Usar asignación de componentes heredados en el cuadro de diálogo Nuevo ajuste preestablecido de salida.
En la consola Mapa, las opciones de configuración preestablecidas para la asignación de componentes heredados se organizan en las siguientes pestañas:
- General
- Contenido
- Referencias entre mapas
General
La ficha General contiene las siguientes opciones de configuración:
Se crea un nodo en el repositorio de AEM con el nombre especificado aquí. Si no se especifica el Nombre del sitio (Site Name), se creará el nodo de sitio con el nombre de fichero de mapa DITA.
El nombre de sitio que especifique aquí también se utiliza como título en la ficha del explorador.
También puede utilizar variables al establecer el Nombre del sitio. Para obtener información detallada, vea Usar variables para establecer las opciones Ruta de destino, Nombre de sitio o Nombre de archivo
user-guide y la ruta de acceso de salida como /content/output/aem-guides, el resultado final se generará en el nodo /content/output/aem-guides/user-guide.También puede utilizar variables al establecer la ruta de acceso de salida. Para obtener información detallada, vea Usar variables para establecer las opciones Ruta de destino, Nombre de sitio o Nombre de archivo
Seleccione la opción Eliminar y crear para forzar la eliminación de las páginas existentes durante la publicación. Esta opción elimina el nodo de página junto con su contenido y todas las páginas secundarias debajo de él. Utilice esta opción si ha cambiado la plantilla de diseño del ajuste preestablecido de salida o si desea que se eliminen las páginas adicionales ya presentes en el destino.
Supongamos que ha publicado un mapa DITA, que contiene los temas a.dita, b.dita y c.dita. Antes de volver a publicar el mapa, ha eliminado el tema b.dita del mapa. Ahora, si ha seleccionado esta opción, todo el contenido relacionado con b.dita se elimina de la salida de AEM Sites y solo se publican a.dita y c.dita.
Nota: la información sobre las páginas eliminadas también se captura en los registros de generación de salida. Para obtener más información acerca del acceso a los archivos de registro, vea y compruebe el archivo de registro.
Precaución: al eliminar los temas, las páginas dejarán de estar disponibles en el sitio publicado. Por lo tanto, antes de eliminar los temas, aparece una advertencia. Debe confirmar que desea eliminarlos.
Para obtener más información acerca de cómo usar plantillas de diseño personalizadas para generar resultados, póngase en contacto con el administrador de publicaciones.
Después de generar la salida, seleccione el icono Descargar archivos temporales
Nota: Si las propiedades de archivo se agregan durante la generación, los archivos temporales de salida también incluyen un archivo metadata.xml que contiene esas propiedades.
Contenido
La pestaña Content contiene las siguientes opciones de configuración:
Ver Trabajar con línea de base para obtener más detalles.
None: Seleccione esta opción si no desea aplicar ninguna condición en la salida publicada.
Usando DITAVAL: seleccione los archivos DITAVal para generar contenido condicionado. Puede seleccionar varios archivos DITAVal mediante el cuadro de diálogo de exploración o escribiendo la ruta del archivo. Utilice el icono en forma de cruz situado cerca del nombre del archivo para eliminarlo. Los archivos DITAVal se evalúan en el orden especificado, por lo que las condiciones especificadas en el primer archivo tienen prioridad sobre las condiciones coincidentes especificadas en archivos posteriores. Puede mantener el orden de los archivos añadiendo o eliminando archivos. Si el archivo DITAVal se mueve a otra ubicación o se elimina, no se elimina automáticamente del panel de asignaciones. Debe actualizar la ubicación en caso de que los archivos se muevan o eliminen. Puede pasar el ratón sobre el nombre del archivo para ver la ruta en el repositorio de AEM donde está almacenado el archivo. Solo puede seleccionar archivos DITAVal y se muestra un error si selecciona cualquier otro tipo de 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 acerca de los ajustes preestablecidos de condición, vea Usar ajustes preestablecidos de condición.
Propiedades de archivo (Assets)
Nota: las propiedades de metadatos distinguen entre mayúsculas y minúsculas.
Si ha seleccionado una Línea base, los valores de las propiedades se basan en la versión de la Línea base seleccionada. Si no ha seleccionado una Línea de base, los valores de las propiedades se basan en la versión más reciente.
También puede pasar los metadatos a la salida mediante la publicación DITA-OT. Para obtener más información, Pase los metadatos a la salida mediante DITA-OT.
Nota: si no ha definido
cq:tags en la opción Propiedades, los valores de cq:tags se seleccionarán de la copia de trabajo actual aunque haya seleccionado una Línea de base para la publicación.Usar propiedades de mapa como alternativa
Solo las propiedades String, Date o Long (únicas y de varios valores) se pueden pasar a las páginas del sitio de AEM. Los valores de metadatos de una propiedad de tipo cadena no admiten ningún carácter especial (como
@, #, " ").* Esta opción debe usarse junto con la opción
Properties.Referencias de mapas cruzados
Esta lista contiene temas que contienen referencias entre mapas con scope ="peer". Puede especificar el contexto de publicación para una lista de referencias de mapas cruzados con scope="peer" a temas disponibles en otras asignaciones DITA. Esta pestaña aparece si utiliza la versión de Experience Manager Guides (UUID).
Para obtener más información, consulte la sección Trabajar con temas vinculados a continuación.
Trabajar con temas vinculados
Experience Manager Guides le permite crear referencias de temas utilizando peer @scope. A continuación, puede definir el contexto de publicación de estas referencias desde los ajustes preestablecidos de AEM Sites y, finalmente, generar la salida de los temas vinculados.
Para obtener más información, vea Generar resultados de temas de vinculación de otros mapas.
Siga estos pasos para especificar el contexto de publicación de los archivos de vínculos cruzados:
-
Abra la ficha Referencias de mapas cruzados. Para ver esta ficha, asegúrese de que
<xrefs>tengan identificadores únicos. Los identificadores únicos de<xrefs>se generarán automáticamente al editar o guardar el contenido anterior si el identificador no está presente.No podrá ver la vinculación entre mapas cruzados en los casos siguientes:
- Para los ajustes preestablecidos creados antes de la versión 4.6, la pestaña Referencias cruzadas está deshabilitada y aparece la información del objeto Consulte el tablero de mapas.
- Para los ajustes preestablecidos creados a partir del tablero de mapas, consulte el tablero de mapas.
- Para los ajustes preestablecidos de OOTB, consulte la información sobre herramientas del tablero de mapas.
- Para los ajustes preestablecidos globales, cree una copia local de este ajuste preestablecido global para establecer referencias entre mapas.
-
Se muestra una lista de temas y sus referencias
note note NOTE La ficha Referencias de mapas cruzados muestra los temas que están vinculados usando solamente scope="peer". Para los vínculos conscope="local", no es necesario especificar el contexto de publicación.Todos los temas vinculados tienen su último ajuste preestablecido de salida y mapa seleccionado de forma predeterminada. El contexto de publicación de todos los temas vinculados está establecido en la asignación
<Most recently generated>de forma predeterminada.
-
Si desea utilizar el resultado publicado más recientemente de cada archivo dependiente en el mapa, seleccione Usar contexto de publicación generado más recientemente para todos los temas dependientes.
Debe publicar el mapa seleccionado como mapa principal antes de publicar el mapa que contiene los temas vinculados. Si el mapa con temas vinculados no se publica, los vínculos aparecen como texto normal en lugar de como hipervínculos en la salida de AEM Sites.
Debe seleccionar el mismo tipo de ajuste preestablecido de AEM Sites para el tema vinculado. Por ejemplo, si el ajuste preestablecido actual de AEM Sites utiliza la asignación de componentes heredados, seleccione un ajuste preestablecido de AEM Sites similar en el tema vinculado. -
En la lista desplegable Mapa principal, seleccione el archivo de asignación con cuya salida desee vincular la salida del mapa actual.
Al seleccionar un archivo de asignación, se muestra el UUID del mapa en la columna UUID del mapa principal. Los ajustes preestablecidos de salida asociados con el mapa elegido se enumeran en la lista Ajustes preestablecidos del mapa principal. Por ejemplo, el Tema 1 del Mapa A contiene una referencia al Tema 2. El tema 2 puede estar presente en mapas únicos o múltiples. Puede seleccionar el mapa principal y un ajuste preestablecido específico o la salida publicada más recientemente para cada vínculo. -
Si se hace referencia al mismo tema más de una vez en un archivo, puede agregar un contexto de publicación diferente para cada instancia. Esto proporciona una mayor flexibilidad y control sobre su contenido. Por ejemplo, el tema 3 está presente tanto en el mapa B como en el mapa C. El tema 1 contiene dos referencias al tema 3. Puede elegir Mapa B como mapa principal para el primer vínculo y Mapa C como mapa principal para el segundo vínculo.
-
En la lista desplegable Ajuste preestablecido del mapa principal, seleccione el ajuste preestablecido de salida con el que desea vincular la salida del mapa actual.
note note NOTE Los diferentes ajustes preestablecidos de AEM Sites del mapa actual aparecen en la lista desplegable. Si no selecciona ningún ajuste preestablecido, aparece un icono de advertencia y la generación de resultados falla. -
Seleccione la asignación requerida y su ajuste preestablecido de salida para todos los temas de origen y seleccione Generar.
Tema principal: Explicación de los ajustes preestablecidos de salida