DocBook vs. DITA: Will The Real Standard Please Stand Up?

•Als PPT, PDF herunterladen•

6 gefällt mir•3,012 views

Presented by Teresa Mulvihill at Documentation and Training West, May 6-9, 2008 Vancouver, BC Over a decade ago DocBook became the standard for those forging ahead in XML publications. DocBook offered a cheaper and more efficient way to publish to multiple formats. Single-sourcing became a reality for hardware and software companies. However, in recent years, many in technical documentation publications have proclaimed the Darwin Information Typing Architecture (DITA) as standard for XML documentation. DITA offered an architecture in which to create and publish structured content. Makers of XML editors advertise seamless integration with DITA. Does this leave DocBook on the shelf? Are these two seemingly rival standards really that different? This presentation answers these questions with comparative examples, allowing the audience to decide for themselves.

Technologie Business

DocBook versus DITA: Will the real standard please stand up? Author: Teresa Mulvihill www.t2acommunications.com

About Teresa Mulvihill t2a Communications - LiveTechDocs Slide Bachelor of Science in International Communications and Technology Working experience… ,[object Object],[object Object],[object Object]

t2a Communications - LiveTechDocs Slide Companies, clients, and partners Companies Partners Hardware Clients Software Clients Network Security Clients Others

DocBook Vs DITA – Table of Contents t2a Communications - LiveTechDocs Slide ,[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

DocBook Vs DITA – Background t2a Communications - LiveTechDocs Slide 1991 1999 HaL Computer Systems 1998 2004

DocBook Vs DITA – Definitions t2a Communications - LiveTechDocs Slide DocBook is a document type definition (DTD) for writing technical books and articles, with the structure that such forms imply. DITA (Darwin Information Typing Architecture) is both a DTD and a set of rules for writing online contextual documentation such as software help files.

DocBook Vs DITA – Concepts t2a Communications - LiveTechDocs Slide DocBook is hierarchical by nature, and must be developed to allow for single-sourced content. DITA separates content from context, allowing multiple architectures of information. DocBook is a fixed element and attribute set. DITA is extensible, allowing the definition of information types.

DocBook Vs DITA – Comparisons t2a Communications - LiveTechDocs Slide Topic-based Separation of content and context Specialization Key Features Large set of elements and attributes targeted for technical documentation Topic oriented Context Book (section) oriented

DocBook Vs DITA – Comparisons t2a Communications - LiveTechDocs Slide ditamap file with all files and each file’s related links Document File Regular XML file called an include file with all files included in the document bat, bin, dtd, etc. files, and transformation engine Download and Installation bat, bin, dtd, etc. files and eDE able to run with as is

DocBook Vs DITA – Comparisons t2a Communications - LiveTechDocs Slide Small, growing community Community Well supported by the XML community Unrestricted, but all need development Output PDF HTML HTMLHelp

DocBook Vs DITA – Comparisons t2a Communications - LiveTechDocs Slide DITA is impressively engineered, but can be too industrial-strength. Complexity With a little development, DocBook can do what DITA is attempting on a smaller scale.

DocBook Vs DITA – Comparisons t2a Communications - LiveTechDocs Slide

DocBook Vs DITA – Compatibility t2a Communications - LiveTechDocs Slide ,[object Object],[object Object],[object Object],[object Object],[object Object]

DocBook Vs DITA – Future possibilities t2a Communications - LiveTechDocs Slide The only constant is change… Possible with training for reviewers Collaboration management Book hierarchy enables easier collaboration Community is working on a plug-in WIKIs Possible with development XMLMind, XMLSpy, ArborText, FrameMaker… Software XMLMind, XMLSpy, ArborText, FrameMaker…

DocBook Vs DITA – Make your own decision Slide t2a Communications - LiveTechDocs Medium to large Small to medium Budget One month plus Immediate Integration time frame XML, FrameMaker XML, MS Word, FrameMaker Documentation input Various PDF, HTML, HTMLHelp Documentation output Large Small to medium Documentation volume

DocBook Vs DITA – The End Slide Thank you! Time for Q&A… t2a Communications - LiveTechDocs

Weitere ähnliche Inhalte

Ähnlich wie DocBook vs. DITA: Will The Real Standard Please Stand Up?

Doc Book Vs Dita Teresa

day

Doc Book Vs Dita

day

Introduction to DITA

Chanaka Palliyaguru

TWC 545 Presentation-DITA

Linguistic Atlas Project

OASIS DITA History(2009)

Don Day

Putting quality to the test ... How do you define quality in content conversion? Is it only about the output? Or do the performance, speed and reliability of the process matter too? Stilo has put its leading OmniMark content processing solution to the test to see how it stands up against the DITA Open Toolkit. See the results of this technical benchmarking exercise in the following presentation and contact Stilo to learn how you can accelerate the adoption of DITA with OmniMark. www.stilo.com

Dita Accelerator Xml2008

Stilo International

DITA getting started

Raghu nath

Presented at DocTrain East 2007 by Bob Doyle, DITA Users -- This introduction to XML Authoring will acquaint you with over fifty tools aimed at structuring content with DITA. They are not just DITA-compliant authoring tools (editors) for writers. They also include content management systems (CMS), translation management systems (TMS), and dynamic publishing engines that fully support DITA. You will also need to know about tools that convert legacy documents to DITA and help to design stylesheets for DITA deliverables. The best DITA tools for technical communicators implement the DITA standard while hiding all the complexity of the underlying XML (eXtensible Markup Language). As a tech writer and not a tech, you should be able to forget about XML - except to know that you are using it (DITA is XML) and that it consists of named content elements (or components) with attributes. You need to know enough about the content elements so you can reference (conref) them for reuse. You need to know about their attributes so you can filter on them for conditional processing. And you should appreciate that because components are uniquely identifiable they lend themselves perfectly to automated dynamic assembly using a publishing engine. We will describe how you can get started with structured writing without knowing XML or installing anything. The promise of topic-based structured authoring is not simply better documentation. It is the creation of mission-critical information for your organization, written with a deep understanding of your most important audiences, that can be repurposed to multiple delivery channels and localized for multilingual global markets. You are not just writing content, you are preparing the information deliverables that enhance the value of your organization in all its markets. To do that well, you must understand the latest tools in structured writing that are revolutionizing corporate information systems - today in documentation but tomorrow throughout the enterprise, from external marketing to internal human resources. Whether you are trying to push a new product into a new market or are “onboarding” a new employee, the need for high quality information to educate the customer or train the new salesperson is a challenge for technical communicators. You need to think outside the docs! The key idea behind Darwin Information Typing Architecture is to create content in small chunks or modules called topics. A topic is the right size when it can stand alone as meaningful information. Topics are then assembled into documents using DITA maps, which are hierarchical lists of pointers or links to topics. The pointers are called “topicrefs” (for topic references). Think of documents as assembled from single-source component parts. Assembly can be conditional, dependent on properties or metadata “tags” you attach to a topic. For example, the “audience” property might be “beginner” or “advanced.” At a still finer level of granularity, individual elements of a topic can also be assigned property tags for conditional assembly. More importantly, a topic element can be assigned a unique ID that makes it a content component reusable in other topics. As you will learn, DITA is a leading technology for “component content management,” which multiplies the value of your work. You need to leverage DITA and structured content to multiply your income.

Painless XML Authoring?: How DITA Simplifies XML

Scott Abel

Drupal for dita - n ldita

Kristof Van Tomme

Intro to Digitization Projects

zsrlibrary

Recently we published an alpha version of the DITA module for Drupal, a community driven Open Source CMS that powers 1% of the Internet. The module contains the tools for uploading topics individually or in bulk, it let's you author DITA topics in forms and it has a Graphical User Interface that let's you create mindmaps that can be used as DITA maps. The DITA maps so created, together with their referenced topics can also be exported using the DITA Open Toolkit integration. In this talk you'll get an introduction to Drupal and the DITA module and you'll learn how we want to use it to help our community write better, more reusable documentation.

DITA in the Open Source CMS Drupal - Baltimore 2011

Kristof Van Tomme

Keep Calm and Specialize your Content Model

ctnitchie

Mathew DITA Deep Dive

akashjd

Doctraineast2008

bobdoyle

This ebook is based on a blog series leading up to the IDEAlliance XML 2010; eMedia Revolution conference. In each chapter, I present one of the ideas that provide the foundation of my presentation at that conference. Reduce costs and complexity with a strategy that includes XML standards adoption, structured content creation and a digital-first workflow. As eMedia devices and delivery systems proliferate, publishers, agencies and traditional media service providers are challenged with keeping up with demand for content conversion. Content distributors can reduce costs and complexity with a strategy that includes adoption of XML standards, a component architecture for structured content creation and a workflow that adheres to a digital-first orientation.

Trekk cross media series using xml to create once - distribute everywhere - e...

Jeffrey Stewart

Presented by Thomas Aldous at Documentation and Training East 2008, October 29-November 1 in Burlington, MA. This session is for anyone that is interested in learning how to manage a transition to Specialized DITA including Content Management Systems, Editors and Publishing Server issues and resolutions. As a added bonus, we will also convert an Word Document To Specialized DITA and edit the content is FrameMaker 8. There will be a question and answer period at the end of the session for both technical and project management issues.

[Case Study] - Nuclear Power, DITA and FrameMaker: The How's and Why's

Scott Abel

Single Sourcing_Drupal

Javeria Begum

DITA-Workshop on Saturday 5 May 2018 at Pune

Amit Siddhartha

Dita webinar 20th march

Metapercept

Dita ot pipeline webinar

Suite Solutions

Ähnlich wie DocBook vs. DITA: Will The Real Standard Please Stand Up? (20)

Doc Book Vs Dita Teresa

Doc Book Vs Dita

Introduction to DITA

TWC 545 Presentation-DITA

OASIS DITA History(2009)

Dita Accelerator Xml2008

DITA getting started

Painless XML Authoring?: How DITA Simplifies XML

Drupal for dita - n ldita

Intro to Digitization Projects

DITA in the Open Source CMS Drupal - Baltimore 2011

Keep Calm and Specialize your Content Model

Mathew DITA Deep Dive

Doctraineast2008

Trekk cross media series using xml to create once - distribute everywhere - e...

[Case Study] - Nuclear Power, DITA and FrameMaker: The How's and Why's

Single Sourcing_Drupal

DITA-Workshop on Saturday 5 May 2018 at Pune

Dita webinar 20th march

Dita ot pipeline webinar

Mehr von Scott Abel

2023 Challenges and Opportunities Impacting Technical Documentation Team Capa...

Scott Abel

A new era of computing—The Cognitive Era—is taking shape right now. It promises monumental change; altering forever the way we create, manage, and deliver content. Over the next two decades cognitive computing will radically transform every aspect of our field. It will change the way human beings around the globe live and work. It will change the way business solve problems and make decisions. And, it will provide us with powerful methods of enabling customer success. The Cognitive Era is not science fiction. It’s science fact. It’s here today. Let’s explore the possibilities.

The Cognitive Era and the Future of Content

Scott Abel

A new era of computing—The Cognitive Era—is taking shape right now. It promises monumental change—altering forever the way we create, manage, and deliver content. Over the next two decades cognitive computing will radically transform every aspect of our field. It will change the way human beings around the globe live and work. It will change the way business solve problems and make decisions. And, it will provide us with powerful methods of enabling customer success. The Cognitive Era is not science fiction. It’s science fact, and it’s here today.

The cognitive era and the future of content

Scott Abel

One of the biggest problems facing content marketers and other content professionals today is their inability to create content that establishes a brand as a thought leader. There's never enough time to create all the content needed. This presentation examines an influencer marketing campaign that takes advantage of content manufacturing and that leverages the unified content strategy. While you may not leverage the same tools and standards that we did, the concepts are applicable to almost any content producing organization.

Establishing thought leadership with content manufacturing and influencer mar...

Scott Abel

Content marketing production processes are broken. Most organizations can’t crank out the wide variety of content needed because their processes are outdated, inefficient, and riddled with waste. Oh, and then there are tools. Content marketers don’t have the right ones for the jobs at hand. In this presentation, content strategy guru Scott Abel, The Content Wrangler, will demystify the benefits of intelligent content for content marketers and outline the changes needed in order for marketers to take advantage of the approach. Attendee takeaways: How adopting intelligent content can turn a content marketing department into a content marketing factory How some brands are leveraging intelligent content to produce more content with less effort Lessons learned from the pros working in the trenches What you’ll need to get started #CMWorld

Creating A Digital Content Factory: Getting Started with Intelligent Content

Scott Abel

In the Experience Age, consumers expect much more from brands than they have in the past. Once they’ve enjoyed an exceptional customer experience, they become intolerant of confusing, irrelevant, and inconsistent content. Brands that recognize this fact and deliver exceptional content experiences across all customer touchpoint will be rewarded with loyalty. In order to deliver exceptional content experiences, savvy brands are taking a critical look at how they create, manage, and deliver content. And, what they’re finding is that the approaches they’ve relied on for decades can no longer meet current and future business needs. Enter intelligent content. Content with superpowers. Content that is designed to dynamically adapt to meet customer needs. It’s content that is digital, data-driven, and dynamic. It’s digital in that it is designed and built for a connected world. It is data-driven in that can be connected to — and integrated with — enterprise data resources. And, it’s dynamic in that it can automatically respond to individual customer needs. During this opening keynote presentation (originally delivered at the Intelligent Content Conference in San Francisco, March 2015), Scott Abel, The Content Wrangler, and co-founder of the Intelligent Content Conference will explore the need for intelligent content in the Experience Age. You’ll discover why our current processes are insufficient, and what some companies are doing to overcome traditional publishing roadblocks.

Intelligent Content in the Experience Age by Scott Abel, The Content Wrangler

Scott Abel

Did you know that the average human brain processes information that is more visual up to 60,000 times faster than text? But wait! Text is visual right? Not in the same way. Photos, videos and other visual mediums communicate on a whole 'nother level than a paragraph of text. The rise of visual content marketing over the last couple of years has been driven by bevy of platforms and tools that give little excuse to not include it into your marketing efforts. Join Adam Helweh as he identifies these trends, explores the tools and helps you create a more vibrant visual marketing mix for your audience. You will learn: • Why is visual content more effective than other types of content • What emerging trends and tools are driving the use of visual content • How to go beyond the confines of the static image to make visual content that’s more alive and engaging. This presentation was given at Content Strategy Applied USA on November 17-18, 2014

Emerging Trends in Visual Content Marketing with Adam Helweh

Scott Abel

Today, business is digital. That makes content critical. Content now represents nearly a third of marketing budgets alone (Content Marketing Institute), and that proportion will only increase. Content also is the substance of most digital media products and digital channel communications. So, you might have enjoyed some success with implementing a content strategy for a single product, channel, or marketing campaign. Now, imagine repeating that success. How do you make your content strategy scale across products, brands, channels, markets and more? It's a question that often brings up many, many, MANY more questions for midsize and enterprise organizations. This session will help you answer them with a practical vision and 3 useful principles to scale your content strategy. This presentation was given at Content Strategy Applied USA on November 17-18, 2014

Scalable Content Strategy: Nice Thought or Viable Vision? with Colleen Jones

Scott Abel

When creating websites and apps for a multinational organization like IBM or GE, how do you ensure that global content is easily adaptable and translatable? Especially when you're creating content that needs to be accessed via tablet, phone and desktop? This presentation covers the basics of creating global content strategy for audiences with varying needs based on geography and language. This presentation was given at Content Strategy Applied USA on November 17-18, 2014

Content Strategy Across Geographies and Platforms with Melinda Flores

Scott Abel

You CAN prove the savings possible from moving your unstructured content to intelligent content. The benefits are measurable. Intelligent content combined with a content management system can facilitate savings and improvements in content development, translation, regulations, governance, multi-channel publishing, and quality. In this session, Mark discusses how the various processes benefit from intelligent content and discusses metrics that prove the benefit. If it hurts, then it's time to calculate the pain — and the relief. This session draws from concepts in Mark's book, DITA Metrics 101, The Business Case for XML and Intelligent Content. Mark also discusses which metrics you should gather so you can align your plan with corporate strategy and become the "Executive Whisperer." This session is part of The Content Wrangler Virtual Summit on Advanced Technical Communication Practices, December 4-5, 2014. Hosted by BrightTALK. Sponsored by SDL, Astoria Software, Acrolinx, oXygen XML Editor, Logos, Scriptorium, and Oberon Technologies.

The ROI of Intelligent Content with Mark Lewis, DITA Educator, Quark

Scott Abel

Content strategy is about so much more than streamlining your content development process—it's about supporting your organization's business goals. To be truly effective, your content strategy should be global. That means breaking down the barriers that keep the different types of content producers in your organization apart. Your organization creates various kinds of content—technical, marketing, training, and more. Your content strategy may begin with tech comm, but it should also account for these other types of content to present a unified message and better serve your brand. This presentation shows how, with a global strategy, all of your content can work together to help your organization succeed. Gretyl Kinsey is a technical consultant with Scriptorium Publishing who specializes in content strategy and tech comm tools and technologies. Since joining Scriptorium in 2011, she has been involved with the development and implementation of content strategies for organizations in a variety of industries. She has experience with every step of the implementation process, from customizing transforms to converting legacy content to helping with follow-on support. She also frequently contributes her graphic design skills to the marketing side of Scriptorium. With a background in journalism and visual communication, she is interested in the convergence between technical and marketing communication, and in content strategies that encourage it. This session is part of The Content Wrangler Virtual Summit on Advanced Technical Communication Practices, December 4-5, 2014. Hosted by BrightTALK. Sponsored by SDL, Astoria Software, Acrolinx, oXygen XML Editor, Logos, Scriptorium, and Oberon Technologies.

Content Strategy for Technical Communication and Beyond with Gretyl Kinsey, S...

Scott Abel

Once a prospect buys a product or service, the content they interact with is no longer familiar. The instructions provided don't look, feel, or sound anything like the marketing and sales materials that introduced them to your brand. Neither does the service contract, the warranty, the customer support website, the product documentation, nor the training materials. The extensive variability in customer experience — and each customer touchpoint — creates a different and inconsistent version of the brand, some that bear little or no resemblance to the brand that executives believe they are building. There are often as many brands as there are touch points. For no good reason, the content experience changes drastically -- and not in a good way. That's why organizations that recognize the importance of a unified customer experience have started rethinking what it means to be customer-centric. Some forward-thinking organizations are reorganizing customer-facing content creators into teams under one roof. They're breaking down the barriers — the silos — that prevent them from collaborating; from creating a unified customer content experience. In this presentation, Scott Abel, The Content Wrangler, discusses the challenges of content inconsistency and incongruity, and why he thinks the future of technical communication is marketing. This session is part of The Content Wrangler Virtual Summit on Advanced Technical Communication Practices, December 4-5, 2014. Hosted by BrightTALK. Sponsored by SDL, Astoria Software, Acrolinx, oXygen XML Editor, Logos, Scriptorium, and Oberon Technologies.

The Future of Technical Communication is Marketing with Scott Abel, The Conte...

Scott Abel

In this webinar, Matt and Greg explain what Global English is and who it benefits, introduce you to some Global English techniques that you can implement immediately, and they examine a couple of case studies of companies who have implemented Global English—and have experienced dramatic results. This session is part of The Content Wrangler Virtual Summit on Advanced Technical Communication Practices, December 4-5, 2014. Hosted by BrightTALK. Sponsored by SDL, Astoria Software, Acrolinx, oXygen XML Editor, Logos, Scriptorium, and Oberon Technologies.

Clear and Simple: Lower Your Content Costs with Global English with Matthew K...

Scott Abel

Andrew Thomas shows you a fast-paced look at how to leverage content to cultivate a loyal customer base. Andrew Thomas is a Director of Product Marketing for Content Management Technologies at SDL, focusing on structured content technologies. Andrew has worked with XML for a wide variety of content, from marketing materials, to printed manuals and web applications. He's witnessed firsthand, the diversity of structured content and how it can empower businesses and customer engagement. Before joining SDL, Andrew was a language intelligence solutions manager for Adobe Systems and oversaw the translation process for their DITA content. This session was part of The Content Wrangler Virtual Summit on Advanced Technical Communication Practices, December 4-5, 2014. Hosted by BrightTALK. Sponsored by SDL, Astoria Software, Acrolinx, oXygen XML Editor, Logos, Scriptorium, and Oberon Technologies.

Fandom Isn't Random with Andrew Thomas, SDL

Scott Abel

George Bina explores the world of XML authoring for technical documentation. He shares tips and tricks designed to help technical communicators understand the advanced information management capabilities structured XML authoring provides over traditional authoring approaches. Specifically, George addresses the following questions: How do I know what content to create? What XML markup should I choose and why? How do I leverage markup to engineer better authoring experiences? How to we enforce content rules in XML documents? Why correcting content problems during the authoring process can help you reduce costs? This session was part of The Content Wrangler Virtual Summit on Advanced Technical Communication Practices, December 4-5, 2014. Hosted by BrightTALK. Sponsored by SDL, Astoria Software, Acrolinx, oXygen XML Editor, Logos, Scriptorium, and Oberon Technologies.

Deep Dive: Structured XML Authoring with George Bina, oXygen XML Editor

Scott Abel

Once a prospect buys a product or service, the content they interact with is no longer familiar. The instructions provided don't look, feel, or sound anything like the marketing and sales materials that introduced them to your brand. Neither does the service contract, the warranty, the customer support website, the product documentation, nor the training materials. The extensive variability in customer experience — and each customer touchpoint — creates a different and inconsistent version of the brand, some that bear little or no resemblance to the brand that executives believe they are building. There are often as many brands as there are touchpoints. For no good reason, the content experience changes drastically -- and not in a good way. That's why organizations that recognize the importance of a unified customer experience have started rethinking what it means to be customer-centric. Some forward-thinking organizations are reorganizing customer-facing content creators into teams under one roof. They're breaking down the barriers — the silos — that prevent them from collaborating; from creating a unified customer content experience. In this presentation, delivered at Acrolinx Day at LavaCon 2014 Portland, Scott Abel, The Content Wrangler, discussed the challenges of content inconsistency and incongruity, and why he thinks the future of technical communication is marketing.

The Future of Technical Communication is Marketing

Scott Abel

Time is in short supply. Deadlines are tight. Resources are even tighter. If you're like most content professionals, you have dozens of great ideas but not enough time, money or experience to bring them to life. But it doesn't have to be this way. In this content marketing meets intelligent content engineering case study, we will explain how the newly published book, The Language of Content Strategy (XML Press) was created with the help of the crowd, structured XML content, a wiki and a formal content strategy. Attend this session to learn how the two seasoned content strategists enlisted the help of 50 knowledgeable experts to create a printed book, an e-book, a companion website and educational flash cards in record time, all from a single source of content. You'll discover why it's imperative that content professionals —regardless of their area of specialty — understand and leverage the power of advanced information development practices. You'll leave knowing why a repeatable content production system, optimized for productivity and designed to efficiently produce multiple content products simultaneously, is no longer an option, but rather a necessity.

The Making of 'The Language of Content Strategy' - by Scott Abel, The Content...

Scott Abel

Getting the right information to the right people, at the right time, in the right format, and in the right language is the goal of every professional technical communicator. But, the pace of change is fast, and each and every step forward is often accompanied by two steps back. That’s because the speed of technological change is outstripping our ability to keep up. It seems we’re always playing catch up. But, it doesn’t have to be that way. In this slide deck, Scott Abel, The Content Wrangler, showcases five powerful information technology innovations that, when harnessed by professional technical communicators, can help us future-proof our content and ensure we’re meeting – even exceeding – our goals.

5 Revolutionary Technologies Technical Communicators Can’t Afford To Ignore

Scott Abel

Getting the right information to the right people, at the right time, in the right format, and in the right language is the goal of every professional content marketer. But, the pace of change is fast, and each and every step forward is often accompanied by two steps back. That’s because the speed of technological change is outstripping our ability to keep up. It seems we’re always playing catch up. But, it doesn’t have to be that way. In this Content Marketing World 2014 presentation, Scott Abel, The Content Wrangler, showcases five powerful information technology innovations that, when harnessed by professional content marketers, can help us future-proof our content marketing efforts and ensure we’re meeting – even exceeding – our goals.

Content Marketing Futurist: Revolutionary Technologies Content Marketers Can’...

Scott Abel

In this presentation from Localization World Singapore, April 2013, Scott Abel explores the importance of thinking strategically about content (how it is created, why its created, and the goals of global content initiatives) by helping the audience understand the importance of vision in content strategy. The presentation also touches on how organizations can find time for innovation and provides several resources for content strategy professionals.

Thinking Strategically About Content - Localization World Singapore

Scott Abel

Mehr von Scott Abel (20)