# Werken met plugins

Kate gebruikt twee verschillende vormen van plugins, namelijk plugins voor de toepassing &kate; en plugins voor de bewerkercomponent van &kate;. De laatsten zijn beschikbaar aan elke toepassing met de bewerkercomponent, zoals KDevelop, Quanta, Kile, Kwrite en vele anderen, terwijl plugins voor toepassing specifiek zijn voor de toepassing &kate;.

U kunt beide typen plugins inschakelen in de instellingendialoog, die ook toegang biedt tot extra instellingenopties voor plugins die dat vereisen.

Er zijn veel plugins beschikbaar voor allerlei doelen en u kunt op het web zoeken naar meer. Er worden een paar plugins meegeleverd met de bewerkercomponent, voor het automatisch invoegen van accolades, bestanden invoegen, gegevenshulpmiddelen en exporteren van tekst als &HTML;.

## Plugins voor editorcomponenten

Op het tabblad Pluginsop de pagina Extensies ziet u een lijst met alle beschikbare plugins en u kunt een vinkje plaatsen bij de plugins die u wilt gebruiken. Klik op de knop Informatie om het dialoogvenster Over voor deze plugin te openen.

Is een configureerbare plugin aangevinkt, dan wordt de de knop Configureren ingeschakeld zodat u de geaccentueerde plugin kunt configureren.

AutomatischeAccolades

- De plugin AutomatischeAccolades vervangt de interne functie Automatische haakjes van &kate;. Wanneer een regel eindigt met een openingsaccolade { en er op &Enter; wordt gedrukt, wordt er automatisch een sluitaccolade } ingevoegd aan het begin van de volgende regel.

Gegevenshulpmiddelen

- Schakelt gegevenshulpmiddelen in zoals thesaurus en spellingcontrole (indien geïnstalleerd). Gegevenshulpmiddelen zijn alleen beschikbaar wanneer er tekst is geselecteerd, of wanneer er met rechts op een woord is geklikt. Als er geen gegevenshulpmiddelen worden aangeboden terwijl er wel tekst is geselecteerd dient u deze te installeren. Sommige gegevenshulpmiddelen maken deel uit van het &koffice;pakket. Als deze plugin is ingeschakeld en de gegevenshulpmiddelen zijn geïnstalleerd, worden er items toegevoegd aan het einde van het contextmenu.

Exportprogramma

- Met deze opdracht kunt u het huidige document met alle geaccentueerde informatie exporteren naar een HTML-document via Bestand Als HTML exporteren. U kunt ook via Bewerken als HTML kopiëren de huidige geselecteerde tekst als HTML kopiëren naar het klembord.

PictogramInvoegen

- De plugin voor pictograminvoegen is alleen nuttig voor &kde;-ontwikkelaars: Het voegt een item Insert KIcon-Code toe in het contextmenu van de editor. Indien geactiveerd, opent de pictogramkiezer van &kde; (met het tonen van pictogrammen van toepassingen, actiepictogrammen &etc;..). Als u er op klikt, zal de bestandsnaam zonder extensie als tekst worde ingevoerd. Alleen nuttig voor het instellen van pictogrammen via &kde;'s framework door de KIcon()-class.

Insane (niet ZEN) HTML-codering (lichte editie)

- Een plugin, die zen-codering doet zoals keuze-voltooiing >. Voor meer informatie zie Zen-codering.

Bestand invoegen

- Met deze plugin kunt u elk leesbaar bestand invoegen op de cursorpositie. Indien ingeschakeld, krijgt het menu Hulpmiddelen een extra item: Bestand invoegen.

## &kate;-programma-plugins

&kate;-plugins zijn additionele functies voor &kate; Ze kunnen extra menu's en sneltoetsen toevoegen en de mogelijkheden van &kate; uitbreiden. U kunt er vanuit &kate; net zo veel installeren als u wilt. Open het configuratiedialoogvenster van &kate; door het menu Instellingen &kate; instellen... te kiezen. Kies dan Toepassing Plugins om de gewenste plugins te vinden.

De beschikbare plugins voor de toepassing zijn:

- &gdb; - levert een eenvoudige &gdb;-frontend

- Backtrace browser - Backtrace navigatieweergave

- Snel van document wisselen - Snel overschakelen naar ander reeds geopend document

- SQL-plugin - Voer zoekopdracht op SQL-database uit

- Plug-in voor Zoeken en vervangen - zoek en vervang patronen in alle open bestanden of alle bestanden in een map

- Tabbladbalk - Voegt een standaard tabbladbalk toe aan het hoofdvenster van &kate;

- Tekstfilter - Gemakkelijke tekstfiltering

- Symboolviewer - Referentiesymbolen uit de broncode halen en tonen

- Bestandssysteembrowser - Blader door het bestandssysteem

- Terminalweergave - Weergave met ingebedde terminal

- CTags-plugin - Definities/declaraties opzoeken met CTags

- Sjablonen van bestanden - Maak aan de hand van sjablonen nieuwe bestanden aan

- Header van een broncodebestand openen - Open het bijhorende .h/[.cpp|.c]-bestand

- Bouwplug-in - Compileren of Make uitvoeren en foutboodschappen ontleden

- E-mail bestanden - Bestanden via e-mail verzenden

- Tabbladbalk met meerdere regels - Voegt een tabbladbalk met meerdere regels toe aan het hoofdvenster van &kate;

- Fragmenten in Kate - Plugin voor fragmenten met ondersteuning voor code aanvullen

- Plug-in voor tekst-naar-spraak van Jovie -Voegt een menu-optie toe voor het uitspreken van de tekst

- Validatie van &XML;- Valideert -bestanden met behulp van xmllint

- &XML;-aanvulling - Somt -elementen, -attributen, -attribuutwaarden en -entiteiten op die door de DTD zijn toegestaan

- Tabbladbalk - Voegt een tabbladbalk toe aan hoofdvenster van Kate

## Bestandssjablonen

De plugin Sjablonen van bestanden biedt u de mogelijkheid om bestanden aan te maken gebaseerd op andere bestanden

Wanneer u Kate voor de eerste keer installeert, dan moet u de plugin inschakelen:

1. Klik Instellingen Kate instellen

2. In de boomstructuur links op het scherm, klik op Plugins.

3. In het paneel Plugin-beheerder rechts, selecteert u Sjablonen van bestanden en klik dan op OK.

U kunt nu elk bestand als een sjabloon gebruiken (dit maakt een kopie van het bestand aan met een lege &URL;.) Speciale sjabloonbestanden kunnen macro's bevatten om informatie zoals uw naam, e-mailadres, de huidige datum en positioneert de cursor op een geschikte positie in het nieuwe bestand.

U kunt op eenvoudige wijze een nieuwe sjabloon aanmaken aan de hand van een geopend document.

De sjablonen uit de sjabloonmappen zullen worden getoond via de menuoptie Bestand Nieuw van sjabloon.

De sjabloonmap is onderdeel van het bestandssysteem van &kde; en bestaat minstens uit

- `$`KDEDIR`/share/applications/kate/plugins/katefiletemplates/templates`

- `$`KDEHOME`/share/applications/kate/plugins/katefiletemplates/templates.`

Als uw omgevingsvariabele `KDEDIRS` aanvullende mappen bevat, dan worden deze ook doorzocht voor een vergelijkbare submap. Als er sjablonen met dezelfde naam in verschillende mappen gevonden worden, wordt de sjabloon uit uw persoonlijke map (KDEHOME) gebruikt.

### Menustructuur

Bestand Nieuw uit sjablonen Elk bestand...

- Opent het dialoogvenster "Bestandsselectie" van waaruit u een willekeurig tekstbestand kunt kiezen om als sjabloon te gebruiken. Als het gekozen bestand de extensie `katetemplate` heeft, wordt het doorzocht op sjablooninformatie en macro's.

Bestand Nieuw van sjabloon

- De resterende submenu's bevatten koppelingen naar sjablonen. Klik op een menuoptie om een bestand aan te maken zoals is omschreven door de tekst van de menuoptie.

Instellingen Sjablonen beheren...

- Dit opent een dialoogvenster met een lijst van alle sjablonen die in de sjabloonmappen zijn gevonden. U kunt in dit dialoogvenster sjablonen toevoegen, verwijderen of bewerken.

### Een &kate;-sjabloon gebruiken

Als u een bestand aanmaakt aan de hand van een sjabloon dat macro's bevat, dan verschijnen enkele van deze macro's als bewerkbare variabelen in de tekst. Deze variabelen zijn dan onderstreept.

De eerste variabele zal worden geselecteerd. U hoeft dus alleen maar te typen om het te bewerken. Als de documenttekst meerdere exemplaren van dezelfde variabele bevat, dan veranderen deze mee met uw wijziging. Om naar de volgende bewerkbare variabele te gaan, druk op de -toets. Als de laatste variabele is bewerkt wordt de lijst uitgeschakeld en werkt de -toets weer als normaal.

### Uw eigen sjablonen aanmaken

Om een nieuwe sjabloon aan te maken, gebruikt u menuoptie Instellingen Sjablonen beheren om de sjabloonbeheerder te openen. Klik vervolgens op Nieuw... om de sjabloonassistent te starten. U wordt dan gevraagd naar een optioneel bestand om de sjabloon op te baseren. Daarna geeft u de informatie voor de sjabloon op en de sjabloon wordt automatisch voor u aangemaakt.

U kunt ook handmatig een sjabloon aanmaken door sjablooninformatie bovenin een bestand te plaatsen en vervolgens tekst, macro's en de cursorpositiemarkering toe te voegen, en het bestand op te slaan met de extensie `katetemplate`.

Alle sjablonen die u in de sjabloonmap opslaat worden automatisch toegevoegd aan het sjabloonmenu van Kate.

### Sjablonen bewerken

Om een sjabloon te bewerken, kiest u menuoptie Instellingen Sjablonen beheren.... Selecteer de sjabloon waaraan u wilt werken en klik op Bewerken.... Het sjabloonbestand wordt nu geopend. Sluit het dialoogvenster, bewerk het sjabloonbestand naar believen, sla het op en sluit het vervolgens af. De wijzigingen in de sjabloon zijn onmiddellijk van kracht. U kunt de sjabloon activeren om uw wijzigingen te testen.

### Het sjabloonformaat van &kate;

Als u bestanden gebruikt met de extensie `katetemplate`, dan worden deze doorzocht op sjablooninformatie, macro's en een cursorpositie.

#### Sjablooninformatie

Bij het lezen van het bestand pakt de ontleder de regels die beginnen met de term `katetemplate:` en doorzoekt ze op sjablooninformatie in de vorm VARIABELENAAM=WAARDE. De eerste regel die niet begint met `katetemplate:` wordt gebruikt als begin van de sjablooninhoud. WAARDE mag elk teken bevatten, behalve het = teken. Geschikte variabelenamen zijn:

`Sjabloon`

- Dit is de naam van het sjabloon, deze wordt getoond in het menu Bestand Nieuw van sjabloon.

`Group`

- De groep plaatst de sjabloon in een submenu van het menu Bestand Nieuw van sjabloon.

`Name`

- Dit is de naam die aan het document wordt gegeven, en zal worden getoond in de bestandenlijst en titelbalk. Als de naam `%N` bevat, dan zal deze plaatshouder worden vervangen door een getal. Dit getal wordt hoger als er meer documenten met dezelfde naam zijn.

`Accentuering`

- Deze plugin zal proberen de accentuering van het nieuwe document in te stellen op de waarde in deze variabele. De waarde dient hetzelfde te zijn als de accentuering in menu Hulpmiddelen Accentueringsmodus.

`Description`

- Een korte informatieve beschrijving van de sjabloon. Dit wordt momenteel gebruikt om een "Wat is dit"-tekst in te stellen voor de menuoptie. In de toekomst is het mogelijk dat het voor meer doeleinden zal worden gebruikt.

Auteur

- Een tekenreeks die de auteur aangeeft, bijvoorbeeld in de vorm `Naam <e-mailadres>`. Dit wordt momenteel gebruikt in de "Wat is dit"-tekst van de menuoptie, maar wordt in de toekomst mogelijk voor meer doeleinden gebruikt.

#### Sjabloonmacro's

Tijdens het ontleden van de inhoud worden macro's in de vorm `%{NAME}` of `%{NAME}` omgezet. Als u het voorvoegsel `$` gebruikt, wordt de omgezette macro behandeld als een bewerkbare variabele. Als u `%` gebruikt, dan niet, tenzij het omzetten is mislukt.

De volgende macro's zullen worden omgezet:

`time`

- Wordt omgezet in de huidige tijd volgens uw lokale opmaak.

`datum`

- Wordt omgezet in de huidige datum volgens de korte opmaak.

`datetime`

- Wordt omgezet in de huidige datum en tijd, opgemaakt volgens uw lokale instelling.

`year`

- Het huidige jaar als viercijferig getal.

`month`

- De volledige naam van de huidige maand, in de huidige taalinstelling.

`dag`

- Wordt omgezet in de huidige dag.

`hostname`

- Wordt omgezet in de hostnaam van uw computer.

`index`

- Wordt omgezet in 'i'.

`fullname`

- Wordt omgezet in uw volledige naam, zoals is opgegeven in het eigenaaradres in uw standaard &kde;-adresboek.

`firstname`

- Wordt omgezet in uw voornaam, zoals is opgegeven in het eigenaaradres in uw standaard &kde;-adresboek.

`lastname`

- Wordt omgezet in uw achternaam, zoals is opgegeven in het eigenaaradres in uw standaard &kde;-adresboek.

e-mail

- Wordt omgezet in uw e-mailadres, zoals is opgegeven in het eigenaaradres in uw standaard &kde;-adresboek.

Elke macro die niet in bovenstaande lijst staat wordt behandeld als bewerkbare variabele, ongeacht het voorvoegsel. Als dezelfde variabele meerdere malen in de sjabloon voorkomt, kunnen ze in één keer worden bewerkt nadat een document is aangemaakt aan de hand van het sjabloon.

#### Cursorpositie instellen

De speciale macro `${cursor}` zal worden vervangen door een verticale balk en wordt toegevoegd aan het einde van de lijst met bewerkbare variabelen. Dit is onafhankelijk van diens positie in de tekst.

### Dankbetuigingen en licentie

&kate; Plugin Sjabloonbestanden copyright 2004 &Anders.Lund; &Anders.Lund.mail;.

Documentatie copyright 2004 &Anders.Lund;

## &XML;-validatie

Deze plugin controleert of &XML;-bestanden op de juiste manier zijn opgemaakt en valide zijn.

Deze plugin controleert het huidige bestand. Een lijst met waarschuwingen en foutmeldingen zal aan de onderzijde van &kate;'s venster verschijnen. Klik op een foutmelding om naar de bijhorende plaats in het bestand te gaan. Als het bestand een DOCTYPE heeft, dan zal deze worden gebruikt om de validatie van het bestand te controleren. De DTD wordt op een relatieve positie van het bestand verwacht; dus als de DTD verwijst naar DTD/xhtml1-transitional.dtd en het bestand is `/home/rinse/test.xml`, dan wordt de DTD verwacht op `/home/rinse/DTD/xhtml1-transitional.dtd`. DTD's op afstand die zijn gespecificeerd via HTTP worden ook ondersteund.

Als het bestand geen doctype heeft, zal het worden gecontroleerd op de opmaak.

Als u meer wilt weten over &XML;, ga dan naar de officiële W3C &XML;-webpagina's.

Intern roept deze plugin het commando `xmllint` aan. Dit hulpprogramma is onderdeel van libxml2. Als dit niet correct op uw systeem is geïnstalleerd, zal deze plugin niet werken.

De plugin schrijft een tijdelijk bestand naar dezelfde map als waarin het te controleren bestand zich bevindt. U dient dus schrijftoegang te hebben tot deze map.

Om deze plugin te laden opent u de instellingendialoog van &kate; onder Instellingen &kate; instellen.... Selecteer daarna XML-validatie die zal verschijnen in de sectie Toepassing / Plugins en de dialoog afsluit.

### Menustructuur

XML XML valideren

- Dit start de controle, zoals hierboven beschreven.

### Dankbetuigingen en licentie

&kate;-plugin XML Validation copyright 2002 &Daniel.Naber; &Daniel.Naber.mail;

Documentatie copyright 2002 &Daniel.Naber;

## &XML;-aanvulling

Deze plugin geeft hints over wat is toegestaan op een bepaalde positie in een &XML;-bestand volgens de DTD van het bestand. Het toont mogelijke elementen, attributen, attribuutwaarden of entiteiten, afhankelijk van de positie van de cursor (⪚ alle entiteiten worden getoond als het teken links van de cursor een &) is. Het is ook mogelijk om de dichtstbijzijnde open tag aan de linker kant te sluiten.

De DTD moet bestaan in &XML;-formaat, zoals geproduceerd door het Perl programma `dtdparse`. We zullen een DTD in dit formaat meta DTD noemen. Sommige meta DTD's zijn meegeleverd. Zij zijn geïnstalleerd in `$KDEDIR/share/apps/katexmltools/`, die ook de standaard map is wanneer u Meta DTD toekennen.... Om uw eigen meta DTD's te maken, haal `dtdparse` op uit http://dtdparse.sourceforge.net.

### Hoe te gebruiken

Start &kate; en open de instellingendialoog onder Instellingen &kate; instellen.... Selecteer daarna XML-aanvulling die zal verschijnen in de sectie Toepassing/Plugins en de dialoog afsluit. Selecteer hierna XML Meta DTD toekennen.... Als uw document geen DOCTYPE bevat of de doctype is onbekend, dan moet u een meta DTD uit het bestandssysteem kiezen. Anders wordt de meta DTD, die overeenkomt met de huidige DOCTYPE van het document, automatisch geladen.

U kunt de plugin gebruiken terwijl u uw tekst intypt:

< (kleiner-dan-toets)

- Dit start een lijst met mogelijke elementen tenzij de cursor zich al in een tag bevindt. Merk op dat u dit nu niet kunt gebruiken om het element op topniveau in te voegen (⪚ <html>).

</(kleiner-dan-toets + schuine streep)

- Invoeren van deze tekens biedt het sluiten van het huidige element (het dichtst bij de geopende links van de cursor). Druk op &Enter; om de suggestie te accepteren. Anders dan met de menu-items Element sluiten, werkt dit alleen met een toegekende DTD.

" (aanhalingsteken-toets)

- De toets aanhalingsteken start een lijst met mogelijke attribuutwaarden (als die er zijn) als u zich in een tag bevindt.

(spatietoets)

- Deze toets start een lijst met mogelijke attribuutwaarden voor het huidige element als u zich in een tag bevindt.

& (ampersand-toets)

- Deze toets start een lijst met benoemde entiteiten.

### Mogelijkheden en beperkingen

U kunt alle functies en beperkingen testen door `$KDEDIR/share/apps/katexmltools/testcases.xml` in &kate; te laden en de instructies te volgen.

### Menustructuur

&Ctrl;Return XML Element invoegen...

- Dit opent een dialoog die u een &XML;-element laat invoegen. De tekens <, > en de sluittag zullen automatisch worden ingevoegd. Als u tekst hebt geselecteerd wanneer dit menu-item is geselecteerd, dan zal de geselecteerde tekst worden omgeven door de openings- en sluittag. De dialoog biedt ook aanvulling van alle elementen die kunnen worden ingevoegd op de huidige positie van de cursor als u een meta DTD hebt toegekend via Meta DTD toekennen....

&Ctrl;< XML Element sluiten

- Hiermee wordt uw tekst doorzocht naar een tag die nog niet is gesloten en zal deze sluiten door de overeenkomstige sluittag. Het zoeken start op de positie van de cursor en gaat naar links. Als het geen open tag kan vinden dan zal er niets gebeuren.

XML Meta-DTD toekennen...

- Dit vertelt de plugin welke meta DTD voor het huidige document te gebruiken. Merk op dat dit toekennen niet zal worden opgeslagen. U zult het moeten herhalen wanneer u &kate; de volgende keer opstart.

### Dankbetuigingen en licentie

&kate;-plugin XML-aanvulling copyright 2001,2002 &Daniel.Naber; &Daniel.Naber.mail;

KDE SC 4 versie copyright 2010 Tomáš Trnka

Documentatie copyright 2001,2002 &Daniel.Naber;

## Snel van document wisselen

### Menustructuur

&Ctrl;1 Ga naar Snel wisselen

- Opent de dialoog Snel van document wisselen met een zoekveld en een lijst met geopende bestanden. Bij het invoeren van tekst in het zoekveld worden de documentnamen en document-url's gezocht voor overeenkomende tekst. Bij het invoeren van tekst in het zoekveld kunt u de cursortoetsen Omhoog en Omlaag gebruiken om te navigeren in de lijstweergave. Als de dialoog verlaten wordt met OK zal de plugin omschakelen naar het document geselecteerd in de lijstweergave. Dit maakt schakelen tussen documenten gemakkelijker, als er heel wat van hen geopend zijn.

## Exportprogramma

### Menustructuur

Bestand Als HTML exporteren...

- Exporteer uw bestand in &HTML;-formaat zodat uw document als webpagina kan worden bekeken.

Bewerken Als HTML kopiëren...

- Kopieert geselecteerde tekst met de syntax geaccentueerd als HTML tekst.

## Zoeken en vervangen

### Inleiding

De plug-in Zoeken in bestanden van &kappname; stelt u in staat naar tekst of reguliere expressies te zoeken in veel verschillende bestanden tegelijk. U kunt in alle open bestanden zoeken of alle bestanden in één map en als optie zijn submappen. U kunt zelfs filteren op bestandsnaam, bijvoorbeeld alleen in bestanden zoeken die eindigen op een specifieke bestandsextensie.

### Interface

#### Zoek opdracht

De volgende opties worden altijd getoond bovenaan de hulpmiddelenweergave Zoeken in bestanden:

Nieuw tabblad

- U kunt zoveel zoekopdrachten tegelijk open hebben als u wilt. Klik gewoon op de knop Nieuw tabblad in de linkerbovenhoek van de hulpmiddelweergave Zoeken en een nieuw tabblad voor resultaten zal worden geopend waarmee u een andere zoekopdracht kunt geven.

Zoekopdracht

- Het lange tekstvak bovenaan is waar u intypt wat u wilt vinden. U kunt standaard tekst invoeren of een reguliere expressie, indien ingeschakeld.

Zoeken

- Wanneer u klaar bent met alles in te stellen drukt u gewoon op de knop Zoeken om uw zoekopdracht uit te voeren. U kunt ook op &Enter; drukken in de tekstvak voor zoeken om hetzelfde te doen.

Locatie

- Deze heeft twee opties. Selecteer In open bestanden om in alle nu in &kappname; geopende bestanden te zoeken. Selecteer In map om in een map en optioneel zijn submappen te zoeken.

Opties

- Er zijn twee beschikbare opties. Indien ingeschakeld, Hoofdlettergevoelig beperkt zoekresultaten tot alleen die exact dezelfde combinatie van hoofd- en kleine letters hebben als in uw zoekopdracht. Reguliere expressies stelt u in staat om reguliere expressies te gebruiken in plaats van eenvoudige tekst als uw zoekopdracht.

Resultaten omschakelen

- De neerwaartse pijl in de rechterbovenhoek van het venster van hulpmiddel Zoeken in bestanden zal de onderste helft van dat venster omschakelen tussen het weergeven van extra opties voor de modus Zoeken in map en de resultaten van uw zoekopdracht.

#### Opties van Zoeken in map

Deze opties worden getoond onder de hier voor genoemde zoekopties. Als in plaats hiervan zoekresultaten worden getoond, druk dan op de knop Resultaten omschakelen om ze weer te geven. Deze opties zijn alleen van toepassing op wanneer de modus Zoeken in map is ingeschakeld. Als Zoeken in open bestanden is geselecteerd, dan zijn ze uitgeschakeld.

Map

- U kunt het pad van de map waarin u wilt zoeken invoeren. U wilt bijvoorbeeld `~/development/kde/kate/` invoeren als u in de broncode van &kate; wilt zoeken.

Bestandsdialoog openen

- Gebruik deze knop om de map op te zoeken met uw mapbrowser.

Omhoog

- Gebruik deze knop om de geselecteerde autobladwijzer te bewerken.

Huidig map herstellen

- Gebruik deze knop om het Map-item op de map in te stellen waarin het nu geopende document zich bevindt.

Filter

- Dit stelt u in staat om alleen bestandsnamen te zoeken die aan een bepaald patroon voldoen. Om bijvoorbeeld alleen bestanden geschreven in C++ te zoeken, wijzigt u het in `*.cpp`. Om naar bestanden te zoeken die met `kate` beginnen, wijzigt u het naar `kate*`. U kunt meerdere filters invoeren gescheiden door een komma (`,`). Om bestanden uit te sluiten in de zoekopdracht zet u een minteken (`-`) voor de lijst.

Recursief

- Bij activering van deze optie zal &kappname; ook in alle submappen van de geselecteerde map zoeken.

Verborgen bestanden meenemen

- Bij activering van deze optie zal &kappname; ook in bestanden of mappen zoeken die typisch verborgen zijn door uw &OS;.

Symbolische koppelingen volgen

- De plug-in Zoeken in bestanden volgt typisch geen symbolische koppelingen. Wanneer deze optie is ingeschakeld zal de plug-in deze volgen en zoeken in de bestanden of mappen waarnaar ze verwijzen.

  Het is mogelijk bij symbolische koppelingen om naar een map te verwijzen die hoger in hiërarchie van de mappen ligt dan de map waarin nu wordt gezocht of andere mappen die symbolische koppelingen bevatten naar een map hoger in de hiërarchie. Als zich zo'n koppeling in de map waarin gezocht bevindt en deze optie is inschekeld, dan zal &kappname; bij herhaling de koppeling volgen en in de map zoeken waarna de zoekopdracht nooit zal eindigen.

#### Zoekresultaten

De resultaten van uw zoekopdracht worden hieronder getoond in de zoekopties. Als opties voor de modus Zoeken in map getoond worden, druk dan gewoon op de knop Resultaten omschakelen om ze te tonen. Ze zullen ook automatisch worden getoond zodra een zoekopdracht wordt uitgevoerd.

Het zoekresultaat toont drie kolommen die de informatie leveren over elk resultaat van uw zoekopdracht. De kolom Bestand toont de naam van het bestand. De kolom Regel toont het regelnummer waarin de inhoud van uw zoekopdracht is gevonden. De kolom Tekst toont de volledige tekst van die regel.

Om het bestand te openen waarin het gezochte is gevonden, is dubbelklikken voldoende. &kappname; zal het bestand zo nodig openen en de cursor aan het begin van de gezochte tekst in het bestand plaatsen.

### Menustructuur

Beeld Hulpmiddelenweergaven Zoeken in bestanden tonen

- Toont of verbergt het hulpmiddel van &kappname; Zoeken in bestanden.

## Bestanden via e-mail verzenden

### Menustructuur

Bestand Bestand verzenden...

- Uw e-mailclient openen en het bestand als bijlage aan het e-mailbericht toevoegen.

## Bestandssysteembrowser

In de bestandenkiezer kunt u de inhoud van mappen bekijken en bestanden uit een geopende map in het huidige frame openen.

### Menustructuur

Beeld Hulpmiddelenweergaven Bestandssysteembrowser tonen

- Toont of verbergt de Bestandssysteembrowser van &kate;

### Interface

De bestandenkiezer heeft, van boven naar beneden, de volgende elementen:

Een werkbalk

- Deze bevat de standaard navigatieknoppen:

  Terug

- Wanneer u op deze knop klikt, wordt het commando `cd` naar de vorige map in de geschiedenis uitgevoerd. Deze knop is niet beschikbaar als er geen vorig item is.

Vooruit

- Wanneer u op deze knop klikt, wordt het commando `cd` naar de volgende map in de geschiedenis uitgevoerd. Deze knop is niet beschikbaar als er geen volgend item is.

Bladwijzers

- Opent een submenu om bladwijzers te bewerken en toe te voegen en een nieuwe map voor bladwijzers.

Map van huidig document

- Wanneer u op deze knop klikt, wordt het commando `cd` naar de map waarin het huidige document zich bevindt (indien mogelijk) uitgevoerd. Deze knop is niet beschikbaar als het document een nieuw, onopgeslagen bestand is of als de map waarin het bestand zich bevindt niet bepaald kan worden.

Opties

- Beknopte weergave

- Alleen bestandsnamen tonen

Gedetailleerde weergave

- Naam, Datum, Grootte en Type van de bestanden tonen.

Boomstructuurweergave

- Zoals Beknopte weergave, maar mappen kunnen worden uitgevouwen om hun inhoud te bekijken.

Gedetailleerde boomweergave

- Dit stelt u ook in staat om mappen uit te vouwen, maar toont extra kolommen beschikbaar in Gedetailleerde weergave.

Verborgen bestanden tonen

- Toont bestanden die normaal verborgen zijn door uw besturingssysteem.

Automatisch synchroniseren met huidig document

- Wanneer deze optie is ingeschakeld zal de bestandssysteembrowser automatisch een `cd` uitvoeren naar de map van het document dat nu geopend is in het bewerkingsgebied elke keer als het wijzigt.

Een locatie-item

- Dit toont een broodkruimelnavigatie naar de huidige geopende map, zoals in &dolphin;. U kunt op elke map klikken om het door te bladeren of klik op een van de pijlen, links van de map, om een onderliggende map te selecteren. U kunt ook uit Plaatsen kiezen door op het meest linkse pictogram in de broodkruimelnavigatie te klikken, die een pictogram toont die uw huidige Plaats toont.

  U kunt ook rechts van de broodkruimels klikken on ze te wijzigen waar u het pad naar een map, die u wilt zien, kunt intypen. Het &URL;-invoerveld houdt een lijst bij van eerder ingetypte paden. Klik op de pijlknop rechts van het invoerveld om een pad te kiezen.

  Het &URL;-invoerveld maakt gebruik van automatische aanvulling. De methode kan ingesteld worden in het contextmenu dat verschijnt wanneer u met de &RMB; op de tekst klikt.

De mappenweergave

- Dit is een standaard mappenweergave van &kde;.

Een filterinvoerveld

- In het filterinvoerveld kunt u het filter voor de bestanden die u wilt zien intypen. Het filter gebruikt de standaard jokertekens; items moeten worden gescheiden door een spatie. Voorbeeld: `*.cpp *.h *.moc`

  Om alle bestanden te kunnen zien, typt u een enkele asterisk `*` in.

  Het filterinvoerveld houdt een lijst bij van de laatste tien filters. Klik op de pijlknop rechts van het invoerveld om het gewenste filter te kiezen. U kunt het filter uitschakelen door op de knop Tekst wissen te klikken links van de pijlknop voor automatisch aanvullen.

### Configuratie

Deze plugin kan worden geconfigureerd op de pagina Bestandssysteembrowser van instellingen van &kate;.

Werkbalk

- Stel deze knoppen in op de werkbalk van het bladerprogramma voor het bestandssysteem door diegene, die u wil inschakelen, te verplaatsen naar de lijst Geselecteerde acties en sorteer ze met de pijlknoppen naast de lijst.

## Kate-fragmenten

### Inleiding

Kate-fragmenten is een plug-in die wordt gebruikt om u tijd te besparen door ondersteuning toe te voegen voor zogenaamde "fragmenten" (herbruikbare broncode, machinecode of tekst). De plug-in ondersteunt ook code-aanvulling en QtScript.

### Menustructuur

Beeld Hulpmiddelenweergaven Kate-fragmenten tonen

- Toont het fragmentenpaneel met alle fragmenten in uw opslag voor het huidige geopende bestandstype.

### Configuratie

De instellingen voor Kate-fragmenten benaderen kan in Instellingen Kate instellen, in Kate-fragmenten onder Toepassingen.

Instellen van Kate-fragmenten Het paneel voor het instellen van Kate-fragmenten.

Het paneel voor het instellen van Kate-fragmenten.

In het configuratiepaneel zou u een lijst met opslagruimten met fragmenten moeten zien, samen met opties om uw eigen ruimten aan te maken, ze van het internet te halen of te laden uit een lokaal bestand. Elke opslagruimte heeft een keuzevakje dat gebruikt kan worden om het te activeren of te deactiveren. Er zijn ook knoppen om bestaande opslagruimten te bewerken en te verwijderen.

#### Fragment-opslagruimte-bestanden laden

U kunt fragment-opslagruimten van het internet downloaden. Klik eenvoudig op Nieuwe fragmenten ophalen en er opent zich een venster met een lijst met fragment-opslagruimten. Controleer na het downloaden van het gewenste fragment of het is geactiveerd.

U kunt ook een fragment-opslagruimte uit een lokaal bestand laden met de bestandenbrowser onderaan het paneel. Klik op knop Naar opslagruimte kopiëren indien gereed.

#### Fragmenten aanmaken en bewerken

Bewerker van fragmenten De bewerker van fragmenten.

Het interface van de bewerker van fragmenten.

Om een nieuwe fragment-opslagruimte aan te maken klikt u op Nieuw bestand voor tekstfragmenten. U zou nu een dialoog moeten zien die naar de naam van het fragmentbestand, de licentie en auteur vraagt. Na het kiezen van de gewenste opties, klikt u op Aanmaken en de bewerker van fragmenten zal worden geopend.

De bewerker van fragmenten bevat de volgende opties:

Bestandstype

- Selecteer het/de bestandstype(n) waarop de fragment-opslagruimte moet worden toegepast. Het is standaard ingesteld op *, dus is de opslagruimte op alle bestanden van toepassing. U kunt het bijvoorbeeld wijzigen in zoiets als `C++` of iets uit een lijst selecteren door op Bewerken te drukken. U kunt meer dan één bestandstype selecteren door ze te scheiden met een `;`.

Auteurs

- Voer de na(a)m(en) in van de auteur(s) van het fragmentenbestand.

Lijst met fragmenten

- Bevat alle fragmenten gedefinieerd in het fragmentenbestand. U kunt eenvoudig op een fragment in de lijst klikken om het te bewerken.

Toevoegen (+)

- Wordt gebruikt om een nieuw fragment aan te maken.

Verwijderen (-)

- Wordt gebruikt om een fragment te verwijderen.

Overeenkomst/naam

- Verschijnt in de lijst met fragmenten in de hulpmiddelenweergave en wordt ook doorzocht bij het gebruiken van de functie code-aanvullen.

Voorvoegsel tonen, Achtervoegsel tonen en Argumenten tonen

- Wordt gebruikt om behulpzame informatie weer te geven bij het gebruik van code-aanvulling. Het voor- en achtervoegsel worden getoond voor en na de naam, terwijl de argumenten tussen haakjes worden getoond onmiddellijk na de naam.

Inhoud van tekstfragmenten

- Opnieuw te gebruiken tekst of code. Dit is wat er verschijnt in uw document wanneer het fragment wordt gebruikt.

In Inhoud van tekstfragmenten kunt u variabelen specificeren met `${`naam`}` of `%{`name`}`. Deze kunnen gevuld worden door QtScript of wanneer het fragment wordt gebruikt. Er is een speciale variabele - ${cursor} of %{cursor} - die automatisch de cursor op zijn eerste voorkomen zet.

### Fragmenten gebruiken

Kate-fragmenten in actie Kate-fragmenten gebruiken vanuit een hulpmiddelenweergave en een afrolmenu.

Uit een lijst met fragmenten kiezen.

U kunt fragmenten aanroepen op twee manieren:

- Door het fragment uit de hulpmiddelenweergave te kiezen.

- Bij het schrijven kunt u &Ctrl; Spatie indrukken, die alle fragmenten zal weergeven in een gemaksvenster waaruit u kunt kiezen. U kunt het begin van de naam van het fragment kiezen voor of na het indrukken van deze toetscombinatie, die functionaliteit levert gelijkend op code-aanvulling.

Als het fragment variabelen (naast `${cursor}`) bevat dan zal de cursor automatisch naar het eerste voorkomen van een variabele gaan en zal op u wachten om iets te schrijven. Als u klaar bent, drukt u op om naar de volgende variabele te gaan, enzovoort.

### Dankbetuigingen en licentie

Kate Snippets is geschreven door Joseph Wenninger.

Speciale dank gaat naar de deelnemer van Google Code-In 2011 Martin Gergov voor het schrijven van veel van deze sectie.

## Bouwplug-in

### Inleiding

De Bouwplug-in stelt u in staat om acties op een project uit te voeren, zoals bouwen, opschonen en compileren.

### De Bouwplug-in gebruiken

De Bouwplug-in voegt een weergavehulpmiddel Bouwuitvoer onderaan toe en een menu Bouw op de menubalk. Het weergavehulpmiddel kan worden gebruikt om de instellingen van het bouwdoel in te stellen, terwijl het menu kan worden gebruikt om de acties bouwen, opschonen en compileren te doen.

Het weergavehulpmiddel Bouwuitvoer heeft drie tabbladen:

- Fouten & waarschuwingen

- Uitvoer

- Instellingen van doel

#### Tabblad Instellingen van doel

Het tabbald Instellingen van doel kan gebruikt worden om verschillende bouwdoelen in te stellen.

Elk doel bevat vier opties voor instellingen:

Werkmap

- U kunt het pad naar het project hier instellen. Leeg laten om de map van het huidige document te gebruiken .

Bouwen

- Deze optie laat u het bouwcommando instellen. Het is standaard ingesteld op `make`.

Opschonen

- Deze optie laat u het opschooncommando instellen. Het is standaard ingesteld op `make clean`.

Snel compileren

- Deze optie laat u het commando voor snel compileren instellen. Het is standaard ingesteld op `gcc -Wall -g %f`.

Er kan een nieuw doel worden aangemaakt met de knop Nieuw. De knop Kopiëren kan woirden gebruikt om een kopie te maken van een bestaand doel. De knop Verwijderen wordt gebruikt om een doel te verwijderen.

#### Tabblad Uitvoer

Het tabblad Uitvoer toont de console-uitvoer die is gegenereerd door het laatste commando.

#### Fouten & waarschuwingen

Het tabblad Fouten & waarschuwingen geeft een lijst met de fouten en waarschuwingen die door het laatste commando zijn gegenereerd.

Elke regel bevat een bericht, de bestandsnaam en het regelnummer indien beschikbaar. Op de fout of waarschuwing klikken brengt u naar het bijbehorende bestand en zet de cursor op het bijbehorende regelnummer.

Om naar de vorige fout te gaan drukt u op &Ctrl;&Alt;Links. Om naar de volgende fout te gaan drukt u op &Ctrl;&Alt;Rechts.

### Menustructuur

Bouwen Bouwen

- Voert het Bouwen-commando uit voor het nu geselecteerde doel.

Bouwen Opschonen

- Voert het Opschonen-commando uit voor het nu geselecteerde doel.

Bouwen Snel compileren

- Voert het Snel compileren-commando uit voor het nu geselecteerde doel.

&Ctrl;&Alt;Links Bouwen Vorige fout

- Verplaatst de cursor naar de locatie van de vorige fout in het document.

&Ctrl;&Alt;Rechts Bouwen Volgende fout

- Verplaatst de cursor naar de locatie van de volgende fout in het document.

Bouwen Doelen

- Uit een lijst met door de gebruiker ingestelde doelen kiezen.

Bouwen Volgende doel

- Schakel om naar het volgende door de gebruiker ingestelde doel.

### Dankbetuigingen en licentie

De plug-in Build (Bouwen) van &kate; is geschreven door Kåre Särs.

Speciale dank gaat naar de deelnemer van Google Code-In 2011 Salma Sultana voor het schrijven van veel van deze sectie.

## SQL-plug-in

### Inleiding

De Structured Query Language (SQL) is een gespecialiseerde taal voor het bijwerken, verwijderen en opvragen van informatie uit databases.

The plugin SQL van Kate stelt u in staat om:

- Een database aan te maken

- Te verbinden met bestaande databases

- Gegevens in de database te voegen en uit de database te verwijderen

- Zoekopdrachten uit te voeren

- Resultaten in een tabel te tonen

### Te verbinden met een database

Selecteer Verbinding toevoegen uit het menu SQL of de werkbalk en selecteer daarna het Qt-databasestuurprogramma dat u wilt gebruiken (inclusief QSQLITE, QMYSQL3, QMYSQL, QODBC3, QODBC, QPSQL7 en QPSQL). Als u het gewenste stuurprogramma niet ziet, dan moet u het installeren. Druk daarna op Volgende

Als de door u geselecteerde database een bestand gebruikt, geeft dan eenvoudig de locatie van de database en druk op de knop Volgende. Als een verbinding met een server vereist is, moet u de hostnaam van de server, uw gebruikersnaam en wachtwoord invoeren en elke andere informatie die het specifieke stuurprogramma kan vereisen. Druk daarna op Volgende

Geef tot slot een naam aan uw verbinding en druk op Beëindigen.

### Queries uitvoeren

#### INVOEGEN/VERWIJDEREN/BIJWERKEN

U kunt gegevens invoegen, verwijderen en bijwerken met de SQL-plug-in op dezelfde manier als vanaf de commandoregel of in een programma. Voer eenvoudig een query in en druk op de Query uitvoeren.

##### Enkele voorbeeld queries

`INSERT`

-     INSERT INTO tabelnaam ("feature1", "feature2", "feature3", "feature4", "feature5")
      VALUES ("waarde1", "waarde2", "waarde3", "waarde4", "waarde5" )

`DELETE`

-     DELETE FROM tabelnaam WHERE name = "tekst"

`UPDATE`

-     UPDATE tabelnaam SET "feature1" = "tekst", "feature2" = "tekst", "feature3" = "text", "feature4" = "tekst", "feature5" = "tekst"

#### SELECT

Na het uitvoeren van een `SELECT` query, kunt u de resultaten als een tabel bekijken die zal verschijnen in het weergavehulpmiddel SQL-gegevensuitvoer onderaan &kappname; of als tekst in de SQL-tekstuitvoer. Als er een fout is ziet u dat de tekstuitvoer.

##### Voorbeeld `SELECT` zoekopdracht

    SELECT * FROM tabelnaam

In de hulpmiddelweergave SQL-gegevensuitvoer bevinden zich enige knoppen:

Kolomgrootte aanpassen aan inhoud

- Wijzigt de grootte van kolommen om hun inhoud te laten passen.

Rijgrootte aanpassen aan inhoud

- Wijzigt de grootte van rijen om hun inhoud te laten passen.

Kopiëren

- Selecteert de gehele tabelinhoud en kopieert deze naar de klembordbuffer.

Exporteren

- Exporteert de gehele tabelinhoud naar een bestand, het klembord of het huidige document in het formaat kommagescheiden waarden.

Wissen

- Verwijdert alles uit de tabelweergave

U kunt nu de kleuren wijzigen die getoond worden in de tabel in de sectie SQL van Instellingen Kate instellen .

### Bladeren

U kunt door uw database bladeren met het weergavehulpmiddel SQL-schemabrowser links. De weergegeven informatie varieert afhankelijk van welk stuurprogramma voor de database u gebruikt.

Om deze lijst te verversen klikt u rechts ergens in het weergavehulpmiddel en selectert u Verversen. Om een query te maken op een item in de lijst, klikt u rechts op een item, selecteert Genereren en selecteert u het type query (SELECT, UPDATE, INSERT en DELETE) uit het submenu dat verschijnt.

### Menustructuur

SQL Verbinding toevoegen...

- Voegt een nieuwe verbinding toe met elk databasestuurprogramma.

SQL Verbinding verwijderen

- Verwijdert de geselecteerde verbinding.

SQL Verbinding bewerken...

- Bewerkt de huidige verbindingsinstellingen.

Verbindingen

- Alle door u gemaakte databaseverbindingen staan in de lijst tussen de menu-items Verbinding bewerken en Query uitvoeren. Selecteer er een om queries uit te voeren of maak er wijzigingen in.

&Ctrl;E SQL Zoekopdracht uitvoeren

- Voer uw query uit.

### Dankbetuigingen en licentie

De SQL-plug-in is geschreven door Marco Mentasti.

Speciale dank gaat naar de deelnemer van Google Code-In 2011 Ömer Faruk ORUÇ voor het schrijven van veel van deze sectie.

## &gdb;-plug-in

### Inleiding

De &gdb;-plug-in van &kappname; levert een eenvoudige frontend naar het populaire &GNU; Project Debugger.

Eerdere ervaring met &gdb; is zeer aanbevolen. Voor meer informatie over het gebruik van &gdb; bezoekt u de website van &gdb;

U kunt de &gdb;-plug-in inschakelen in de sectie met plug-ins in de instellingen van &kappname;.

Om de plug-in juist te laten werken, moet u een bestand met de broncode hebben (van een door &gdb; ondersteunde soort) en een uitvoerbaar programma.

Als u compileert met &gcc;/`g++` dan zou u het argument op de opdrachtregel ``-ggdb`` willen gebruiken.

Nadat deze voorbereidingen zijn gedaan, opent u het bestand met de broncode in &kappname;, voert het pad naar het uitvoerbare programma in in het tabblad Instellingen van de hulpmiddelenweergave Debugweergave en selecteert u Debug Debugging starten uit het menu om te beginnen.

### Structuur van menu en werkbalk

Al deze opties zijn beschikbaar in de menu's van &kappname; en er zijn er ook veel beschikbaar op de werkbalk Debug.

Beeld Hulpmiddelenweergaven Debugweergave tonen

- Toont een hulpmiddelenweergave met &gdb;-uitvoer, de gebruikte opdrachtregel van &gdb; en andere instellingen.

Beeld Hulpmiddelenweergaven Lokalen tonen

- Toont een lijst met alle nu geladen variabelen en hun waarden.

Beeld Hulpmiddelenweergaven Aanroepstack tonen

- Toont een backtrace van &gdb;.

Debug Doelen

- Een submenu die een lijst met doelen bevat (uitvoerbare programma's).

Debug Argumentlijsten

- Een submenu die een lijst met alle argumenten bevat.

Debug Met debuggen beginnen

- Start &gdb; met een doel.

Debug Afbreken / Stoppen van debugging

- Stopt &gdb;.

Debug Debugging opnieuw starten

- Start &gdb; opnieuw.

Debug Breekpunt omschakelen

- Een breekpunt op de huidige cursorpositie instellen.

Debug Instappen

- Het huidige statement uitvoeren (functie-aanroep zal worden gedebugd).

Debug Overheen stappen

- Het huidige statement uitvoeren (functie-aanroep zal niet worden gedebugd).

Debug Uitstappen

- Uitvoering hernemen totdat het programma in uitvoering zich beëindigd.

Debug PC verplaatsen

- Programcounter (PC) verplaatsen (volgende uitvoeren).

Debug Uitvoeren tot de cursor

- Voert het programma uit totdat het de huidige cursorpositie bereikt.

Debug Doorgaan

- Negeert elk breekpunt en voert het programma uit totdat het zich beëindigd (al of niet met succes).

Debug Waarde afdrukken

- Drukt de waarde van de variabele af waar de cursor nu naar wijst.

Instellingen Getoonde werkbalken&gdb;-plug-in

- De debug-werkbalk tonen.

### Debugweergave

Het hulpmiddel Debugweergave heeft een aantal tabbladen:

&gdb;-uitvoer

- Bevat uitvoer van &gdb; en een &gdb;-commandoregel.

  Het tabblad Uitvoer Het tabblad Uitvoer.

  Het tabblad Uitvoer toont de uitvoer van een debug-sessie.

Instellingen

- Doel

- Pad naar het doel (uitvoerbaar bestand) voor debugging.

Werkmap

- De huidige werkmap geleverd aan het doel.

Arg-lijst

- Argumenten aan het programma gegeven.

Focus behouden

- De focus op de &gdb;-commandoregel houden.

IO omleiden

- Opent een nieuw tabblad IO in de Debugweergave waar u uitvoer kunt zien en invoer kunt leveren aan het programma in uitvoering.

Het tabblad Instellingen Het tabblad Instellingen.

Het tabblad Instellingen toont de configuratie van een debug-sessie.

IO

- Bevat een gebied die uitvoer weergeeft van het in uitvoering zijnde programma en een commandoregel waar u invoer aan het programma kunt leveren.

  Het tabblad IO Het tabblad IO.

  Het tabblad IO met uitvoer van een eenvoudig testprogramma.

### Aanroepstapel en lokale waarden

Het hulpmiddel Aanroepstapel bevat een lijst van een geformatteerde backtrace komende uit &gdb;.

Het hulpmiddel voor het weergeven van de aanroepstapel van &gdb; Het hulpmiddel voor het weergeven van de aanroepstapel.

Het hulpmiddel voor het weergeven van de Aanroepstapel met de &gdb;-plug-in.

Het hulpmiddel voor de weergave van Lokale variabelen bevat een lijst met alle nu geladen variabelen uit het programma en de bijbehorende waarden.

Het hulpmiddel voor weergave van lokale variabelen van &gdb; Het hulpmiddel voor weergave van lokale variabelen.

Het hulpmiddel voor het weergeven van Lokale variabelen met de &gdb;-plug-in.

### Dankbetuigingen en licentie

Speciale dank gaat naar de deelnemer van Google Code-In 2011 Martin Gergov voor het schrijven van veel van deze sectie.