# &kfilereplace;'i käsiraamat

Emiliano
Gulmini

    emi_barbarossa@yahoo.it

Marek
Laane

    bald@smail.ee

Tõlge eesti keelde
2004
Emiliano Gulmini
&FDLNotice;
2004-08-09
1.0.0

&kfilereplace; on stringide otsimise ja asendamise vahend.

KDE
KFileReplace
asendamine
otsimine
string

## Sissejuhatus

&kfilereplace; is an application used to search and replace a list of strings in a file tree. The strings may be literal or &qt;-like regular expressions. There are also other options to tune your search.

## &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

New session

  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.

Search only

  See nupp käivitab otsimise.

Asenda

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

Simulated Replace

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

Peata

  See nupp peatab operatsiooni.

Add Strings

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

Delete Strings

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

Edit Strings

  See nupp võimaldab redigeerida valitud stringi.

Delete List

  See nupp kustutab nimekirjast kõik stringid.

Invert Strings

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

Load String List

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

Search in Subfolders

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

Make Backup Files

  See nupp võimaldab failide varukoopia loomist.

Case-sensitive Search

  See nupp võimaldab tõstutundlikku otsingut.

Commands

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

Regular expressions

  This button enables &qt;-like regular expressions.

### Tulemuste nimekiri

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

The Results view shows the name of the files that contain the strings you have to retrieve (and replace), their path, their size, the number of strings found and the user id of the files. This view also provides the exact position of each match. You can also open a file by clicking with the &RMB; on an list entry that contains line and column position.

### Stringide nimekiri

This is the Strings view: &kfilereplace;'i stringide vaade &kfilereplace;'i stringide vaade

The Strings view visualizes the list of strings you want search/replace. Please note that in search mode the Results view and the Strings view have a different layout.

### The New Session Dialog

The New Session dialog is used to setup the basic parameters needed by &kfilereplace; to work. It consists of two tabs, General and Advanced.

#### The General Tab

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

When you want to begin a new session the first step is to click on the New Session button. Then you must enter the base path and a sequence of shell-like wildcards to use as filter.

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.

#### The Advanced Tab

&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.

### The Options Dialog

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.

### The Add Strings Dialog

&kfilereplace;'s Add Strings dialog
&kfilereplace;'s Add Strings dialog

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

If you want to open a file that matches some of your strings, you have to select a line in the result view and click on it with the &RMB;. A context menu will appear from which you can open the file. If you use &kfilereplace; embedded in &quantaplus;, you can open the file directly in it at the specified line and column.

### Commands

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 .

## 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@smail.ee

&underFDL; &underGPL;

## Installation

### How to install &kfilereplace;

&kfilereplace; is currently part of &kdewebdev; package, so, in order to install it, you have to get a copy of &kdewebdev;. Note that if you are using a &kde; installation provided by your OS vendor, probably you already have &kdewebdev; installed; in this case, you can use &kfilereplace; either by opening &quantaplus; Web editor, or by calling it directly (unless you have an old &kde; version). Else you can download the &kdewebdev; package from the Internet: please refer to &kdewebdev; home site for more information.

### 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$] this command return the current date and time in &qt; ISO format. 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;