1 / 16

Getting started with DITA: Information modeling with DITA maps

Getting started with DITA: Information modeling with DITA maps. Ian Larner User Technologies, IBM Hursley Lab, England Ian_larner@uk.ibm.com. Title slide. IAWB Roles and Goals modelling. IAWB: Task-based UA model (DITA). Topic type picker. Visualization. File | New DITA map. Tasks.

earl
Download Presentation

Getting started with DITA: Information modeling with DITA maps

An Image/Link below is provided (as is) to download presentation Download Policy: Content on the Website is provided to you AS IS for your information and personal use and may not be sold / licensed / shared on other websites without getting consent from its author. Content is provided to you AS IS for your information and personal use only. Download presentation by click this link. While downloading, if for some reason you are not able to download a presentation, the publisher may have deleted the file from their server. During download, if you can't get a presentation, the file might be deleted by the publisher.

E N D

Presentation Transcript

  1. Getting started with DITA: Information modeling with DITA maps Ian Larner User Technologies, IBM Hursley Lab, England Ian_larner@uk.ibm.com Title slide

  2. IAWB Roles and Goals modelling

  3. IAWB: Task-based UA model (DITA)

  4. Topic type picker Visualization File | New DITA map Tasks Metadataproperties Reference Open maps Concepts Relationship table browser Properties table Outline Node assistant Relationship table editor Topic file status manager

  5. Modeling with maps • [<5] In IAWB, create a project • [<5] Create a map • [10] Add a simple topic reference • Nest topic references (inherent hierarchical relationships/linking) • [10] Work with properties and metadata • [10] Work with topic files (generate stub files) • [10] Work with relationship tables (extra related linking) • Summary (+get the complete sample if you want!)

  6. Have a go…

  7. Recap / summary

  8. DITA modelling (Maps and topic sets) • Model(define) user tasks and need for supporting topics … in DITA maps • Include model aspects of users, artifacts, ... as metadata (and topics?) • User goals and task topics, • Hierarchy, continuum (sequence, prereq task) • Supporting topics (concept, reference) • Topic hierarchy = hierarchy of references to topics • Metadata for user characteristics, artifacts, ... • Extra relationships between topics • Semantics and vocabulary • Stub templates for topics • ... Topics and maps for information development & delivery

  9. To Tg T C R T Example scenario Welcome CSH CSH CSH CSH SelectBlend Selectadditives Summary& Serve 3 “I want to get a tea, English Breakfast, milk, & 2 sugars” “I want to get a custom blend of coffee” Tea Maker / Coffee Maker 2 1 “I need to install the Tea Maker” 4

  10. Task model (roles and goals) for Beverage Maker

  11. DITA map common to all products

  12. Adapted info for Tea Maker and Coffee Maker

  13. Adapting information when presented to the user

  14. Making the information adaptable • Defined adaptability • In a DITA map • Information type (task, concept, ...) ... and its specialization/generalization • Topic metadata attributes - @audience, @platform, @product, @othermeta, @your_props • Topic metadata elements - audience, category, keywords, (Eclipse help criteria), ... • Topic set metadata - topic/@collection-type, map/topicmetadata • Relationships - Relationship tables, topicgroups, ... • In a DITA topic • Information type (task, concept, ...) ... and its specialization/generalization • Topic metadata attributes - @audience, @platform, @product, @othermeta, @your_props • Topic metadata elements - audience, category, keywords, (Eclipse help criteria), ... • Topic structure (prereq, context, steps, result) • Semantic elements • Element metadata attributes - @audience, @platform, @product, @othermeta, @your_props • Relationships - xrefs, related-links, conrefs, keyrefs...

  15. Where to get more • DITA articles: • http://xml.coverpages.org/dita.html • http://dita.xml.org/ • OASIS DITA Technical Committee: • http://www.oasis-open.org/committees/dita • DITA Open Toolkit: • http://dita-ot.sourceforge.net • Task Modeler (IAWB) • http://www.alphaworks.ibm.com/tech/taskmodeler

  16. Where to get more • "Design Patterns for Information Architecture with DITA Map Domains. Defining a Type for Collections of Topics." By Erik Hennum (Advisory Software Engineer, IBM), Don Day (Lead DITA Architect, IBM), John Hunt (User Assistance Architect, IBM), and Dave A. Schell (Chief Strategist and Tools Lead, IBM). • http://www-106.ibm.com/developerworks/xml/library/x-dita7/ • "Using DITA for Information Architecture." By Michael Priestley (IBM User Technologies). Presented at WritersUA 2005 Conference • http://xml.coverpages.org/DITA-PriestleyWinUA2005.ppt • “IBM Task Modeler basics” reuse of a presentation by John Hunt, on the Web site of the Silicon Valley DITA Interest Group • http://svdig.ditamap.com/

More Related