Download - DITA 1.3: What's New and Different
![Page 1: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/1.jpg)
DITA 1.3: What's New And
Different
A quick guide to the new and cool stuff coming in DITA 1.3
Contrext, LLC 1
Eliot KimberContrext, LLC
DCL Webinar 2 Nov 2014
![Page 2: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/2.jpg)
First A Bit About DCL
• The next few slides introduce Data Conversion Laboratory
Contrext, LLC 2
![Page 3: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/3.jpg)
Valuable Content Transformed
• Document Digitization
• XML and HTML Conversion
• eBook Production
• Hosted Solutions
• Big Data Automation
• Conversion Management
• Editorial Services
• Harmonizer
![Page 4: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/4.jpg)
Experience the DCL Difference
DCL blends years of conversion experience with cutting-edge technology and
the infrastructure to make the process easy and efficient.
• World-Class Services
• Leading-Edge Technology
• Unparalleled Infrastructure
• US-Based Management
• Complex-Content Expertise
• 24/7 Online Project Tracking
• Automated Quality Control
• Global Capabilities
![Page 5: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/5.jpg)
We Serve a Very Broad Client Base . . .
![Page 6: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/6.jpg)
. . . Spanning All Industries
• Aerospace
• Associations
• Defense
• Distribution
• Education
• Financial
• Government
• Libraries
• Life Sciences
• Manufacturing
• Medical
• Museums
• Periodicals
• Professional
• Publishing
• Reference
• Research
• Societies
• Software
• STM
• Technology
• Telecommunications
• Universities
• Utilities
![Page 7: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/7.jpg)
DITA 1.3: What's New And
Different
A quick guide to the new and cool stuff coming in DITA 1.3
Contrext, LLC 7
Eliot KimberContrext, LLC
DCL Webinar 2 Nov 2014
![Page 8: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/8.jpg)
About the Author
• Independent consultant focusing on DITA analysis, design, and implementation
• Doing SGML and XML for cough 30 years cough• Founding member of the DITA Technical Committee• Founding member of the XML Working Group• Co-editor of HyTime standard (ISO/IEC 10744)• Primary developer and founder of the DITA for
Publishers project• Author of DITA for Practitioners, Vol 1 (XML Press)• More DITA 1.3 accepted proposals than any other TC
member
Contrext, LLC 8
![Page 9: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/9.jpg)
DITA VERSION 1.3 ACTIVITY
Contrext, LLC 9
![Page 10: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/10.jpg)
DITA 1.3 Status
• DITA 1.3 features are frozen as of May 2014
• Public draft of final 1.3 specification for OASIS final approval process available soon
• Approval targeted for mid 2015
• Implementation in Open Toolkit under way (OT 2.x, DITA Community organization)
Contrext, LLC 10
![Page 11: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/11.jpg)
What Can I Do Today?
• New vocabulary immediately usable– Map and topic types and new domains are normal DITA
specializations– DITA 1.3 vocabulary packaged as OT plugin for convenience– Spec is stable—markup design unlikely to change between
now and final approval– OT 2.x is 1.3 support release. Many 1.3 features already
implemented– Most vocabulary also supported by OT 1.x plugins
• New architecture can be implemented as preprocessing for DITA 1.2 processors
Contrext, LLC 11
![Page 12: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/12.jpg)
Reminder: Always Backward
Compatible
• All DITA 1.x versions must be backwards compatible with earler 1.x versions
• DITA 1.3 completely backwards compatible
– All DITA 1.0, 1.1, 1.2 documents are valid 1.3 documents
– Behavior of documents should be the same
Contrext, LLC 12
![Page 13: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/13.jpg)
QUICK OVERVIEW OF NEW
DITA 1.3 FEATURES
Contrext, LLC 13
![Page 14: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/14.jpg)
Lots of New Vocabulary
• MathML and SVG integrations• Troubleshooting: new topic type, note type, task elements• UX window display details map element and <revisionid> attributes• Release management metadata• Learning and training enhancements• @deliveryTarget conditional attribute• <line-through> and <overline> in highlight domain• New <div> base element type• Elements for tagging XML markup• New <sort-as> element• New table attributes for layout control and accessibility• @cascade to control metadata propagation in maps• More…
Contrext, LLC 14
![Page 15: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/15.jpg)
Architectural Enhancements
• Scoped keys– Same key reference can resolve to different topics or
text in different parts of a map– Enables cross-deliverable linking
• Branch filtering– Apply different filtering rules to different parts of a
map– Automates replication of map branches for different
sets of conditions
• “this topic” fragment identifier: “#./fig-01”• Cross-deliverable links
Contrext, LLC 15
![Page 16: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/16.jpg)
Not Even Talking About
• RELAX NG as master vocabulary grammar format
• Many small-but-important enhancements to base content models
• Specialization enhancments (use structural types as though they were domains)
• Specification improvements
• Stuff we considered but didn’t put in for various reasons
Contrext, LLC 16
![Page 17: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/17.jpg)
ARCHITECTURAL ENHANCEMENT:
SCOPED KEYS
Contrext, LLC 17
![Page 18: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/18.jpg)
DITA 1.2 Keys
• Indirect addressing for topics:– Assign keys to topics within maps– Refer to keys in topics– Keys resolve through map– Same key can resolve to different topics in different maps– Essential for re-use
• In 1.2, keys are global within a given publication (root map)– Every reference to a key must resolve to the same topic or
text– Limits creation of multi-product or multi-language
publications
Contrext, LLC 18
![Page 19: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/19.jpg)
DITA 1.3: Key Scopes
• Named scopes within maps• Unqualified key references resolve to key in current
scope• Key references can be qualified with scope names:
scope1.key-one, scope2.key-one
• Higher maps can override keys defined in scopes• Same key referenced in different scopes can resolve to
different topics• Same topic used in different scopes within same map
can link to different targets• Applies to conref, xref, topicref, etc.
Contrext, LLC 19
![Page 20: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/20.jpg)
Scoped Key Use Cases
• Multi-product or multi-language publications– Each product or language is a different scope
– Different text or topics or images for same key in different product or language context
• Combine separate publications into a single publication– Each publication is a separate key scope and defines
its own keys
– No interference between keys defined in each publication
Contrext, LLC 20
![Page 21: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/21.jpg)
Cross-Deliverable Links
• Define another publication’s root map as a key scope in your map– Target publication is a “peer” to your publication
– Processors don’t have to process the target map when processing your map
• Can link to keys defined in the target publication using scope-qualified key references
• Enables generation of deliverables with working cross-deliverable links, e.g.: HTML-to-HTML, HTML-to-PDF, PDF-to-PDF, PDF-to-HTML
Contrext, LLC 21
![Page 22: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/22.jpg)
ARCHITECTURAL ENHANCEMENT:
BRANCH FILTERING
Contrext, LLC 22
![Page 23: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/23.jpg)
DITA 1.2 Filtering
• Filtering conditions apply only to whole publication
• No way to have different conditions applied to different parts of a map
• Can lead to complex and hard-to-manage conditions
Contrext, LLC 23
![Page 24: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/24.jpg)
DITA 1.3: Branch Filtering
• Point to DITAVAL files from within topicrefs
• DITAVAL applies to that branch of the map
• For a single branch, can have multiple DITAVAL references– Each DITAVAL produces a new copy of the branch
filtered according to that DITAVAL
– Avoids need to maintain copies of map branches with only different filtering
• Can control how names in duplicated branches are constructed
Contrext, LLC 24
![Page 25: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/25.jpg)
Branch Filtering Use Cases
• Multi-platform publications:– <chapter keyref=“installation”>
<ditavalref keyref=“ditaval-osx”/>
<ditavalref keyref=“ditaval-win”/>
<ditavalref keyref=“ditaval-lin”/>
<topicref keyref=“inst-overview”/>
…
</chapter>
• Multi-audience publications
• Multi-product publications
Contrext, LLC 25
![Page 26: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/26.jpg)
NEW VOCABULARY
Contrext, LLC 26
![Page 27: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/27.jpg)
SVG Integration
• Inline SVG graphics
– <svg-container>
• Can pull in SVG from non-DITA XML files
– <svgref>
Contrext, LLC 27
![Page 28: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/28.jpg)
MathML Integration
• MathML domain:– <mathml> element contains <m:math>– Can link to <m:math> elements in non-DITA XML files:
<mathmlref>
• Equation domain:– Elements for identifying semantic equations:
• <equation-inline>, <equation-block>, <equation-figure>
– Can control equation numbering• <equation-number>
– Can have alternate forms of the equation: MathML, image, etc.
Contrext, LLC 28
![Page 29: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/29.jpg)
Troubleshooting Support
• New topic type: troubleshooting
– Provides problem/cause/solution structures
• New elements for use within tasks:
– <steptroubleshooting>, <tasktroubleshooting>
– Clearly identifies troubleshooting-specific information
• New “trouble” note type for highlighting troubleshooting-related notes
Contrext, LLC 29
![Page 30: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/30.jpg)
UX Window Control
• Specifically for online help• Within maps:
– Define size and position details of windodws to use for showing online help
– <ux-window name=“win-01”width=“400” height=“600” >
• Within topics:– Reference named windows from <resourceid>
elements in topics – <resourceid appid=“myapp”
ux-windowref=“win-01”/>
Contrext, LLC 30
![Page 31: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/31.jpg)
Release Management Metadata
• Metadata for maps and topics
– <change-historylist>
– <change-item>
• Lets you capture details about a specific change to the map or topic:
– Who, what, when, why
– References to issue-tracker issues
• Can be extended with additional metadata
Contrext, LLC 31
![Page 32: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/32.jpg)
Learning and Training
Enhancements
• New learingObjectMap and learningGroupMap map types
• New learning2 domain for interactions (assessments):– Allows block elements in questions, answers, and
feedback
– Same semantics and question types as DITA 1.2 learning domain
– Can be used with 1.2 learning domain
Contrext, LLC 32
![Page 33: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/33.jpg)
@deliveryTarget Conditional
Attribute
• Lets you have deliverable-specific content:
– PDF, EPUB, HTML, online help, etc.
• Specialization of @props
• Includes sample subject scheme map that defines a set of typical values
• Can use any values you want
Contrext, LLC 33
![Page 34: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/34.jpg)
Highlight Domain Enhancements
• New element types:
– <line-through>
– <overline>
• Completes the set of line-based highlighting (underline, overline, line-through)
• Note: Can use existing @status=“deleted” to indicate deletions
Contrext, LLC 34
![Page 35: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/35.jpg)
XML Markup Tagging
• XML domain
• Elements for tagging mentions of XML elements, attributes, etc.
• Useful for documenting XML vocabularies
• Used by the DITA 1.3 spec
• XML domain specializes “markup domain”
– General elements for indentifying any kind of markup-related names: <markupname>
Contrext, LLC 35
![Page 36: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/36.jpg)
New <div> Base Element Type
• Like DITA 1.2 <sectiondiv>
• Can go in body or section
• Specialization base for learning2 elements
• No semantic other than containment
Contrext, LLC 36
![Page 37: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/37.jpg)
SUMMARY
Contrext, LLC 37
![Page 38: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/38.jpg)
Reuse Support Features
• Scoped keys and branch filtering satisfy most of the reuse requirements not met in DITA 1.2
• “This topic” fragment identifier makes links within conrefs work properly
• Branch filtering makes multi-product or multi-language or multi-audience publications possible
• Cross-deliverable linking allows flexibility in packaging of content into deliverables
Contrext, LLC 38
![Page 39: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/39.jpg)
Vocabulary: Key Requirements,
Relevant Standards
• Integration of MathML and SVG aligns DITA with HTML5 and EPUB3
• Troubleshooting and release management markup addresses important Technical Communication requirements
• Learning2 domain makes question and answer markup useable for typical Publishing use cases
• UX enhancements important for online help delivery
Contrext, LLC 39
![Page 40: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/40.jpg)
In Short
• DITA 1.3 fills in important feature holes left in DITA 1.2
• Iterative improvement in vocabulary• No changes to existing semantics, processing
rules, etc.• Key scopes and branch filtering critical for
authors but challenging for CCMS and authoring tool vendors
• Highlights importance of Information Architect role within writing teams
Contrext, LLC 40
![Page 41: DITA 1.3: What's New and Different](https://reader034.vdocuments.us/reader034/viewer/2022042701/559f3f291a28ab76748b470a/html5/thumbnails/41.jpg)
Resources
• OASIS DITA Technical Committee: https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=dita
• OASIS DITA Adoption Technical Committee: https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=dita-adoption
• Kris Eberlein’s DITA 1.3 Overview: http://dita.xml.org/sites/dita.xml.org/files/overview-of-dita-1.3.pdf
• DITA Open Toolkit: https://dita-ot.github.io• DITA Community Resources GitHub project:
http://www.dita-community.org• Me: [email protected], http://contrext.com
Contrext, LLC 41