Skriftlig Info ➜ DITA-publisering ➜ DITA variabler ➜ Sette inn en variabel fra en topic map

Sette inn en variabel fra en topic map

Enhver variabel definert i et emnekart (topic map) kan brukes i et tekstfragment i topics og andre biblioteker.

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

På denne siden

Forutsetninger

Du har alle verktøy tilgjengelig, og rettigheter til å utvikle nytt innhold.

Du må vite det riktige navnet på variabelen. Merk at dette navnet skiller mellom store og små bokstaver.

Kontekst

Du kan sette inn en variabel fra en topic map på en av følgende måter:

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.

Tips

For å identifisere emnekartet jeg bruker til å definere variabler, og gjøre det lettere å finne, omtaler jeg det som et "keymap". Dette er ikke en standard DITA-betegnelse. I databasesystemet ditt foreslår jeg at du oppretter "Keymap" som en map-type i metadataene dine. Unik identifisering gjør at emnekartene med variabeldefinisjoner er enklere å finne.

Prosedyre

  1. Sjekk ut topic'en eller biblioteket som du vil sette variabelen inn i.
  2. Plasser markøren i ønsket posisjon i teksten.
  3. Slik kopierer du variabelen fra en annet topic eller bibliotek:
    1. Åpne topic'en eller biblioteket som du kan kopiere <keyword>-element.
    2. Kopier <keyword>-elementet og lim det inn i din egen tekst.

      Variabelens verdi (innhold) er ikke viktig. Riktig definerte verdi blir automatisk satt inn når dokumentet publiseres.

  4. Slik setter du inn variabelen manuelt:
    1. Opprett et <keyword> element.
    2. Endre keyref-attributtet slik at det inneholder riktig variabelnavn.

      Du må bruke riktig navn. Merk at dette navnet skiller mellom store og små bokstaver.

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.