# El manual de &kfilereplace;

## Introducció

&kfilereplace; és una aplicació que s'utilitza per cercar i substituir una llista de cadenes en un arbre de fitxers. Les cadenes poden ser literals o expressions regulars a l'estil de &Qt;. També hi ha altres opcions per afinar la cerca.

## Usar &kfilereplace;

&kfilereplace; en la seva versió autònoma &kfilereplace; en la seva versió autònoma

### La barra d'eines

La barra d'eines de &kfilereplace; s'assembla a això: La barra d'eines de &kfilereplace; La barra d'eines de &kfilereplace;

La barra d'eines mostra els botons de les funcions principals.

### Icones de la barra d'eines

Personalitza la sessió de cerca/substitueix

- Aquest botó mostra un diàleg de sessió en el que podreu establir diverses opcions bàsiques. Si s'executa &kfilereplace; com a una aplicació independent, com a primer pas haureu de fer clic en aquest botó.

Cerca

- Aquest botó inicia un bucle de cerca.

Simula

- Aquest botó inicia un bucle de cerca i substitució simulat. Realment no passa res quan es fa clic en aquest botó.

Substitueix

- Aquest botó inicia un bucle de cerca i substitució. Quan es troba una cadena, &kfilereplace; la substituirà per una altra.

Atura

- Aquest botó atura una operació.

Afegeix cadena

- Aquest botó obre el diàleg Inserir cadenes en el qual podreu editar la vostra llista de cadenes.

Suprimeix cadena

- Aquest botó elimina la cadena seleccionada (o l'actual si no hi ha selecció) de la llista.

Edita la cadena seleccionada

- Aquest botó edita la cadena seleccionada.

Llista cadenes buides

- Aquest botó elimina totes les cadenes de la llista.

Inverteix la cadena actual

- Aquest botó intercanvia la cadena de cerca amb la de substitució, de manera que podreu revertir una operació de cerca/substitueix.

Carrega la llista de cadenes des d'un fitxer

- Aquest botó carrega una llista de cadenes desades en un fitxer XML amb una extensió `kfr`.

Inclou subcarpetes

- Aquest botó permet cercar/substituir recursivament a les subcarpetes del directori base.

Crea còpies de seguretat

- Aquest botó permet generar fitxers de còpia de seguretat.

Sensible a caixa

- Aquest botó permet la cerca sensible a majúscules i minúscules.

Habilita ordres en cadenes de substitució

- Aquest botó permet la capacitat d'utilitzar ordres. Les ordres són cadenes especials. Veure kfilereplace-commands.

Habilita les expressions regulars

- Aquest botó permet expressions regulars a l'estil de &Qt;.

### La llista de resultats

La vista «Resultats» de &kfilereplace; La vista «Resultats» de &kfilereplace;

La vista de resultats mostra el nom dels fitxers que contenen les cadenes per rebre (i substituir), el seu camí, la seva mida, el nombre de cadenes trobades i l'identificador d'usuari dels fitxers. Aquesta vista també proporciona la posició exacta de cada coincidència. També podreu obrir un fitxer fent clic amb el &BDR; sobre una entrada de la llista que conté la línia i la columna de la posició al fitxer.

### La llista de cadenes

Aquesta és la vista de cadenes: La vista «Cadenes» de &kfilereplace; La vista «Cadenes» de &kfilereplace;

La vista de cadenes visualitza la llista de cadenes que voleu cercar/substituir. Tingueu en compte que en el mode de cerca les vistes de resultats i de cadenes tenen un disseny diferent.

### El diàleg de cerca i substitució en fitxers

El diàleg Cerca i substitució en fitxers s'utilitza per configurar els paràmetres bàsics necessaris per a que treballi &kfilereplace;. Es compon de dues pestanyes, General i Avançat.

#### La pestanya general

La pestanya «General» de &kfilereplace; La pestanya «General» de &kfilereplace;

Quan voleu iniciar una nova sessió el primer pas és fer clic al botó Personalitzar la sessió de cerca/substitueix. A continuació, haureu d'introduir el camí base i una seqüència de comodins a l'estil de l'intèrpret d'ordres per utilitzar com a filtre.

A continuació, podeu configurar algunes opcions útils, com la cerca en totes les subcarpetes, fer una cerca sensible a majúscules i minúscules, permetre ordres i/o expressions regulars

Recordeu que les expressions regulars i les ordres poden alentir el rendiment.

, fer una còpia de seguretat de cada fitxer abans de substituir.

Per iniciar la cerca, podeu posar una cadena al quadre de cerca i premeu Cerca ara, en cas contrari deixeu buida al quadre de cerca i premeu Cerca més tard.

#### La pestanya avançat

La pestanya «Avançat» de &kfilereplace; La pestanya «Avançat» de &kfilereplace;

La pestanya Avançat permet configurar algunes opcions útils per a restringir la cerca a un subconjunt de l'arbre de fitxers de destinació. Si només voleu executar &kfilereplace; sobre els fitxers que tinguin una mida en l'interval de 10 KB a 100 KB, llavors podeu utilitzar les opcions de mida. També hi ha una opció de data en la que es restringeix la cerca en un interval temporal, i una última opció que permet només cercar als fitxers que pertanyen (o no) a un usuari en particular (això pot ser més útil per als administradors de sistemes).

### El diàleg opcions

Aquest diàleg conté les opcions que es troben a la barra d'eines i opcions addicionals que poden ser útils en algunes situacions. El podeu invocar seleccionant Arranjament Configura KFileReplace... al menú principal.

#### Opcions generals

Aquestes opcions es presenten a la secció de la barra d'eines. La pestanya «General» de la finestra «Opcions» La pestanya «General» de la finestra «Opcions»

#### Opcions avançades

La pestanya «Avançat» de la finestra «Opcions» La pestanya «Avançat» de la finestra «Opcions»

Amaga els fitxers si no s'ha trobat o substituït cadenes Mentre se cerca, aturar en la primera cadena trobada Segueix els enllaços simbòlics Ignora fitxers i directoris ocults
- només mostra els fitxers que coincideixen amb algunes de les vostres cadenes. Això accelerarà la cerca. &kfilereplace; s'aturarà quan trobi una coincidència, i continuarà la cerca d'altres cadenes o, si cerqueu una sola cadena, continuarà amb el següent fitxer. si un fitxer és un enllaç a un altre, llavors cercarà al fitxer real. si es troben fitxers o carpetes ocultes, seran ignorats.

### El diàleg Inserir cadenes de cerca/substitueix

El diàleg «Inserir cadenes de cerca/substitueix» de &kfilereplace; El diàleg «Inserir cadenes de cerca/substitueix» de &kfilereplace;

Aquest diàleg s'utilitza per inserir i editar una llista de cadenes. Només haureu de seleccionar si s'ha d'inserir, o bé una llista per a només cerques o una llista de cerca i substitueix, i després amb els dos mini-editors presentareu el text. Els botons de fletxa us permetran afegir parells de cadenes o suprimir-les. En acabar, feu clic a D'acord.

## Característiques de &kfilereplace;

Aquest capítol proporciona informació sobre algunes capacitats útils de &kfilereplace;.

### Com desar la vostra llista de cadenes

Si voleu tornar a utilitzar una llista de cadenes, la podeu desar en un fitxer `xml`. Per fer-ho, seleccioneu des de la barra de menú Cerca/Substitueix Cadenes Desa la llista de cadenes a fitxer. Quan deseu una llista, es crearà un simple fitxer `xml` amb extensió `kfr`. Per carregar un fitxer `kfr`, seleccioneu des de la barra de menú Cerca/Substitueix Cadenes Carrega la llista de cadenes des d'un fitxer. El fitxer real s'assembla a això:

    <?xml version="1.0" ?>
    <kfr>
            <mode search="false"/>
            <replacement>
                    <oldstring
    ><![CDATA[CADENA_DE_CERCA_1]]
    ></oldstring>
                    <newstring
    ><![CDATA[CADENA_DE_SUBSTITUCIÓ_1]]
    ></newstring>
            </replacement>
            <replacement>
                    <oldstring
    ><![CDATA[CADENA_DE_CERCA_2]]
    ></oldstring>
                    <newstring
    ><![CDATA[CADENA_DE_SUBSTITUCIÓ_2]]
    ></newstring>
            </replacement>

            <replacement>
                    <oldstring
    ><![CDATA[CADENA_DE_CERCA_N]]
    ></oldstring>
                    <newstring
    ><![CDATA[CADENA_DE_SUBSTITUCIÓ_N]]
    ></newstring>
            </replacement>

    </kfr
    >

Si utilitzeu un format previ, podeu actualitzar a mà el fitxer amb només modificar-lo d'acord amb l'anterior esquema. Alternativament, podreu carregar el fitxer escrit en l'antic format i desar-lo de nou amb &kfilereplace; de la manera explicada anteriorment.

### Com crear un informe simple

Podeu crear un informe escollint Cerca/Substitueix Resultats Crea un fitxer d'informe des del menú principal. Un informe és una carpeta que conté un fitxer `xml` i `css`. Els informes poden ser útils per mantenir un registre simple de les vostres operacions. La característica «Informe» de &kfilereplace; La característica «Informe» de &kfilereplace;

### Com utilitzar expressions regulars

Si voleu cercar per cada cadena que comenci amb x, ht o u i que acabi amb ml, podeu escriure una expressió regular d'aquesta manera: `(x|ht|u)ml`. Inserir aquesta expressió a l'editor de cerques, feu clic a D'acord, i activeu les expressions regulars prement el botó Expressió regular. Tingueu en compte que l'ús d'expressions regulars us permetrà realitzar cerques molt complicades, però el cost podria ser una degradació del rendiment. L'expressió regular pot ser molt difícil, i sovint és el cas que si voleu resoldre un problema amb una expressió regular, teniu dos problemes.

### Com protegir els fitxers originals

Si no voleu perdre els fitxers originals, podeu fer una còpia d'ells abans de substituir les cadenes. Després d'inserir les cadenes, i abans d'iniciar el procés de substitució, només heu de prémer el botó Còpia de seguretat. Si voleu personalitzar l'extensió dels fitxers de còpia de seguretat obriu el diàleg Opcions.

### Com obrir un fitxer

Si voleu obrir un fitxer que coincideix amb alguna dels cadenes, haureu de seleccionar una línia a la vista de resultats i fer clic amb el &BDR;. Apareixerà un menú contextual des del qual podreu obrir el fitxer.

### Ordres

Suposeu que voleu substituir la frase Alícia al país de les meravelles amb el fitxer complet que conté la novel·la d'en Carroll. Probablement no ho voldreu fer a mà, us caldrà una ordre que ho faci. Feu clic al botó Afegeix, seleccioneu Mode de cercar i substituir i inseriu les següents cadenes: `Alícia al país de les meravelles` en el mini-editor de cerques i la cadena `[$loadfile:`/camí/carpeta/fitxer`$]` en el mini-editor de substitució. Feu clic a D'acord. Quan torneu a la finestra principal de &kfilereplace;, premeu el botó Habilita ordres que activarà les ordres, i inicieu el procés de substitució. També hi ha altres ordres, veure available-commands per obtenir una llista de totes.

## Crèdits i llicència

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

## Els autors i mantenidors de &kfilereplace;:

François Dupoux dupoux@dupoux.com

- Autor original

Andras Mantia amantia@kde.org

- Autor del shell, creador de KPart, co-mantenidor

Emiliano Gulmini emi_barbarossa@yahoo.it

- Mantenidor actual, netejador de codi i re-escriptor

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

Traductor de la documentació: &credits.Antoni.Bella;

&underFDL; &underGPL;

## Instal·lació i compilació

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

### Requeriments

Per tal d'utilitzar l'ordre [$mathexp:`alguna_expressió_matemàtica`$] haureu d'instal·lar la utilitat matemàtica &bc; (versió 1.06 o posterior), escrita per en Philip A. Nelson (philnelson@acm.org).

## Ordres de &kfilereplace;

[$datetime:iso$] [$datetime:local$] [$user:uid$] [$user:gid$] [$user:loginname$] [$user:fullname$] [$user:homedir$] [$user:shell$] [$loadfile:`/meu-camí/meu-directori/meu-fitxer`$] [$empty:$] [$random:`UN_NÚMERO_ENTER`$] [$random:$] [$mathexp:`expressió-bc`$]
- aquesta ordre retorna la data i hora actuals en format ISO de &Qt;. com l'anterior però en el format local. retorna l'identificador de l'usuari actual. retorna l'identificador de grup de l'usuari actual. retorna nom d'accés de l'usuari actual. retorna nom complet de l'usuari actual. retorna la carpeta inicial de l'usuari actual. retorna l'interpret d'ordres de l'usuari actual. retorna el contingut del fitxer meu-fitxer. retorna la cadena buida. retorna una cadena de nombres aleatoris utilitzant UN_NÚMERO_ENTER com la llavor inicial. ​​igual que l'anterior, però sense llavor inicial. retorna el resultat d'una expressió matemàtica de &bc; v1.06.

&documentation.index;