&Anders.Lund; &Anders.Lund.mail;
Pablo
de Vicente

    vicente@oan.es

Traductor
Marcos
Fouces Lago

    mfouces@yahoo.es

Traductor
Santiago
Fernández Sancho

    santi@est.unileon.es

Traductor

# Herramientas de edición avanzadas

## Comentar/descomentar

Las órdenes Comentar y Descomentar, disponibles en el menú Herramientas le permiten añadir o eliminar marcas de comentario de la selección, o en su defecto, de la línea actual. El formato de los comentarios depende del formato del texto que esté escribiendo.

Las reglas que determinan cómo deben ser los comentarios se establecen en las definiciones de sintaxis, así que si no se utiliza el resaltado de sintaxis, no será posible la realización automática de comentarios.

Algunos formatos definen marcas de comentarios de una sola línea, otros de varias líneas y otros utilizan ambas posibilidades. Si no están disponibles los comentarios de varias líneas, será imposible comentar una selección cuya última línea no esté incluida por completo.

Si está disponible una marca de comentario de una sola línea, es preferible comentar las líneas individualmente, ya que así se evitan problemas de comentarios anidados.

Al eliminar las marcas de comentario, se debe seleccionar el texto no comentado. Al eliminar marcas de comentario multilínea de una selección, se ignorará cualquier espacio en blanco que quede fuera de las marcas de comentario.

Para colocar marcas de comentario, utilice Herramientas Comentar o el acceso directo de teclado correspondiente, que por defecto es &Ctrl;#.

Para eliminar marcas de comentario, utilice el elemento de menú Herramientas Descomentar o el acceso directo de teclado correspondiente, que por defecto es &Ctrl;&Shift;#.

## El componente de la línea de órdenes del editor

El editor Kate tiene un componente que es una línea de órdenes interna, y le permitirá llevar a cabo diversas acciones desde un interfaz mínimo. La línea de órdenes es una entrada de texto en la parte inferior del área de edición, y para mostrarlo solo tendrá que seleccionar Ver Cambiar a línea de comando o utilizar el acceso rápido (de forma predeterminada es F7). El editor proporciona un conjunto de órdenes como las que se documentan a continuación, así como aquellos otros que se suministren a partir de extensiones.

Para ejecutar una órden, pulse la tecla entrar. La línea de órdenes indicará si ha tenido éxito mostrando un mensaje. Si entra en la línea de órdenes pulsando F7 se ocultará automáticamente después de unos segundos. Para borrar el mensaje e introducir una nueva orden, pulse F7 nuevamente.

La línea de órdenes tiene un sistema de ayuda integrado, escriba la orden `help` para iniciarlo. Para ver una lista de todas las órdenes disponibles escriba `help list`, para ver ayuda especifica para una orden específica, escriba `help orden`.

La línea de órdenes tiene integrado un historial, por tanto podrá reutilizar las órdenes ya tecleadas. Para navegar a través del historial, utilice las teclas Arriba y Abajo. A la vez que se muestran las órdenes del historial, se seleccionará la parte del argumento, permitiendo cambiarlos fácilmente, sobreescribiendo los argumentos.

### Órdenes estándar de la línea de órdenes

#### Órdenes para configurar el editor

Estas órdenes son las que proporciona el componente del editor, y le permite configurar únicamente el documento activo y la vista. Esto es especialmente práctico si desea utilizar una configuración diferente de la predeterminada, por ejemplo para el sangrado.

##### Tipos de argumentos

BOOLEAN

  Se utilizan con órdenes que activan o desactivan opciones. Los valores aceptados son: `on`, `off`, `true`, `false`, `1` o `0`.

INTEGER

  Un número entero.

STRING

  Una cadena.

    set-tab-widthINTEGER ancho

  Establece la tabulación con el valor de `ancho`.

    set-indent-widthINTEGER ancho

  Establece el sangrado con el valor de `ancho`. Solo se utiliza si se está sangrando con espacios.

    set-word-wrap-columnINTEGER ancho

  Establece el ancho de línea para el ajuste de línea con el valor de `ancho`. Esto se utiliza si se tiene activado el ajuste de línea del documento.

    set-icon-borderenable

  Configura la visibilidad del borde de iconos.

    set-folding-markersBOOLEANO activar

  Configura la visibilidad del panel de marcas plegables.

    set-line-numbersBOOLEAN activar

  Configura la visibilidad de los números de línea del panel.

    set-replace-tabsBOOLEAN enable

  Si está activado, se sustituyen los espacios de tabulador por espacios normales a medida que escribe.

    set-remove-trailing-spaceBOOLEAN enable

  Si está activo, las espacios en blanco de marca se eliminan en el momento en el que el cursor salga de la línea.

    set-show-tabsBOOLEAN activar

  Si está activado, los caracteres de tabulación y espacios en blanco de marca se visualizarán como un puntito.

    set-indent-spacesBOOLEAN activar

  Si está activado, el editor hará un sangrado con `indent-width` espacios para cada nivel de sangrado, en lugar de con un caracter de tabulación.

    set-mixed-indentBOOLEAN activar

  Si está activado, kate utilizará una mezcla de tabuladores y espacios para el sangrado. Cada nivel de sangrado tendrá `indent-width` de ancho, y los diferentes niveles de sangrado se optimizarán utilizando los máximos caracteres de tabulación posibles.

  Cuando se ejecuta, esta orden activará el sangrado con espacios, y si no se especifica el ancho se asignará una valor igual a la mitad de `tab-width` para el documento en tiempo de ejecución.

    set-word-wrapBOOLEAN activar

  Activa el ajuste de línea dinámico de acuerdo con el valor de `activar`.

    set-replace-tabs-saveBOOLEAN activar

  Cuando está activo, los tabuladores se reemplazan con espacios en blanco al guardar el documento.

    set-remove-trailing-space-saveBOOLEAN activar

  Cuando está activo, se eliminan las marcas de los espacios de cada línea al guardar el documento.

    set-indent-modenombre

  Asigna el modo de sangrado automático a `nombre`. si `nombre` es desconocido, el modo seleccionado es 'none'. Los modos válidos son 'cstyle', 'csands', 'xml', 'python', 'varindent' y 'none'.

    set-highlightresaltado

  Asigna el sistema de resaltado de sintaxis al documento. El argumento debe ser un nombre de resaltado válido, como aquellos que se pueden ver en el menú Herramientas Resaltado. Esta orden proporciona una lista de autocompletado para los argumentos.

#### Órdenes para la edición

Estas órdenes modifican el documento actual.

    indent

  Sangrado de texto en la línea actual.

    unindent

  Elimina el sangrado de las líneas seleccionadas o de la línea actual.

    cleanindent

  Borra el sangrado de las líneas seleccionadas o de la línea actual de acuerdo con la configuración del sangrado que tenga el documento.

    comment

  Inserta marcas de comentario haciendo que la selección, las líneas seleccionadas o la línea actual sean un comentario de acuerdo con el formato de texto que se haya definido en la sintaxis de resaltado para el documento.

    uncomment

  Elimina la etiqueta de comentario de la selección, de las líneas seleccionadas o de la línea actual, de acuerdo con las reglas sintácticas de resaltado del documento.

    kill-line

  Borra la línea actual.

    replacepatrónreemplazo

  Reemplaza el texto que coincida con `patrón` con el valor de `reemplazo`. Si desea incluir espacios en blanco en el `patrón`, deberá entrecomillar tanto el `patrón` como el `reemplazo` con comillas simples o dobles. Si los argumentos no van entrecomillados, la primera palabra se utilizará como `patrón` y el resto como `reemplazo`. Si `reemplazo` está vacío, cada aparición de `patrón` se borra.

  Puede asignar parámetros para configurar la búsqueda añadiendo dos puntos, seguidos de una o más letras cada una de las cuales representa una configuración, quedando de la forma `replace:opciones patrón reemplazo`. Las opciones disponibles son:

  `b`

    Buscar hacia atrás.

  `c`

    Buscar desde la posición del cursor.

  `e`

    Buscar sólo en el texto seleccionado.

  `r`

    Busca utilizando una expresión regular. Si está asignado, puede utilizar `\N` donde N es un número que representa capturas en la cadena de reemplazo.

  `s`

    Búsqueda distinguiendo mayúsculas y minúsculas.

  `p`

    Pide permiso para reemplazar la siguiente aparición.

  `w`

    Encontrar sólo palabras completas.

    dateformato

  Inserta una cadena de fecha/hora definida de acuerdo a `formato`, o si éste no se especifica se utiliza el formato aaaa-MM-dd hh:mm:ss. La interpretación del `formato` será la siguiente:

  `d` | El día como número sin ceros a la izquierda (1-31).
  `dd` | El día como un número a dos dígitos (01-31).
  `ddd` | La abreviatura del nombre del día según la localización (ejem: 'Lun'...'Dom').
  `dddd` | El nombre completo del día según la localización (ejem: 'Lunes'...'Domingo').
  `M` | El mes como un número sin ceros a la izquierda (1-12).
  `MM` | El mes como un número a dos dígitos (01-12).
  `MMM` | La abreviatura del nombre del mes según su localización (p.ej: 'Ene'..'Dic').
  `yy` | Año a dos dígitos (00-99).
  `yyyy` | Año a cuatro dígitos (1752-8000).
  `h` | La hora sin ceros a la izquierda (0..23 o 1..12 si se muestra AM/PM).
  `hh` | La hora a dos dígitos (00..23 o 01..12 si se muestra AM/PM).
  `m` | Los minutos sin ceros a la izquierda (0..59).
  `mm` | Los minutos a dos dígitos (00..59).
  `s` | Los segundos sin ceros a la izquierda (0..59).
  `ss` | Los segundos a dos dígitos (00..59).
  `z` | Los milisegundos sin ceros a la izquierda (0..999).
  `zzz` | Los milisegundos a tres dígitos (000..999).
  `AP` | Se utiliza para mostrar AM/PM. AP se reemplazará por "AM" o "PM".
  `ap` | Se utiliza para mostrar am/pm. ap se reemplazará por "am" o "pm".

    charidentificador

  Esta órden le permite insertar caracteres literales por su identificador numérico, en formato decimal, octal o hexadecimal. Para utilizarlo inicie el diálogo de edición de órdenes y teclee `char: [número]` en la casilla de entrada, después pulse Aceptar.

  ##### Ejemplos de `char`

  Entrada: `char:234`

  Salida: `ê`

  Entrada: `char:0x1234`

  Salida: `ሴ`

`s///[ig]` `%s///[ig]`

  Esta orden ejecuta una operación de búsqueda/sustitución similar a las de sed en la línea actual o en todo el archivo (`%s///`).

  Brevemente, se busca en el texto alguna cadena que coincida con el patrón de búsqueda, la expresión regular entre la primera y la segunda barra, y cuando se encuentra una coincidencia, la parte coincidente del texto es sustituida por la expresión contenida entre las barras central y última de la cadena. Los paréntesis en el patrón de búsquedas crean retroreferencias, es decir, que el comando recuerda qué parte de la coincidencia se encontraba entre los paréntesis; estas cadenas se pueden reutilizar en el patrón de sustitución, refiriendose a ellas como `\1` como el primer conjunto de paréntesis, `\2` como el segundo y así sucesivamente.

  Para hacer una búsqueda literal de `(` o `)`, debe escapar el carácter utilizando una barra invertida: `\(\)`.

  Si coloca una `i` al final de la expresión, las coincidencias son sensibles a mayúsculas y minúsculas. Si coloca una `g` al final, se reemplazarán todas las apariciones del patrón, en cualquier otro caso se reemplazará únicamente la primera aparición.

  ##### Sustitución de texto en la línea actual

  Su buen amigo el ordenador se ha detenido, diciendo que la clase `myClass`, mencionada en la línea 3902 del archivo fuente no está definida.

  ¡Vaya por Dios! pensará usted, es que se trataba de `MyClass`. Se desplaza a la línea 3902 y en vez de intentar buscar la palabra en el texto, abre el diálogo del comando de edición, introduce `s/myclass/MyClass/i`, pulsa el botón Aceptar, guarda el archivo y vuelve a compilar esta vez sin ningún error.

  ##### Sustitución de texto en todo el archivo

  Imagine que tiene un archivo, en el que menciona a Señorita Jensen varias veces, cuando resulta que alguien viene y le dice que se acaba de casar con Señora Jones. Usted querrá, desde luego, sustituir cada aparición de Señorita Jensen por Señora Jensen.

  Inicie la línea de órdenes y teclee la orden `%s/Señorita Jones/Señora Jones/`, y una vez que haya pulsado entrar habrá terminado.

  ##### Un ejemplo más avanzado

  Este ejemplo hace uso de referencias anteriores así como de una clase de caracteres (si no sabe lo que es esto, por favor consulte la documentación citada más adelante).

  Suponga que tiene la siguiente línea:

      void MyClass::DoStringOps( String      &foo, String &bar String *p, int  &a, int &b )

  Pero usted se da cuenta de que ese código no está bien, y decide que quiere utilizar la palabra clave `const` en todos los argumentos address of, que se caracterizan por tener un operador & delante del nombre del argumento. También desea simplificar el espacio en blanco, de forma que sólo haya uno entre cada palabra.

  Abra el diálogo de edición de órdenes, e introduzca: `s/\s+(\w+)\s+(&)/ const \1 \2/g`, después pulse el botón Aceptar. La `g` al final de la expresión hace que la expresión regular recompile cada coincidencia para guardar las retroreferencias.

  Salida: `void MyClass::DoStringOps( const String &foo, const String &bar String *p, const int &a, const int &b )`

  Misión completada. Ahora, ¿qué ha ocurrido? Bien, hemos buscado algún espacio en blanco (`\s+`) seguido de uno o más caracteres alfabéticos (`\w+`) seguidos de más espacio en blanco (`\s+`) seguido del símbolo &, y en el proceso hemos guardado el bloque alfabético y el & para reutilizarlos en la operación de sustitución. Entonces hemos sustituido la parte coincidente de nuestra línea por un espacio en blanco seguido de const seguido de un espacio en blanco seguido de nuestro bloque alfabético (`\1`) seguido de un espacio en blanco seguido de nuestro & almacenado (`\2`)

  En algunos casos el bloque alfabético era String, en otros int, así que la clase de caracteres `\w` y el cuantificador `+` nos han servido de gran ayuda.

#### Opciones para navegar

    gotoINT línea

  Esta orden va a la línea especificada.

    findpatrón

  Esta orden navega hasta la primera aparición del `patrón` de acuerdo con la configuración. Las siguientes apariciones se pueden encontrar utilizando Editar Buscar siguiente (el acceso rápido predeterminado es F3).

  La orden find puede configurarse añadiendo dos puntos seguidos de una o más opciones, el formato es `find:opciones patrón`. Están soportadas las siguientes opciones:

  `b`

    Buscar hacia atrás.

  `c`

    Buscar desde la posición del cursor.

  `e`

    Buscar sólo en el texto seleccionado.

  `r`

    Busca utilizando una expresión regular. Si está asignado, puede utilizar `\N` donde N es un número que representa capturas en la cadena de reemplazo.

  `s`

    Búsqueda distinguiendo mayúsculas y minúsculas.

  `w`

    Encontrar sólo palabras completas.

    ifindpatrón

  Esta orden proporciona búsqueda como-teclee. Puede configurar el comportamiento o la búsqueda añadiendo dos puntos seguidos de una o más opciones, de forma similar a: `ifind:opciones patrón`. Las opciones permitidas son:

  `b`

    Buscar hacia atrás.

  `r`

    Buscar mediante expresiones regulares.

  `s`

    Búsqueda distinguiendo mayúsculas y minúsculas.

  `c`

    Buscar desde la posición del cursor.