# El manual de &kfilereplace;

## Introducción

&kfilereplace; es una aplicación que se utiliza para buscar y reemplazar una lista de cadenas en un árbol de archivos. Las cadenas deben ser literales o expresiones regulares al estilo de &Qt;. También hay otras opciones para una búsqueda más precisa.

## Usar &kfilereplace;

&kfilereplace;, en su versión autónoma. &kfilereplace;, en su versión autónoma.

### La barra de herramientas

La barra de herramientas de &kfilereplace; debería tener este aspecto: Barra de herramientas de &kfilereplace; Barra de herramientas de &kfilereplace;

La barra de herramientas le muestra los botones de las funcionalidades principales.

### Iconos de la barra de herramientas

Personalizar sesión de búsqueda o reemplazo

- Este botón muestra una ventana con un cuadro de diálogo de sesión en el que puede definir varias opciones básicas. Si &kfilereplace; funciona como aplicación individual, debería hacer clic sobre este botón como primer paso.

Buscar

- Este botón da comienzo al bucle de búsqueda.

Reemplazar

- Este botón da comienzo a un bucle simulado de búsqueda y reemplazo. En realidad, no se realiza ninguna operación cuando pulsa este botón.

Reemplazo

- Este botón da comienzo al bucle de búsqueda y reemplazo. Cuando se encuentra una cadena, &kfilereplace; la reemplaza por otra.

Detener

- Este botón detiene una operación.

Añadir cadena

- Este botón abre el cuadro de diálogo Añadir cadenas, en el que puede editar su lista de cadenas.

Borrar cadena

- Este botón borra de la lista la cadena seleccionada (o la actual si no hay ninguna en la selección).

Modificar cadena seleccionada

- Este botón edita la cadena seleccionada.

Lista de cadenas vacía

- Este botón borra todas las cadenas de la lista.

Invertir cadena actual

- Este botón intercambia la cadena de búsqueda y la de reemplazo. De este modo, se puede revertir una operación de búsqueda y reemplazo.

Cargar lista de cadenas desde archivo

- Este botón carga una lista de cadenas guardada en un archivo xml con extensión `kfr`le" >.

Incluir subcarpetas

- Este botón le permite buscar y reemplazar recursivamente en las subcarpetas del directorio base.

Crear copias de seguridad

- Este botón permite la generación de archivos de copia de seguridad.

Búsqueda sensible a las mayúsculas

- Este botón permite realizar una búsqueda sensible a mayúsculas.

Activar órdenes en la cadena de reemplazo

- Este botón activa la capacidad de órdenes. Las órdenes son cadenas especiales. Tiene más información en kfilereplace-commands.

Activar expresiones regulares

- Este botón activa las expresiones regulares al estilo de &Qt;.

### La lista de resultados

Vista de resultados de &kfilereplace; Vista de resultados de &kfilereplace;

La vista de Resultados muestra el nombre de los archivos que contienen las cadenas que se tienen que buscar (y reemplazar), su ruta, su tamaño, el número de cadenas y el identificador del usuario de los archivos. Esta vista también proporciona la posición exacta de cada coincidencia. También puede abrir un archivo haciendo clic con el &RMB; en la entrada de la lista que contiene la posición de la línea y de la columna.

### La lista de cadenas

Esta es la vista de la lista de Cadenas: Vista de cadenas de &kfilereplace; Vista de cadenas de &kfilereplace;

La vista de Cadenas muestra la lista de cadenas que sequieren buscar o reemplazar. Hay que tener en cuenta que en el modo de búsqueda, la vistas de Resultados y de Cadenas tienen una disposición diferente.

### El cuadro de diálogo de buscar y reemplazar en archivos

El cuadro de diálogo Buscar y reemplazar se usa para configurar los parámetros básicos que necesita &kfilereplace; para funcionar. Consta de dos pestañas, General y Avanzado.

#### La pestaña General

Pestaña «General» de &kfilereplace; Pestaña «General» de &kfilereplace;

Cuando quiera comenzar una sesión nueva, lo primero que tiene que hacer es pulsar sobre el botón Personalizar sesión de buscar y reemplazar. Después, debe introducir la ruta de búsqueda y una secuencia de comodines de la shell para usarla como filtro.

Luego, debería definir algunas opciones útiles, como la búsqueda en todas las subcarpetas, hacer una búsqueda teniendo en cuenta mayúsculas y minúsculas, activar órdenes o expresiones regulares

Tenga en cuenta que las expresiones regulares y las órdenes pueden provocar caídas de rendimiento.

, haciendo una copia de seguridad de cada archivo antes de reemplazarlo.

Si quiere comenzar a buscar, puede poner una cadena en la casilla de búsqueda y presione Buscar ahora. De no ser así, deje vacía la casilla de búsqueda y presione Buscar más tarde.

#### La pestaña Avanzado

Pestaña «Avanzado» de &kfilereplace; Pestaña «Avanzado» de &kfilereplace;

La pestaña Advanzado le permite configurar algunas opciones útiles para restringir la búsqueda a un subconjunto de su árbol de archivos de destino. Si quisiera que &kfilereplace; buscase únicamente en archivos que tuviesen un tamaño en el intervalo de 10KB a 100KB, podría usar las opciones de tamaño. También hay una opción de fecha, que restringe la búsqueda a un rango de fechas, y una última opción que le permite buscar solo en los archivos que pertenezcan (o que no pertenezcan) a un usuario en particular (esto puede ser más útil para los administradores de sistemas).

### El cuadro de diálogo Opciones

Este cuadro de diálogo contiene opciones que están en la barra de herramientas y opciones extra que pueden ser útiles en algunas situaciones. Puede invocarlo seleccionando en el menú Preferencias Configurar KFileReplace....

#### Opciones generales

Estas opciones se han presentado en la sección Barra de herramientas. La pestaña «General» de la ventana «Opciones» La pestaña «General» de la ventana «Opciones»

#### Opciones avanzadas

La pestaña «Avanzado» de la ventana «Opciones» La pestaña «Avanzado» de la ventana «Opciones»

No mostrar archivos si no se encuentran ni reemplazan cadenas Al buscar, detenerse en la primera cadena que se encuentre Seguir enlaces simbólicos Ignorar archivos y directorios ocultos
- muestra solo los archivos que coincidan con sus cadenas. Acelera la búsqueda. &kfilereplace; se detendrá cuando encuentre una cadena que coincida, y seguirá buscando otras cadenas o, si lo que busca es una única cadena, continuará con el archivo siguiente. si un archivo es un enlace a otro, se busca en el archivo real. si se encuentran archivos o carpetas ocultas, se ignoran.

### El cuadro de diálogo cadenas de búsqueda o reemplazo

Cuadro de diálogo Insertar cadenas de búsqueda y reemplazo de &kfilereplace; Cuadro de diálogo Insertar cadenas de búsqueda y reemplazo de &kfilereplace;

Este cuadro de diálogo se usa para insertar y editar una lista de cadenas. So lo tiene que seleccionar si debe insertar, o bien una lista solo para búsquedas o una lista de búsquedas y reemplazos. Luego, con los dos minieditores debe introducir sus textos. Los botones de las flechas le permiten añadir pares de cadenas o borrarlas, si es que se equivoca. Cuando termine, haga clic sobre el botón Aceptar.

## Características de &kfilereplace;

Este capítulo proporciona información sobre algunas características útiles de &kfilereplace;.

### Cómo guardar su lista de cadenas

Cuando quiera reutilizar una lista de cadenas, puede guardarla en un archivo `xml`. Para ello, seleccione la opción Buscar/reemplazar Cadenas Guardar la lista de cadenas en un archivo de la barra de menús. Cuando guarda una lista, se crea un archivo `xml` sencillo con extensión `kfr`. Para cargar un archivo `kfr`, seleccione Buscar/reemplazar Cadenas Cargar la lista de cadenas desde un archivo en la barra de menús. El formato de este archivo debería parecerse a:

    <?xml version="1.0" ?>
    <kfr>
            <mode search="false"/>
            <replacement>
                    <oldstring
    ><![CDATA[SEARCH_STRING_1]]
    ></oldstring>
                    <newstring
    ><![CDATA[REPLACE_STRING_1]]
    ></newstring>
            </replacement>
            <replacement>
                    <oldstring
    ><![CDATA[SEARCH_STRING_2]]
    ></oldstring>
                    <newstring
    ><![CDATA[REPLACE_STRING_2]]
    ></newstring>
            </replacement>

            <replacement>
                    <oldstring
    ><![CDATA[SEARCH_STRING_N]]
    ></oldstring>
                    <newstring
    ><![CDATA[REPLACE_STRING_N]]
    ></newstring>
            </replacement>

    </kfr
    >

Si va a usar un formato anterior, puede actualizar a mano su archivo, modificándolo para que sea acorde con el esquema de arriba. También puede cargar el archivo escrito en el formato antiguo y guardarlo de nuevo con &kfilereplace; de la forma que se explicó antes.

### Cómo crear un informe sencillo

Puede crear un informe seleccionando Buscar/reemplazar Resultados Crear archivo de informe del menú. Un informe es una carpeta que contiene un archivo `xml` y otro `css`. Los informes pueden ser útiles para mantener un registro sencillo de sus operaciones. Característica «Informe» de &kfilereplace; Característica «Informe» de &kfilereplace;

### Cómo usar expresiones regulares

Si quiere buscar cada cadena que comience por x o ht o u y que termine por ml, puede escribir una expresión regular como `(x|ht|u)ml`. Inserte esta expresión en el editor de búsqueda, haga clic sobre el botón Aceptar y, por último, active las expresiones regulares cambiando el estado del botón Expresiones regulares. Tenga en cuenta que usar expresiones regulares le permite hacer búsquedas muy complejas, a cambio de un coste: la bajada de rendimiento en la velocidad. Las expresiones regulares pueden ser algo engañosas, y se suele decir que si quiere resolver un problema con una expresión regular, tiene dos problemas.

### Cómo proteger los archivos originales

Si no quiere perder sus archivos originales, puede hacer una copia de seguridad de ellos antes de reemplazar las cadenas. Después de insertar sus cadenas y antes de empezar el proceso de reemplazo, tiene que conmutar el botón Copia de seguridad. Si quiere personalizar la extensión de los archivos de la copia de seguridad, abra el cuadro de diálogo Opciones.

### Cómo abrir un archivo

Si quiere abrir un archivo que coincida con alguna de sus cadenas, tiene que seleccionar una línea en la vista de resultados y hacer clic sobre ella con el &RMB;. Aparecerá un menú de contexto desde el que pueda abrir el archivo.

### Órdenes

Pongamos que quiere sustituir la frase Alicia en el país de las maravillas por elarchivo completo que contiene la novela de Carroll. Probablemente no quiera hacerlo manualmente. Por tanto, necesita que una orden lo haga para usted. Haga clic en el botón Añadir, seleccione Modo de búsqueda y reemplazo e inserte las siguientes cadenas: `Alicia en el país de las maravillas` en el mini-editor de búsqueda y `[$loadfile:`/ruta-a-la-carpeta/mi-carpeta/mi-archivo`$]` en el minieditor de reemplazo. Haga clic en el botón Aceptar y, cuando esté de vuelta en la ventana principal de &kfilereplace;, conmute el botón Acción de orden para permitir las órdenes y dé comienzo al reemplazo. También hay otras órdenes, que puede consultar en available-commands.

## Créditos y licencia

&kfilereplace; Copyright del programa 1999 por François Dupoux dupoux@dupoux.com, 2003 Andras Mantia amantia@kde.org, 2004 Emiliano Gulmini emi_barbarossa@yahoo.it

## Los autores y responsables de &kfilereplace;:

François Dupoux dupoux@dupoux.com

- Autor original

Andras Mantia amantia@kde.org

- Autor de la shell, creador y responsable de KPart

Emiliano Gulmini emi_barbarossa@yahoo.it

- Responsable actual, limpieza y reescritura de código

Copyright de la documentación 2004 Emiliano Gulmini emi_barbarossa@yahoo.it

Traductores: Juan Manuel García Molinajuanma@superiodico.net y Rocío Gallego traducciones@rociogallego.com.

&underFDL; &underGPL;

## Instalación y compilación

&install.intro.documentation; &install.compile.documentation;

### Requisitos

Para usar la orden [$mathexp:`alguna_exp_matematica`$], debería instalar la utilidad matemática &bc; (versión 1.06 o posterior), escrita por Philip A. Nelson (philnelson@acm.org).

## Órdenes de &kfilereplace;

[$datetime:iso$] [$datetime:local$] [$user:uid$] [$user:gid$] [$user:loginname$] [$user:fullname$] [$user:homedir$] [$user:shell$] [$loadfile:`/mi-ruta/mi-directorio/mi-archivo`$] [$empty:$] [$random:`UN_NUMERO_ENTERO`$] [$random:$] [$mathexp:`expresión-de-bc`$]
- esta orden devuelve la fecha y hora en formato &Qt; ISO. como el anterior, pero en formato local. devuelve el UID del usuario actual. devuelve el GID del usuario actual. devuelve el nombre del usuario actual. devuelve el nombre completo del usuario actual. devuelve la carpeta personal del usuario actual. devuelve la shell del usuario actual. devuelve el contenido del archivo mi-archivo. devuelve la cadena vacía. devuelve una cadena con un número aleatorio, usando UN_NUMERO_ENTERO como semilla inicial. como el anterior, pero sin semilla inicial. devuelve el resultado de una expresión matemática de &bc; 1.06.

&documentation.index;