Het handboek van KFileReplace. Emiliano Gulmini Vertaler/Nalezer: Alexander S. Koning Vertaler/Nalezer: Tom Albers : Antoon Tolboom

Transcriptie

1 Emiliano Gulmini Vertaler/Nalezer: Alexander S. Koning Vertaler/Nalezer: Tom Albers : Antoon Tolboom

2 2

3 Inhoudsopgave 1 Inleiding 5 2 KFileReplace gebruiken De werkbalk De resultatenlijst De tekenreeksen-lijst De dialoog Zoeken & vervangen in bestanden Het tabblad Algemeen Het tabblad Geavanceerd De dialoog Opties Algemene opties Geavanceerde opties De dialoog Zoeken/vervangen van tekenreeksen invoegen Mogelijkheden van KFileReplace Uw tekenreekslijst opslaan Hoe een eenvoudig rapport aan te maken Hoe reguliere expressies te gebruiken Hoe originele bestanden te beschermen Hoe een bestand te openen Commando s Dankbetuiging en licentie 16 A Installatie en compilatie 17 A.1 Vereisten B Opdrachten van KFileReplace 18

4 Samenvatting KFileReplace is een hulpmiddel om tekenreeksen te zoeken en te vervangen.

5 Hoofdstuk 1 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. 5

6 Hoofdstuk 2 KFileReplace gebruiken 2.1 De werkbalk De werkbalk van KFileReplace zou er als volgt uit moeten zien: Op de werkbalk ziet u de knoppen van de belangrijkste functies. WERKBALKPICTOGRAMMEN Zoeken/vervangen-sessie aanpassen 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. 6

7 Zoeken Deze knop start een zoeklus. Simuleren Deze knop start een gesimuleerde zoek&vervang-lus. Er wordt niets daadwerkelijk vervangen. Vervangen Deze knop start een zoek&vervang-lus. Als een tekenreeks gevonden is, vervangt KFileReplace deze door een andere tekenreeks. Stoppen Deze knop stopt een actie. Tekenreeks toevoegen Met deze knop opent u het dialoogvenster Tekenreeksen toevoegen waarin u uw tekenreeksen kunt bewerken. Tekenreeks verwijderen Met deze knop verwijdert u de geselecteerde tekenreeks (of de huidige, als er geen selectie is) uit de lijst. Geselecteerde tekenreeks bewerken Met deze knop bewerkt u een geselecteerde tekenreeks. Lijst met tekenreeksen leegmaken Deze knop verwijdert alle tekenreeksen uit de lijst. Huidige tekenreeks omdraaien Deze knop verwisselt een zoek- en een vervang-tekenreeks met elkaar, zodat u de zoek/vervang-operatie kunt terugdraaien. Tekenreeksenlijst uit bestand laden Deze knop laadt een lijst van tekenreeksen opgeslagen in een xml-bestand met een extensie kfr. Inclusief submappen Met deze knop kunt u recursief in de submappen van uw basismap zoeken en vervangen. Reserve kopieën maken Deze knop schakelt het maken van reservekopie-bestanden in. 7

8 Hoofdlettergevoelig Deze knop schakelt hoofdlettergevoelig zoeken in. Commando s in vervangende tekenreeks inschakelen Deze opdracht schakelt de mogelijkheid tot het gebruiken van opdrachten in. Opdrachten zijn speciale tekenreeksen. Zie Section 3.6. Reguliere expressies activeren Deze knop schakelt Qt -achtige reguliere expressies in. 2.2 De resultatenlijst De resultatenweergave 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 bestanden. Deze weergave toont ook de precieze plaats van de gevonden tekenreeksen. U kunt ook een bestand openen door met de rechtermuisknop op een lijst-item te klikken dat de regel en kolom bevat. 2.3 De tekenreeksen-lijst Dit is de tekenreeks-weergave: De tekenreeks-weergave toont de lijst van woorden die u wilt zoeken/vervangen. Let op dat in zoekmodus de resultaten- en de tekenreeks-weergave een andere indeling hebben. 2.4 De dialoog Zoeken & vervangen in bestanden De dialoog Zoeken & vervangen in bestanden wordt gebruikt om de basisparameters in te stellen die KFileReplace nodig heeft om te werken. Het bestaat uit twee tabbladen, Algemeen en Geavanceerd. 8

9 2.4.1 Het tabblad Algemeen Als u een nieuwe sessie wilt beginnen is de eerste stap om op de knop Zoeken/vervangen aanpassen 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 1, 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. 1 Let op dat reguliere expressies en opdrachten de snelheidsprestatie verslechteren. 9

10 2.4.2 Het tabblad Geavanceerd 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 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). 2.5 De dialoog Opties Dit dialoogvenster bevat opties uit de werkbalk en extra opties die in sommige situaties handig kunnen zijn. U kunt het oproepen door Instellingen KFileReplace instellen... uit het hoofdmenu te kiezen Algemene opties Deze opties zijn beschreven in de sectie Werkbalk. 10

11 2.5.2 Geavanceerde opties Bestanden niet tonen als er geen tekenreeksen zijn gevonden of vervangen: toont alleen de bestanden die met sommige tekenreeksen overeenkomen. Dit versnelt het zoeken., Stop bij het zoeken bij de eerste vindplaats: 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., Symbolische koppelingen volgen: als een bestand een koppeling is naar een ander, zoek dan in het echte bestand., Verborgen bestanden en mappen negeren: als verborgen bestanden of mappen gevonden worden, negeer deze. 11

12 2.6 De dialoog Zoeken/vervangen van tekenreeksen invoegen 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. 12

13 Hoofdstuk 3 Mogelijkheden van KFileReplace Dit hoofdstuk biedt informatie over een aantal nuttige mogelijkheden van KFileReplace 3.1 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/vervangen Tekenreeksen Tekenreeksen in bestand opslaan. Als u een lijst opslaat wordt een eenvoudig xml-bestand met de extensie k fr aangemaakt. Om een kfr-bestand te laden, kiest u uit de menubalk Zoeken/vervangen Tekenreeksen Tekenreeksen 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 > 13

14 </ 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. 3.2 Hoe een eenvoudig rapport aan te maken U kunt een rapport aanmaken door Zoeken/vervangen Resultaten 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. 3.3 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. 3.4 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. 14

15 3.5 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 rechtermuisknop. Er verschijnt een contextmenu waaruit u het bestand kunt openen. 3.6 Commando s 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 vervangtekenreeks [$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 aanhangsel B voor een overzicht. 15

16 Hoofdstuk 4 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 Oorspronkelijke 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 (c) 2004 Emiliano Gulmini emi_barbarossa@yahoo.it Op- of aanmerkingen over de vertalingen van de toepassing en haar documentatie kunt u melden op Dit document is vertaald in het Nederlands door Alexander S. Koning sanderkoning@kde.nl. De vertaling werd nagelezen door Tom Albers tomalbers@kde.nl. Nagelezen door Antoon Tolboom Deze documentatie valt onder de bepalingen van de GNU vrije-documentatie-licentie. Deze toepassing valt onder de bepalingen van de GNU General Public License. 16

17 Bijlage A Installatie en compilatie KFileReplace is een onderdeel van het KDE-project KFileReplace is een onderdeel van de module kdewebdev. Deze module kunt u vinden op de FTP-site van het KDE-project: ftp://ftp.kde.org/pub/kde/. Er zijn een aantal stappen nodig om KFileReplace op uw systeem te compileren en te installeren. Voer de volgende commando s uit in de hoofdmap van de broncode van KFileReplace: %./ configure % make % make install Aangezien KFileReplace autoconf en automake gebruikt, zouden er bij de compilatie geen problemen mogen voorkomen. Indien u toch problemen tegenkomt, meldt u ze dan in de betreffende KD inglists. A.1 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). 17

18 Bijlage B Opdrachten van KFileReplace [$datetime:iso$]: dit commando retourneert de huidige datum en tijd in Qt ISO-formaat., [$datetime:local$]: zoals boven maar in lokaal formaat., [$user:uid$]: retourneer het UID van de huidige gebruiker., [$user:gid$]: retourneer het GID van de huidige gebruiker., [$user:loginname$]: retourneer de aanmeldnaam van de huidige gebruiker., [$user:fullname$]: retourneer de volledige naam van de huidige gebruiker., [$user:homedir$]: retourneer de persoonlijke map van de huidige gebruiker., [$user:shell$]: retourneer de shell van de huidige gebruiker., [$loadfile:/mijn-pad/mijnmap/mijn-bestand$]: retourneer de inhoud van het bestand mijnbestand., [$empty:$]: retourneer de lege tekenreeks., [$random:geheel_getal$]: retourneer een willekeurig getal met GEHEEL_GETAL als het eerste zaadgetal., [$random:$]: als boven, maar zonder eerste zaadgetal., [$mathexp:bc-uit drukking$]: retourneer het resultaat van een wiskundige uitdrukking volgens bc v