# Bestandsjablonen

Anders
Lund

    anders@alweb.dk

Maandag 16 feb 2004
0.1

KDE
kate
kdeaddons
sjabloon
macro

# Inleiding

Met deze plugin kunt u bestanden aanmaken gebaseerd op andere bestanden. U kunt elk willekeurig bestand gebruiken als een sjabloon. De plugin zal een kopie van het bestand aanmaken zonder bestandsnaam. Ook kunt u een speciaal sjabloon gebruiken welke mogelijk macro's bevat om informatie in te vullen, zoals uw naam, e-mailadres, de huidige datum en omgevingsvariabelen. Uw cursor wordt bovendien geplaatst op een bruikbare positie in het nieuwe bestand.

De sjablonen uit de sjabloonmappen zullen worden aangeboden via menuoptie Bestand Vanuit sjabloon....

Met de plugin kunt u ook op eenvoudige wijze een nieuw 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 worden gevonden in de verschillende mappen, dan wordt het sjabloon uit uw persoonlijke map (KDEHOME) gekozen.

## Menustructuur

Bestand Nieuw vanuit sjabloon Een bestand...

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

Bestand Nieuw vanuit sjabloon Recent gebruikt

  Toont een lijst met de bestanden die recentelijk als sjabloon zijn gebruikt.

Bestand Nieuw vanuit 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 dialoog met een lijst van alle sjablonen die in de sjabloonmappen zijn gevonden. U kunt vanuit dit dialoog sjablonen toevoegen, verwijderen of bewerken.

## Uw eigen sjablonen aanmaken

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

U kunt ook handmatig een sjabloon aanmaken door sjablooninformatie aan de bovenzijde van een bestand te plaatsen, 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, kies menuoptie Instellingen Sjablonen beheren.... Selecteer de sjabloon waaraan u wilt werken en klik op Bewerken.... Het sjabloonbestand wordt nu geopend. Sluit de dialoog, 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 voor sjablooninformatie, macro's een 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 menu Bestand Vanuit sjabloon.

`Group`

  De groep plaatst de sjabloon in een submenu van het menu Bestand Vanuit 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 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.

Author

  Een tekenreeks die de auteur aangeeft, bijv. 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

Bij het ontleden van de sjablooninhoud worden de macro's in de vorm `%Tekst` vervangen door de bijhorende tekst. De volgende macro's kunnen worden gebruikt:

%time

  Voegt de huidige tijd in in uw lokale opmaak, zoals wordt teruggegeven door `QTime::currentTime().toString()`.

%date

  Voegt de datum in de lange opmaak in, zoals teruggegeven wordt door `QDate::currentDate().toString()`.

%datetime

  Voegt de huidige datum en tijd in opgemaakt volgens uw lokale instelling, zoals teruggegeven door `QDateTime::currentDateTime().toString()`.

%year

  Het huidige jaar als viercijferig getal.

%month

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

%{date(OPMAAKTEKST)}

  Dit voegt de datum/tijd in opgemaakt volgens de `OPMAAKTEKST`. OPMAAKTEKST is een plaatshouder voor de volgende opmaken:

  #### Entiteiten voor datumopmaak

  h | het uur zonder voorafgaande nul (0..23 of 1..12 bij AM/PM-weergave)
  hh | het uur met een voorafgaande nul (00..23 of 01..12 bij AM/PM-weergave)
  m | de minuten zonder voorafgaande nul (0..59)
  mm | de minuten met voorafgaande nul (00..59)
  s | de seconden zonder voorafgaande nul (0..59)
  ss | de seconden met een voorafgaande nul (00..59)
  z | de milliseconden zonder voorafgaande nullen (0..999)
  zzz | de milliseconden met voorafgaande nullen (000..999)
  AP | gebruik AM/PM-weergave. AP wordt vervangen door "AM" of "PM".
  ap | gebruik am/pm-weergave. ap zal worden vervangen door "am" of "pm".
  d | de dagen als getal zonder voorafgaande nul (1-31)
  dd | de dagen als getal met voorafgaande nul (01-31)
  ddd | de afgekorte dagnaam in uw taal (dus "ma".."zon").
  dddd | de volledige dagnaam in uw taal (dus "maandag".."zondag").
  M | de maand als getal zonder voorafgaande nul (1-12)
  MM | de maand als getal met voorafgaande nul (01-12)
  MMM | de afgekorte maandnaam in uw taal (dus "jan".."dec").
  MMMM | de volledige maandnaam in uw taal (dus "januari".."december").
  YY | het jaar als tweecijferig getal (00-99).
  YYYY | het jaar als viercijferig getal (1752-8000).

  Hiermee kunt u de weergegeven datum nauwkeurig samenstellen. Gebruik de gebruikelijke scheidingstekens tussen de onderdelen. Bijvoorbeeld: `h:m:s ap`.

%realname

  Voegt uw volledige naam in, als deze kan worden gevonden. De ontleder zal eerst de e-mailinstellingen in KDE's Configuratiecentrum proberen en daarna de accountinformatie. Als er geen volledige naam is gevonden zal uw gebruikersnaam worden gebruikt.

%username

  Voegt uw gebruikersnaam in.

%email

  Voegt uw e-mailadres in, als deze is gevonden. De ontleder zal zoeken in de e-mailinstellingen in KDE's Configuratiecentrum. Indien niets gevonden zal `GEBRUIKERSNAAM@$HOST` worden gebruikt.

%organisation

  Dit is uw organisatie, indien aanwezig in de e-mailinstellingen van KDE's Configuratiecentrum. Indien niets gevonden zal de tekst leeg worden gelaten.

%VARIABELE

  Elke andere tekst zal worden geïnterpreteerd als een omgevingsvariabele. De waarde van die variabele zal worden ingevoegd. Als er geen variabele met die naam is ingesteld op uw computer, dan zal de tekst "WARNING <VARIABLE> is not set" worden ingevoegd.

### Cursorpositie instellen

De ontleder zoekt naar een dakje (^) dat niet voorafgegaan wordt door een backslash (\). Indien gevonden zal het dakje worden verwijderd uit de tekst en wordt de cursor op die plek geplaatst. Als er meerdere dakjes worden gevonden die niet zijn gemarkeerd met een backslash, worden ze allemaal verwijderd. Het laatste dakje zal dan worden gebruikt.

Bij gemarkeerde dakjes zal de voorafgaande backslash worden verwijderd.

## Dankbetuigingen en licenties

&kate;-plugin File Templates copyright 2004 Anders Lund anders@alweb.dk.

Documentatie copyright 2004 Anders Lund

&vertaling.rinse; &underGPL;