To DITA or not to DITA?Mathew VargheseContent Architect, Citrix
AgendaCreating DITA topicsGenerating output using DITA Open ToolkitProfiling using ditavalAltering style sheets
Misinformation!Long, boring, and highly theoreticalDemos 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 EntailsUnderstanding topic-based writingUnderstanding minimalismGreater emphasis on information architectureIn short, good writing practices.
Adopting DITA Does Not EntailLearning XMLCoding and/or working on a CLIIn short, no drastic change.
DITA makes you a better writerANDProvides alternate career opportunities
DITA Building BlocksTopicsConceptTaskReferenceMapsDitamapBookmap
DITA Building BlocksCRTCTTT
Creating DITA TopicsAnalyzeAnalyzeAnalyze again!Get the right specsExtend the DITA Information ModelContent Strategy - LaterUnderstand Semantic TaggingFrameMaker vs. DITA
Get the Right SpecsLanguage Specificationhttp://docs.oasis-open.org/dita/v1.1/langspec/ditaref-type.htmlArchitecture Specificationhttp://docs.oasis-open.org/dita/v1.1/archspec/archspec.html
Extend the DITA Information ModelCTR
Extend the DITA Information ModelCCC
Analyze, analyze, and analyze again!Audience AnalysisDITA TopicsTask AnalysisEvery DITA topic should map to a unique objective.
Content Strategy - LaterThe Paradigm Shift
Semantic TaggingBuild your tagging scheme
FrameMaker and DITAFrameMaker is a tool and DITA is an information architecture.FrameMaker supports DITA.Please, don’t hit me!
Generating Output
Install DITA OThttp://sourceforge.net/projects/dita-ot/
Quick, Dirty, out-of-the-box!Using ANTant -f samples\ant_sample\sample_pdf.xml
Using the JAVA Command Linejava -jar lib/dost.jar /i:samples/sequence.ditamap /outdir:out /transtype:xhtml
Using the DITA OT GUIhttp://sourceforge.net/projects/ditaotgui/
Using Your Editing Tool
Profiling using ditaval
TipsProfile sparinglyAlways plan for negative conditionsPublish profiling rules
Pillar Testaudiencecontext
Transforms
Simple TricksModifying the CSS for HTML-based outputsXSL mods for PDFOpen demo/fo/cfg/fo/attrs/front-matter-attr.xslGo to __frontmatter__title attribute set
Questions

Mathew DITA Deep Dive

Editor's Notes

  • #13 Early adopters converted existing documentation to DITA. Disturbing. It is still the trend.
  • #18 Content strategy early in the cycle restricts options.