KFileReplace"> kdewebdev"> bc"> ]> &kfilereplace;'i käsiraamat Emiliano Gulmini
emi_barbarossa@yahoo.it
Marek Laane
bald@starman.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; 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. . 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. <guilabel >Uue seansi</guilabel > dialoog Uue seansi dialoogis saab määrata peamised parameetrid, mille alusel &kfilereplace; töötab. Dialoog koosneb kahest kaardist: Üldine ja Muud. Kaart <guilabel >Üldine</guilabel > &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 kasutaminePalun 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 <guilabel >Muud</guilabel > &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. <guilabel >Seadistuste</guilabel >dialoog 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 SeadistusedKFileReplace 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. <guilabel >Stringi lisamise</guilabel > 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/AsendamineStringidSalvesta stringide nimekiri failina. Nimekirja salvestamisel luuakse lihtne xml-fail laiendiga kfr. kfr-faili avamiseks vali menüükäsk Otsimine/AsendamineStringidLaadi 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/AsendamineTulemusedLoo 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 . 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@starman.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;