Cuadro de diálogo Información de referencia de clave
Este cuadro de diálogo permite ver información acerca de la definición de clave asociada con una referencia de clave en un tema o mapa DITA. Este cuadro de diálogo se invoca desde la opción de menú > o desde la opción del menú de accesos directos que corresponda. La opción de menú solo está disponible si el cursor se encuentra en un elemento que contenga una referencia de clave.
Debe tenerse en cuenta que, para que una referencia de clave tenga información acerca de su definición de clave, debe tener un contexto de clave activa y la definición de clave asociada debe estar en dicho contexto. Un contexto de clave es un mapa DITA que contiene definiciones de clave. Si ese mapa es un mapa de definiciones de clave DITA, estará disponible información adicional para las definiciones.
El valor asignado a la opción definida ditakeycontext permite determinar el contexto de clave para un documento. Esta opción se puede definir explícitamente, aunque Arbortext Editor la define automáticamente en ciertos casos. Por ejemplo, si se abre un tema de referencia desde un mapa que contiene definiciones de clave, Arbortext Editor define dicho mapa como el contexto de clave.
En el cuadro de diálogo Información de referencia de clave se incluyen las opciones siguientes:
• Información de definición de clave: se proporciona información acerca de una definición de clave.
Si ese mapa es un mapa de definiciones de clave DITA, es posible que haya información adicional disponible para las definiciones. Se proporciona la siguiente información:
◦ Clave: permite proporcionar el nombre de la clave.
◦ href: permite proporcionar la ruta completa al documento identificado mediante el atributo href en la definición de clave.
Si no se ha asignado ningún href, se mostrará (ninguno).
◦ Ámbito: permite proporcionar el atributo scope del valor a partir de la definición de clave en vigor para esta referencia de clave.
◦ Formato: permite proporcionar el atributo format del valor a partir de la definición de clave en vigor para esta referencia de clave.
◦ Texto: permite visualizar el contenido de texto definido por la definición de clave.
En el caso de las referencias de clave usadas para el reemplazo de texto, esta opción también muestra los marcadores incluidos en la definición de clave. Para otras referencias de clave, esta opción muestra texto del destino de la referencia.
◦ Descripción: permite proporcionar una descripción de la clave.
Si la clave está definida en un mapa de definiciones de clave DITA y se especifica el elemento keydescription, la descripción procede de dicho elemento. En caso contrario, la descripción viene del contenido del elemento navtitle, el atributo navtitle o el elemento linktext, en dicho orden. Se debe tener en cuenta que, en el caso de los documentos DITA 2.0, la descripción procede del contenido de los elementos titlehint, navtitle o linktitle, en ese orden, si no se ha especificado keydescription.
◦ ID de elemento: permite proporcionar el valor de ID para el elemento que se pretende usar como destino de la definición de clave.
Esta información solo está disponible para un mapa de definiciones de clave DITA que tenga un valor asignado en el elemento keysubelementid en la definición de clave.
◦ Etiquetas: permite proporcionar una lista de elementos para los que la clave está definida para proporcionar una referencia.
Esta información solo está disponible para un mapa de definiciones de clave DITA que tenga un valor asignado en el elemento keyreftags en la definición de clave.
◦ Mapa de definición: permite proporcionar la ruta al mapa en el que se encuentra la definición de clave.
• Ir a definición: permite abrir el mapa en el que se incluye la definición de clave en una nueva ventana de Arbortext Editor y realza la definición de clave en el mapa.