200 likes | 419 Views
Arbeta med Arbortext. Övningsuppgift DITA (PM01). 2 – KIT209 2012-05-15. Uppgiften. Ett dokument enligt DITA standard, använd DITA map (ej BookMap) Lämna in som: • renderad PDF • hela filstrukturen som ZIP
E N D
Arbeta med Arbortext Övningsuppgift DITA (PM01) 2 – KIT209 2012-05-15
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 – KIT209 2012-05-15
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 – KIT209 2012-05-15
Notepad eller Arbortext? 5 – KIT209 2012-05-15
Bild Använd valfritt verktyg För uppgift tagga befintlig information:1. PDF view 2. PrtScn 3. File new, paste4. Beskär5. Spara som PNG För egna bilder:Illustrator/PowerPoint/Word/Visio, spara som bitmap 6 – KIT209 2012-05-15
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 – KIT209 2012-05-15
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 – KIT209 2012-05-15
Exempel på dokumentations-utmaning http://www.skb.se/Templates/Standard____34555.aspx Samordnagranskningsflö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 – KIT209 2012-05-24
On-line DITA editor Bara exempel, använd inte..., kan inte spara... Internet Explorer och Firefox (tveksamt) http://www.ditastorm.com, registrera dig 11 – KIT209 2012-05-24
Bada för att bli ren ”Bada med syfte att bli ren” Är det controlled language? Rimlighetstesta mothttp://translate.google.se 12 – KIT209 2012-05-24
Element och attribut Element <image> Har en start-tag och slut-tag Attribut ger mer information för ett element Exempel attribut till <image> href=”graphics/fig3.png” Modify attributes: Ställ dig vid start-tag Välj Edit > Modify Attributes, eller Tryck Ctrl + D. 13 – KIT209 2012-05-24
Steps och substeps Ja, i 2 nivåer 14 – KIT209 2012-05-24
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 – KIT209 2012-05-24
Hazardstatement Arbortext Editor har symbol och layout för kombinerad ANSI + OSI standard 16 – KIT209 2012-05-24
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 <xref> Länklista sist i topics genom <link> 17 – KIT209 2012-05-24
Länk inom samma topic <steps> <step><cmd id="insertWater">Häll i vatten.</cmd></step> </steps> <result></result> <example></example> <postreq>Om du har utfört <xref id="insertWater">steg 1</xref> mÃ¥ste du även tappa ur vattnet, sÃ¥vida ingen annan ska bada i samma vatten.</postreq> 18 – KIT209 2012-05-24
Länk till annan topic <li><p>Kapitel 2: Ett exempel pÃ¥ en instruktion: Byte av bromsbackar.</p></li> <li><p><xref format="dita" href="ByteAvGlodlampaIVardagsrum.dita“ scope="local" type="task">Kapitel 3</xref>: Ett exempel pÃ¥ en instruktion: Byte av glödlampa i armatur.</p></li><?Pub Caret 1?> <li><p>Kapitel 4: Ett exempel pÃ¥ en beskrivning: Min mobiltelefon.</p></li> 19 – KIT209 2012-05-24