Filskabeloner Anders Lund
&Anders.Lund.mail;
&erik.kjaer.pedersen.role;
2006-01-10 0.1 KDE kate tdeaddons 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. 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ætningHå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 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;