# &kfilereplace;'i käsiraamat

## Sissejuhatus

&kfilereplace; on tööriist, millega saab failipuus üht või enamat stringi otsida ning asendada. Otsitavad stringid võivad olla sõna-sõnalised või &qt;-stiilis regulaaravaldised. Otsingut saab mitmel moel täpsustada.

## &kfilereplace;'i kasutamine

&kfilereplace; omaette rakendusena &kfilereplace; omaette rakendusena

### Tööriistariba

&kfilereplace;'i tööriistariba näeb välja selline: &kfilereplace;'i tööriistariba &kfilereplace;'i tööriistariba

Tööriistaribal paiknevad põhilisi toiminguid pakkuvad nupud.

### Tööriistariba ikoonid

Uus seanss

- Selle nupuga saab avada seansidialoogi, milles saab määrata ära mitmed põhivalikud. Kui &kfilereplace; käivitada omaette rakendusena, tulekski kõigepealt sellele nupule klõpsata.

Otsi

- See nupp käivitab otsimise.

Asenda

- See nupp alustab otsimist ja asendamist. Kui otsitav string leitakse, asendab &kfilereplace; selle uue, sinu määratud stringiga.

Simuleeri

- See nupp alustab otsimise ja asendamise simulatsiooni. Sellele klõpsates ei võeta tegelikult midagi ette.

Peata

- See nupp peatab operatsiooni.

Lisa string

- See nupp avab stringi lisamise dialoogi, kus saab muuta stringide nimekirja.

Kustuta string

- See nupp kustutab valitud (või aktiivse, kui midagi pole valitud) stringi nimekirjast.

Muuda stringi

- See nupp võimaldab redigeerida valitud stringi.

Kustuta nimekiri

- See nupp kustutab nimekirjast kõik stringid.

Vaheta string

- See nupp vahetab otsingu- ja asendusstringi, võimaldades hõlpsasti tagasi võtta varasemat otsimis/asendamisoperatsiooni

Laadi stringide nimekiri

- See nupp avab stringide nimekirja, mis on salvestatud XML-failina laiendiga `kfr`.

Kaasa alamkataloogid

- See nupp võimaldab otsida/asendada oma baaskataloogis rekursiivselt, s.t. alamkatalooge kaasates.

Loo varukoopiad

- See nupp võimaldab failide varukoopia loomist.

Tõstutundlik

- See nupp võimaldab tõstutundlikku otsingut.

Käsud

- See nupp võimaldab kasutada käske. Käsud on eristringid. Vt. kfilereplace-commands.

Regulaaravaldised

- See nupp võimaldab kasutada &qt;-stiilis regulaaravaldisi.

### Tulemuste nimekiri

&kfilereplace;'i tulemuste vaade &kfilereplace;'i tulemuste vaade

Tulemuste vaade näitab nende failide nimesid, milles esineb otsitav (ja asendatav) string, nende asukohta, suurust, leitud stringide arvu ning failide kasutaja ID-d. Vaates on näha ka leitud stringide täpne asukoht failides. Faili saab avada rida ja veergu sisaldaval nimekirja kirjel &HPN;ga klõpsates.

### Stringide nimekiri

Selline näeb välja stringide vaade: &kfilereplace;'i stringide vaade &kfilereplace;'i stringide vaade

Stringide vaade näitab stringide nimekirja, mida soovid otsida/asendada. Arvesta, et otsimisrežiimis on tulemuste ja stringide vaade erinevad.

### Uue seansi dialoog

Uue seansi dialoogis saab määrata peamised parameetrid, mille alusel &kfilereplace; töötab. Dialoog koosneb kahest kaardist: Üldine ja Muud.

#### Kaart Üldine

&kfilereplace;'i kaart Üldine &kfilereplace;'i kaart Üldine

Kui soovid alustada uut seanssi, tuleb kõigepealt klõpsata tööriistaribal nupule Uus seanss button. Seejärel tuleb määrata baaskataloog ning filtrina kasutatavad metamärgid.

Siin on võimalik valida ka mõningad kasulikud lisamäärangud, näiteks otsimine alamkataloogides, tõstutundlik otsing, käskude lubamine, regulaaravaldiste kasutamine

Palun arvesta, et regulaaravaldised ja käsud võivad mõjuda negatiivselt operatsiooni kiirusele.

, varukoopia loomise kõigist failidest enne asendusoperatsiooni.

Otsimise alustamiseks kirjuta otsingukasti string ja klõpsa nupule Otsi nüüd. Teine võimalus on jätta otsingukast tühjaks ja klõpsata nupule Otsi hiljem.

#### Kaart Muud

&kfilereplace;'i kaart Muud &kfilereplace;'i kaart Muud

Kaardil Muud on mõningad valikud, millega saab piirata otsingut failisüsteemi teatud osaga. Kui soovid näiteks kasutada &kfilereplace;'i failide leidmiseks, mille suurus jääb vahemikku 10 KB kuni 100 KB, saab kasutada suurusepiirangut. Samuti saab määrata otsitavate failide ajalise vahemiku ning lasta otsida ainult teatud kasutajale kuuluvaid (või mittekuuluvaid) faile. Viimane võimalus on eriti kasulik süsteemiadministratoritele.

### Seadistustedialoog

Selles dialoogis leiab valikud, mida võib näha tööriistaribal, aga ka mõned lisavalikud, millest võib teatud olukordades kasu olla. Dialoogi saab avada menüükäsuga Seadistused KFileReplace seadistamine...

#### Üldised seadistused

Neid seadistusi on selgitatud tööriistariba tutvustavas osas. Seadistustedialoogi kaart Üldine Seadistustedialoogi kaart Üldine

#### Muud seadistused

Seadistustedialoogi kaart Muud Seadistustedialoogi kaart Muud

Faili ei näidata, kui stringe ei leita ega asendata Otsimisel peatutakse esimese leitud stringi juures Nimeviitade järgimine Peidetud failide ja kataloogide ignoreerimine
- näitab ainult faile, mis sobivad otsitava stringiga. See kiirendab otsingut. &kfilereplace; peatub sobiva stringi leidmisel ja jätkab muude stringide otsingut või kui otsidki ainult üht stringi, liigub otsinguga edasi järgmise faili juurde. kui fail viitab mõnele muule failile, otsitakse tegelikus failis. peidetud failide või kataloogide esinemisel jäetakse need läbi uurimata.

### Stringi lisamise dialoog

&kfilereplace;'i stringi lisamise dialoog &kfilereplace;'i stringi lisamise dialoog

Selle dialoogiga saab stringe nimekirja lisada ja neid muuta. Selleks tuleb lihtsalt lisada kas ainult otsitav või otsimis/asendamisnimekiri ning siis kahe miniredaktoriga määrata oma otsitav tekst. Noolenupud võimaldavad stringe lisada või kustutada. Kui oled lõpetanud, klõpsa nupule OK.

## &kfilereplace;'i omadused

Selles peatükis tutvustame mõningaid &kfilereplace;'i kasulikke omadusi.

### Kuidas salvestada stringide nimekirja

Kui soovid stringide nimekirja taaskasutamiseks talletada, saab selle salvestada `xml`-failina. Selleks vali menüükäsk Otsimine/Asendamine Stringid Salvesta stringide nimekiri failina. Nimekirja salvestamisel luuakse lihtne `xml`-fail laiendiga `kfr`. `kfr`-faili avamiseks vali menüükäsk Otsimine/Asendamine Stringid Laadi stringide nimekiri failist. Fail ise näeb välja umbes selline:

    <?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
    >

Kui kasutad varasemat vormingut, saad seda käsitsi uuendada, muutes faili vastavalt toodud skeemile. Teine võimalus on avada vanas vormingus fail ja lasta see &kfilereplace;'il juba uues vormingus salvestada eespool kirjeldatud käsuga.

### Kuidas luua lihtne raport

Rapordi loomiseks vali menüükäsk Otsimine/Asendamine Tulemused Loo rapordifail. Raport on kataloog, mis sisaldab `xml`- ja `css`-faili. Rapordid on kasulikud näiteks oma operatsioonidel silma peal hoidmiseks. &kfilereplace;'i rapordivõimalus &kfilereplace;'i rapordivõimalus

### Kuidas kasutada regulaaravaldisi

Kui soovid otsida kõiki faile, mille alguses seisab x, ht või u ja lõpus ml, võid kirja panna sellise regulaaravaldise: `(x|ht|u)ml`. Lisa see otsinguredaktorisse, klõpsa nupule OK ning luba regulaaravaldiste kasutamine klõpsuga nupule Regulaaravaldis. Pane tähele, et regulaaravaldistega on võimalik sooritada ka väga keerukaid otsinguid, kuid see võtab omajagu aega. Regulaaravaldised on üsna keerukad ja kapriissed, nii et sageli öeldakse, et kui soovid lahendada probleemi regulaaravaldist kasutades, saad kaela kaks probleemi.

### Kuidas kaitsta originaalfaile

Kui sa ei soovi kaotata algseid faile, võib neist enne stringide asendamist koopia teha. Pärast stringide lisamist ja enne asendamise alustamist tuleb lihtsalt sisse lülitada nupp Varukoopia. Kui soovid varukoopiate laiendit muuta, ava seadistustedialoog.

### Kuidas faili avada

Kui soovid avada faili, milles leidub mõni otsitav string, tuleb tulemustevaates valida vastav rida ja klõpsata sellel &HPN;ga. Ilmuvast kontekstimenüüst saabki valida faili avamise käsu. Kui kasutad &kfilereplace;'i &quantaplus;'i põimituna, saad faili avada otse selles vajalikul real ja veerus.

### Käsud

Oletame, et soovid asendada väljendi Alice Imedemaal terve Carrolli jutustust sisaldava failiga. Vaevalt soovid sa seda käsitsi teha ning siin tulevadki appi käsud. Klõpsa nupule Lisa, vali OTsimis/asendamisrežiim ja sisesta järgmised stringid: `Alice Imedemaal` otsingu miniredaktorisse ning `[$loadfile:`/minu-kataloogi-asukoht/minu-kataloog/minu-fail`$]` asendamise miniredaktorisse. Klõpsa nupule OK. Klõpsa nüüd &kfilereplace;'i peaaknas nupule Käsud, mis lubab kasutada käske, ning alusta asendamist. Käske on teisigi, need toob ära available-commands.

## Autorid ja litsents

&kfilereplace;. Rakenduse autoriõigus 1999: François Dupoux dupoux@dupoux.com, 2003: Andras Mantia amantia@kde.org, 2004: Emiliano Gulmini emi_barbarossa@yahoo.it

## &kfilereplace;'i autorid ja hooldajad:

François Dupoux dupoux@dupoux.com

- Originaali autor

Andras Mantia amantia@kde.org

- Shelli autor, KParti looja, kaashooldaja

Emiliano Gulmini emi_barbarossa@yahoo.it

- Praegune hooldaja, koodi puhastaja ja ümberkirjutaja

Dokumentatsiooni autoriõigus 2004: Emiliano Gulmini emi_barbarossa@yahoo.it

Tõlge eesti keelde: Marek Laane bald@online.ee

&underFDL; &underGPL;

## Paigaldamine

### &kfilereplace;'i paigaldamine

&kfilereplace; kuulub paketi &kdewebdev; koosseisu, nii et selle paigaldamiseks tuleb paigaldada &kdewebdev;. Pane tähele, et kui kasutad oma distributsiooni pakkuja pakendatud &kde;d, on &kdewebdev; arvatavasti juba paigaldatud. Sellisel juhul saad &kfilereplace;'i kasutada kas veebiredaktorit &quantaplus; avades või seda otse välja kutsudes (kui sul pole just mõni vanem &kde; versioon). Vastasel juhul laadi &kdewebdev; alla internetist. Sellest räägib lähemalt &kdewebdev;'i kodulehekülg.

### Nõuded

Käsu [$mathexp:`mingi_matemaatiline_avaldis`$] kasutamiseks peab olema paigaldatud matemaatikautiliit &bc; (versioon 1.06 või uuem), mille autor on Philip A. Nelson (philnelson@acm.org).

## &kfilereplace;'i käsud

[$datetime:iso$] [$datetime:local$] [$user:uid$] [$user:gid$] [$user:loginname$] [$user:fullname$] [$user:homedir$] [$user:shell$] [$loadfile:`/minu-rada/minu-kataloog/minu-fail`$] [$empty:$] [$random:`TÄISARV`$] [$random:$] [$mathexp:`bc-avaldis`$]
- see käsk tagastab praeguse kuupäeva ja kellaaja &qt; ISO-vormingus. nagu eelmine, aga kohalikus vormingus. tagastab praeguse kasutaja UID. tagastab praeguse kasutaja GID. tagastab praeguse kasutaja kasutajanime. tagastab praeguse kasutaja täieliku nime. tagastab praeguse kasutaja kodukataloogi. tagastab praeguse kasutaja shelli. tagastab faili minu-fail sisu. tagastab tühja stringi. tagastab juhusliku arvustringi, kasutades algseemnena TÄISARVU. nagu eelmine, aga ilma algseemneta. tagastab &bc; v1.06 matemaatilise avaldise tulemuse.

&documentation.index;