Filskabeloner
Anders Lund &Anders.Lund.mail;
&erik.kjaer.pedersen.role;
2006-01-10 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 FilNy ud 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.
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 FilNy ud fra skabelon.
Gruppe
Gruppen placerer skabelone i en undermenu for menuen FilNy ud 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øjerFremhævning .
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.Lund.mail;.
Dokumentation ophavsret 2004 &Anders.Lund;
&erik.kjaer.pedersen.credit;
&underGPL;