DITA

Topic  Topic är grundtypen i DITA. Från den är topics specialiserade i tre varianter: Concept, Task, och Reference.  Alla DITA topics delar en gemensam struktur som inkluderar ID-attribut, titel och body.

Varför strukturera topics beroende på informationstyp?  Meningen är att läsaren direkt ska förstå syftet med den  för att hjälpa dem förstå något  för att hjälpa dem utföra något  för att ge tilläggsinformation

Vilka element finns i de olika topics? Beroende på behov. Exempel: Topics Element

Concept  Concept är rotelementet för en topic som svarar på frågan ”vad är?”.  Concept topics ger bakgrundsinformation som behövs för att man ska kunna jobba med en produkt på rätt sätt.

Struktur på Concept  Concept är den enklaste specialiseringen av DITA.  Concept kan inkludera paragrafer, listor, och andra element så väl som sektioner och exempel.  Elementet har få begränsningar vad gäller användandet av subsections och exempel.

Exempel på Concept topic Operation of pump The lubricating pump is a hydraulically operated piston pump with electric control. The metered amount of oil is determined by electrically altering the pump’s working frequency. The lubricating pump is made up of blocks. The pump consists of one main block with 1-2 auxiliary blocks connected to it (depending on the number of the booms). The main block and each auxiliary block have their own lubrication monitoring switch. Electric control is for the main block only. Monitoring is always activated when operating voltage is switched on. Element Topic

Concept

<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> Operation of pump The lubricating pump is a hydraulically operated piston pump with electric control. The metered amount of oil is determined by electrically altering the pump’s working frequency. The lubricating pump is made up of blocks. The pump consists of one main block with 1-2 auxiliary blocks connected to it (depending on the number of the booms). The main block and each auxiliary block have their own lubrication monitoring switch. Electric control is for the main block only. Monitoring is always activated when operating voltage is switched on.

Task  Tasks är byggblock för att skapa information i procedurform.  En task topic innehåller steg-för-steg- instruktioner som beskriver vad som ska göras och i vilken ordning.  Task topic inkluderar sektioner för att beskriva sammanhang, förutsättningar och förväntade resultat.

Struktur på Task  är huvudelementet i en task topic.  Elementet har en specifik struktur, med några valbara men inte obligatoriska element i följande ordning:,,,, och.  Varje i aktiviteten måste innehålla ett element som beskriver exakt vad användaren måste göra för att fullfölja sin uppgift.

Exempel på Task topic Checking the operation of dosers Check the operation of the dosers approximately one month after system start-up and then at intervals determined by the operating conditions, but not less often than every 6 months. Check for potential excessive or insufficient lubrication and adjust the dosers when necessary. Check procedures 1. Disconnect the lubrication pipes and hoses from the lubrication points. 2. Pressurise the line. 3. Check that the lubricant flows from the lubricant pipes and hoses. 4. Reconnect the lubrication pipes and hoses to the lubrication points. If no lubricant flows from the lubrication pipes or hoses, see the section Troubleshooting. Topic Element

Task i Arbortext

Task som text Checking the operation of dosers Check the operation of the dosers approximately one month after system start-up and then at intervals determined by the operating conditions, but not less often than every 6 months. Check for potential excessive or insufficient lubrication and adjust the dosers when necessary. Disconnect the lubrication pipes and hoses from the lubrication points. Pressurise the line. Check that the lubricant flows from the lubricant pipes and hoses. Reconnect the lubrication pipes and hoses to the lubrication points. If no lubricant flows from the lubrication pipes or hoses, see the section Troubleshooting.

Reference  Reference används för att presentera strikt strukturerad data som snabbreferens.  Reference kan innehålla allt som har någorlunda konstant innehåll, så som kommandon, litteraturlistor och kataloger.  Denna information är endast som tillägg till den aktivitet användaren måste utföra.

Struktur på Reference  Huvudinnehållet i en reference är  Reference begränsar innehållet till tabeller, listor med egenskaper, syntaxsektioner och allmänna sektioner och exempel.

Exempel på Reference topic Operation temperatureNLGI gradeExample Below 0 °C00Shell Grease Centra W Mobil Chassis LBZ Esso Fliessfett S 420 (EGL 3818) Above 0 °C2Shell Retinax EP2 Mobil HP222 Esso Beacon EP2 Recommended lubricants Use the recommended lubricants or corresponding products from other manufacturers. Topic Element

Reference i Arbortext

Reference som text Lubricants Recommended lubricants Use the recommended lubricants or corresponding products from other manufacturers. Recommended lubricants Operation temperature NLGI grade Example

Reference som text forts. Below 0°C 00 Shell Grease Centra W, Mobil Chassis LBZ, Esso Fliessfett S 420 (EGL 3818) Above 0°C 2 Shell Retinax EP2, Mobil HP222, Esso Beacon EP2

Hur gör man? 1.Identifiera vilka task topics som behövs – baserat på användarens behov 2.Identifiera vilka concept och reference topics som behövs för att stödja dessa 3.Skapa, strukturera och publicera (≈ TOCs, playlists)

Bra topics 1.De använder rubrik (title) syntax för att beskriva informationstyp 2.De undviker att blanda informationstyper 3.De fungerar som ett nav, och pekar på relaterade topics (om behov finns) 4.De fokuserar på en användarfråga

Mer information  DITA Infocenter:  DITA Users:  DITA xml.org: