Arbeta med Arbortext Övningsuppgift DITA (PM01) 2 – KIT

Uppgiften  Ett dokument enligt DITA standard, använd DITA map (ej BookMap)  Lämna in som: renderad PDF hela filstrukturen som ZIP  Praktisera två typiska uppgifter: – Tagga befintlig information – Skapa helt ny information 3 – KIT

Skrämmande?  DITA = ~200 element  Arbortext har mängder med menyer  OK, det är inte som MS Word, men... – Arbortext Editor vägleder – ”Standard” fungerar bra ...och, ditt ”dokumentet” är läsbart även år 2060 när du går i pension 4 – KIT

Notepad eller Arbortext? Notepad (Anteckningar) Arbortext Editor Skapa och modifiera XML- filer enligt DITA ja Rendera PDFnejja Rendera HTMLnejja Vägledning i skapandet / modifieringen nejja Hjälpfil för DITAnejja 5 – KIT

Bild  Använd valfritt verktyg  För uppgift tagga befintlig information: 1. PDF view 2. PrtScn 3. File new, paste 4. Beskär 5. Spara som PNG  För egna bilder: Illustrator/PowerPoint/Word/Visio, spara som bitmap 6 – KIT

Rendera för web / PDF  File  Publish  For Web  File  Publish  PDF File  Snabbkontroll: File  Print Preview  I XML/DITA-miljö finns det i princip inget page-break 7 – KIT

Några menykommandon  Visa lista på tillåtna element: Tryck Retur  View  Document map eller Edit View  Edit  Resolved Document  View  Full tags  Tools  Check Completeness  Tools  Preferences för språk, mm 8 – KIT

Exempel på dokumentations- utmaning   Samordna granskningsflöden i de olika projekteringsstegen, både mellan leverantörer och SKB...  Under ledning av CAD-samordnaren utveckla och implementera dokument- och informationshanteringssystem, rutiner och mallar samt samordning inom projektet. Då projektet kommer fortgå under många år kommer detta att vara en kontinuerlig arbetsuppgift där övergång till elektroniska dokument eftersträvas och genomförs i samarbete med leverantörer och övriga SKB 10 – KIT

On-line DITA editor  Bara exempel, använd inte..., kan inte spara...  Internet Explorer och Firefox (tveksamt)  registrera dig 11 – KIT

Bada för att bli ren  ”Bada med syfte att bli ren”  Är det controlled language?  Rimlighetstesta mot – KIT

Element och attribut  Element   Har en start-tag och slut-tag  Attribut ger mer information för ett element  Exempel attribut till  href=”graphics/fig3.png”  Modify attributes:  Ställ dig vid start-tag  Välj Edit > Modify Attributes, eller  Tryck Ctrl + D. 13 – KIT

Steps och substeps  Ja, i 2 nivåer 14 – KIT

Hazards – warnings and cautions  Danger: Människan dör eller blir allvarligt skadad  Warning: Människan kan dö, eller bli allvarligt skadad  Caution: Människan kan bli mindre skadad  Notice: Maskinen kan bli skadad  Finns en del andra nivåer:  attention, important, etc. 15 – KIT

Hazardstatement  Arbortext Editor har symbol och layout för kombinerad ANSI + OSI standard 16 – KIT

Länkar  Länka till:  element i aktuellt topic  annat topic  element i annat topic  Internet  En länk kräver ID på länkobjektet  Finns inget ID ger Arbortext Editor hjälp när du ska sätta attributet href=”xxx”  Länka i löptext genom  Länklista sist i topics genom 17 – KIT

Länk inom samma topic 18 – KIT Häll i vatten. Om du har utfört steg 1 mÃ¥ste du även tappa ur vattnet, sÃ¥vida ingen annan ska bada i samma vatten.

Länk till annan topic 19 – KIT Kapitel 2: Ett exempel pÃ¥ en instruktion: Byte av bromsbackar. Kapitel 3 : Ett exempel pÃ¥ en instruktion: Byte av glödlampa i armatur. Kapitel 4: Ett exempel pÃ¥ en beskrivning: Min mobiltelefon.