# Filskabeloner

Anders
Lund

    anders@alweb.dk

Man 16. feb. 2004
0.1

KDE
kate
kdeaddons
skabelon
makro

# Indledning

Filskabelon-plugin tillader dig at lave filer baseret på andre filer. Du kan bruge en vilkårlig fil som skabelon, hvilket vil lave en kopi af filen med en tom URL, eller bruge en speciel skabelonfil som kan indeholder makroer til at udfylde information s[som dit navn og e-mail-adresse, dagens dato og så videre, og placere markøren et godt sted i den nye fil.

Derudover vil skabeloner der er i skabelonmapper blive præsenteret under menupunktet Fil Fra skabelon....

Dette plugin sørger også for en metode til nemt at lave en ny skabelon ud fra et åbent dokument.

Skabelonmapper en en del af &kde;'s filsystem, og består af i det mindste KDEDIR/share/applications/kate/plugins/katefiletemplates/templates og KDEHOME/share/applications/kate/plugins/katefiletemplates/templates. Hvis din KDEDIRS miljøvariabel indeholder yderligere mapper, gennemsøges disse også for en lignende undermappe. Hvis skabeloner med samme navn bliver fundet, så vælges den i den lokale (KDEHOME)-mappe.

## Menustruktur

Fil Ny fra skabelon Vilkårlig fil...

  Præsentere dig for en 'Åbn fil'-dialog der lader dig bruge en vilkårlig fil som skabelon. Hvis den valgte fil har endelsen `katetemplate` vil den blive fortolket for skabeloninformation og makroer.

Fil Ny fra skabelon Brug nylige

  Præsentere en liste af filer der er blevet brugt som skabeloner for nylig, repræsenteret ved deres URL.

Fil Ny fra skabelon

  De tilbageværende undermenuer indeholder link til skabeloner. Klik på et menupunkt for at lave en fil som beskrevet i menupunktets tekst.

Opsætning Håndtér skabeloner

  Dette vil starte en dialog med en liste af alle skabeloner fundet indeni skabelonmapperne, sammen med valgmuligheder for at tilføje, redigere eller fjerne skabeloner.

## Brig en &kate;-skabelon

Når der laves en fil ud fra en skabelon der indeholder makroer, vil nogle makroer ses som redigerbare variabler i teksten. Sådanne variabler ses som understregede ord i teksten.

Den første variabel vil blive valgt, så skal blot skrive for at redigere den. Hvis dokumentets tekst indeholder flere dugaver af den samme variabel, bliver de også ændret mens du redigerer. For at gå til den næste redigerbare variabel, så tryk på TAB-tasten. Når den sidste variabel er redigeret, droppes listen og din TAB-tast virker igen som normalt.

## Lav dine egen skabeloner

For at lave en ny skabelon, bruges punktet Opsætning Håndtér skabeloner til at starte skabelonhåndteringsdialogen. I den klikkes på Ny... for at startet Filskabelon-guiden. Du vil blive spurgt om der er en fil du vil lave om til en skabelon og bedt om skabeloninformationsindstillinger, og en skabelonfil vil blive lavet for dig.

Alternativt kan du lave en skabelon manuelt ved at tilføje skabeloninformation foroven i en vilkårlig fil, tilføje tekst og makroer og og gemme den med endelsen `katetemplate`.

Skabelonmenuen blive automatisk opdateret hvis du valgte at gemme din skabelon i skabelonmappen.

## Redigering af skabeloner

For at redigere en skabelon bruges Opsætning Håndtér skabeloner.... Vælg skabelonen du ønsker at arbejde med og klik på Redigér..., så vil skabelonfilen blive åbnet. Luk dialogen, redigér skabelonfilen som ønsket, gem den og luk den. Ændringer af skabelonerne får øjeblikkelig virkning, du kan aktivere skabelonen for at teste dine ændringer efter du har gemt den.

## Kate's skabelonformat

Hvis du bruger filer med endelsen `katetemplate`, vil de blive fortolket for skabeloninformation, makroer og markørposition.

### Skabeloninformation

Mens filen læses holder tolkeren linjer der begynder med udtrykket `katetemplate:` og gennemsøger dem for skabeloninformation på formen VARIABLENAME=VALUE. Den første linje der ikke starter med `katetemplate:` vil blive opfattet som skabelonens indhold. VALUE kan indeholde et vilkårligt tegn bortset fra lighedstegnet (=). Lovlige variabelnavne er:

`Skabelon`

  Dette er skabelonnavnet, vist i menuen Fil Fra skabelon.

`Gruppe`

  Gruppen placerer skabelone i en undermenu for menuen Fil Fra skabelon.

`Navn`

  Dette er navnet der vil blive sat for dokumentet, og vist i fillisten og titellinjen. Hvis navnet indeholder `%N` vil det blive erstattet med et tal, der øges hvis flere dokumenter har samme navn.

`Fremhæv`

  Dette plugin vil forsøge at sætte fremhævning for det nye dokument til værdien for denne variabel. Værdien skal være navnet, som fundet i Værktøjer Fremhæv .

`Beskrivelse`

  En kort informativ beskrivelse af skabelonen. Dette bruges for øjeblikket til at sætte en 'Have er dette'-streng for menupunktet, men kan bruges til flere formål i fremtiden.

Forfatter

  En streng der identificerer forfatteren, for eksempel på formen `Navn <e-mail-adresse>`. Dette bruges for øjeblikket til at sætte en 'Have er dette'-streng for menupunktet, men kan bruges til flere formål i fremtiden..

### Skabelonmakroer

Når skabelonens indhold fortolkes, bliver makroer på formen `%{NAME}` eller `${NAME}` udvidet. Hvis du bruger `$`-præfikset, vil de udvidede makroer blive behandlet som en redigerbar variabel når et dokument oprettes ud fra skabelonen, hvorimod hvis du bruger `%` sker dette ikke, medmindre udvidelsen er mislykket.

Følgende makroer udvides:

time

  Udvides til det nuværende tidspunkt på dit lokale format.

date

  Udvides til nuværende dato på kort format.

datetime

  Udvider til dato og tidspunkt, formateret som en streng ifølge dine lokale indstillinger.

year

  Det nuværende år som et fircifret tal.

month

  Det fulde navn på måneden, ifølge de lokale indstillinger.

day

  Udvides til månedens nuværende dag.

hostname

  Udvides til 'hostname' for din computer.

index

  Udvides til 'i'.

fullname

  Udvides til dit fulde navn, som defineret i din ejeradresse i KDE's standard-adressebog.

firstname

  Udvides til dit fornavn, som defineret i din ejeradresse i KDE's standard-adressebog.

lastname

  Udvides til dit efternavn, som defineret i din ejeradresse i KDE's standard-adressebog.

email

  Udvides til din e-mail-navn, som defineret i din ejeradresse i KDE's standard-adressebog.

Enhver makro der ikke er i ovenstående liste behandles som en redigerbar variabel uanset præfiks. Hvis den samme variabel forekommer flere gange i skabelonen, kan de redigeres på en gang efter et dokument er oprettet ud fra skabelonen.

### Indstilling af markørens position

Den specielle makro `${cursor}` bliver erstattet med en lodret linje og tilføjet til slutningen af redigerbare variabler, uafhængig af dens placering i teksten.

## Tak og anerkendelser

&kate;-plugin Fil-skabeloner ophavsret 2004 Anders Lund anders@alweb.dk.

Dokumentation ophavsret 2004 Anders Lund

&erik.kjaer.pedersen.credit; &underGPL;