Skriftlig Info ➜ DITA-publisering ➜ DITA topics ➜ DITA Concept topic
Her er en den "offisielle" beskrivelsen fra Oasis (i min oversettelse):
Konsept-emner gir bakgrunn som hjelper leserne til å forstå viktig informasjon om et produkt, en oppgave, en prosess eller annen konseptuell eller beskrivende informasjon. Et konsept kan være en utvidet definisjon av en stor abstraksjon som en prosess eller funksjon. Konseptuell informasjon kan forklare arten og komponentene til et produkt og beskrive hvordan det passer inn i en produktkategori. Konseptuell informasjon hjelper leserne med å kartlegge kunnskapen og forståelsen sin til oppgavene de trenger å utføre og å gi annen viktig informasjon om et produkt, en prosess eller et system.
Oasis, "Concepts", docs.oasis-open.org, [REF]
Jeg velger å definere concept topic på denne måten:
En DITA Concept topic er en frittstående datamodul som inneholder multimodal tekst. Modulen har en tittel og nok informasjon til å formidle nødvendig informasjon om en oppgave, en prosess eller et annet tilsvarende konsept. Informasjonen skal støtte opp om forståelsen av de oppgavene som produktet utfører. En concept topic skal således formidle enklere beskrivelser som hjelper leseren med å forstå et produkts grunnleggende karakteristika, virkemåte og funksjoner.
På sett og vis kan du si at en concept topic gir leseren informasjon som det er "nødvendig å ha" for å forstå produktet. En reference topic formidler informasjon som det er "kjekt å ha". Dette er informasjon som leseren strengt tatt ikke trenger for å bruke produktet, men som er nyttig for de som ønsker mer detaljert informasjon. Det er du som må plassere informasjonen i en av de to kategoriene. Dette er det nyttig å diskutere i fagmiljøet for å etablere retningslinjer.
En concept topic er enkel å bruke fordi strukturen er åpen. Informasjonen kan presenteres med alle relevante DITA-elementer, med unntak av de som er spesifikke for task topic.
En DITA concept topic er strukturert som følger:
<title>
Alle concept topics skal ha en tittel.
<shortdesc>
Alle concept topics må ha en "short description" som definerer kontekst.
<prolog>
Dette elementet kan brukes for å legge inn indeks-informasjon. Indeks-informasjon kan forøvrig også legges inn andre steder i topic'en.
<conceptbody>
Dette elementet brukes for å samle all informasjonen i topic'en. Se Struktur for <conceptbody>.
Av disse elementene er det bare <title> og <conceptbody> som er obligatoriske.
Strukturen i <conceptbody> er åpen. De grunnleggende elementen kan plasseres i tilfeldig rekkefølge uten viktige begrensninger. Det er ikke hensiktsmessig å forklare alle elementene her. De vanligste elementene som brukes er:
<p>
<p> er en paragraf som kan inneholde en eller flere setninger. <p> kan legges rett inn under <conceptbody>.
<ul>
<ul> er en unummerert liste (Engelsk: unordered list), også kalt "bulletliste". Den kan inneholde en eller flere punkter. <ul> kan legges rett inn under <conceptbody>. <ul>-lister kan plasseres inni hverandre for å skape flere nivåer. Du kan også legge <ul>-lister inn i <ol>-lister og omvendt.
<ol>
<ol> er en nummerert liste (Engelsk: ordered list). Den kan inneholde en eller flere nummererte punkter. <ol> kan legges rett inn under <conceptbody>. <oul>-lister kan plasseres inni hverandre for å skape flere nivåer. Du kan også legge <ol>-lister inn i <uol>-lister og omvendt.
|
Det kan være fristende å bruke <ol>-elementet for å lage en nummerert liste, og deretter kalle dette en prosedyre. Dette er ikke tillatt, og det er et direkte brudd på hele filosofien som DITA representerer. Prosedyrer skal og må plasseres i task topics. Concept topics skal bare inneholde forklarende og beskrivende informasjon. |
Noen steder er det ønskelig bytte ut nummerne i listen med store eller små bokstaver, eller kanskje romertall. Dette gjøres ved hjelp av attributter, og må implementeres i stilarket. Generelt er det for eksempel lurt å bruke bokstaver når man skal henvise til detaljer i en illustrasjon. En liste med A, B, C osv kan ikke misforstås som en prosedyre.
<dl>
<dl> er en liste for å forklare terminologi, og brukes ofte for å liste opp valg i en meny. Den kan inneholde en eller flere termer. <dl> kan legges rett inn under <conceptbody>.
<div>
<div> brukes for å samle undeliggende elementer under et felles hovedelement. Dette er nyttig ved profilering og gjenbruk.
<section>
<section> brukes for å samle undeliggende elementer under et felles hovedelement. <section> kan ha en <title>, og elementet kan deles videre i <sectiondiv>- og/eller <div>-elementer. <section>-elementer kan ikke plasseres inni hverandre.
<example>
<example> brukes som navnet tilsier til å beskrive et eksempel.
Om ønskelig kan elementet <conbodydiv> også brukes for å samle informasjon. En <conbodydiv> har samme egenskaper som en et <conbody>-element. Bruken av <conbody> og <section> gjør at du kan samle informasjon som hører sammen. Dette kan være svært nyttig fordi eventuell profilering av et <conbodydiv>-element også vil gjelde alt som er inni. Du kan også bruke et slikt "samle-element" i et bibliotek for å gjenbruke mye informasjonen på en gang.
På tilsvarende måte kan <sectiondiv> og/eller <div> brukes inni <section>.
Det som er viktig med en concept task er den begrensningen som er tillagt <conbody>-elementet. Denne begrensningen virker på følgende måte:
Det kan høres ut som dette er en begrensning som vanskeliggjør bruken, men slik er det ikke. Faktisk er den ganske logisk. Hvis du for eksempel legger inn et <section>-element med en tittel, og inne i denne legger inn vanlig tekst, hvordan kan da leseren se at innholdet i <section>-elementet slutter og "annen" informasjon starter? Tittelen som brukes først i <section>-element vil jo gjelde all informasjon frem til neste tittel.
Her er et eksempel som beskriver en (svært) kort Concept topic.
<concept>
<title>Dette er den tittelen som vises i publikasjonens innholdsfortegnelse</title>
<shortdesc>Dette er den innledende teksten som definerer context</shortdesc>
<conbody>
<p>Brødtekst</p>
<section>
<title>Denne tittelen vises ikke i innholdsfortegnelsen, for concept topic'en har en flat struktur</title>
<p>Brødtekst</p>
<p>Brødtekst</p>
</section>
</conbody>
</concept>
Dette eksempelet forestiller en concept topic som inneholder en tittel, en enkelt setning (Brødtekst), og deretter en <section>med tittel og to setninger. Når du jobber i en XML-editor vil sjelden koden se slik ut. Du trenger heller ikke huske på hvilke elementer du kan bruke hvor, for det vil editoren hjelpe deg med.
Lage en ny DITA topic fra en mal
Lage en ny DITA topic ved å duplisere en eksisterende topic
Sette en topic inn i en topic map
Sette en topic inn i en bookmap
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.