Uso de perfiles con documentos DITA
Los documentos DITA soportan la función de perfiles de
Arbortext Editor. Los valores para los atributos de creación de perfiles se muestran en la vista por columnas, en el mapa del documento y en el cuadro de diálogo
Modificar atributos. Sin embargo, los valores de creación de perfiles sólo se pueden cambiar en el cuadro de diálogo
Aplicar perfiles. Si se intentan cambiar los valores de atributo en la vista por columnas o en el mapa del documento, se abrirá el cuadro de diálogo
Aplicar perfiles. En el cuadro de diálogo
Modificar atributos, los valores de perfil son de solo lectura y hay un botón disponible (
) para invocar el cuadro de diálogo
Aplicar perfiles.
Cada uno de los tipos de documento DITA por defecto tiene asociado un fichero de configuración de creación de perfiles (.pcf) que incluye las categorías y los valores de creación de perfiles siguientes, basados en los atributos DITA estándar:
Atributo DITA | Categoría de perfiles | Valores de perfiles |
audience | Audience | • Novice • Expert |
platform | Platform | • MS-Windows • Unix/Linux |
producto | Product | • Project-X • Project-Y • Project-Z |
otherprops | Other | • Blue • Green |
Puede cambiar las categorías de creación de perfiles y los valores asociados a estos atributos como desee. También puede añadir categorías de creación de perfiles adicionales. Se debe tener en cuenta que, aunque normalmente los valores múltiples para un mismo atributo se separan mediante caracteres de punto y coma en los ficheros .pcf, el estándar DITA usa espacios para separar esos valores. Por defecto, los ficheros de tipos de documento DITA .pcf usan espacios para separar los valores múltiples de un solo atributo para que coincida con el estándar.
Los ficheros .pcf por defecto también contienen los siguientes grupos de perfiles definidos:
• Windows Expert: permite definir Platform en MS-Windows y Audience en Expert.
• Unix Novice: permite definir Platform en Unix/Linux y Audience en Novice.
Extensión del soporte de perfilado
Las siguientes son algunas recomendaciones para ampliar la funcionalidad de creación de perfiles por defecto:
• Atributo otherprops del estándar DITA: este atributo se puede usar para una categoría de creación de perfiles personalizada.
• Otros atributos del estándar DITA: aunque los demás atributos del estándar DITA no están diseñados para la creación de perfiles de metadatos, se puede usar un atributo DITA estándar de tipo CDATA para una categoría de creación de perfiles personalizada.
• Atributo DITA especializado: el atributo props del estándar DITA se puede especializar para crear cualquier otro atributo necesario en las categorías de creación de perfiles.
• Atributo con espacio de nombres — puede establecer un espacio de nombres XML para crear perfiles de atributos y añadir ese espacio al elemento raíz de los documentos DITA.
Es recomendable modificar la plantilla y los documentos de muestra del tipo de documento DITA para el que desee ampliar los perfiles añadiendo la declaración del espacio de nombres. Por ejemplo, el siguiente es el elemento raíz del documento plantilla Tema DITA:
<topic id="topic1">
El siguiente es el elemento raíz con un ejemplo de declaración de espacio de nombres:
<topic id="topic1" xmlns:custProf="http://www.acme.com/namespaces/profiling>
De este modo, se podrán usar los atributos definidos en el espacio de nombres del fichero .pcf para las categorías de creación de perfiles. Observe que debe añadir el espacio de nombres antes del atributo. Por ejemplo: custProf:security.
Puede aplicar un atributo con espacio de nombres a cualquier elemento del documento, incluso a aquéllos que no tengan los atributos de metadatos del estándar DITA.
Para obtener más información acerca de la configuración de perfiles, consulte la sección sobre personalización de la configuración de perfiles del sitio en el manual Customizer's Guide. Nota: Este manual no está disponible en español.
Ficheros DITAVAL y perfilado
La norma DITA también proporciona soporte para el procesamiento condicional mediante
ficheros DITAVAL. Con los documentos DITA se pueden utilizar tanto ficheros DITAVAL como ficheros de perfilado. Sin embargo, los ficheros DITAVAL tienen prioridad y cualquier regla definida en ficheros DITAVAL se aplica antes de que ningún perfilado tenga efecto.
Se pueden usar ficheros .pcf existentes como base para los ficheros DITAVAL, de la siguiente manera:
• Si se elige > > o
Editar fichero DITAVAL para trabajar con un fichero DITAVAL, se abre
Cuadro de diálogo Editor DITAVAL con la información de perfilado de cualquier fichero
.pcf asociado con el tema o la asignación actual.
• Al trabajar directamente con un fichero DITAVAL en Arbortext Editor, se puede elegir > para importar grupos de perfiles definidos en un fichero .pcf al fichero DITAVAL actual.
• Al editar un fichero DITAVAL en el cuadro de diálogo Editor DITAVAL, se puede utilizar el botón Importar perfiles para importar configuración de perfiles y grupos de perfiles definidos de un fichero .pcf al fichero DITAVAL actual.
Sombreado de perfiles
Es posible configurar el sombreado de colores para diferenciar entre grupos de perfiles, atributos y valores. Consulte
Uso del sombreado en elementos con perfiles para obtener más información sobre la configuración del sombreado de valores de perfil.
Cuando el sombreado de perfiles está activado, se muestra como se indica a continuación para los documentos DITA:
• Las referencias de tema y el contenido del elemento se muestran en el color definido para el perfil o el valor correspondiente.
• Un elemento con perfil se indica mediante el icono
en las vistas de mapa del documento y vista por columnas.
El sombreado se activa mediante el comando set showprofileshading.
El cuadro de diálogo Aplicar perfiles muestra el sombreado de perfiles que se ha configurado para la instancia del tipo de documento. Consulte Sombreado de perfiles para obtener directrices sobre la visualización del sombreado de perfiles en el cuadro de diálogo.