1 / 47

The Future of XML Editing Content Management with FrameMaker and DITA

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. Framemaker > XML > DITA.

michi
Download Presentation

The Future of XML Editing Content Management with FrameMaker and DITA

An Image/Link below is provided (as is) to download presentation Download Policy: Content on the Website is provided to you AS IS for your information and personal use and may not be sold / licensed / shared on other websites without getting consent from its author. Content is provided to you AS IS for your information and personal use only. Download presentation by click this link. While downloading, if for some reason you are not able to download a presentation, the publisher may have deleted the file from their server. During download, if you can't get a presentation, the file might be deleted by the publisher.

E N D

Presentation Transcript

  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 > 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.

  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 > 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 • 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 • We are happy to report solid proof of Intelligent Designers in the evolution of DITA…

  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 (NPR’s “The Connection”) • Dave Winer – RSS creator • Adam Curry – wants audio attached • Bloggercon • BlogAudio.org • Lydon’s 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 DITA—all 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? • It’s 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 - <font>, <b>, <i> • Structure - <div>, <span> • Semantics <task>, <concept>

  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 don’t 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 <oXygen/> • 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@ 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 ‘O’s 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@cmsreview.com • bobdoyle@skybuilders.com • Read my articles • www.econtentmag.com/About/AboutAuthor.aspx?AuthorID=155 • This presentation is online at • http://www.cmsreview.com/presentations/FMChautauqua.ppt

  43. 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 -

  44. Parker Brothers Games

  45. 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

  46. 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

More Related