Het handboek van Kate-plugins
Copyright © 2001, 2002
Het is toegestaan dit document te kopiëren, te verdelen en/of te wijzigen onder de voorwaarden van de GNU vrije-documentatie-licentie, versie 1.1 of een latere versie, gepubliceerd door de Free Software Foundation; zonder invariante paragrafen, zonder vooromslagteksten, en zonder achteromslagteksten. Een kopie van de licentie vindt u hier: de paragraaf "GNU vrije-documentatielicentie".
Dit is het handboek van de plugins voor Kate, KDE's Advanced Text Editor.
Inhoudsopgave
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 -> te kiezen. Kies dan -> om de gewenste plugins te vinden.
Meer informatie over het gebruik van Kate en het activeren van plugins is beschikbaar in het handboek van Kate.
De plugins in die in dit handboek worden beschreven zijn:
Deze plugin geeft aan de hand van het bijhorende DTD hints over wat is toegestaan op een bepaalde positie in een XML-bestand. Ze biedt een lijst met mogelijke elementen, attributen, attribuutwaarden of entiteiten, afhankelijk van de cursorpositie. Zo worden bijvoorbeeld alle entiteiten getoond als het teken links van de cursor een “&” is. Het is ook mogelijk om de dichtstbijzijnde geopende tag links van de cursor te sluiten.
DE DTD dient aanwezig te zijn in XML-opmaak, zoals wordt aangemaakt door het Perl-programma dtdparse. We zullen een DTD in deze opmaak een “meta-DTD” noemen. Sommige meta-DTD's worden meegeleverd met KDE. U kunt ze vinden in de map $KDEDIR/share/apps/katexmltools/. Dit is ook de standaardmap als u kiest voor . Om uw eigen meta-DTD's aan te maken, moet u het programma dtdparse van http://dtdparse.sourceforge.net installeren.
Start Kate en kies het menu-item ->. In het dialoogvenster dat wordt geopend kiest u vervolgens de sectie Toepassing Plugins. Selecteer in deze sectie Kate XML-aanvulling en bevestig uw keuze. Kies dan in het hoofdvenster van Kate het menu-item ->. Als uw document geen “DOCTYPE” bevat, of het doctype is onbekend, kies dan een meta-DTD op uw harde schijf. In andere gevallen zal het meta-DTD dat overeenkomt met het DOCTYPE van het document automatisch worden geladen.
U kunt nu de plugin gebruiken terwijl u tekst intypt:
Opent een lijst met mogelijke elementen, tenzij de cursor zich al in een tag bevindt. Opmerking: u kunt dit niet gebruiken als u een hoofdelement wilt invoegen (bijv. “<html>”).
Opent een lijst met mogelijke attribuutwaarden (indien aanwezig) als de cursor zich in een tag bevindt.
Opent een lijst met mogelijke attributen voor het huidige element als de cursor zich in een tag bevindt.
Opent een lijst met benoemde entiteiten.
U kunt alle functies en beperkingen testen door het bestand $KDEDIR/share/apps/katexmltools/testcases.xml in Kate te laden en de instructies te volgen. Opmerking: het werken met meerdere weergaven per document wordt momenteel niet goed ondersteund door deze plugin.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Opent een dialoogvenster waarin u een XML-element kunt invoegen. De tekens <,> en de afsluitende tag zullen automatisch worden ingevoegd. Als u deze menuoptie kiest terwijl er tekst is geselecteerd, zal de geselecteerde tekst worden omgeven door de openings- en afsluitende tags. Het dialoogvenster biedt ook auto-aanvulling voor alle elementen die ingevoegd mogen worden op de huidige cursorpositie volgens de meta-DTD die u hebt toegewezen via menuoptie .
Deze optie zoekt naar een tag die nog niet is gesloten, en zal deze sluiten door de bijhorende afsluitende tag in te voegen. De zoekactie begint bij de cursorpositie en gaat naar links. Als er geen openstaande tag wordt gevonden gebeurt er niets.
Hiermee kunt u het meta-DTD bepalen voor het huidige document. Opmerking: deze toewijzing zal niet worden opgeslagen. U moet telkens als u Kate start het meta-DTD opnieuw toewijzen.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Kate-plugin “XML Completion” copyright 2001,2002 Daniel Naber (daniel.naber AT t-online.de)
Documentatie copyright 2001,2002 Daniel Naber
Op- of aanmerkingen over de vertalingen van de toepassing en haar documentatie kunt u melden op http://www.kde.nl/bugs.
Dit document is vertaald in het Nederlands door Niels Reedijk.
De vertaling werd nagelezen door Natalie Koning.
Deze toepassing valt onder de bepalingen van de GNU General Public License.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
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 het configuratiedialoogvenster van Kate door het menu -> te kiezen. Kies dan Kate XML-validatie in de sectie Toepassing/Plugins, sluit daarna het dialoogvenster.
Kate-plugin “XML Validation” copyright 2002 Daniel Naber (daniel.naber AT t-online.de)
Documentatie copyright 2002 Daniel Naber
Op- of aanmerkingen over de vertalingen van de toepassing en haar documentatie kunt u melden op http://www.kde.nl/bugs.
Dit document is vertaald in het Nederlands door Otto Bruggeman.
Dit document is vertaald in het Nederlands door Rinse de Vries.
De vertaling werd nagelezen door Natalie Koning.
Deze toepassing valt onder de bepalingen van de GNU General Public License.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Met de plugin “Commando invoegen” kunt u de uitvoer van een shell-commando invoegen in een in Kate geopend document.
Om de plugin “Commando invoegen” in te stellen, opent u het dialoogvenster vanuit het menu ->en kiest u de sectie +Commando invoegen.
Om de plugin te gebruiken selecteert u in het menu . Er wordt dan een klein dialoogvenster geopend waarin u het commando kunt invoeren, de werkmap kiezen, en bepalen of foutmeldingen (uitvoer van STDERR) zullen worden ingesloten in de ingevoegde tekst. U kunt ook het commando boven de uitvoer laten plaatsen.
De plugin kan een aantal commando's onthouden die zijn gekozen op de configuratiepagina. Deze worden gebruikt voor het automatisch aanvullen van commando's, en kunnen worden geselecteerd in een lijst in de commando-invoer.
Standaard zal het commando worden uitgevoerd in de werkmap van het Kate-proces. Dit is meestal uw persoonlijke map. Dit kunt u aanpassen op de configuratiepagina van de plugin.
Opmerking: elk shell-commando dat invoer nodig heeft (zoals passwd), of gebruikt maakt van een ncurses-interface of iets vergelijkbaars (zoals top) zal geen bruikbare uitvoer opleveren.
Om de plugin “Commando invoegen” in te stellen, opent u het dialoogvenster vanuit het menu ->en kiest u de sectie +Commando invoegen.
De volgende opties zijn beschikbaar:
Het aantal te onthouden commando's kunt u met de schuifpijlen wijzigen. Elk getal tussen 0 en 99 is mogelijk. De standaard is 20.
Deze instelling wordt gepresenteerd als een set keuzerondjes, waarmee u kunt bepalen hoe de werkmap van een commando zal worden gekozen. De opties zijn de werkmap van het Kate-proces (gewoonlijk is dit uw persoonlijke map als u Kate vanuit het K-menu hebt gestart), de map van het document (indien van toepassing, anders wordt bovenstaande optie gebruikt), of de werkmap van het laatste commando dat door de plugin is uitgevoerd.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Kate Plugin “Insert Command”, copyright 2001 Anders Lund (anders AT alweb.dk).
Documentatie copyright 2001 Anders Lund (anders AT alweb.dk)
Op- of aanmerkingen over de vertalingen van de toepassing en haar documentatie kunt u melden op http://www.kde.nl/bugs.
Dit document is vertaald in het Nederlands door Niels Reedijk.
De vertaling werd nagelezen door Natalie Koning.
Deze toepassing valt onder de bepalingen van de GNU General Public License.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Deze plugin opent een dialoogvenster waarin u de naam van een HTML-tag kunt opgeven. Attributen en waarden die u in de openingstag wilt hebben, vult u in bij attribuutnaam="atribuutwaarde"
Kate-plugin “HTML Tools” copyright 2002 Joseph Wenninger (kde AT jowenn.at).
Documentatie copyright 2005 Francis Giannaros
Op- of aanmerkingen over de vertalingen van de toepassing en haar documentatie kunt u melden op http://www.kde.nl/bugs.
Dit document is vertaald in het Nederlands door Rinse de Vries.
De vertaling werd nagelezen door Natalie Koning.
Deze toepassing valt onder de bepalingen van de GNU General Public License.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
De Kate-plugin “Open Header” heeft nog geen documentatie. Als u interesse hebt om deze te schrijven, neem dan contact op met Lauri Watts (lauri AT kde.org), coördinator van KDE's documentatieteam.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
De Kate-plugin “Tekstfilter” heeft nog geen documentatie. Als u interesse hebt om deze te schrijven, neem dan contact op met Lauri Watts (lauri AT kde.org), coördinator van KDE's documentatieteam.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Met deze plugin kunt u bestanden aanmaken die gebaseerd zijn op andere bestanden. U kunt elk willekeurig bestand gebruiken als een sjabloon. De plugin zal een kopie van het bestand aanmaken met een lege URL (zonder bestandsnaam). Ook kunt u een speciale sjabloon gebruiken die macro's kan bevatten om informatie in te vullen, zoals uw naam, e-mailadres, de huidige datum, omgevingsvariabelen, enzovoort. De cursor wordt bovendien op een bruikbare positie in het nieuwe bestand geplaatst.
De sjablonen uit de sjabloonmappen zullen worden aangeboden via de menuoptie ->.
Met de plugin kunt u ook op eenvoudige wijze een nieuwe sjabloon aanmaken aan de hand van een geopend document.
De sjabloonmappen zijn onderdeel van het KDE-bestandssysteem en bestaan uit tenminste KDEDIR/share/applications/kate/plugins/katefiletemplates/templates en 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.
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.
Toont een lijst met de bestanden die recentelijk als sjabloon zijn gebruikt, aangegeven door hun URL.
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.
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.
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 Tab-toets. Als de laatste variabele is bewerkt wordt de lijst uitgeschakeld en werkt de Tab-toets weer als normaal.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Om een nieuwe sjabloon aan te maken, gebruikt u menuoptie -> om de sjabloonbeheerder te openen. Klik vervolgens op 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.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Om een sjabloon te bewerken, kiest u menuoptie ->. Selecteer de sjabloon waaraan u wilt werken en klik op . 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.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Als u bestanden gebruikt met de extensie katetemplate, dan worden deze doorzocht op sjablooninformatie, macro's en een cursorpositie.
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:
TemplateDit is de naam van het sjabloon, deze wordt getoond in het menu ->.
GroupDe groep plaatst de sjabloon in een submenu van het menu ->.
NameDit 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.
HighlightDeze 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 ->.
DescriptionEen 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.
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.
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:
Wordt omgezet in de huidige tijd volgens uw lokale opmaak.
Wordt omgezet in de huidige datum volgens de korte opmaak.
Wordt omgezet in de huidige datum en tijd, opgemaakt volgens uw lokale instelling.
Het huidige jaar als viercijferig getal.
De volledige naam van de huidige maand, in de huidige taalinstelling.
Wordt omgezet in de huidige dag.
Wordt omgezet in de hostnaam van uw computer.
Wordt omgezet in 'i'.
Wordt omgezet in uw volledige naam, zoals is opgegeven in het eigenaaradres in uw standaard KDE-adresboek.
Wordt omgezet in uw voornaam, zoals is opgegeven in het eigenaaradres in uw standaard KDE-adresboek.
Wordt omgezet in uw achternaam, zoals is opgegeven in het eigenaaradres in uw standaard KDE-adresboek.
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.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Kate-plugin “File Templates” copyright 2004 Anders Lund (anders AT alweb.dk).
Documentatie copyright 2004 Anders Lund
Op- of aanmerkingen over de vertalingen van de toepassing en haar documentatie kunt u melden op http://www.kde.nl/bugs.
Dit document is vertaald in het Nederlands door Rinse de Vries.
De vertaling werd nagelezen door Natalie Koning.
Deze toepassing valt onder de bepalingen van de GNU General Public License.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Informatie over het auteursrecht voor elk applet vindt u in het bijhorende hoofdstuk.
Deze documentatie valt onder de bepalingen van de GNU vrije-documentatie-licentie.
Deze toepassing valt onder de bepalingen van de GNU General Public License.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team