Ayuda > Introducción a la creación DITA > Publicación de documentos DITA
  
Publicación de documentos DITA
Arbortext Editor permite publicar temas y mapas DITA. Para los mapas DITA, es posible también seleccionar parte del mapa y sólo publicar la parte seleccionada del mismo.
Se incluye una hoja de estilo de Arbortext Styler (.style) para utilizarla con cada uno de los tipos de documento DITA por defecto. Estas hojas de estilo se pueden utilizar directamente o como base para crear hojas mejoradas o personalizadas propias y usarlas en la publicación de documentos DITA. Las muestras de hojas de estilo también están disponibles en un formato modular, lo que le permite usar los módulos existentes como bloques para construir una hoja de estilo adecuada a su entorno. Si desea más información sobre la creación de hojas de estilo para documentos DITA, consulte la ayuda en línea de Arbortext Styler.
Puede publicar documentos DITA con los tipos de salida siguientes:
HTML
Ayuda HTML
Imprimir
PDF
Web
EPUB
RTF
También puede usar Fichero > Vista previa de impresión para ver el documento DITA antes de publicarlo. La función de creación de perfiles de Arbortext Editor y los ficheros DITAVAL del estándar DITA se soportan en los documentos DITA, lo que permite filtrar contenido en la salida publicada.
La publicación de un tema DITA es similar a la de otros tipos de documentos. Una vez publicado un tema DITA con Arbortext Editor o con Arbortext Publishing Engine, el tema se publica según la hoja de estilo asociada, y se publica con el formato de salida especificado. Este tema se publica como si estuviese contenido en un mapa DITA, lo que garantizará que las referencias cruzadas y los vínculos se resolverán correctamente. Sin embargo, la publicación de un tema individual con referencias cruzadas y vínculos no tiene el mismo resultado que la publicación de un mapa DITA que haga referencia a todos los temas. La publicación de los temas resulta a menudo más útil para las verificaciones y revisiones. Es aconsejable realizar la publicación final desde un mapa DITA.
Un mapa DITA es una recopilación de referencias a los temas y a otro contenido DITA, de modo que cuando se publica un mapa DITA, el proceso de publicación primero recopila todo el contenido de referencia del mapa en un documento intermedio denominado documento resuelto para definir el estilo. El documento resuelto entonces se publica al aplicar la hoja de estilo asociada, y se publica con el formato de salida especificado. Si en el mapa se incluyen referencias a DITA o a otros tipos de documentos que no están contenidos en el mapa que se está publicando, el proceso de publicación recopilará los destinos de estas referencias durante la publicación, lo que permitirá a dichas referencias resolverse correctamente en la salida. Los ficheros a los que se hace referencia se almacenan en una carpeta cuyo nombre se basa en el documento de salida con .ditaLinks adjunto al nombre de la carpeta.
También se puede generar una versión del documento resuelto para definir el estilo mediante la opción de menú Arbortext EditorEditar > Editar documento resuelto > Para definir el estilo. Esta versión del documento resuelto permite usar Arbortext Styler para crear una hoja de estilo para el mapa. El documento resuelto para definir el estilo es un documento temporal cuyo único objetivo es la creación de la hoja de estilo. A diferencia del documento resuelto para edición, los cambios aplicados al documento resuelto para definir el estilo no se reflejarán en los temas asociados cuando se cierre el documento resuelto.
Para los tipos de salida EPUB, ayuda HTML y Web, que producen varios ficheros HTML, el proceso de publicación conserva los nombres de los ficheros de entrada DITA y cualquier estructura de directorio en la que los ficheros de entrada se encuentren por defecto. Esta configuración, así como otras opciones por defecto, se puede cambiar en Arbortext Styler.
Uso del atributo deliveryTarget
Se puede utilizar el atributo de perfil deliveryTarget en las referencias de temas (elementos topicref) de los mapas DITA, así como en los temas, para controlar si el contenido o el tema al que se hace referencia se incluyen en un tipo de salida específico. En los tipos de documento enviados, el atributo deliveryTarget tiene los siguientes valores admitidos:
print-no: no se incluye el tema en las salidas impresas.
print-only: se incluye el tema en las salidas impresas.
Estos valores imitan los valores permitidos para el atributo print (obsoleto en DITA 1.3). El atributo print sigue siendo soportada en Arbortext Editor.
Se recomienda que los valores del atributo deliveryTarget reflejen el tipo de salida de destino (por ejemplo, epub, pdf o html).
Si va a utilizar los valores de deliveryTarget con este fin, debe seleccionar el valor obligatorio como configuración de perfil durante el proceso de publicación.
Si una referencia de tema contiene otras, el valor del atributo deliveryTarget de la referencia de tema padre controla la inclusión de todas las referencias de tema en la salida especificada. En este caso, se ignoran los valores del atributo deliveryTarget para las referencias de tema anidadas.
Publicación con referencias de clave
Arbortext Editor soporta el procesamiento de la mayor parte de las referencias de claves definidas en la sección sobre el procesamiento de referencias de clave de la especificación de la arquitectura de DITA en OASIS para la publicación. El reemplazo de contenido de texto durante la publicación se soporta tanto mediante la inserción de texto en elementos vacíos que hacen referencia a una definición de clave como mediante el atributo conkeyref.
En determinados casos, es posible que una referencia conkeyref no tenga ningún ID de tema en la referencia. Por ejemplo, si la definición de clave solo contiene el URI del tema y la referencia de clave del contenido hace referencia al nombre de clave y a un ID de elemento dentro del tema al que se hace referencia. El tema al que se hace referencia en el URI puede contener otros temas, ya sea porque es una Ditabase o porque contiene temas anidados, y estos temas pueden contener elementos con el mismo ID En este caso, Arbortext Editor da por supuesto que el primer elemento del tema con el ID especificada es el destino de la referencia de contenido. Si el tema contiene varios elementos con la misma ID, podría resultar en la utilización del elemento incorrecto como destino de la referencia de contenido. Es una práctica recomendada asegurarse de que el ID del tema se incluye en todas las definiciones de clave que se pretenden utilizar para referencias conkeyref.