Definere en variabel i et DITA bibliotek

Du kan bruke et bibliotek (library topic) til å definere variabler og gi dem de nødvendige verdiene.

(Denne prosedyren er basert på Tridion Docs database og Oxygen XML redigeringsprogram. Andre verktøy har tilsvarende funksjonalitet.)

På denne siden

Forutsetninger
Kontekst
Prosedyre

Forutsetninger

Du har alle verktøy tilgjengelig, og rettigheter til å utvikle nytt innhold. En passende mappe er tilgjengelig i databasestrukturen.

Kontekst

Biblioteket du skal lage nå kan bare brukes til å definere variabler. Du kan ikke bruke det samme biblioteket for både variabler og tekstfragmenter.

Du kan lage et nytt bibliotek på en av følgende måter:

Du kan duplisere et eksisterende bibliotek og endre variabeldefinisjonene og/eller verdiene.

Dette eksisterende biblioteket inneholder allerede de riktige variablene, men de har feil verdier.
Du kan definere variablene ved hjelp av en bibliotek-mal.
Malen inneholder forhåndsdefinerte variabler, men ikke nødvendigvis de variablene du trenger. Du må også tilordne de riktige verdiene.
Du kan lage et nytt bibliotek fra bunnen av og manuelt skrive inn de nødvendige elementene og attributtene.

Dette biblioteket er i utgangspunktet tomt.

I beskrivelsene, prosedyrene og eksemplene bruker jeg <keyword>-elementet. I mange DITA-systemer kan du også bruke andre elementer. Elementene må være definert i systemfilene som styrer publiseringssystemets funksjonalitet. Ta kontakt med systemleverandøren din for mer informasjon om dette.

Jeg vil anbefale at dere standardiserer på bruken av <keyword>-elementet for variabler. Selv om det er tillatt på bruke andre elementer er det lettere å være konsekvent. Dette øker forståelsen i teamet, og letter vedlikeholdet. Spesielt nye brukere vil lettere kunne identifisere hva som er variabler og hva som ikke er.

Prosedyre

Fra editorens hovedmeny, velg Tridion Docs ➜ Browse repository.
I databasestrukturen, naviger til den folderen hvor du ønsker å etablere et nytt bibliotek.
For å duplisere et eksisterende bibliotek:
1. Høyreklikk på en av de eksisterende bibliotekene og velg Duplicate.
  En kopi av det eksisterende biblioteket blir etablert.
2. Høyreklikk på det nye biblioteket, og velg Properties.
  Pass på at du gjør dette med det nye biblioteket! Du må ikke endre det gamle!
3. I dialogboksen som åpnes, fyll ut alle relevante felt med metadata.
  
  Følg reglene for metadata. Identifiserer det nye biblioteket slik at det tydelig fremgår at det brukes til å definere variabler.
4. Klikk OK.
5. Velg det nye biblioteket, høyreklikk og velg Check out.
6. Angi ny verdier.
  
  Taggene ser slik ut:
```
<keyword varref="VARIABLE">
   VALUE
</keyword>
```
7. Velg Tridion Docs ➜ Check in når du er ferdig.
For å definere variablene ved hjelp av en bibliotek-mal:
1. På høyre verktøylinje, klikk det grønne +-symbolet for å hente frem relevante maler.
2. Velg ønsket mal.
3. I dialogboksen som åpnes, fyll ut alle relevante felt med metadata.
  
  Følg reglene for metadata. Identifiserer det nye biblioteket slik at det tydelig fremgår at det brukes til å definere variabler.
4. Klikk OK.
5. Velg det nye biblioteket, høyreklikk og velg Check out.
6. Definer de nødvendige variabeldefinisjonene ved å endre varid-attributtene og angi nye verdier.
  
  Taggene ser slik ut:
```
<keyword varref="VARIABLE">
   VALUE
</keyword>
```
7. Velg Tridion Docs ➜ Check in når du er ferdig.
For å lage et nytt bibliotek fra bunnen av:
1. På høyre verktøylinje, klikk det grønne +-symbolet for å hente frem relevante maler.
2. Velg en mal for et tomot bibliotek.
3. I dialogboksen som åpnes, fyll ut alle relevante felt med metadata.
  
  Følg reglene for metadata. Identifiserer det nye biblioteket slik at det tydelig fremgår at det brukes til å definere variabler.
4. Klikk OK.
5. Velg det nye biblioteket, høyreklikk og velg Check out.
6. Legg inn et <p>-element.
7. Inni <p>-elementet, legg inn et <keyword>-element.
8. Definer variabelen ved å sette varid-attributten, og angi ønsket verdi.
  
  Taggene ser slik ut:
```
<p>
<keyword varref="VARIABLE">
   VALUE
</keyword>
</p>
```
9. Gjenta (f), (g) og (h) for å definere flere variabler.
10. Velg Tridion Docs ➜ Check in når du er ferdig.

Tips

Vurder å bygge et modulært system med variabeldefinisjoner. Dette tillater gjenbruk av definisjoner og verdier, og gir en høy grad av konsistens.

På disse sidene forklares bare hvordan variabler brukes i DITA-publisering. Hvis du ønsker utfyllende forklaringer rundt prinsippet med variabler, se under Metodikk og spesielt Bruk av variabler i teksten.

Alle eksterne linker åpner i et nytt vindu. Jeg tar ikke ansvar for informasjon på eksterne nettsteder, selv om jeg har linket til dem. Vennligst rapporter linker som ikke virker.

Informasjonen på denne siden representerer mine personlige meninger, og min egen forståelse av temaet som beskrives. Du kan gjerne linke til siden, men ikke kopiere større deler av innholdet uten tillatelse. Jeg tar ingen ansvar for eventuelle feil, misforståelser eller manglende informasjon om omfattende temaer. Jeg tar heller intet ansvar for feil du måtte gjøre eller forårsake som et resultat av feilaktig eller manglende informasjon. Du kan gjerne bidra med kommentarer, egner erfaringer eller utfyllende informasjon. Se Kontaktinformasjonen.