DocumentaciónAEM GuidesDocumentación de AEM Guides

Utilizar la especialización personalizada DITA-OT y DITA id181GAJ0005Z

Last update: Thu Sep 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Experimentado
  • Administrador

DITA Open Toolkit (DITA-OT) es un conjunto de herramientas de código abierto basadas en Java que proporcionan procesamiento para mapas DITA y contenido de temas. AEM Guides permite importar y utilizar fácilmente complementos DITA-OT personalizados. Una vez importado, AEM Guides puede configurarse para que utilice el complemento DITA-OT personalizado para generar resultados en cualquier formato. En el momento de generar la salida, simplemente seleccione la opción DITA-OT y AEM Guides utilizará el complemento DITA-OT personalizado para generar la salida requerida.

Si desea procesar parámetros Ant al publicar cualquier salida, AEM Guides le ofrece una forma sencilla de hacerlo. Puede especificar qué parámetros Ant desea utilizar y los mismos que procesará el proceso de publicación.

NOTE
AEM Guides se suministra con DITA-OT versión 3.3.2. Sin embargo, AEM Guides es compatible con la versión 1.7 y posteriores de DITA-OT. Para obtener la lista completa de las versiones de DITA-OT, consulte Versiones de DITA-OT.
TIP
Consulte las secciones Configuración de perfiles DITA-OT y Uso de DITA-OT personalizado en la guía de prácticas recomendadas para conocer las prácticas recomendadas sobre el uso de complementos DITA-OT personalizados.

Uso de complementos DITA-OT personalizados id181NH1020L7

Existen dos maneras de utilizar el complemento DITA-OT personalizado para la publicación. AEM El primer método consiste en cargar el complemento DITA-OT personalizado en el repositorio de la. El otro método es guardar el complemento DITA-OT personalizado en el servidor, crear un perfil y proporcionar la ubicación del complemento DITA-OT personalizado en el perfil.

De forma predeterminada, AEM Guides incluye un perfil preconfigurado que contiene las configuraciones de las plantillas predeterminadas que se utilizan para editar y publicar contenido. Puede crear perfiles personalizados con plantillas personalizadas para utilizarlas al editar documentos y complementos DITA-OT personalizados para publicar contenido.

El paquete DITA-OT predeterminado disponible con AEM Guides viene con el procesador Apache FOP XSL-FO, que no admite la representación de ecuaciones de MathML. Si utiliza ecuaciones de MathML en el contenido, asegúrese de haber integrado un complemento del motor de renderización de MathML para Apache FOP o utilice un procesador XSL-FO diferente.

IMPORTANT
Si ha actualizado AEM Guides de la versión 2.2 a la versión 2.5.1 o 2.6, todos los cambios realizados mediante el administrador de configuración se seleccionan automáticamente y se almacenan en el perfil predeterminado.

AEM Realice los siguientes pasos para cargar el complemento DITA-OT personalizado en el repositorio de:

  1. AEM Inicie sesión en la aplicación y abra el modo CRXDE Lite.

  2. Descargar el archivo de DITA-OT.ZIP.

    La ubicación del archivo DITA-OT.ZIP es /libs/fmdita/dita_resources/DITA-OT.zip.

  3. Extraiga el contenido del archivo zip en el servidor.

  4. Utilice un mecanismo de integrador de plugins DITA-OT para integrar la nueva versión de DITA-OT con su plugin DITA-OT personalizado.

    note note
    NOTE
    El separador de rutas de clase del archivo ZIP del complemento depende del sistema operativo, lo que significa que si el servidor está alojado en Windows, el separador de rutas de clase será diferente del utilizado en Linux. Para obtener más información sobre la integración manual de complementos, consulte el tema Instalación manual de complementos en la documentación de DITA-OT.

  5. Vuelva a crear el archivo ZIP manteniendo el mismo nombre (DITA-OT.ZIP) y la estructura de carpetas.

  6. AEM Cargue el archivo ZIP actualizado de nuevo en el repositorio de.

    Asegúrese de realizar las siguientes comprobaciones antes de cargar el archivo ZIP:

    • Ejecute el integrador (para instalar el complemento personalizado) en un sistema operativo Mac/Linux para evitar problemas con los separadores de archivos: como los sistemas operativos Windows y Linux tienen diferentes separadores de archivos, el complemento integrado en el sistema operativo Mac/Linux es compatible con la configuración de Windows y Linux.
    • Asegúrese de que el archivo DITA-OT.ZIP contenga una carpeta denominada "DITA-OT" que tenga todos los complementos y archivos relevantes.
    • AEM Compruebe que el archivo DITA-OT.ZIP que crea sea del tipo mime: "nt:file" (corresponde al tipo principal de archivo ZIP cuando se carga en el archivo de tipo). AEM Utilice una herramienta WebDAV o una implementación de código para cargar este archivo ZIP en la ruta deseada en la. AEM AEM (No utilice el administrador de paquetes de la aplicación para implementar este archivo ZIP, ya que este ZIP no es un paquete de contenido de la aplicación, sino solo un archivo de almacenamiento.)
    note note
    NOTE
    Se recomienda no sobrescribir el paquete DITA-OT predeterminado. Debe cargar el paquete DITA-OT personalizado que contiene el complemento en otra ubicación de la carpeta apps.

  7. Abra el perfil DITA predeterminado para editarlo y guárdelo (sin realizar ninguna actualización) para que los cambios surtan efecto.

Realice los siguientes pasos para crear un nuevo perfil y configurarlo para utilizar el complemento DITA-OT personalizado almacenado en el servidor:

  1. Almacene el complemento DITA-OT personalizado en el servidor.

    note note
    NOTE
    La estructura de carpetas para almacenar el complemento DITA-OT personalizado debe ser: \*<parent-folder\>*\DITA-OT.

  2. Haga clic en el vínculo Adobe Experience Manager en la parte superior y elija Herramientas.

  3. Seleccione Guías de la lista de herramientas.

  4. Haga clic en el mosaico Perfiles DITA.

    note note
    NOTE
    La información de Perfil predeterminado se muestra en la página Perfiles. Si ha actualizado AEM Guides de la versión 2.2 a la versión 2.5.1 o 2.6, todos los cambios realizados mediante el administrador de configuración se seleccionan automáticamente y se almacenan en el perfil predeterminado.

  5. Puede elegir editar el perfil predeterminado, crear un nuevo perfil o duplicar la configuración del perfil predeterminado para crear un nuevo perfil.

    note note
    NOTE
    Puede actualizar el perfil predeterminado, pero no puede eliminarlo. Sin embargo, todos los perfiles nuevos que cree se pueden editar y eliminar.

  6. Configure las siguientes propiedades para utilizar el complemento DITA-OT personalizado:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2 17-row-2 18-row-2 19-row-2
    Nombre de la propiedad Descripción
    Propiedades de perfil
    Nombre de perfil Proporcione un nombre único para este perfil.
    Reutilizar salida (Opcional) Si su perfil se basa en un perfil existente, seleccione esta opción. Si selecciona esta opción, AEM Guides no volverá a extraer el contenido del paquete DITA-OT y reutilizará el paquete DITA-OT existente.
    Ruta de extracción de perfil (Opcional) Especifique la ruta en la que DITA-OT se mantiene en el disco. De forma predeterminada, AEM Guides agrupa un paquete DITA-OT en su repositorio y se extrae en el disco en esta ruta.
    Nota Puede definir esta ruta usando cualquier variable o propiedad del sistema existente. Consulte la descripción de la propiedad DITA-OT Environment Variables para obtener más información.
    Ruta asignada (Opcional) Especifique la ruta en el repositorio de contenido para el que se aplica este perfil. Puede especificar varias ubicaciones.
    Propiedades DITA-OT
    Tiempo de espera DITA-OT (Opcional) Especifique el tiempo (en segundos) durante el que AEM Guides espera una respuesta del complemento DITA-OT. Si no se recibe ninguna respuesta en el tiempo especificado, AEM Guides finaliza la tarea de publicación y la tarea se marca como fallida. Además, los registros de errores están disponibles en el archivo de registro de generación de resultados.
    Valor predeterminado: 300 segundos (5 minutos)
    Argumentos del PDF DITA-OT Especifique los argumentos de línea de comandos que procesa el complemento DITA-OT personalizado para generar la salida del PDF. Para todos los perfiles DITA-OT personalizados, especifique el siguiente argumento de línea de comandos:-lib plugins/org.dita.pdf2.fop/lib/
    AEM Argumentos de DITA-OT AEM (Opcional) Especifique los argumentos de línea de comandos personalizados que procesa el complemento DITA-OT personalizado para generar la salida del sitio de la.
    Rutas de biblioteca DITA-OT (Opcional) Especifique las rutas de biblioteca adicionales del complemento DITA-OT.
    XML de compilación DITA-OT (Opcional) Especifique la ruta del script de compilación Ant personalizado que se incluye con el complemento DITA-OT personalizado. Esta ruta es relativa al directorio DITA-OT del sistema de archivos.
    Carpeta de script DITA-OT Ant (Opcional) Especifique la ruta de la carpeta de scripts DITA-OT Ant. Esta ruta es relativa al directorio DITA-OT del sistema de archivos.
    Variables de entorno DITA-OT (Opcional) Especifique las variables de entorno que desea pasar al proceso DITA-OT. De manera predeterminada, AEM Guides agrega cuatro variables: ANT_OPTS, ANT_HOME, PATH y CLASSPATH.
    Puede reutilizar cualquiera de las variables o propiedades de entorno del sistema existentes para generar nuevas variables de entorno. Por ejemplo, si tiene JAVA_HOME variable de sistema definida en el sistema y desea definir una nueva variable de entorno llamada JAVA_BIN que se ha creado con JAVA_HOME. A continuación, puede agregar la definición de JAVA_BIN como:
    JAVA_BIN= ${JAVA_HOME}/bin
    Nota También puede usar las propiedades del sistema Java para generar variables de entorno. AEM Por ejemplo, si el script de inicio define una propiedad del sistema Java java.io.tmpdir en un directorio temporal, puede utilizar esta propiedad para definir una nueva variable como: ${java.io.tmpdir}/fmdita/dita_ot.
    Importante Para reutilizar cualquier variable o propiedad del sistema existente, debe incluirse en ${}.
    Sobrescribir salida DITA-OT (Opcional) Si se selecciona esta opción, puede especificar el paquete DITA-OT disponible en el sistema local para generar la salida mediante DITA-OT. Esta configuración se establece al activar ConfigManager. AEM
    Si desea especificar la ruta de un paquete DITA-OT almacenado en el servidor, anule la selección de esta opción.
    AEM Ruta de archivo zip de DITA-OT/ Ruta de directorio DITA-OT local En función de lo que seleccione en Sobrescribir salida DITA-OT, especifique la ruta completa en la que se almacena el fichero DITA-OT.zip personalizado. AEM Podría ser la ruta en su repositorio de o en el sistema local.
    Ruta de complemento de DITA-OT Ruta del complemento personalizado. Este complemento se integra automáticamente con el paquete DITA-OT principal.
    Integrar catálogos AEM (Optional) ruta de acceso de los archivos DTD y XSD catalog.xml personalizados en el repositorio de la. Esto sólo debe proporcionarse cuando falten catálogos en el paquete DITA-OT. Estos catálogos se integran automáticamente con el DITA-OT principal como complemento.
    Agregar catálogo de ID de sistema (Opcional) Seleccione esta opción sólo si faltan entradas de Id. público en el catálogo o si los archivos DITA utilizan únicamente los Id. de sistema relativos a la ruta de acceso del servidor desde la que se cargan.
    Ruta temporal DITA-OT (Opcional) Especifique una ubicación temporal en la que los archivos DITA se copien para su procesamiento. Antes de que DITA-OT procese los archivos, se copian en esta ubicación temporal. De manera predeterminada, la ubicación de almacenamiento temporal es:
    Nota Puede definir esta ruta usando cualquier variable o propiedad del sistema existente. Consulte la descripción de la propiedad DITA-OT Environment Variables para obtener más información.
    note note
    NOTE
    El instalador de AEM Guides crea dos variables de entorno que puede utilizar para especificar la ruta de los archivos de complemento DITA-OT personalizados. Estas variables de entorno son: DITAOT_DIR, que contiene la ruta del directorio DITA-OT en el sistema de archivos; y DITAMAP_DIR, que contiene la ruta en la que el contenido del mapa DITA se extrae en el sistema de archivos.

  7. Haga clic en Listo para guardar el perfil.

NOTE
Puede exportar el perfil DITA personalizado como paquete y cargarlo en las demás instancias de AEM Guides para ahorrar tiempo. Para obtener más información, consulte Apéndice.

Integración de la especialización DITA id211MB0E00XA

La especialización DITA es el proceso de creación de nuevas estructuras DITA mediante la adición de nuevos elementos o la eliminación de elementos existentes. Para crear un nuevo elemento DITA, se puede tomar un elemento DITA existente como base y modificarlo según sus necesidades de creación. En esencia, la especialización DITA le permite crear modelos de información personalizados que cumplan con los requisitos de su empresa, conservando al mismo tiempo las ventajas de la arquitectura DITA existente.

La función Perfil (Profile) se puede utilizar para almacenar ajustes de especialización DITA personalizados. Esta configuración se puede utilizar en el momento de crear y publicar contenido DITA personalizado. AEM Guides le permite utilizar un ID público y un ID del sistema en sus DTD/XSD personalizados.

NOTE
El editor web de AEM Guides no es compatible con XSD.

Realice los siguientes pasos para crear un nuevo perfil y configurarlo para utilizar AEM Guides de DTD y XSD especializados:

  1. Cree una carpeta de especialización en el equipo local que contenga los DTD y XSD especializados.

  2. Especifique los detalles de DTD en el archivo catalog.xml que también se deben incluir en la carpeta de especialización.

    note note
    NOTE
    AEM En el caso de DITA 1.3, la ubicación predeterminada para el archivo DTD catalog.xml en el repositorio de datos es: /libs/fmdita/dita_resources/DITA-1.3/dtd/catalog.xml.

  3. Especifique los detalles XSD en el archivo catalog.xml que también se deben incluir en la carpeta de especialización.

    note note
    NOTE
    AEM En el caso de DITA 1.3, la ubicación predeterminada para el archivo catalog.xml XSD en el repositorio de datos es: /libs/fmdita/dita_resources/DITA-1.3/xsd/catalog.xml.

  4. Cargue la carpeta en la siguiente ubicación:

    /apps/fmdita/dita_resources

  5. Haga clic en el vínculo Adobe Experience Manager en la parte superior y elija Herramientas.

  6. Seleccione Guías de la lista de herramientas.

  7. Haga clic en el mosaico Perfiles DITA.

    note note
    NOTE
    La información de Perfil predeterminado se muestra en la página Perfiles. Si ha actualizado AEM Guides de la versión 2.2 a la versión 2.5.1 o 2.6, todos los cambios realizados mediante el administrador de configuración se seleccionan automáticamente y se almacenan en el perfil predeterminado.

  8. Puede elegir editar el perfil predeterminado, crear un nuevo perfil o duplicar la configuración del perfil predeterminado para crear un nuevo perfil.

    note note
    NOTE
    No puede eliminar el perfil predeterminado. Sin embargo, todos los perfiles nuevos que cree se pueden editar y eliminar.

  9. AEM En la configuración de Esquema > Catálogo, especifique la ruta de los archivos DTD y XSD catalog.xml personalizados del repositorio de la.

    note note
    NOTE
    AEM Si está utilizando el esquema personalizado, debe definir la ruta de los archivos DTD y XSD catalog.xml personalizados en el repositorio de en la opción Integrar catálogos.

  10. Seleccione la opción Agregar catálogo de ID de sistema.

    note note
    NOTE
    Seleccione esta opción sólo si faltan entradas de Id. público en el catálogo o si los archivos DITA utilizan sólo los Id. de sistema relativos a la ruta de acceso del archivo local desde la que se cargan.

    Para obtener más información acerca de otras propiedades de la página Perfiles, vea la tabla de propiedades en Paso 6 de la sección Usar complementos DITA-OT personalizados.

  11. Haga clic en Listo para guardar el perfil.

NOTE
Puede exportar el perfil DITA personalizado como paquete y cargarlo en las demás instancias de AEM Guides para ahorrar tiempo. Para obtener más información, consulte Appendix.md.
recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178