KFileReplace'i käsiraamat
KFileReplace'i käsiraamat
Järgmine

KFileReplace'i käsiraamat

Emiliano Gulmini

Tõlge eesti keelde: Marek Laane
Versioon 1.0.0 (2004-08-09)

Käesolevat dokumenti võib kopeerida, edasi levitada ja/või muuta vastavalt GNU Vaba Dokumentatsiooni Litsentsi tingimustele, nagu need on avaldanud Vaba Tarkvara Fond; kas Litsentsi versioon 1.1 või ükskõik milline hilisem versioon; kaasa arvatud mittemuudetavad sektsioonid (puudub), esikaane tekstid (puudub), ja tagakaane tekstid (puudub). Litsentsi koopiaga võimaldab tutvuda sektsioon "GNU Vaba Dokumentatsiooni Litsents".

KFileReplace on stringide otsimise ja asendamise vahend.


Peatükk 1. Sissejuhatus
Sissejuhatus
Eelmine
Järgmine

Peatükk 1. 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.

Eelmine
Järgmine
Esileht


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Peatükk 2. KFileReplace'i kasutamine
KFileReplace'i kasutamine
Eelmine
Järgmine

Peatükk 2. KFileReplace'i kasutamine


KFileReplace omaette rakendusena

Tööriistariba

KFileReplace'i tööriistariba näeb välja selline:


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. “Käsud”.

Regulaaravaldised

See nupp võimaldab kasutada Qt stiilis regulaaravaldisi.

Tulemuste nimekiri
Tulemuste nimekiri

Tulemuste nimekiri


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 hiire parem nuppga klõpsates.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Stringide nimekiri
Stringide nimekiri

Stringide nimekiri

Selline näeb välja 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.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Uue seansi dialoog
Uue seansi dialoog

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

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[1], 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

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.



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



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Seadistustedialoog
Seadistustedialoog

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

Muud seadistused


Seadistustedialoogi kaart Muud
Faili ei näidata, kui stringe ei leita ega asendata: näitab ainult faile, mis sobivad otsitava stringiga. See kiirendab otsingut.
Otsimisel peatutakse esimese leitud stringi juures: 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.
Nimeviitade järgimine: kui fail viitab mõnele muule failile, otsitakse tegelikus failis.
Peidetud failide ja kataloogide ignoreerimine: peidetud failide või kataloogide esinemisel jäetakse need läbi uurimata.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Stringi lisamise dialoog
Stringi lisamise dialoog

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.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Eelmine
Järgmine
Esileht


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Peatükk 3. KFileReplace'i omadused
KFileReplace'i omadused
Eelmine
Järgmine

Peatükk 3. 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
Kuidas luua lihtne raport

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



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Kuidas kasutada regulaaravaldisi
Kuidas kasutada regulaaravaldisi

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



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Kuidas kaitsta originaalfaile
Kuidas kaitsta originaalfaile

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.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Kuidas faili avada
Kuidas faili avada

Kuidas faili avada

Kui soovid avada faili, milles leidub mõni otsitav string, tuleb tulemustevaates valida vastav rida ja klõpsata sellel hiire parem nuppga. Ilmuvast kontekstimenüüst saabki valida faili avamise käsu. Kui kasutad KFileReplace'i Quanta Plus'i põimituna, saad faili avada otse selles vajalikul real ja veerus.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Käsud
Käsud

Käsud

Oletame, et soovid asendada väljendi “Alice Imedemaalterve 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 Lisa B, KFileReplace'i käsud.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Eelmine
Järgmine
Esileht


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Peatükk 4. Autorid ja litsents
Autorid ja litsents
Eelmine
Järgmine

Peatükk 4. Autorid ja litsents

KFileReplace. Rakenduse autoriõigus 1999: François Dupoux , 2003: Andras Mantia , 2004: Emiliano Gulmini

KFileReplace'i autorid ja hooldajad:

François Dupoux

Originaali autor

Andras Mantia

Shelli autor, KParti looja, kaashooldaja

Emiliano Gulmini

Praegune hooldaja, koodi puhastaja ja ümberkirjutaja

Dokumentatsiooni autoriõigus (c) 2004: Emiliano Gulmini

Tõlge eesti keelde: Marek Laane

Käesolev dokumentatsioon on litsenseeritud vastavalt GNU Vaba Dokumentatsiooni Litsentsi tingimustele.

Käesolev programm on litsenseeritud vastavalt GNU Üldise Avaliku Litsentsi tingimustele.

Eelmine
Järgmine
Esileht


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Lisa A. Paigaldamine
Paigaldamine
Eelmine
Järgmine

Lisa A. 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 KDEd, on kdewebdev arvatavasti juba paigaldatud. Sellisel juhul saad KFileReplace'i kasutada kas veebiredaktorit Quanta Plus 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
Nõuded

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 ().



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Eelmine
Järgmine
Esileht


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Lisa B. KFileReplace'i käsud
KFileReplace'i käsud
Eelmine

Lisa B. KFileReplace'i käsud

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

Eelmine
Esileht


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Järgmine
 


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team