Mathew DITA Deep Dive

702 views

Published on

  • Be the first to comment

  • Be the first to like this

Mathew DITA Deep Dive

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

×