The Future of XML Editing Content Management with FrameMaker and DITA

1
The Future of XML EditingContent Management
withFrameMaker and DITA

• Bob Doyle
• Founder, CM Professionals
• Editor, CMS Review
• Contributing Editor, EContent Magazine
• CEO, skyBuilders.com
• Observer, OASIS DITA TC
• Organizer, Boston DITA Users Group

2
Framemaker gt XML gt DITA

• As Kay Ethier knows well, XML has become a key
  part of Framemaker.
• DITA is XML for tech writers.
• With full support for DITA, Framemaker solidifies
  its leadership position among XML Editors.

3
The Road to DITA

• SGML markup for documentation
• the book was the paradigm (DocBook)
• XML extensible markup
• the web was a new paradigm (HTML gt XHTML)
• the web demanded more hyperlinking
• random access chunks of information on demand
• single-source, multichannel, multilingual
• DITA ready-made metadata

4
Darwin and Intelligent Design

• There is still some controversy in parts of the
  country
• Kansas and Texas?
• about the amazing scientific evidence for human
  evolution

5
Intelligent Design and Darwin Information Typing
Architecture

• We are happy to report solid proof of Intelligent
  Designers in the evolution of DITA

• SGML
• - Charles Goldfarb
• - Edward Mosher
• - Raymond Lorie
• XML
• Jon Bozak
• Yuri Rubinsky
• - James Clark
• - Tim Bray
• DITA
• Don Day
• Michael Priestley
• David Schell
• Eric Hennum
• John Hunt
• and many unnamed programmers at IBM

6
Lovely DITA, Meter Maid,Ready-made Metadata

• DITA is a small set of standard XML content
  elements and attributes
• Can DITA do anything XML cannot? No.
• Can it do 80 of typical technical documentation
  needs? Yes.
• RSS is also a standard set of XML elements
• Will DITA be as successful as RSS?

7
RSS is standard metadata

• Rich Site Summary or
• Really Simple Syndication
• RSS 1.0, 2.0, Atom
• All are lightweight XML structures that millions
  of people find easy to use (because they never
  see them!)
• News portals, weblogs, and podcasts

8
The First Podcast

• Christopher Lydon (NPRs The Connection)
• Dave Winer RSS creator
• Adam Curry wants audio attached
• Bloggercon
• BlogAudio.org
• Lydons new Open Source Show on WGBH

9
Secret of FrameMaker Success

• Authors work with a familiar tool
• Support for structured authoring
• Export standards-based content that can be used
  in global content management
• DITA is a revolution now in technical
  documentation
• It can also be used to author any kind of
  controlled corporate content

10
DITA Open Toolkit

• A landmark in open-source software being
  incorporated into competing proprietary products
  from XML editors to CM systems.
• Thanks to Don Day, Erik Hennum, John Hunt,
  Michael Priestley, Dave Schell and unnamed
  programmers at IBM

11
DITA Application Pack

• FrameMaker integrates the DITA Open Toolkit (as
  did XMeTaL, others)
• Publishes to various outputs, including a
  FrameMaker Book, without the DITA OT
• Uses XSLT for processing DITA maps.
• XSLT is customizable directly.
  

12
The Development Community behind the Application
Pack

• Backspace Ink, Bright Path Solutions, Document
  Jones, Group Wellesley, Integrated Technologies,
  Leximation, Promptt, Publishing Smarter,
  Scriptorium Publishing, Text Structure
  Consulting, and Silicon Publishing created the
  Application Pack for DITAall overseen and
  coordinated by Silicon Publishing.

13
The value of structured writing

• Writing for consistency
• A difference should make a difference
• Writing for reuse
• A single source of truth
• Writing for translation
• Never translate the same sentence twice
• Writing for machine translation
• Simplified English
• Guided writing
• Never write the same sentence twice

14
Defining Content Management

• What Is Content?
• What Is Content Management?
• What is a CM System?
• Stages in the Content Lifecycle?
• CM and IA (Information Architecture)

15
What Is Content?

• Its not the Presentation or the Structure!
• Separate Presentation from Content
• Structure the Content
• Tag Content with Meaning (semantics)

16
Three Different Professions

• The three layers are the work of different
  professionals
• Designers for Style
• Architects for Structure
• Authors for Content

17
Three Kinds of Markup

• The three layers use different markup
• Style - ltfontgt, ltbgt, ltigt
• Structure - ltdivgt, ltspangt
• Semantics lttaskgt, ltconceptgt

18
Three Uses of XML

• The three layers use different technologies
• XSLT Stylesheets (CSS)
• XML Schemas (DTDs)
• XML DITA Documents

19
The FrameMaker EDD

• Note that the EDD combines the two layers of
  presentation and structure stylesheets and
  schemas (the content model).
• Normally this is not an issue for tech writers.
• But be aware if your organization uses other
  DITA-aware XML editors

20
FrameMaker and DITA

• DITA makes the transition to structured authoring
  very affordable
• You dont need to develop DTDs, Schemas,
  Stylesheets, and XSLT Transformations.
• Authors will need to learn topic-based authoring
  (a big change).

21
XML Editors Review

• Altova XML Spy
• Cladonia Exchanger
• Stylus Studio
• SyncRO Soft ltoXygen/gt
• Adobe FrameMaker
• Arbortext Editor
• XMetal Author
• Syntext Serna

Eight top XML Editors were studied Chosen from
75 on CMS Review Published in the June issue
of EContent Magazine XMetal acquired
by Justsystem
22
XML CMS

• Astoria
• Bluestream XDocs
• IXIASoft
• Mark Logic
• Siberlogic
• Trisoft
• Vasont
• X-Hive/Docato
• XyEnterprise Content_at_

Most are integrating the DITA Open Toolkit, which
gives them access to a growing number of tools
developed by an open-source community
23
Global CMS

• Idiom
• L10nBRIDGE
• Sajan
• SDL/TRADOS
• DITA and Translation
• TMX, TBX, X-LIFF

24
What Is Content Management?

• Content management is the whole process from
  creation and capture of original content to the
  delivery of different versions to many publishing
  channels in multiple languages.
• Print, Web, Cell/PDA, Help, etc.

25
What is a CM System?

• It is humans using computers and software to
  assist in managing content.
• It has two main parts
• The user interface.
• The database (content repository).
• Everything else is magic middleware.
• It helps manage the content lifecycle.

26
The Content Lifecycle

• 7 stages
• Organize
• Rules
• Create
• Storage
• Assembly
• Publish
• Archive
• Context
• Users
• Content

27
Two Kinds of Information Architecture

• IA of document sets, books in a library, a
  website, the World Wide Web organization,
  cataloging, metadata tagging, accessibility,
  findability.
• DITA is the internal architecture of a single
  document - page structure, navigation elements,
  and content elements.

28
The Three Os in CMS

• Open Source (and Open Documents)
• Online (ASPs)
• Offshore (Globalization)
• Enabling technologies (XML, Javascript)
• AJAX, Web 2.0, Web Services
• DITA

29
CMS Review
30
CMS Review Glossary
31
Definition of Accessibility
32
Finding a CMS

• The CMSML project at CMS Review and CM Pros

Click compare to get the results below...
Select two CMS or enter search terms to find
CMS that match your criteria. The directory is a
faceted classification scheme.
33
Other CMS Review Sites

• CMS Forum
• CMS Wiki
• CMSML
• CMS News
• CMS Calendar
• CMS Glossary
• CMS Global
• CMS Boston
• Memography
• TaxoTips

34
CM Professionals

• An organization with Community Tools
• Calendar, Glossary, Resource Library,
• Member Directory, Mailing Lists
• Blog Aggregation, Podcasts
• International Summits
• Face-to-Face Meetings
• CM Pros Communities in Africa, Australia,
  Benelux, Canada, and Scandinavia

35
CM Professionals
36
CM Pros Member Directory
37
CM Pros Events Calendar
38
CM Pros Best Practices
39
CM Pros Videos

• Eighty hours of video
• CM Pros Summits, Gilbane Conferences, IA
  Summit, OSCOM, Bloggercons at Harvard.

Bob Boiko interviews
40
Anna van Raaphorst, CM Pro

• DITA OT User Guide and Reference
• By Anna and husband Dick Johnson.
• Available for free download from the CM Pros
  Resource Library and at
• http//dita-ot.sourceforge.net/

41
Please Consider Joining CM Professionals

• You can register online to be a member
• www.cmprofessionals.org/membership/how_to_join/

42
Thank you.

• Contact Bob Doyle
• editor_at_cmsreview.com
• bobdoyle_at_skybuilders.com
• Read my articles
• www.econtentmag.com/About/AboutAuthor.aspx?AuthorI
  D155
• This presentation is online at
• http//www.cmsreview.com/presentations/FMChautauqu
  a.ppt

43
(No Transcript)
44
Bob Doyle Timeline

• Ph.D. Astrophysics, Harvard - 1968
• Collaborative Observing Program, Skylab - 1970-72
  
• Super8 Sound - 1973-78
• Harvard-Radcliffe Film Workshop - 1975-85
• Merlin and 5 other computer games - 1977-81
• iXO Telecomputer - 1980-87
• MacPublisher - 1984-87
• Brown Television (BTV) - 1986
• Hi-8 and DTV Users Groups - 1986-96
• Harvard-Radcliffe Television (HRTV) - 1988
• Quad Sound Studios - 1990
• Digital Video Editor, New Media -1993-99
• skyBuilders.com - 2000 -
• CMS Review - 2003 -
• CM Professionals - 2004 -
• EContent - 2004 -
• iTV Studio 2006 -

45
Parker Brothers Games
46
iXO Telecomputer

• Computer-initiated dialogues (AI)
• Yes, No, Help, Repeat keys
• Operators are standing by
• Stock trades, airline reservations, bill paying.
• Hearing-impaired
• Powered from phone line
• Venture capital 13 million
• Never developed the backend database services
• Huge NOL carry-forward

47
MacPublisher

• First Desktop Publishing Program
• 11th Certified Mac Developer
• Shipped in 1984
• Laserwriter in 1985
• First spot color text on Apple Imagewriter
• First rotated text/gaphics
• Sold 20,000 copies
• MacIndexer
• Mac-Hyphen
• Sold to Letraset in 1987