En topic settes inn i en topic map ved å bruke elementet <chapter>. Dette elementet har en attributt href som peker på topic'ens GUID-identifisering. En forenkling av dette ser slik ut:

<chapter href="GUID"></chapter>

Det er to måter å gjøre dette på:

Bruk editorens dialogboks
Legg inn et <chapter>-element manuelt og kopier objektets GUID-identifikasjon inn i href-attributten.

Det som er spesielt i DITA er altså at vi ikke har noen dedikerte "kapittel"- eller "avsnitt"-elementer, vi har bare de topic'ene du lager. At en topic endrer egenskap fra <topic> til <chapter> når du legger det inn i øverste nivå i bookmap er kun for å illustrere den tradisjonelle bokstrukturen. Det er like fullt et emne. Strukturen bygger du ved å sette emner inne i hverandre.

Prosedyre

Bruk editorens dialogboks:
1. Plasser cursor der hvor du ønsker å sette inn topic'en.
2. Fra editorens hovedmeny, velg DITA ➜ Insert topic reference.
3. I dialogboksen som åpnes, sett Reference type til Chapter.
4. På høyre side av dialogen, klikk det grønne ikonet for å åpne databasen.
5. I databasen, let frem den topic'en du vil sette inn.
6. Når du har funnet den, dobbelt-klikk for å velge den inn.
7. Klikk Insert and close.
Legg inn et <topicref>-element manuelt:
1. Finn topic'en du ønsker å sette inn, og kopier GUID-identifikatoren for den.
  
  Du kan hente GUID-identifikatoren fra topic'ens Properties-dialog. Hvis du har lagt GUID-identifikatoren inn i en kommentar øverst i topic'en kan du hente det fra en forhåndsvisning. Du kan eventuelt åpne topic'en for å se etter.
2. Plasser cursor der hvor du ønsker å sette inn topic'en.
3. Trykk Enter-tasten på tastaturet, og velg <chapter> på listen over elementer.
4. Klikk på start-taggen i <chapter>-elementet, trykk deretter Alt-Enter for å hente inn attributtene.
5. Velg href.
6. Kopier inn GUID-identifikatoren.
7. Klikk OK.
Observer at <chapter>-elementet nå vises med topic'ens GUID-identifikator.
Anbefalt: Før du avslutter, gjør følgende:
1. Klikk på det lille ikonet som vises på venste side i <chapter>-elementet.
  
  Topic'en åpnes i editoren.
  
  Verifiser at du har hentet inn riktig topic.
2. Kopier de to kommentarene du la inn da du laget topic'en, og legg dem inn over <chapter>-elementet i topic map.
Slik:
```
<comment>Topic'ens metadata tittel</comment>
<comment>Topic'ens GUID-identifisering</comment>
<chapter href="GUID">(GUID-identifisering vises her)</chapter>
```
Kommentarene forteller deg alltid hvilken topic du har hentet inn og plassert her. Hvis du skal kopiere <chapter>-elementet til et annet sted, husk å ta med de to kommentarene også.

Du kan ikke kopiere <chapter>-elementer inn i relasjonstabeller (relationship tables)!

Relaterte konsepter

Om DITA emner (topics)

Innhold og struktur i en topic

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.

2022-11-29