Mathew DITA Deep Dive
Upcoming SlideShare
Loading in...5
×
 

Like this? Share it with your network

Share

Mathew DITA Deep Dive

on

  • 698 views

 

Statistics

Views

Total Views
698
Views on SlideShare
698
Embed Views
0

Actions

Likes
0
Downloads
3
Comments
0

0 Embeds 0

No embeds

Accessibility

Categories

Upload Details

Uploaded via as Microsoft PowerPoint

Usage Rights

© All Rights Reserved

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
    Processing…
Post Comment
Edit your comment
  • Early adopters converted existing documentation to DITA. Disturbing. It is still the trend.
  • Content strategy early in the cycle restricts options.

Mathew DITA Deep Dive Presentation Transcript

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