Transcript Content Management Today

The Future of XML Editing
Content Management with
FrameMaker 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
November 8, 2006
Framemaker > XML > 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.
November 8, 2006
The Road to DITA
• SGML – markup for documentation
– the book was the paradigm (DocBook)
• XML – extensible markup
–
–
–
–
the web was a new paradigm (HTML > XHTML)
the web demanded more hyperlinking
random access chunks of information on demand
single-source, multichannel, multilingual
• DITA – ready-made metadata
November 8, 2006
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…
November 8, 2006
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
November 8, 2006
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?
November 8, 2006
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
November 8, 2006
The First Podcast
• Christopher Lydon (NPR’s “The Connection”)
• Dave Winer – RSS creator
• Adam Curry – wants audio attached
• Bloggercon
• BlogAudio.org
• Lydon’s new “Open Source” Show on WGBH
November 8, 2006
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
November 8, 2006
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
November 8, 2006
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.
November 8, 2006
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 DITA—all overseen and
coordinated by Silicon Publishing.
November 8, 2006
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
November 8, 2006
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)
November 8, 2006
What Is Content?
• It’s not the Presentation
or the Structure!
• Separate Presentation
from Content
• Structure the Content
• Tag Content with
Meaning (semantics)
November 8, 2006
Three Different Professions
• The three layers are
the work of different
professionals
• Designers for Style
• Architects for Structure
• Authors for Content
November 8, 2006
Three Kinds of Markup
• The three layers use
different “markup”
• Style - <font>, <b>, <i>
• Structure - <div>,
<span>
• Semantics <task>,
<concept>
November 8, 2006
Three Uses of XML
• The three layers use
different technologies
• XSLT Stylesheets
(CSS)
• XML Schemas (DTDs)
• XML DITA Documents
November 8, 2006
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
November 8, 2006
FrameMaker and DITA
• DITA makes the transition to structured
authoring very affordable
• You don’t need to develop DTDs,
Schemas, Stylesheets, and XSLT
Transformations.
• Authors will need to learn topic-based
authoring (a big change).
November 8, 2006
XML Editors Review
•
•
•
•
•
•
•
•
Altova XML Spy
Cladonia Exchanger
Stylus Studio
SyncRO Soft <oXygen/>
Adobe FrameMaker
Arbortext Editor
XMetal Author
Syntext Serna
November 8, 2006
Eight top XML Editors
were studied
Chosen from 75
on CMS Review
Published in
the June issue of
EContent Magazine
XMetal acquired by
Justsystem
XML CMS
•
•
•
•
•
•
•
•
•
Astoria
Bluestream XDocs
IXIASoft
Mark Logic
Siberlogic
Trisoft
Vasont
X-Hive/Docato
XyEnterprise Content@
November 8, 2006
Most are integrating
the DITA Open
Toolkit, which gives
them access to a
growing number of
tools developed by
an open-source
community
Global CMS
•
•
•
•
Idiom
L10nBRIDGE
Sajan
SDL/TRADOS
• DITA and Translation
• TMX, TBX, X-LIFF
November 8, 2006
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.
November 8, 2006
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.
November 8, 2006
The Content Lifecycle
•
7 stages
•
•
•
•
•
•
•
Organize
Rules
Create
Storage
Assembly
Publish
Archive
•
•
•
Context
Users
Content
November 8, 2006
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.
November 8, 2006
The Three ‘O’s in CMS
• Open Source (and Open Documents)
• Online (ASPs)
• Offshore (Globalization)
• Enabling technologies (XML, Javascript)
• AJAX, Web 2.0, Web Services
• DITA
November 8, 2006
CMS Review
November 8, 2006
CMS Review Glossary
November 8, 2006
Definition of Accessibility
November 8, 2006
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.
November 8, 2006
Other CMS Review Sites
•
•
•
•
•
•
•
•
•
•
November 8, 2006
CMS Forum
CMS Wiki
CMSML
CMS News
CMS Calendar
CMS Glossary
CMS Global
CMS Boston
Memography
TaxoTips
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
November 8, 2006
CM Professionals
November 8, 2006
CM Pros Member Directory
November 8, 2006
CM Pros Events Calendar
November 8, 2006
CM Pros Best Practices
November 8, 2006
CM Pros Videos
• Eighty hours of video –
• CM Pros Summits,
Gilbane Conferences,
IA Summit, OSCOM,
Bloggercons at Harvard.
Bob Boiko interviews
November 8, 2006
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/
November 8, 2006
Please Consider Joining
CM Professionals
• You can register online to be a member
• www.cmprofessionals.org/membership/how_to_join/
November 8, 2006
Thank you.
• Contact Bob Doyle
• [email protected]
• [email protected]
• Read my articles
• www.econtentmag.com/About/AboutAuthor.aspx?AuthorID=155
• This presentation is online at
• http://www.cmsreview.com/presentations/FMChautauqua.ppt
November 8, 2006
November 8, 2006
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 -
November 8, 2006
Parker Brothers Games
November 8, 2006
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
November 8, 2006
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
November 8, 2006