KFileReplace"> tdewebdev"> bc"> ]> Het handboek van &kfilereplace; Emiliano Gulmini
emi_barbarossa@yahoo.it
&Sander.Koning;&Tom.Albers;AntoonTolboom
atolboo@casema.nl
2004 Emiliano Gulmini &FDLNotice; 2004-08-09 1.0.0 &kfilereplace; is een hulpmiddel om tekenreeksen te zoeken en te vervangen. KDE KFileReplace vervangen zoeken tekenreeks
Inleiding &kfilereplace; is een toepassing waarmee u een lijst van tekenreeksen in een bestandenboom kunt zoeken en vervangen. Dit kunnen letterlijke tekenreeksen zijn of Qt-achtige reguliere expressies. Verder zijn er een aantal opties waarmee u uw zoekopdracht kunt verfijnen. &kfilereplace; gebruiken &kfilereplace; als alleenstaande toepassing &kfilereplace; als alleenstaande toepassing De werkbalk De werkbalk van &kfilereplace; zou er als volgt uit moeten zien: De werkbalk van &kfilereplace; De werkbalk van &kfilereplace; Op de werkbalk ziet u de knoppen van de belangrijkste functies. Werkbalkpictogrammen Nieuwe sessie Deze knop toont een sessie-dialoogvenster, waarin u diverse basisopties kunt instellen; als &kfilereplace; als alleenstaande toepassing draait dient u dit als eerste te doen. Alleen zoeken Deze knop start een zoeklus. Vervangen Deze knop start een zoek&vervang-lus. Als een tekenreeks gevonden is, vervangt &kfilereplace; deze door een andere tekenreeks. Gesimuleerd vervangen Deze knop start een gesimuleerde zoek&vervang-lus. Er wordt niets daadwerkelijk vervangen. Stoppen Deze knop stopt een actie. Tekenreeksen toevoegen Met deze knop opent u het dialoogvenster Tekenreeksen toevoegen waarin u uw tekenreeksen kunt bewerken. Tekenreeksen verwijderen Met deze knop verwijdert u de geselecteerde tekenreeks (of de huidige, als er geen selectie is) uit de lijst. Tekenreeksen bewerken Met deze knop bewerkt u een geselecteerde tekenreeks. Lijst verwijderen Deze knop verwijdert alle tekenreeksen uit de lijst. Tekenreeksen omdraaien Deze knop verwisselt een zoek- en een vervang-tekenreeks met elkaar, zodat u de zoek/vervang-operatie kunt terugdraaien. Tekenreeksen-lijst laden Deze knop laadt een lijst van tekenreeksen opgeslagen in een xml-bestand met een extensie kfr. In submappen zoeken Met deze knop kunt u recursief in de submappen van uw basismap zoeken en vervangen. Reservekopiebestanden maken Deze knop schakelt het maken van reservekopie-bestanden in. Hoofdlettergevoelig zoeken Deze knop schakelt hoofdlettergevoelig zoeken in. Opdrachten Deze opdracht schakelt de mogelijkheid tot het gebruiken van opdrachten in. Opdrachten zijn speciale tekenreeksen. Zie . Reguliere expressies Deze knop schakelt Qt-achtige reguliere expressies in. De resultatenlijst De resultatenweergave van &kfilereplace; De resultatenweergave van &kfilereplace; De resultaten-weergave toont de namen van de bestanden waarin de gevonden (en vervangen) tekenreeksen voorkomen, hun pad, hun grootte, het aantal gevonden tekenreeksen en de gebruikers-id van de ebstanden. Deze weergave toont ook de precieze plaats van de gevonden tekenreeksen. U kunt ook een bestand openen door met de &RMB; op een lijstitem te klikken dat de regel en kolom bevat. De tekenreeksen-lijst Dit is de tekenreeksweergave: De tekenreeksweergave van &kfilereplace; De tekenreeksweergave van &kfilereplace; De tekenreeksweergave toont de lijst van woorden die u wilt zoeken/vervangen. Let op dat in zoekmodus de resultaten- en de tekenreeksweergave een andere indeling hebben. Het dialoogvenster <guilabel >Nieuwe sessie</guilabel > Het dialoogvenster Nieuwe sessie wordt gebruikt om de basisparameters in te stellen die &kfilereplace; nodig heeft om te werken. Het bestaat uit twee tabbladen, Algemeen en Geavanceerd. Het tabblad <guilabel >Algemeen</guilabel > Het tabblad "Algemeen" van &kfilereplace; Het tabblad "Algemeen" van &kfilereplace; Als u een nieuwe sessie wilt beginnen is de eerste stap om op de knop Nieuwe sessie te klikken. Dan dient u het basispad in te voeren en een serie van shell-achtige jokertekens om als filter te gebruiken. Dan kunt u wat nuttige opties instellen, zoals zoeken in alle submappen, een hoofdlettergevoelige zoekactie uitvoeren, opdrachten inschakelen en/of reguliere expressies Let op dat reguliere expressies en opdrachten de snelheidsprestatie verslechteren., een reservekopie maken van elk bestand vóór vervangen. Als u wilt beginnen met zoeken, kunt u een tekenreeks in het zoekveld invoeren en de knop Nu zoeken kiezen, anders laat u het zoekveld leeg en kiest u Later zoeken. Het tabblad <guilabel >Geavanceerd</guilabel > Het tabblad "Geavanceerd" van &kfilereplace; Het tabblad "Geavanceerd" van &kfilereplace; Op het tabblad Geavanceerd kunt u een aantal nuttige opties instellen om het zoeken te beperken tot een kleiner deel van uw bestandsboom. Als u &kfilereplace; alleen op bestanden wilt laten werken die een grootte hebben van 10 KB - 100 KB, kunt u de grootte-opties gebruiken. Er is ook een datumoptie die de zoekactie beperkt tot een bepaalde periode, en een laatste optie waarmee u alleen in bestanden kunt zoeken die (niet) van een bepaalde gebruiker zijn (dit kan nuttiger zijn voor systeembeheerders). Het dialoogvenster <guilabel >Opties</guilabel > Dit dialoogvenster bevat opties uit de werkbalk en extra opties die in sommige situaties handig kunnen zijn. U kunt het oproepen door InstellingenKFileReplace instellen... uit het hoofdmenu te kiezen. Algemene opties Deze opties zijn beschreven in de sectie Werkbalk. Het tabblad "Algemeen" van het venster "Opties" Het tabblad "Algemeen" van het venster "Opties" Geavanceerde opties Het tabblad "Geavanceerd" van het venster "Opties" Het tabblad "Geavanceerd" van het venster "Opties" Bestanden niet tonen als er geen tekenreeksen zijn gevonden of vervangen Stop bij het zoeken bij de eerste vindplaats Symbolische koppelingen volgen Verborgen bestanden en mappen negeren toont alleen de bestanden die met sommige tekenreeksen overeenkomen. Dit versnelt het zoeken. &kfilereplace; stopt als het een overeenkomende tekenreeks vindt, en gaat door met zoeken voor andere tekenreeksen of gaat door met het volgende bestand als u naar slechts één tekenreeks zoekt. als een bestand een koppeling is naar een ander, zoek dan in het echte bestand. als verborgen bestanden of mappen gevonden worden, negeer deze. Het dialoogvenster <guilabel >Tekenreeksen toevoegen</guilabel > Het dialoogvenster "Tekenreeksen toevoegen" van &kfilereplace; Het dialoogvenster "Tekenreeksen toevoegen" van &kfilereplace; Dit dialoogvenster wordt gebruikt om een lijst met tekenreeksen in te voegen en te bewerken. U hoeft slechts een lijst voor alleen zoeken of voor zoeken en vervangen in te voegen, en kunt dan met de twee mini-editors uw tekst invoeren. Met de pijlknoppen kunt u paren tekenreeksen toevoegen of verwijderen. Als u klaar bent, klikt u OK. Mogelijkheden van &kfilereplace; Dit hoofdstuk biedt informatie over een aantal nuttige mogelijkheden van &kfilereplace; Uw tekenreekslijst opslaan Als u een lijst met tekenreeksen wilt hergebruiken kunt u deze in een xml-bestand opslaan. Hiertoe kiest u uit de menubalk Zoeken/vervangenTekenreeksenTekenreeksen in bestand opslaan. Als u een lijst opslaat wordt een eenvoudig xml-bestand met de extensie kfr aangemaakt. Om een kfr-bestand te laden, kiest u uit de menubalk Zoeken/vervangenTekenreeksenTekenreeksen uit bestand laden. Het werkelijke bestand ziet er als volgt uit: <?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 > Als u een vorig formaat gebruikt, kunt u met de hand uw bestand bijwerken door het aan te passen aan het bovenstaande schema. U kunt ook het bestand dat in het oude formaat geschreven is inladen en het opnieuw met &kfilereplace; opslaan zoals hierboven uitgelegd. Hoe een eenvoudig rapport aan te maken U kunt een rapport aanmaken door Zoeken/vervangenResultaten Rapportbestand maken uit het hoofdmenu te kiezen. Een rapport is een map die een xml- en een css-bestand bevat. Rapporten kunnen nuttig zijn om een eenvoudig logboek van uw handelingen bij te houden. De rapportagemogelijkheid van &kfilereplace; De rapportagemogelijkheid van &kfilereplace; Hoe reguliere expressies te gebruiken Als u elke tekenreeks wilt zoeken die begint met x, ht of u en eindigt met ml, kunt u een reguliere expressie schrijven als: (x|ht|u)ml. Voeg deze expressie in in de zoekeditor, klik OK en schakel reguliere expressies in door de knop Reguliere expressie in te schakelen. Let op dat het gebruik van reguliere expressies u erg gecompliceerde zoekacties biedt, maar dat dit een prestatievermindering kost. Reguliere expressies kunnen erg lastig zijn, en vaak geldt als u een probleem wilt oplossen met een reguliere expressie, heeft u twee problemen. Hoe originele bestanden te beschermen Als u uw originele bestanden niet wilt verliezen, kunt u een kopie van ze maken voordat u de tekenreeksen vervangt. Nadat u uw tekenreeksen hebt ingevoerd, en voordat u het vervangingsproces start, schakelt u hiervoor de knop Reservekopie in. Als u de extensie van de reservekopiebestanden wilt aanpassen opent u het dialoogvenster Opties. Hoe een bestand te openen Als u een bestand wilt openen dat een aantal gezochte tekenreeksen bevat, selecteert u een regel in de resultatenweergave en klikt u deze aan met de &RMB;. Een contextmenu verschijnt waaruit u het bestand kunt openen. Als u &kfilereplace; ingebed in &quantaplus; gebruikt, kunt u het bestand daar direct in openen op de opgegeven regel en kolom. Opdrachten Stel dat u de tekst Alice in Wonderland wilt vervangen door het gehele bestand waarin de tekst van Carrolls boek staat. Dat wilt u waarschijnlijk niet met de hand doen, wat u wilt is een opdracht die dit voor u doet. Kies dus de knop Toevoegen, kies Zoek- en vervangmodus en voer de volgende tekenreeksen in: als zoekterm Alice in Wonderland en als vervangterm [$loadfile:/het-pad-naar-mijn-map/mijn-map/mijn-bestand$]in de vervangings mini-editor. Kies OK, en als u teruggekeerd bent in het hoofdvenster van &kfilereplace; schakelt u de knop Opdrachtactie in die de opdrachten inschakelt, en start u de vervangactie. Er zijn meer opdrachten beschikbaar, zie voor een overzicht. Dankbetuiging en licentie &kfilereplace;. Programma copyright 1999 door François Dupoux dupoux@dupoux.com 2003 Andras Mantia amantia@kde.org 2004 Emiliano Gulminiemi_barbarossa@yahoo.it Auteurs en onderhouders van &kfilereplace;: François Dupoux dupoux@dupoux.com Originele auteur Andras Mantia amantia@kde.org Shell-auteur, maker van KPart, mede-onderhouder Emiliano Gulmini emi_barbarossa@yahoo.it Onderhoud, opschonen & herschrijven van de code Documentatie copyright © 2004 Emiliano Gulmini emi_barbarossa@yahoo.it &meld.fouten;&vertaling.sander;&nagelezen.tom;Nagelezen door Antoon Tolboom &underFDL; &underGPL; Installatie &kfilereplace; installeren &kfilereplace; is momenteel een deel van het pakket &tdewebdev;, dus om het te installeren dient u een kopie van &tdewebdev; te verkrijgen. Let op dat als u een &kde;-installatie gebruikt die bij uw besturingssysteem werd meegeleverd, u &tdewebdev; waarschijnlijk al op uw systeem hebt. In dat geval kunt u &kfilereplace; gebruiken door de webeditor &quantaplus; te openen, of door het direct te starten (tenzij u een oude &kde;-versie hebt). Als dat niet het geval is kunt u het &tdewebdev;-pakket downloaden van internet. Bekijk de site van &tdewebdev; voor meer informatie. Vereisten Om de opdracht [$mathexp:wiskundige_uitdrukking$] te kunnen gebruiken heeft u het wiskundige gereedschap &bc; nodig (versie 1.06 of hoger) van Philip A. Nelson (philnelson@acm.org). Opdrachten van &kfilereplace; [$datetime:iso$] [$datetime:local$] [$user:uid$] [$user:gid$] [$user:loginname$] [$user:fullname$] [$user:homedir$] [$user:shell$] [$loadfile:/mijn-pad/mijn-map/mijn-bestand$] [$empty:$] [$random:GEHEEL_GETAL$] [$random:$] [$mathexp:bc-uitdrukking$] dit commando retourneert de huidige datum en tijd in Qt ISO-formaat. zoals boven maar in lokaal formaat. retourneer het UID van de huidige gebruiker. retourneer het GID van de huidige gebruiker. retourneer de aanmeldnaam van de huidige gebruiker. retourneer de volledige naam van de huidige gebruiker. retourneer de persoonlijke map van de huidige gebruiker. retourneer de shell van de huidige gebruiker. retourneer de inhoud van het bestand mijnbestand. retourneer de lege tekenreeks. retourneer een willekeurig getal met GEHEEL_GETAL als het eerste zaadgetal. als boven, maar zonder eerste zaadgetal. retourneer het resultaat van een wiskundige uitdrukking volgens &bc; v1.06 &documentation.index;