Ajustes preestablecidos de AEM Sites en el editor web
Puede crear ajustes preestablecidos de AEM Sites desde el editor web y configurarlos para generar la salida de AEM Sites. El resultado de AEM Sites se basa en la asignación de componentes compuestos junto con guides-components, lo que facilita la creación y administración eficientes del contenido.
Experience Manager Guides proporciona plantillas predefinidas para crear AEM Sites. Estos ajustes preestablecidos 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 ajustes preestablecidos de AEM Sites
Siga estos pasos para crear los ajustes preestablecidos de AEM Sites desde el Editor web:
- En el panel Repositorio, abra el fichero de mapa DITA en la vista Mapa.
- En la ficha Output, seleccione el icono + para crear un ajuste preestablecido 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 del cuadro de diálogo Nuevo ajuste preestablecido de salida.
- 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.
Añadir ajustes preestablecidos al perfil de carpeta actual
Como administrador, Experience Manager Guides le permite crear y administrar ajustes preestablecidos de salida para los Perfiles global y de carpeta. Seleccione la opción Agregar al perfil de carpeta actual en el cuadro de diálogo Nuevo ajuste preestablecido de salida para crear un ajuste preestablecido de salida para el perfil de carpeta actual. El icono
Ajustes preestablecidos de AEM Sites basados en asignación de componentes heredados
También puede crear los ajustes preestablecidos de AEM Sites mediante la asignación de componentes heredados. Para crear los ajustes preestablecidos de AEM Sites basados en la asignación de componentes heredados, seleccione la opción Usar asignación de componentes heredados en el cuadro de diálogo Nuevo ajuste preestablecido de salida.
Algunas opciones pueden diferir para los ajustes preestablecidos que utilizan la asignación de componentes heredados.
Configuración de los ajustes preestablecidos de AEM Sites
Las configuraciones están organizadas bajo las pestañas General, Contenido, Lista de temas y Referencias de mapas cruzados.
General
La ficha General contiene las siguientes configuraciones relacionadas con la generación de resultados:
-
Usar ruta del sitio
-
Ruta del sitio
-
Sitio
-
Ruta de Publish
-
Plantilla de página de tema
-
Generar nombres de página basados en
- Nombre de archivo del tema
- Título del tema
-
Limpieza de páginas generadas anteriormente
- Eliminar páginas generadas anteriormente para temas eliminados del mapa
- Elimine todas las páginas creadas por otras fuentes en esta ruta:
-
Flujo de trabajo de generación posterior
Contenido
La ficha Contenido contiene las siguientes configuraciones:
-
Usar línea base
-
Filtro de condición
-
Argumentos adicionales de la línea de comandos de DITA-OT
-
Metadatos
- Propiedades de archivo (Assets)
- Usar propiedades de mapa como alternativa
Para obtener más información, consulte Configuración de AEM Sites.
Lista de temas
La 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 que sólo se puedan publicar esos temas en lugar de publicar todo el mapa DITA.
AEM La pestaña Lista de temas está presente en los ajustes preestablecidos de la que no se han creado en función de la asignación heredada.
Referencias entre mapas
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).
Obtenga más información sobre cómo publicar temas vinculados.
Configuración de AEM Sites aem_sites_config
Las siguientes opciones están disponibles para la salida de AEM Sites:
Seleccione Actualizar
AEMG-Docs y la ruta de acceso de Publish como aemg-docs-en/docs/product-abc., la salida de AEM Sites se generará bajo el nodo aemg-docs-en/docs/product-abc/ en crx/de.Título de tema: Utiliza el título del tema DITA para crear los nombres de sitio de 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.
Importante: Cuando se genera un resultado incremental para el sitio de la, el resultado se crea utilizando la versión actual de los archivos y no la línea de base adjunta.
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. AEM Puede pasar el ratón sobre el nombre del archivo para ver la ruta en el repositorio de donde se almacena 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 la. 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.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.
Genere la salida de AEM Sites con las plantillas
Experience Manager Guides le permite utilizar las plantillas predeterminadas o agregar sus propias plantillas de AEM Sites.
Antes de configurar los ajustes preestablecidos de AEM Sites, asegúrese de crear una estructura de AEM Sites con las plantillas.
Para obtener más información, vea Descargar e instalar plantillas de AEM Sites.
Siga estos pasos para crear y configurar un ajuste preestablecido de AEM Sites:
-
Abra la ficha Ajustes preestablecidos de salida del mapa DITA que desee publicar.
-
Seleccione el ajuste preestablecido de salida AEM Sites.
-
(Opcional) Desmarque la opción Usar asignación de componentes heredados para crear un ajuste preestablecido de AEM Sites no heredado
-
Haga clic en Agregar. Se crea el ajuste preestablecido de AEM Sites.
-
Puede configurar la plantilla de sitios predeterminada de dos formas:
-
Seleccione Sitio y, a continuación, elija la ruta de publicación y las plantillas de página del tema entre las opciones rellenadas:
- Seleccione el sitio.
- Seleccione Sitio. Por ejemplo,
AEMG Docs. - Las opciones Publish path y Topic page template se establecen automáticamente en el menú desplegable. También puede elegir las opciones. Por ejemplo,
AEMG-Docs-Site/en/docs/product1yTopic pagese establecen respectivamente.
-
Seleccione la ruta completa del sitio:
- Seleccione la opción Usar ruta del sitio.
- Seleccione la ruta completa del sitio. Por ejemplo,
/content/AEMG-Docs-Site/en/docs/product1. - La "Plantilla de página de tema" se establece automáticamente como
Topic Page.
-
-
Guarde los cambios realizados en el ajuste preestablecido.
-
Seleccione la opción Generate.
-
Genere AEM Sites para el mapa correspondiente. Por ejemplo,
/content/AEMG-Docs-Site/en/docs/product.note note NOTE AEM Si publica contenido en un sitio web por primera vez, se recomienda publicar las páginas en el nivel de sitio web de un sitio web en el que se haya realizado la publicación. Esto garantiza que la salida se muestre correctamente en la instancia Publish sin interrupciones en el CSS.
Temas vinculados de Publish
Experience Manager Guides simplifica la publicación de documentos complejos al permitirle 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 Ajustes preestablecidos de salida del mapa DITA que desee publicar.
-
Seleccione el ajuste preestablecido de salida AEM Sites.
Puede ver las fichas General, Contenido, Lista de temas y Referencias de mapas cruzados. Referencias de mapas cruzados ficha aparece si utiliza la versión de Experience Manager Guides (UUID).
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á desactivada y aparece la información del objeto, Consulte Asignación del tablero de mandos.
- Para ajustes preestablecidos creados a partir del tablero de mapas. Consulte Asignación de información sobre herramientas del tablero.
- Para ajustes preestablecidos de OOTB, consulte Cómo aparece la información del panel de mapas.
- Para los ajustes preestablecidos globales, cree una copia local de este ajuste preestablecido global para establecer referencias entre mapas.
Si desea utilizar ajustes preestablecidos de AEM Sites del editor web, cree un nuevo ajuste preestablecido o duplique el existente.
-
Abra la ficha Referencias de mapas cruzados.
Se le mostrará una lista de temas y sus referencias. Puede especificar el contexto de publicación para una lista de referencias de mapas cruzados a temas disponibles en otras asignaciones DITA con
scope=”peer”.Para usar el panel de referencia de mapas cruzados del Editor Web,
<xrefs>debe tener 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.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 mapa 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 de 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. 1. 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