dita open toolkit: open the gates to structured content
TRANSCRIPT
![Page 1: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/1.jpg)
© 2016 VMware Inc. All rights reserved.
DITA Open ToolkitOpen the Gates to Structured Content
Iliana Kostova
Oct 25th, 2016
![Page 2: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/2.jpg)
Agenda
1. Introduction to the DITA Open Toolkit
2. DITA Open Toolkit Architecture
3. Exercise: Generating Content in Several Output Formats
a. Background
b. Action
4. Exercise: Interesting DITA Techniques
a. Background
b. Action
5. Exercise: Example DITA OT Repository
6. Enterprise CMS vs DITA OT
7. Summary
2
![Page 3: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/3.jpg)
3
Introduction to the DITA Open Toolkit
![Page 4: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/4.jpg)
![Page 5: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/5.jpg)
5
HTML5
DITA Content Management in a Nutshell
XHTML PDF
Word
Storage
Version control
Generation
engine
Publishing
channel
Infrastructure
![Page 6: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/6.jpg)
6
HTML5
DITA Toolkit in the Content Management Process
XHTML PDF
Word
DITA OT
WYSIWYG
Editor
Doc Web
site
![Page 7: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/7.jpg)
7
Output Generation Engine for DITA
What is the DITA Open Toolkit?
![Page 8: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/8.jpg)
8
–First steps in DITA
–New features in the DITA specification
–In production at a lower cost
–How a Content Management System (CMS) works
When Would I Use the DITA Open Toolkit?
![Page 9: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/9.jpg)
9
–Open source (free)
–Easy to download and run
–Easy to configure
–No need for an enterprise CMS
Why Would I Use the DITA Open Toolkit?
![Page 10: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/10.jpg)
10
– Web site: http://www.dita-ot.org/
– GitHub project location:
https://github.com/dita-ot
– GitHub download location:
https://github.com/dita-ot/dita-ot/releases/
Download Location
![Page 11: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/11.jpg)
11
–Distribution ZIP package – extract and use; includes XLST files
–Source ZIP package – Java support for XML processing and output generation
–WYSIWYG Editors
Packaging
![Page 12: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/12.jpg)
12
Architecture
![Page 13: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/13.jpg)
13
HTML5
DITA Toolkit in the Content Management Process
XHTML PDF
Word
DITA OT
WYSIWYG
Editor
Validation and Parsing
Transform
XML
Parser
XML
Preprocessor
and
XSLT/Java
Engine
Apache
Ant
![Page 14: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/14.jpg)
14
DITA Open Toolkit Modules
DITA OT
Validation and Parsing
Transform
XML
Parser
XML
PreprocessorApache
Ant
Filter, pull conref’s, generate
related links
Check if the XML docs
are valid against the
DITA standard
Orchestrate
XSLT/Java
Engine
Apply the rules from XSLT
files to generate output
![Page 15: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/15.jpg)
15
DITA Open Toolkit Plug-Ins
DITA OT
Validation and Parsing
Transform
XML
Parser
XML
PreprocessorApache
Ant
XSLT/Java
Engine
HTML5
XHTML PDF
Word
New doc type
(new specialization
+ new xslt rules)
New outyput type
(new xslt rules +
new build target)
Markdown
![Page 16: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/16.jpg)
16
Exercises
![Page 17: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/17.jpg)
17
Introduction to the Exercises
![Page 18: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/18.jpg)
18
Exercise 1: Running DITA OT
![Page 19: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/19.jpg)
CONFIDENTIAL19
Exercise 1: Running DITA OT - Objectives
• Learn how to generate consumable content
• Learn more about different output support
• Learn how to configure output generation
![Page 20: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/20.jpg)
Exercise 1: Running DITA OT - Background
• Prerequisites
– Windows or Linux OS
– Java Development Kit (JDK) 7 or later
– DITA OT extracted
• Command
– dita command (new)
– Calling Ant on a build.xml file (add command line)
– From your DITA WYSIWYG editor
• Input arguments
– Input DITA map or DITA topic
– Transform (output) type
– Output folder
– Additional arguments (common and output-specific)
20
![Page 21: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/21.jpg)
Exercise 1: Running DITA OT - Background
bin/dita
-input input-file
-format format
-output transformtype
-Doption1=value1 -Doption2=value2
21
![Page 22: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/22.jpg)
Exercise 1: Running DITA OT - Action
• Generate HTML5 and PDF output for a DITA map in a special folder
– Groups
• HTML with CSS
• HTML with a TOC tree
– Use the stickies for the dita command line according to the output
– Use the handouts for help
22
![Page 23: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/23.jpg)
Exercise 1: Running DITA OT
23
![Page 24: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/24.jpg)
Exercise 2: Interesting DITA XML Features
24
![Page 25: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/25.jpg)
Exercise 2: Interesting DITA XML Features -Objectives
• Learn how to test advanced features that are purely in DITA XML
• Learn how to test features that require additional processing
16
![Page 26: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/26.jpg)
Exercise 2: Interesting DITA XML Features -Background
• Nesting topics
– Of the same type or of mixed types?
– Manually
– Automatic – chunk attribute for topicref’s in maps
26
![Page 27: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/27.jpg)
Exercise 2: Interesting DITA XML Features -Background
• Keys
– Purpose – use location-agnostic reference to a topic or a piece of topic in links and conref (pull and push)
– Traditional conref is location-aware:step conref=“<target dita
file/object>#<topic_id>/<element_id>”
– You define a key in a map and use in topics without knowledge of the location
27
![Page 28: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/28.jpg)
Exercise 2: Interesting DITA XML Features -Background
• Conditions
– Leave out, include or change content if a condition is true
– Conditions – platform, audience, product, rev, otherprops
28
– Conditional filtering - .ditaval file
![Page 29: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/29.jpg)
Exercise 2: Interesting DITA XML Features -Action
• Generate from a topic made of different nested types
• Reuse and link using keys
– What elements do you need?
– Pull the content
• Use a condition to generate output for Linux admins
– What elements do you need?
29
![Page 30: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/30.jpg)
Exercise 2: Interesting DITA XML Features
30
![Page 31: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/31.jpg)
Exercise 3: Example Repository
31
![Page 32: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/32.jpg)
Exercise 3: Example Repository - Objectives
• Learn how to plan a repository for source control systems (SCMs)
16
![Page 33: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/33.jpg)
Exercise 3: Example Repository - Background
• Share the same repository as engineers
– Benefit from advanced versionins and branching of SCMs
– Rely on the same build team as engineers
– Automate regular builds reusing the setup for the engineers (e.g. use the DITA OT plug-in for Maven)
– Enable engineers to access and build the latest doc by using a familiar toolchain
16
![Page 34: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/34.jpg)
Exercise 3: Example Repository - Action
• Create a repository structure to support several documentation sets
– Use the stickies to
• Include the required folders handed by Iliana
• Name the rest of the folders
• Model the tree
34
![Page 35: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/35.jpg)
Exercise 3: Example Repository - Action
• Examine an example structure of a documentation set
16
dita-ot-home-dir
module1-docs
bin lib plugins
build outputdita
html
generate-output.bat
filter.ditaval
output-log.log
module1.ditamap
concepts
tasks
. . . . . .
. . .
module2-docs
. . .
xsl
![Page 36: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/36.jpg)
Exercise 3: Example Repository
36
![Page 37: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/37.jpg)
Enterprise CMS vs DITA OT
Enterprise CMS DITA Open Toolkit
Pricey Free
Dependence on an external team for updates with
new features
Ability to download and use right away
Professional look-and-feel of the output and
version control
Need to customize it but can be easily integrated
in traditional version control systems like Perforce
and Git and build systems like Maven
You concentrate on the authoring part You need to do some short learning first
Heavy infrastructure setup process You only need a version control system and space
on your computer
. . . . . .
37
![Page 38: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/38.jpg)
Takeaways
• Easy to get started
• Easy to experiment with DITA and single-sourcing
• Easy to pack and integrate in the release
• Easy to customize
38
![Page 39: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/39.jpg)
Useful DITA OT Resources
• DITA OT Home Page
• DITA OT Groups
– Yahoo
• DITA Specification
• Scriptorium, Oxygen
• Apache Ant Project
39
![Page 40: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/40.jpg)
Your opinion is important to us! Please tell us what you thought of the lecture. We look forward to your feedback via smartphone or tablet under
http://in31.honestly.deor scan the QR code
The feedback tool will be available even after the conference!
![Page 41: DITA Open Toolkit: Open the Gates to Structured Content](https://reader034.vdocuments.mx/reader034/viewer/2022051522/58a01c4e1a28abd14a8c3f59/html5/thumbnails/41.jpg)
Thank you!
41