Cuadro de diálogo Insertar referencia de clave
Este cuadro de diálogo permite insertar 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 el botón asociado de la barra de herramientas. Si se desea, se puede acoplar este diálogo en la ventana Arbortext Editor.
Las claves incluidas en este cuadro de diálogo proceden de mapas DITA incluidos en la preferencia avanzada ditakeybaselist. También se pueden añadir mapas a la lista de la sesión actual mediante el botón Añadir/Quitar. Además, si se abre un tema desde el contexto de un mapa que contiene definiciones de clave, dicho mapa pasará a formar parte del contexto de clave cuando se abra este cuadro de diálogo para dicho tema. Si el mapa que contiene las definiciones de clave es un mapa de definiciones de clave DITA, estará disponible información adicional para dichas definiciones.
En el cuadro de diálogo Insertar referencia de clave se incluyen las opciones siguientes:
• Buscar: permite filtrar la lista de definiciones de clave disponibles.
A medida que se escriba en esta opción, el contenido de la tabla de definiciones de clave se va filtrando automáticamente para que coincida con lo que se está escribiendo. La búsqueda abarca el contenido de las columnas Nombre de clave, Título/Descripción y Referencia en la tabla. También abarca cualquier texto, incluidos los marcadores, de la columna Recurso.
• Coincidir mayúsculas y minúsculas: permite determinar si las búsquedas realizadas en la opción Buscar distinguen las mayúsculas y minúsculas.
• Empieza por: permite determinar si las búsquedas realizadas en la opción Buscar deben coincidir con el comienzo del contenido en las columnas buscadas.
• Mapa: permite determinar el mapa usado para las definiciones de clave en la tabla de definición de clave.
El valor por defecto Todo indica el uso de todas las definiciones de clave en el contexto de clave actual. Si se selecciona un mapa específico desde la lista desplegable, en la lista de definición de claves solo aparecerán las definiciones de clave de dicho mapa.
Este cuadro de diálogo se usa para añadir o quitar mapas del contexto de clave actual. Debe tenerse en cuenta que esto solo cambia el contexto de clave de la sesión actual. Para cambiar permanentemente el contexto de clave, se debe modificar la preferencia avanzada ditakeybaselist.
• Tabla de definiciones de clave: se muestran las definiciones de clave que se pueden insertar como referencias en el documento.
Si el mapa que contiene las definiciones de clave es un mapa de definiciones de clave DITA, estará disponible información adicional para dichas definiciones. Si una clave está definida más de una vez, cada definición aparecerá en su propia fila. Si hay varias claves definidas en una definición de clave, cada clave se mostrará por separado en su propia fila.
En la tabla se incluyen las columnas siguientes:
◦ Nombre de clave: permite proporcionar el nombre de la clave.
Las claves regulares no tienen iconos. Las claves de referencia de contenido aparecen indicadas mediante el icono
. Si la clave está definida en un mapa de definiciones de clave DITA y se especifica el elemento
keysubelementid, dicho valor de ID se adjunta al nombre de clave detrás de un
/.
◦ Tipo: permite proporcionar la lista de elementos que se pueden usar para hacer referencia a esta clave.
Si la clave está definida en un mapa de definiciones de clave DITA y se especifica el elemento keyreftags, la lista de claves procede de dicho elemento. En caso contrario, el valor es Cualquiera, lo que indica que cualquier elemento con un elemento keyref puede hacer referencia a la clave. Si la clave es para una referencia de clave de contenido (conkeyref), el valor es el nombre del elemento que debe usarse para la referencia de contenido seguido de (conref).
◦ Título/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.
◦ Recurso: proporciona el valor del atributo the href de la definición de clave o cualquier texto de la definición, incluidos los marcadores, si la definición de clave no incluye ningún valor href.
Si una definición de clave no incluye ningún valor href, se supone que la definición presenta contenido para el reemplazo de texto.
◦ Nombre de mapa: permite proporcionar el nombre del mapa que contiene la definición de clave.
En la tabla solo aparece el nombre básico del mapa. Si la definición de clave proviene de un mapa referenciado desde otro mapa, lo que se muestra es el nombre básico del mapa padre seguido por el nombre base del mapa de referencia entre paréntesis.
• Lista desplegable Insertar: proporciona una lista de elementos de referencia de clave válidos para insertar en la ubicación actual del cursor.
En el caso de las referencia de clave que no estén destinadas al reemplazo de texto, el contenido de la lista estará determinado por el tipo de elemento donde se encuentre ubicado el cursor. El contenido de la lista también se ve afectado por la existencia de un conjunto de etiquetas permitidas en la columna Tipo y por el valor de la preferencia avanzada smartinsert.
En el caso de las referencias de clave destinadas al reemplazo de texto, los elementos que aparecen en esta lista vienen determinados por el valor de la preferencia avanzada ditatextkeyrefs. Por defecto, esta preferencia está definida en off para indicar que solo los elementos con vínculos que permitan una referencia de clave se mostrarán en la lista. Si la preferencia se define en on, los elementos sin vínculos que permitan una referencia de clave también se mostrarán en la lista. De este modo, se podrán insertar referencias de clave destinadas al reemplazo de texto para dichos tipos de elementos.
• Botón Insertar: permite insertar la referencia de clave seleccionada mediante el elemento seleccionado en el documento.
El valor de los atributos href, scope, type y format, así como el texto del vínculo de la definición de clave se usan para la referencia insertada.