# 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 hör till. 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 här visar 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:

Enligt land

- Det här infogar datumet med formatet som anges i Inställningscentralen.

  För att välja det här alternativet, försäkra dig helt enkelt att den övre kombinationsrutan lyder Enligt land. En förhandsgranskning av datumet syns under kryssrutan Egen. Om du är nöjd, klicka på Ok.

Förformaterade datumsträngar

- &kword; levereras med 12 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 under kryssrutan Egen. 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 03/06/2002

  och

  MMMM d, yyyy blir March 6, 2002

  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.

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

### 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 t (fast).

Det här visar en dialogruta.

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

Enligt land

- Det här infogar tiden med formatet som anges i Inställningscentralen.

  För att välja det här alternativet, försäkra dig helt enkelt att den övre kombinationsrutan lyder Enligt land. En förhandsgranskning av tidsformatet syns under kryssrutan Egen. Om du är nöjd, klicka på Ok.

Förformaterade tidssträngar

- &kword; levereras med 5 fördefinierade tidsträ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 under kryssrutan Egen. 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

  FM/EM

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

  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 am

  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.

## Sidnumrering

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

Det finns två variabler som har med sidnummer att göra: Sidnummer och Antal sidor.

För att infoga det nuvarande sidnumret, placera markören där du vill ha sidnumret och välj Infoga Variabel Sidnummer i menyraden. Sidnumret infogas på 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 Antal sidor i menyraden. Det totala antalet sidor infogas.

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.

## 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 Egenskap i menyraden. Detta visar en lista med variabler. Variablerna beskrivs nedan.

Variabel | Exempel | Beskrivning
Filnamn | Resumé.kwd | Infogar dokumentets filnamn.
Katalognamn | /home/mmcbride/kword | Det här är katalognemnet för dokumentet. Filnamnet ingår inte i katalognamn-variabeln.
Upphovsmannens namn | Mike McBride | Namnet på författaren som det anges i rutan Dokumentinformation.
E-post | mpmcbride7@yahoo.com | E-postadressen för författaren som den anges i rutan Dokumentinformation.
Företagsnamn | KDE | Företagsnamnet som anges i rutan Dokumentinformation.
Katalog och filnamn | /home/mmcbride/kword/Resumé.kwd | Katalogen och filnamnet på den nuvarande filen.
Filnamn utan filändelse | Resumé | Det här tar bort filnamnets filändelse (oftast .kwd) från filnamnet.
Telefon | Vilket giltigt telefonnummer som helst | Telefonnumret som anges i rutan Dokumentinformation.
Fax | Vilket giltigt telefonnummer som helst | Telefaxnummret som anges i rutan Dokumentinformation.
Land | Sverige | Landsnamnet som anges i rutan Dokumentinformation.
Dokumentets titel | Min resumé | Dokumentets titel som anges i rutan Dokumentinformation.
Dokumentsammanfattning | Det här är en aktuell resumé. | Sammanfattningen av dokumentet som anges i rutan Dokumentinformation.
Postnummer | Vilket giltigt postnummer som helst | Postnumret som anges i rutan Dokumentinformation.
Stad | Göteborg | Staden som anges i rutan Dokumentinformation.
Gata | Kungsgatan 123 | Gatuadressen som anges i rutan Dokumentinformation.

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änding 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 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.

Från början när du skapar en ny variabel, så har den inte ett värde. &kword; infogar en platsmarkör (<inget värde>) i dokumentet för att markera variabelns plats. Så fort du redigerar värdet av en egen variabel, så ersätter &kword; platsmarkören med det nya värdet.

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 du måste lätt kunna ändra värdet. För att ändra värdet på en variabel (eller ge den ett initialvärde):

Välj Infoga Variabel Egen 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 ändrigar ä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 och &kword; infogar 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. 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 vairabla format. Välj helt enkelt det nya alternativet, så uppdateras den här variabeln.

## Expressions

Expressions are a way to quickly insert common phrases into a document. Once an expression has been selected, the text is inserted into &kword;.

Expressions are different from variables. Expressions are inserted as regular text, and can only be changed later by manually editing the text. Variables, insert a placeholder in the document which can be updated at a later date.

## Using expressions

To use an expression could not be easier.

Simply place the cursor at the location you want the expression inserted and select Insert Expression from the menubar. This will give you a submenu with groups of expressions. Select the group that is appropriate for your expression. This will bring up a list of expressions available to you. Select the appropriate expression.

Once selected, that expression will be inserted at the cursor position.

## Add new expressions

Adding an expression is accomplished by selecting Tools Edit personal expressions from the menubar. This will bring up a dialog box.

The drop down box at the top shows you what group the current expression list is from. Custom is the group name in the example above

You will need to create a new group the first time you want to add a new expression. &kword; will not allow the user to edit or remove any predefined expressions.

The left side of the dialog box lists all the available expressions for that group. There are no expressions yet in the example above.

You manipulate the expressions with the six buttons to the right.

Add group

- Click this button to add a new expression group.

Delete Group

- Deletes the currently selected group and all the expressions within the group.

Rename Group

- Changes the name of the currently selected group.

Add new expression

- Click this button and a small dialog box appears. Enter your expression in the dialog box. Click OK. The expression is now part of the current group.

Delete expression

- Removes the currently selected expression.

Rename expression

- Changes the contents of the currently selected expression.

When you are satisfied with all your changes, click OK.

Click Cancel to abort changes.

## Document Links

## Document Comments