際際滷

際際滷Share a Scribd company logo

Mathew DITA Deep Dive

Download as PPTX, PDF
A
akashjd

This document discusses adopting the Darwin Information Typing Architecture (DITA) standard for technical documentation. It provides an overview of key DITA concepts like topics, maps, and building blocks. It also covers how to create DITA topics, generate output using the DITA Open Toolkit, and profile content using DITAVAL. The presentation aims to dispel myths about DITA being long and boring while providing practical tips through examples and demonstrations.

1 of 31
Download to read offline
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
Mathew DITA Deep Dive
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, dont hit me!
Generating Output
Install DITA OThttp://sourceforge.net/projects/dita-ot/
Quick, Dirty, out-of-the-box!Using ANTant -f samplesnt_sampleample_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

More Related Content

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.