<para>&tdefilereplace; es una aplicación que se usa para buscar y reemplazar una lista de cadenas en el árbol de archivos. Las cadenas deben ser literales o expresiones regulares al estilo de Qt. Incluso hay otras opciones para una mayor precisión en su búsqueda. </para>
<para>Este botón muestra una ventana con un <link linkend="tdefilereplace-the-project-dialog">cuadro de diálogo de sesión</link> en el que puede definir varias opciones básicas. Si &tdefilereplace; funciona como aplicación individual, debería hacer clic sobre este botón como primer paso.</para>
<para>Este botón da comienzo al bucle de búsqueda y reemplazo. Cuando se ha encontrado una cadena, &tdefilereplace; la reemplaza por otra cadena.</para>
<para>Este botón abre el cuadro de diálogo <link linkend="tdefilereplace-the-add-dialog">Añadir cadenas</link>, en el quepuede editar su lista de cadenas.</para>
<para>Este botón alterna entre la búsqueda y el reemplazo de una cadena. De este modo puede cambiar el comportamiento de la operación de búsqueda y reemplazo.</para>
<para>Este botón carga una <link linkend="tdefilereplace-the-kfr-file">lista de cadenas</link> guardada en un archivo xml con extensión <literal role="extension">kfr</literal>le"></para>
<para>Este botón activa la capacidad de órdenes. Las órdenes son cadenas especiales. Tiene más información en <xref linkend="tdefilereplace-commands"/>.</para>
<para>La vista de <guilabel>Resultados</guilabel> 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 id. del usuario de los archivos. Esta vista también le 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.</para>
<para>La vista de <guilabel>Cadenas</guilabel> visualiza la lista de cadenas que quiere buscar o reemplazar. Tenga en cuenta que en el modo de búsqueda, la vista de los <guilabel>Resultados</guilabel> y de las <guilabel>Cadenas</guilabel> tienen una disposición diferente.</para>
<title>El cuadro de diálogo <guilabel>Nueva sesión</guilabel></title>
<para>El cuadro de diálogo <guilabel>Nueva sesión</guilabel> se usa para configurar los parámetros básicos que necesita &tdefilereplace; para funcionar. Consta de dos solapas, <guilabel>General</guilabel> y <guilabel>Avanzado</guilabel>. </para>
<para>Cuando quiera comenzar una sesión nueva, lo primero que tiene que hacer es clic sobre el <link linkend="tdefilereplace-the-toolbar">botón <guiicon>Nueva sesión</guiicon></link>. Luego debe introducir la ruta de búsqueda y una secuencia de comodines de la shell para usarla como un filtro.</para>
<para>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 y/o expresiones regulares<footnote id="performancewarning"><para>Tenga en cuenta que las expresiones regulares y las órdenes pueden provocar caídas de rendimiento.</para></footnote>, haciendo una copia de seguridad de cada archivo antes de reemplazarlo.</para>
<para>Si quiere comenzar a buscar, puede poner una cadena en la casilla de búsqueda y presione <guibutton>Buscar ahora</guibutton>. De no ser así, deje vacía la casilla de búsqueda y presione <guibutton>Buscar más tarde</guibutton>.</para>
<para>La solapa <guilabel>Advanzado</guilabel> le permite configurar algunas opciones útiles para restringir la búsqueda a un subconjunto de su árbol de archivos de destino. Si quisiera que &tdefilereplace; buscase únicamente en archivos que tuviesen un tamaño en el rango 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).</para>
<title>El cuadro de diálogo <guilabel>Opciones</guilabel></title>
<para>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ú <menuchoice><guimenu>Preferencias</guimenu><guimenuitem>Configurar KFileReplace...</guimenuitem></menuchoice>. </para>
<seg>muestra sólo los archivos que coincidan con sus cadenas. Acelera la búsqueda.</seg>
<seg>&tdefilereplace; 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.</seg>
<seg>si un archivo es un enlace a otro, se busca en el archivo real.</seg>
<seg>si se encuentran archivos o carpetas ocultas, se ignoran.</seg>
<para>Este cuadro de diálogo se usa para insertar y editar una lista de cadenas. Sólo tiene que seleccionar si debe insertar o bien una lista sólo para búsquedas o una lista de búsquedas y reemplazos. Luego, con los dos mini-editores debe introducir sus textos. Los botones de las flechas le permiten añadir pares de cadenas o eliminarlas, si es que se equivoca. Cuando termine, haga clic sobre el botón <guibutton>Aceptar</guibutton>.</para>
<para>Cuando quiera reutilizar una lista de cadenas, puede guardarla en un archivo <literal role="extension">xml</literal>. Para ello, seleccione la opción <menuchoice><guimenu>Buscar/reemplazar</guimenu><guisubmenu>Cadenas</guisubmenu><guimenuitem>Guardar la lista de cadenas en un archivo</guimenuitem></menuchoice> de la barra de menús. Cuando guarda una lista, se crea un archivo <literal role="extension">xml</literal> sencillo con extensión <literal role="extension">kfr</literal>. Para cargar un archivo <literal role="extension">kfr</literal>, seleccione <menuchoice><guimenu>Buscar/reemplazar</guimenu><guisubmenu>Cadenas</guisubmenu><guimenuitem>Cargar la lista de cadenas desde un archivo</guimenuitem></menuchoice> en la barra de menús. El formato de este archivo debería parecerse a:</para>
<para>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 &tdefilereplace; de la forma que se explicó antes.</para>
<para>Puede crear un informe seleccionando <menuchoice><guimenu>Buscar/reemplazar</guimenu><guisubmenu>Resultados</guisubmenu><guimenuitem>Crear archivo de informe</guimenuitem></menuchoice> del menú. Un informe es un directorio que contiene un archivo <literal role="extension">xml</literal> y otro <literal role="extension">css</literal>. Los informes pueden ser útiles para mantener un registro sencillo de sus operaciones. <screenshot>
<screeninfo>Característica «Informe» de &tdefilereplace;</screeninfo>
<para>Si quiere buscar cada cadena que comience por <quote>x</quote> o <quote>ht</quote> o <quote>u</quote> y que termine por <quote>ml</quote>, puede escribir una expresión regular como <userinput>(x|ht|u)ml</userinput>. Inserte esta expresión en el editor de búsqueda, haga clic sobre el botón <guibutton>Aceptar</guibutton> y, por último, active las expresiones regulares cambiando el estado del <link linkend="tdefilereplace-the-toolbar">botón <guibutton>Expresiones regulares</guibutton></link>. 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 <quote>si quiere resolver un problema con una expresión regular, tiene dos problemas</quote>.</para>
<title>Cómo proteger los archivos originales</title>
<para>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 cambiar el <link linkend="tdefilereplace-the-toolbar">botón <guiicon>Copia de seguridad</guiicon></link>. Si quiere personalizar la extensión de los archivos de la copia de seguridad, abra el <link linkend="tdefilereplace-the-options-dialog">cuadro de diálogo <guilabel>Opciones</guilabel></link>. </para>
<para>Si quiere abrir un archivo que coincida con alguna de sus cadenas, tiene que seleccionar una línea en la vista de resultados y haga clic sobre ella con el &RMB;. Aparecerá un menú desde el que pueda abrir el archivo. Si usa &tdefilereplace; desde &quantaplus;, puede abrir el archivo directamente en la línea en la columna especificadas.</para>
<para>Pongamos que quiere sustituir la frase <quote>Alicia en el país de las maravillas</quote> por el<ulink url="http://www.textlibrary.com/download/alice-wo.txt">archivo completo que contiene la novela de Carroll</ulink>. Probablemente no quiera hacerlo manualmente. Por tanto, necesita que una orden lo haga para usted. Haga clic en el botón <link linkend="tdefilereplace-the-toolbar"><guiicon>Añadir</guiicon></link>, seleccione <guilabel>Modo de búsqueda y reemplazo</guilabel> e inserte las siguientes cadenas: <userinput>Alicia en el país de las maravillas</userinput> en el mini-editor de búsqueda y <userinput>[$loadfile:<replaceable>/ruta-a-la-carpeta/mi-carpeta/mi-archivo</replaceable>$]</userinput> en el mini-editor de reemplazo. Haga clic en el botón <guibutton>Aceptar</guibutton> y, cuando esté de vuelta en la ventana principal de &tdefilereplace;, active el botón <link linkend="tdefilereplace-the-toolbar">Acción de orden</link> para permitir las órdenes y dé comienzo al reemplazo. También hay otras órdenes, que puede consultar en <xref linkend="available-commands"/>..</para>
<para>&tdefilereplace; Copyright del programa 1999 por François Dupoux <email>dupoux@dupoux.com</email>, 2003 Andras Mantia <email>amantia@kde.org</email>, 2004 Emiliano Gulmini <email>emi_barbarossa@yahoo.it</email> </para>
<para>&tdefilereplace; es actualmente parte del paquete &tdewebdev;. Por tanto, para instalarlo tiene que obtener una copia de &tdewebdev;. Si está usando una instalación de &kde; que le haya proporcionado el mismo autor del sistema operativo probablemente ya tenga instalado &tdewebdev;. En ese caso puede optar por usar &tdefilereplace; abriéndolo desde el editor web &quantaplus; o bien llamarlo directamente (a no ser que tenga una versión antigua de &kde;). Si no, puede descargar desde Internet el paquete &tdewebdev;. Para ello, puede dirigirse al <ulink url="http://kdewebdev.org">sitio web de &tdewebdev;</ulink>, donde podrá obtener toda la información que necesite. </para>
<para>Para usar la orden <link linkend="available-commands">[$mathexp:<replaceable>alguna_exp_matematica</replaceable>$]</link>, debería instalar la utilidad matemática &bc; (versión 1.06 o posterior), escrita por Philip A. Nelson (<email>philnelson@acm.org</email>)</para>
