Writing DITA content with OxygenXML
Technical documentation is no longer tied to a specific software, editor, or platform. Thanks to standards such as DITA XML (Darwin Information Typing Architecture), you can develop modular content that you can also reuse, filter and publish to various channels and formats.
DITA is no stranger to technical writers and information architects, and has now come to be more widely recognised since the emergence of GenAI.
But how do you actually use DITA? Which information types should you use in which situation? How can you write in a way that is so independent of layout and presentation?How do you combine DITA topics into a DITA map? What about conditional content?
In this hands-on course, you'll learn how to use DITA in practice.
Prerequisite: Structured Writing.
Time:
2 days.
Practical information
Language:
Dutch, English, French
Focus:
Technology, Writing
Topic:
Dita XML
Software:
XML-editor
Modality:
Flow office, In-house, Online
What will you learn
how to write your own DITA topics in OxygenXML
DITA: what it is and where it comes from
key features of DITA XML
XML basics (elements, attributes, schemas and DTDs)
information types (task, concept and reference)
information units (topic, map and bookmap)
creating, opening, editing, validating and saving topics
cross-references and relationship tables
creating a DITA map
conditional publishing with ditaval and attribute filtering
tables
graphics
content reuse with content references (conrefs) and key references (keyrefs)
Who is this coaching for?
Perfect for you if you...
are a technical writer and want to work efficiently with DITA and Oxygen XML
are heavily involved in technical documentation, for example as:
information architect
content manager
product owner
product manager
support specialist
DevOps manager
business analyst
process manager
compliance officer
Maybe think again if...
aren’t yet sure whether you want to get started with DITA; for that, there’s ‘DITA in a nutshell’
haven’t yet got the hang of Structured Writing.
Who delivers this course?
Yves is a pioneer in structured writing and DITA.
He is co-director of Flow and a passionate trainer with over 30 years’ experience in technical communication. He has guided teams through content audits, DITA implementations, information architecture, templates, coaching and training, on projects for clients including Toyota Motor Europe, Picanol, DAF Trucks and Barco. He also shares his expertise as a speaker at industry conferences and events, such as DITA Europe, tcworld, Adobe events and other technical communication conferences. Yves is an Adobe-Certified FrameMaker Instructor.
Yves
