SlideShare une entreprise Scribd logo
1  sur  31
To DITA or not to DITA? Mathew Varghese Content Architect, Citrix
Agenda Creating DITA topics Generating output using DITA Open Toolkit Profiling using ditaval Altering style sheets
Misinformation! Long, boring, and highly theoretical Demos will not work! Lots of Q&A to keep you awake :D
CREATING DITA Topics
http://en.wikipedia.org/wiki/Darwin_Information_Typing_Architecture
Adopting DITA Entails Understanding topic-based writing Understanding minimalism Greater emphasis on information architecture In short, good writing practices.
Adopting DITA Does Not Entail Learning XML Coding and/or working on a CLI In short, no drastic change.
DITA makes you a better writerANDProvides alternate career opportunities
DITA Building Blocks Topics Concept Task Reference Maps Ditamap Bookmap
DITA Building Blocks C R T C T T T
Creating DITA Topics Analyze Analyze Analyze again! Get the right specs Extend the DITA Information Model Content Strategy - Later Understand Semantic Tagging FrameMaker vs. DITA
Get the Right Specs Language Specification http://docs.oasis-open.org/dita/v1.1/langspec/ditaref-type.html Architecture Specification http://docs.oasis-open.org/dita/v1.1/archspec/archspec.html
Extend the DITA Information Model C T R
Extend the DITA Information Model C C C
Analyze, analyze, and analyze again! Audience Analysis DITA Topics Task Analysis Every DITA topic should map to a unique objective.
Content Strategy - Later The Paradigm Shift
Semantic Tagging Build your tagging scheme
FrameMaker and DITA FrameMaker is a tool and DITA is an information architecture. FrameMaker supports DITA. Please, don’t hit me!
Generating Output
Install DITA OT http://sourceforge.net/projects/dita-ot/
Quick, Dirty, out-of-the-box! Using ANT ant -f samplesnt_sampleample_pdf.xml
Using the JAVA Command Line java -jar lib/dost.jar /i:samples/sequence.ditamap /outdir:out /transtype:xhtml
Using the DITA OT GUI http://sourceforge.net/projects/ditaotgui/
Using Your Editing Tool
Profiling using ditaval
Tips Profile sparingly Always plan for negative conditions Publish profiling rules
Pillar Test audience context
Transforms
Simple Tricks Modifying the CSS for HTML-based outputs XSL mods for PDF Open demo/fo/cfg/fo/attrs/front-matter-attr.xsl Go to __frontmatter__title attribute set
Questions

Contenu connexe

Similaire à Mathew DITA Deep Dive

Introduction To Information Modeling With DITA
Introduction To Information Modeling With DITAIntroduction To Information Modeling With DITA
Introduction To Information Modeling With DITA
Scott Abel
 
Why DITA?
Why DITA?Why DITA?
Why DITA?
akashjd
 
DITA getting started
DITA getting startedDITA getting started
DITA getting started
Raghu nath
 
CMSDITA2012_Maass_Quinlan_20120412
CMSDITA2012_Maass_Quinlan_20120412CMSDITA2012_Maass_Quinlan_20120412
CMSDITA2012_Maass_Quinlan_20120412
Patrick Quinlan
 
Painless XML Authoring?: How DITA Simplifies XML
Painless XML Authoring?: How DITA Simplifies XMLPainless XML Authoring?: How DITA Simplifies XML
Painless XML Authoring?: How DITA Simplifies XML
Scott Abel
 

Similaire à Mathew DITA Deep Dive (20)

Introduction To Information Modeling With DITA
Introduction To Information Modeling With DITAIntroduction To Information Modeling With DITA
Introduction To Information Modeling With DITA
 
Introduction to DITA
Introduction to DITAIntroduction to DITA
Introduction to DITA
 
Why DITA?
Why DITA?Why DITA?
Why DITA?
 
TWC 545 Presentation-DITA
TWC 545 Presentation-DITATWC 545 Presentation-DITA
TWC 545 Presentation-DITA
 
DITA getting started
DITA getting startedDITA getting started
DITA getting started
 
Using DITA for Online Help
Using DITA for Online HelpUsing DITA for Online Help
Using DITA for Online Help
 
CMSDITA2012_Maass_Quinlan_20120412
CMSDITA2012_Maass_Quinlan_20120412CMSDITA2012_Maass_Quinlan_20120412
CMSDITA2012_Maass_Quinlan_20120412
 
Reports and DITA Metrics IXIASOFT User Conference 2016
Reports and DITA Metrics IXIASOFT User Conference 2016Reports and DITA Metrics IXIASOFT User Conference 2016
Reports and DITA Metrics IXIASOFT User Conference 2016
 
The Evolution of DITAs
The Evolution of DITAsThe Evolution of DITAs
The Evolution of DITAs
 
DITA 101 -- Why the Buzz
DITA 101 -- Why the BuzzDITA 101 -- Why the Buzz
DITA 101 -- Why the Buzz
 
5 Reasons not to use Dita from a CCMS Perspective
5 Reasons not to use Dita from a CCMS Perspective5 Reasons not to use Dita from a CCMS Perspective
5 Reasons not to use Dita from a CCMS Perspective
 
DITA Surprise, Unwrapping DITA Best Practices - tekom tcworld 2016
DITA Surprise, Unwrapping DITA Best Practices - tekom tcworld 2016DITA Surprise, Unwrapping DITA Best Practices - tekom tcworld 2016
DITA Surprise, Unwrapping DITA Best Practices - tekom tcworld 2016
 
DITA-Workshop on Saturday 5 May 2018 at Pune
DITA-Workshop on Saturday 5 May 2018 at PuneDITA-Workshop on Saturday 5 May 2018 at Pune
DITA-Workshop on Saturday 5 May 2018 at Pune
 
Two to Tango - Agile Meets DITA
Two to Tango - Agile Meets DITATwo to Tango - Agile Meets DITA
Two to Tango - Agile Meets DITA
 
Agile Meets DITA: Developing User Documentation in an Agile Environment
Agile Meets DITA: Developing User Documentation in an Agile EnvironmentAgile Meets DITA: Developing User Documentation in an Agile Environment
Agile Meets DITA: Developing User Documentation in an Agile Environment
 
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
 
Painless XML Authoring?: How DITA Simplifies XML
Painless XML Authoring?: How DITA Simplifies XMLPainless XML Authoring?: How DITA Simplifies XML
Painless XML Authoring?: How DITA Simplifies XML
 
10 Million Dita Topics Can't Be Wrong
10 Million Dita Topics Can't Be Wrong10 Million Dita Topics Can't Be Wrong
10 Million Dita Topics Can't Be Wrong
 
DocBook vs. DITA: Will The Real Standard Please Stand Up?
DocBook vs. DITA: Will The Real Standard Please Stand Up?DocBook vs. DITA: Will The Real Standard Please Stand Up?
DocBook vs. DITA: Will The Real Standard Please Stand Up?
 
DITA as Interchange Format for Crowdsourcing and Acquisitions
DITA as Interchange Format for Crowdsourcing and AcquisitionsDITA as Interchange Format for Crowdsourcing and Acquisitions
DITA as Interchange Format for Crowdsourcing and Acquisitions
 

Mathew DITA Deep Dive

Notes de l'éditeur

  1. Early adopters converted existing documentation to DITA. Disturbing. It is still the trend.
  2. Content strategy early in the cycle restricts options.