Bestandssjablonen
Anders Lund &Anders.Lund.mail;
&Rinse.Devries;&Natalie.Koning;
2006-01-10 0.1
KDE
kate
kdeaddons
sjabloon
macro
Inleiding
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 BestandNieuw van sjabloon. 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.
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 Tab-toets. Als de laatste variabele is bewerkt wordt de lijst uitgeschakeld en werkt de Tab-toets weer als normaal.
Uw eigen sjablonen aanmaken
Om een nieuwe sjabloon aan te maken, gebruikt u menuoptie InstellingenSjablonen 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 InstellingenSjablonen 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:
Template
Dit is de naam van het sjabloon, deze wordt getoond in het menu BestandNieuw van sjabloon.
Group
De groep plaatst de sjabloon in een submenu van het menu BestandNieuw 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.
Highlight
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 HulpmiddelenAccentueringsmodus.
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.
Author
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.
date
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.
email
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 licenties
&kate;-plugin File Templates
copyright 2004 &Anders.Lund; &Anders.Lund.mail;.
Documentatie copyright 2004 &Anders.Lund;
&meld.fouten;&vertaling.rinse;&nagelezen.natalie;
&underGPL;