# Menú configurable por el usuario

## Configuración

&kile; soporta un menú configurable por el usuario, que se mostrará como una parte del menú de &kile;. Este menú se puede configurar utilizando el diálogo de configuración de &kile; con Preferencias Configurar Kile Menú del usuario.

Configurar el menú del usuario Configurar el menú del usuario

Tiene dos opciones para posicionar este menú:

- El menú Menú del usuario aparecerá en la barra de menú principal entre los menús LaTeX y Asistente, y el asistente de configuración Editar menú del usuario, en el menú Asistente.

  El menú del usuario está ubicado en el menú principal El menú del usuario está ubicado en el menú principal

- o ambos elementos aparecerán en la parte inferior de la entrada del menú LaTeX.

  El menú del usuario como parte del menú LaTeX El menú del usuario como parte del menú LaTeX

Las etiquetas definidas por el usuario que ya existan de versiones anteriores de &kile; se transformarán automáticamente en el nuevo menú configurable por el usuario. Las etiquetas se guardan en un archivo llamado `usertags.xml` y como todos los archivos de definición de menús, pueden estar en el directorio del menú del usuario local de &kile;: `KILE_APP_DIR/usermenu/`, ⪚ `/home/user/.kde/share/apps/kile/usermenu/`.

Puede utilizar diferentes archivos de definición de menús para diferentes tareas. Llame al asistente del menú del usuario Asistente Editar el menú del usuario o LaTeX Editar el menú del usuario para instalar o editar un archivo de definición de menú.

## Asistente

Puede crear menús nuevos o modificar los existentes con un cómodo asistente de configuración del menú del usuario que se encuentra en Asistente Editar el menú del usuario.

Asistente del menú del usuario Asistente del menú del usuario

En la parte izquierda verá un árbol de menú existente. Al igual que en un menú estándar, hay tres tipos diferentes de elementos de menú disponibles:

- entradas de menú estándar, que se asignan a una acción

- submenús, que contienen más elementos de menú

- separadores, para obtener una estructura visible de todas las entradas.

Para modificar este menú, utilice los seis botones de la izquierda. Hay más acciones posibles disponibles en el menú contextual de los elementos de menú ya existentes.

Árbol del menú definido por el usuario Árbol del menú definido por el usuario

Cada elemento de menú estándar está asignado a una de tres tipos de acciones, cada una de las cuáles tiene diferentes atributos, que podrían establecerse:

- Texto: &kile; le otorga la capacidad de crear sus propias etiquetas. Una etiqueta es similar a un atajo de teclado que lanza algún comando o escribe textos utilizados con frecuencia, ⪚ Joe Sixpack suele utilizar con frecuencia la frase `Hola, he sido incluido…`. Esta etiqueta se incluirá en la posición actual del cursor, cuando se llame a esta acción (consultar arriba). Los metacaracteres también están disponibles (consulte id_usermenu_placeholders).

- Insertar contenidos del archivo: Inserta el contenido completo de un archivo indicado.

  Insertar los contenidos de un archivo Insertar los contenidos de un archivo

- Ejecutar un programa externo: La salida de este programa se puede insertar en el documento abierto. También es posible utilizar el metacaracter `%M` en la línea de ordenes de este programa, puesto que el texto seleccionado se guardará en un archivo temporal. Utilice `%M` para el nombre de archivo de este archivo temporal.

  Ejecutar un programa externo Ejecutar un programa externo

Si falta alguna información importante para una acción, los elementos del menú se colorean en rojo. Esto puede deberse a un archivo no existente

Archivo no existente Archivo no existente

o a la falta de un título para la entrada de menú, lo que se denotará con marcas de interrogación como `???`.

Falta el título de una entrada de menú Falta el título de una entrada de menú

Si abre el menú contextual de uno de estos elementos de menú coloreados en rojo, obtendrá una opción adicional para más información sobre este error.

Información adicional Información adicional

También puede disponer de más información utilizando la funcionalidad ¿Qué es esto? de la mayoría de los widgets.

## Marcadores de posición

### Insertar texto

Hay algunos marcadores de posición que se pueden utilizar en las etiquetas definidas por el usuario: `%C`, `%B`, `%M`, `%E`, `%R` y `%T`.

- `%C`: es donde se colocará el cursor tras la inserción de una etiqueta definida por el usuario.

  Posición del cursor (%C) Posición del cursor (%C)

- `%B`: será sustituido por una viñeta (consulte editing_bullets).

  Viñeta (%B) Viñeta (%B)

- `%M`: será sustituido por el texto seleccionado.

  Texto seleccionado (%M) Texto seleccionado (%M)

- `%E`: denota la profundidad de la sangría del texto que hay dentro de un entorno.

  Sangría del texto de un entorno (%E) Sangría del texto de un entorno (%E)

- `%R`: llamará a un diálogo de referencia para seleccionar una etiqueta ya haya sido definida. Esto se puede utilizar para hacer una referencia a una etiqueta predefinda, que se puede seleccionar de una lista desplegable (consulte también LaTeX Referencias ref o LaTeX Referencias pageref).

  Referencias (%R) Referencias (%R)

- `%T`: llamará a un diálogo de cita para seleccionar una cita ya definida. Al igual que cuando se utiliza LaTeX Referencias cite aparecerá una lista con todas las claves de citas.

  Claves de citas (%T) Claves de citas (%T)

Vamos a considerar otro ejemplo, con la siguiente macro `\frac{%M}{%C}`. En primer lugar, seleccionamos un número en nuestro texto, digamos `42`. Ahora invocamos esta macro y obtenemos `\frac{42}{}` con el cursor colocado dentro del segundo par de corchetes.

### Insertar los contenidos de un archivo

Si desea insertar los contenidos de un archivo de texto, puede utilizar los mismos marcadores de posición.

### Ejecutar un programa

Si desea ejecutar un programa externo, en la línea de ordenes solo se reconoce el marcador `%M` para el texto seleccionado. La selección se guardará en un archivo temporal y el marcador de posición `%M` se sustituye con este nombre de archivo.

Ejecutar un programa externo (%M) Ejecutar un programa externo (%M)

Otro marcador de posición es `%S`, que se sustituye por el nombre base completo, sin la ruta, del documento actual. Este nombre base está compuesto de todos los caracteres del nombre de archivo hasta (pero sin incluirlo) el último carácter «.».

## Parámetro

Muchas entradas de menú pueden tener parámetros adicionales que se explican por sí solos, y que se pueden marcar. Si algunos de estos parámetros no están disponibles para algún tipo de acción, se desactivan.

Parámetro del menú del usuario Parámetro del menú del usuario

Este es un ejemplo de como ejecutar un programa externo:

Ejemplo de parámetro Ejemplo de parámetro

Puede ver que se llama un script `perl`, que debe trabajar con la selección actual. El parámetro Se necesita un texto seleccionado está marcado para garantizar una selección. La salida de este script se insertará (Insertar la salida del programa seleccionado) y sustituirá a la selección actual (Reemplazar texto seleccionado), pero no se seleccionará a sí misma.

Por supuesto, también puede lanzar sus propios programas o guiones. Por ejemplo, seleccionar una lista de números separados por espacios y llamar a un guion o a un programa de Perl que transforme dicha selección en código &latex; para una matriz. Cualquier idea que tenga se puede realizar usando la siguiente entrada del menú de usuario.

Ejemplo de parámetro 2 Ejemplo de parámetro 2

## Archivos de definición de menús

Puede instalar diferentes menús en tiempo de ejecución para diversas tareas. Cuando llame al asistente del menú del usuario, se cargará el archivo de definición de menú actual. Si lo modifica y cierra el diálogo con Aceptar, los cambios se guardarán y se instalarán como un nuevo menú de usuario. El cierre del diálogo con Cancelar descartará todos los cambios.

Archivos de definición de menú Archivos de definición de menú

También es libre de guardar el archivo modificado en el directorio de menús de usuario o de cargar otro archivo de definición de menú e instalarlo. Todos los archivos de definición de menús de usuario se deben guardar en el directorio local de menús de usuario de &kile;: `KILE_APP_DIR/usermenu/`.

Eche un vistazo al archivo de definición de menú de ejemplo `example.xml` para ver más entradas de menú con sus parámetros.