# Dokumentvariabler

En variabel är ett enkelt sätt att låta &kword; ändra dokumentet på ett mycket specifikt sätt för att motsvara dokumentets eller rapportens föränderliga natur.

En variabel kan vara ett tal (som ett sidnummer, det totala antalet sidor i dokumentet, etc.), en uppsättning med ord (kundens namn, produktnamnet, dokumentets filnamn, etc.) ett datum, en tid, eller nästan vad du vill.

När en variabel väl är definierad, läggs en platsmarkör till i dokumentet. &kword; ersätter platsmarkören med värdet som variabeln har varje gång platsmarkören används.

Variabler kan antingen vara fasta (vilket betyder att när de väl har lagts till, så ändras inte deras värden), eller variabla (där platsmarkören uppdateras av &kword; för att motsvara variabelns nuvarande värde).

Det här kapitlet inleds med några exempel på variabler som ofta används (datum, tid och sidnummer), och går sedan igenom de återstående variablerna som är tillgängliga. Till sist beskrivs hur egna variabler kan skapas i dokument.

## Datum och tid

Många brev, rapporter och dokument innehåller information om det datum och den tid de motsvarar. Datum- och tidsinformation kan ange när dokumentet skapades (vilket förblir fast så länge dokumentet finns), eller så kan datum och tid ange senaste ändringen (vilket ändras för var dag som går).

&kword; tillåter både fasta och variabla datum och tider i dokumentet.

### Infoga datum

För att infoga ett datum i dokumentet, placera helt enkelt markören i textrutan där datumet ska läggas till och välj Infoga Variabel Datum i menyraden. Det visar flera alternativ. För att infoga aktuellt datum, välj ett av två alternativ: Aktuellt datum (fast) och Aktuellt datum (variabel).

Aktuellt datum (fast)

- Att välja det här alternativet infogar dagens datum vid markörens nuvarande position. Datumet bestäms genom att läsa av datorns klocka. När det väl har skrivits in, kommer värdet inte att ändras, även om &kword; blir tillsagd att uppdatera dokumentvariablerna.

  Det här alternativet är idealt för datum när dokument skapades, eller när data från dagens arbete läggs till i en rapport. Jämför alternativet med Aktuellt datum (variabel).

Aktuellt datum (variabel)

- Att välja det här alternativet infogar dagens datum vid markörens nuvarande position. Datumet bestäms genom att läsa av datorns klocka. Värdet ändras när &kword; blir tillsagd att uppdatera dokumentvariablerna.

  Det här alternativet är idealt för alla ställen i dokumentet där dagens datum alltid ska finnas. Jämför alternativet med Aktuellt datum (fast).

När datumet väl har valts, visas en dialogruta.

Den övre kombinationsrutan avgör variabelns layout. Du kan välja:

Landets datumformat

- Det här infogar datumet med formatet som anges i &kde;:s Inställningscentral.

  För att välja det här alternativet, försäkra dig helt enkelt om att den övre kombinationsrutan lyder Landets datumformat. En förhandsgranskning av datumet syns ovanför knappen Ok. Om du är nöjd, klicka på Ok.

Förformaterade datumsträngar

- &kword; levereras med 19 fördefinierade datumsträngar. Dessa fördefinierade strängar är allt som behövs i det flesta fall. Välj helt enkelt den fördefinierade strängen i den övre kombinationsrutan. En förhandsgranskning av datumet syns ovanför knappen Ok. Om du är nöjd, klicka på Ok.

Egen sträng

- Om ett lämpligt format för datumet inte kan hittas, är det möjligt att skapa egna datumformatsträngar.

  En datumformatsträng består av en lista med bokstäver och nummer som följer särskilda regler (som beskrivs nedan) för att skapa det fullständiga datumet.

  Datumformatsträngen består av platsmarkörer och avgränsare. Platsmarkörerna definieras i följande tre tabeller.

  Dagar

  Platsmarkörer för dag | d | dd | ddd | dddd
  Exempel | 6 | 06 | tor | torsdag

  Månader

  Platsmarkörer för månad | M | MM | MMM | MMMM
  Exempel | 3 | 03 | Mar | mars

  År

  Platsmarkörer för år | yy | yyyy
  Exempel | 02 | 2002

  Kombinera helt enkelt platsmarkörerna med vanlig text (avgränsare) för att skapa fullständiga datumsträngar.

  Till exempel:

  MM/dd/yyyy översätts till 01/06/2004

  och

  MMMM d, yyyy blir Januari 6, 2004

  Observera att bara platsmarkörerna ändras. Mellanslag, kommatecken, bindestreck och annan text förblir oförändrad.

  Det är viktigt att komma ihåg att platsmarkörerna är skiftlägeskänsliga. DD är inte en platsmarkör, bara dd.

  För att skapa en egen datumsträng, markera kryssrutan Egen.

  Skriv nu in platsmarkörer och avgränsare i den övre kombinationsrutan. Som ett alternativ kan formatet väljas i kombinationsrutan Infoga:, och platsmarkören infogas i datumformatsträngen vid markörens plats.

Det finns en nummerruta som heter Korrigera i dagar. Du kan använda nummerrutan för att justera datumet uppåt eller neråt en eller flera dagar från nuvarande datum.

En förhandsgranskning av nuvarande datumsträng syns ovanför knappen Ok. Klicka på Ok när datumformatsträngen är riktig för att infoga variabeln i dokumentet.

Så fort ett datum har infogats i dokumentet, kan det formateras om till en annan layout och ändras mellan fast och variabelt datum. Klicka helt enkelt en gång med höger musknapp på datumet. En liten meny visas. Välj Ändra variabel till, så visas en undermeny. Välj ny variabel eller layout i menyn, så uppdateras variabeln omedelbart.

Det finns ytterligare tre datum som du kan infoga i dokumentet:

Datum för senaste utskrift

- Att välja det här alternativet infogar det datum dokumentet senast skrevs ut på markörens nuvarande position.

Datum då filen skapades

- Att välja det här alternativet infogar det datum dokumentet skapades på markörens nuvarande position.

Datum då filen ändrades

- Att välja det här alternativet infogar det datum dokumentet senast redigerades på markörens nuvarande position.

### Infoga tid

För att infoga tiden i dokumentet, placera helt enkelt markören i textrutan där tiden ska läggas till och välj Infoga Variabel Tid i menyraden. Det här visar två alternativ: Aktuell tid (fast) och Aktuell tid (variabel).

Aktuell tid (fast)

- Att välja det här alternativet infogar nuvarande tid vid markörens nuvarande position. Tiden bestäms genom att läsa av datorns klocka. När det väl har skrivits in, kommer värdet inte att ändras, även om &kword; blir tillsagd att uppdatera dokumentvariablerna.

  Det här alternativet är idealt för tidsstämpling. Jämför alternativet med Aktuell tid (variabel).

Aktuell tid (variabel)

- Att välja det här alternativet infogar nuvarande tid vid markörens nuvarande position. Tiden bestäms genom att läsa av datorns klocka. Värdet ändras när &kword; blir tillsagd att uppdatera dokumentvariablerna.

  Det här alternativet är idealt för alla ställen i dokumentet där nuvarande tid alltid ska finnas. Jämför alternativet med Aktuell tid (fast).

Det här visar en dialogruta.

Den övre kombinationsrutan avgör variabelns layout. Du kan välja:

Landets format

- Det här infogar tiden med formatet som anges i &kde;:s Inställningscentral.

  För att välja det här alternativet, försäkra dig helt enkelt att den övre kombinationsrutan lyder Landets format. En förhandsgranskning av nuvarande tidsträng syns ovanför knappen Ok. Om du är nöjd, klicka på Ok.

Förformaterade tidssträngar

- &kword; levereras med 6 fördefinierade datumsträngar. Dessa fördefinierade strängar är allt som behövs i det flesta fall. Välj helt enkelt den fördefinierade strängen i den övre kombinationsrutan. En förhandsgranskning av tidsformatet syns ovanför knappen Ok. Om du är nöjd, klicka på Ok.

Egen sträng

- Om ett lämpligt format inte kan hittas, är det möjligt att skapa egna formatsträngar.

  En tidsformatsträng består av en lista med bokstäver och nummer som följer särskilda regler (som beskrivs nedan) för att skapa den fullständiga tiden.

  Tidsformatsträngen består av platsmarkörer och avgränsare. Platsmarkörerna definieras i följande fem tabeller.

  Timmar

  Platsmarkörer för timmar | h | hh
  Exempel | 6 | 06

  Minuter

  Platsmarkörer för minuter | m | mm
  Exempel | 3 | 03

  Sekunder

  Platsmarkörer för sekunder | s | ss
  Exempel | 2 | 02

  Millisekunder

  Platsmarkörer för millisekunder | zzz
  Exempel | 022

  Sekunder

  Platsmarkörer för FM/EM | ap | AP
  Exempel | am | AM

  Kombinera helt enkelt platsmarkörerna med vanlig text (avgränsare) för att skapa fullständiga tidssträngar.

  Till exempel:

  hh:mm:ss blir 06:23:13

  och

  h:mm ap blir 6:23 fm

  Observera att bara platsmarkörerna ändras. Mellanslag, kommatecken och annan text förblir oförändrad.

  Det är viktigt att komma ihåg att platsmarkörerna är skiftlägeskänsliga. HH är inte en platsmarkör, bara hh.

  För att skapa en egen tidssträng, markera kryssrutan Egen.

  Skriv in platsmarkörer och avgränsare i den övre kombinationsrutan. Som ett alternativ kan formatet väljas i kombinationsrutan Infoga:, och platsmarkören infogas i tidsformatsträngen vid markörens plats.

  En förhandsgranskning av nuvarande tidssträng syns under kryssrutan Egen. Klicka på Ok när tidsformatsträngen är riktig för att infoga variabeln i dokumentet.

En förhandsgranskning av nuvarande tidssträng syns under kryssrutan Egen. Klicka på Ok när tidsformatsträngen är riktig för att infoga variabeln i dokumentet.

Så fort tiden har infogats i dokumentet, kan det formateras om till en annan layout och ändras mellan fast och variabel tid. Klicka helt enkelt en gång med höger musknapp på tiden i dokumentet. En liten meny visas. Välj Ändra variabel till, så visas en undermeny. Välj ny variabel eller layout i menyn, så uppdateras variabeln omedelbart.

## Sidnumrering

Det är enkelt att lägga till sidnummer i &kword;.

Det finns fem variabler som har med sidnummer att göra: Sidnummer, Antal sidor, Kapitelrubrik, Nästa sida och Föregående sida.

För att infoga sidnumret för den nuvarande sidan, placera markören där du vill ha sidnumret och välj Infoga Variabel Sida Sidnummer i menyraden. Sidnumret infogas vid markörens nuvarande plats.

För att infoga totalt antal sidor, placera markören där du vill ha variabeln och välj Infoga Variabel Sida Antal sidor i menyraden. Det total antalet sidor infogas.

För att infoga kapitelrubriken, placera markören där du vill ha variabeln och välj Infoga Variabel Sida Kapitelrubrik i menyraden. Kapitelrubriken infogas.

Genom att välja Infoga Variabel Sida Nästa sida i menyraden, infogas en referens till sidnumret efter nuvarande sida på markörens nuvarande plats.

På liknande sätt, genom att välja Infoga Variabel Sida Föregående sida i menyraden, infogas en referens till sidnumret före nuvarande sida på markörens nuvarande plats.

Sidnummer uppdateras dynamiskt medan dokumentet redigeras.

Det är ofta bäst att placera sidnummer i sidhuvud eller sidfot. Detta försäkrar att varje sida har ett sidnummer på lämpligt ställe.

## Kapitelrubrik

Du kan infoga kapitelrubriken var som helst i dokumentet genom att välja Infoga Variabel Sida Kapitelrubrik i menyraden.

&kword; avgör kapitelrubriken genom att börja söka överst på den nuvarande sidan. Det första stycket med stilen Rubrik 1 är kapitelrubriken. Om det inte finns några stycken på den nuvarande sidan, så gör &kword; samma sökning på tidigare sidor, till en kapitelrubrik hittas.

## Andra variabler

&kword; tillhandahåller andra ofta använda variabler som du kan finna användbara. Den här uppsättningen variabler är dokumentspecifik. Du kan infoga de här variablerna genom att välja Infoga Variabel Dokumentinformation i menyraden. Detta visar en lista med variabler. Variablerna beskrivs nedan.

Variabel | Exempel | Detaljinformation
Upphovsmannens namn | Sven Andersson | .
Stad | Göteborg | Staden som anges i rutan Dokumentinformation.
Företag | &kde; | Företagsnamnet som anges i rutan Dokumentinformation.
Land | Sverige | Landsnamnet som anges i rutan Dokumentinformation.
Katalognamn | /home/sven/kword | Det här är katalognamnet för dokumentet. Filnamnet ingår inte i katalognamn-variabeln.
Katalog och filnamn | /home/sven/kword/Resumé.kwd | Katalogen och filnamnet på den nuvarande filen.
Dokumentsammanfattning | Det här är en aktuell resumé. | Sammanfattningen av dokumentet som anges i rutan Dokumentinformation.
Dokumentnyckelord | Resumé, jobb, ansökan | Dokumentets nyckelord som anges i rutan Dokumentinformation.
Dokumentrubrik | Min resumé. | Dokumentets rubrikrad som anges i rutan Dokumentinformation.
Dokumenttitel | Min resumé | Dokumentets titel som anges i rutan Dokumentinformation.
E-post | sven@kde.org | E-postadressen för författaren som den anges i rutan Dokumentinformation.
Fax | Vilket giltigt telefonnummer som helst | Telefaxnumret som anges i rutan Dokumentinformation.
Filnamn | Resumé.kwd | Filens fullständiga namn.
Filnamn utan filändelse | Resumé | Filnamnet utan filändelsen (oftast .kwd).
Initialer | JCU | Initialerna som anges under författare i rutan Dokumentinformation.
Postnummer | Vilket giltigt postnummer som helst | Postnumret som anges i rutan Dokumentinformation.
Gata | Kungsgatan 123 | Gatuadressen som anges i rutan Dokumentinformation.
Telefon (arbete) | Vilket giltigt telefonnummer som helst | Telefonnumret som anges i rutan Dokumentinformation.
Telefon (hem) | Vilket giltigt telefonnummer som helst | Telefonnumret som anges i rutan Dokumentinformation.
Titel | Direktör informationssystem | Titeln som anges under författare i rutan Dokumentinformation.

Dessutom finns ett flertal variabler i undermenyn Statistik för att infoga antal ord, rader, ramar, etc. Variablerna bör vara självförklarliga.

Oinitierade variabler syns som <ingen>, till du definierar deras värde i rutan Dokumentinformation.

## Egna variabler

&kword; har många fördefinierade variabler. Du kan stöta på dokument där det vore trevligt att definiera egna variabler för dokumentet.

Du kan skapa ett obegränsat antal variabler för varje dokument, med användning av egna variabler.

### Skapa en ny egen variabel

För att skapa en ny egen variabel, placera markören på platsen i dokumentet där den nya variabeln ska läggas till.

Välj Infoga Variabel Egen Ny i menyraden. Det visar en dialogruta.

Skriv in variabelnamnet och dess nuvarande värde i kombinationsrutan som tillhandahålls.

Klicka på Ok för att skapa det nya variabelnamnet och infoga det på markörens nuvarande plats. Klicka på Avbryt för att avbryta och inte skapa en ny variabel.

Det är nu möjligt att infoga den här nya variabeln på vilket ställe som helst i dokumentet.

### Redigera värdet för en egen variabel

För att variabler ska vara användbara, måste du kunna ge dem ett värde, och lätt kunna ändra värdet. För att ändra värdet på en variabel:

Välj Verktyg Egna variabler... i menyraden. Detta visar en dialogruta.

Varje egen variabel har en rad i den här tabellen. Den första kolumnen är namnet på variabeln, och den andra kolumnen är värdet.

För att ändra värdet på en variabel, klicka helt enkelt i textrutan till höger om variabelnamnet. Skriv in önskat värde.

När alla ändringar är klara, klicka helt enkelt på Ok och alla variabler uppdateras.

### Infoga en egen variabel

För att infoga en ny egen variabel, välj Infoga Variabel Egen i menyraden. Den egna variabeln listas i undermenyn. Klicka på variabelns namn så infogar &kword; den, med dess nuvarande värde, på markörens plats.

## Uppdatera alla variabelvärden

Du kan tala om för &kword; att alla variabelvärden ska uppdateras (för att vara säker på att alla variabler sätts till sina nuvarande värden). Det här är särskilt viktigt för datum och tider.

Välj helst enkelt Infoga Variabel Uppdatera alla variabler i menyraden.

## Uppdatera ett datum- eller tidsvariabelvärde

Du kan tala om för &kword; att ett enda datum- eller tidsvärde ska uppdateras, och lämna övriga orörda.

Placera helt enkelt markören på variabeln som du vill uppdatera, och klicka med höger musknapp. Välj alternativet Ändra variabel till. En liten meny visas, som anger flera nya formateringsalternativ för datum eller tid, och alternativet att antingen ändra datum eller tid till fasta eller variabla format. Välj helt enkelt det nya alternativet, så uppdateras den här variabeln.