DocBook versus DITA
DocBook
DocBook is a markup language and is used for technical documentation of all sorts.
It allows users to create documents which can be published in many formats such as HTML and PDF without making any changes to the source code.
The DocBook format is based on XML, which makes it easier to read by both humans and machines.
Advantages of DocBook:
Same document can be translated to both web-based and printed document format.User can concentrate on the content rather than its form.Has very good documentation. Provides good support.Is very useful for delivering documents such as single books.
Darwin Information Typing Architecture (DITA)
DITA is a recent innovation in XML publishing.
The name stands for:
Darwin: Uses the principles of specialization and inheritance.Information Typing: Identifies topics that contain different types of information such as concept, task, and reference.Architecture: Provides space for new applications and also for extension within the available applications.DITA works on a modular approach. In DITA, each component of information is considered as a topic. These topics can be combined and reused to form documents. DITA has a number of topic types, like task, concept, and reference. A task topic describes the procedure to accomplish a task. Concept consists of definitions, rules, etc. A reference topic explains instructions and various reference materials. You can define a new topic type by specialization. Specialization allows you to create a new topic based on the properties of an existing topic.
Advantages of DITA:
Encapsulation: Each person is responsible for their job, which increases security. For example, a person creating a topic needs to know the elements pertaining to the topic type, whereas the person using the topic needs to know only how to use it.Polymorphism: Topics can be created as more generic categories for common use.Topics can be reused easily.XML can be modified easily to suit user needs.
Differences between DocBook and DITA
DocBook has been available for many years and is robust and strong compared to DITA. DocBook was initially designed for print and PDF output, but it has now expanded to generate online Help. DITA was not designed for printed output, but was created to use the concept of topic and topic types.DocBook uses hierarchy whereas DITA makes separate topics, which can be combined as required.DocBook has a fixed set of elements. DITA can be extended, allowing the user to add more elements as per individual needs.DocBook has good documentation whereas DITA is too new to be well documented.Expansion of XML is better supported by DITA than DocBook.
Conclusion
DITA makes it easier for content reuse. It is useful if you want to reuse many topics. However, if you are writing a single, long document like a book, DocBook would be a more reliable choice.
Related Tags: technical writing, docbook, dita
Shweta Katdare is a writer with 24 by 5 Tech Comm, a technical writing company that specializes in fast, high-quality writing and editing. For more articles on writing, technology and business, sign up for the 24 by 5 Tech Comm Newsletter at www.24by5.com.
Your Article Search Directory : Find in ArticlesRecent articles in this category:
- 10 Mistakes to Avoid When Writing an Article
Here are 10 mistakes that writers tend to make when writing articles for newsletters or magazines. K - Invigorate Your Healthcare Writing With Words That Are Short, Sweet, And Full of Energy
There are certain kinds of phrasing and word choice, especially in official statements, that can soa - The Case For Customizing Content
You have to consider every angle when you are writing. There are lots of rules to follow and tips to - Writing Strategies For Creating Viral Content
For anybody involved in content marketing the need to develop writing strategies that will produce t - Three Key Ways a Writing Coach Can Improve Your College Admission Essay
In an article entitled "Writing The Essay: Sound Advice from an Expert", Parke Muth, Senior Assistan - Acquiring A Fantastic Proxy - Proxy List
A proxy or proxy server is applied for both effortless obtain to your certain useful resource like a - Turnkey Sites & Website Templates - A Comparison
I'm constantly finding emails soon after a person buys a offer of Site Desing templates. Some men an - Standard Manual For Laptop Or Computer Elements & Software
For many people today, computer system sections plus the innards of the computer system are anything - Different Kinds Of Cameras Can Be Used For Webcams
There are many physical components that make the technology of the PC camera webcam work. The import - What Can Pc Camera Webcam Bring To Us And How It Works?
The PC camera webcam can be used in a wide range of aspects. Such as personal "Big Brother" style di
Most viewed articles in this category:
- Don't Put Off Writing that Book!
If writing that book you've always had in mind tops your list of resolutions or regrets, hiring a wr - How To Write A Better Press Release
A press release is the most effective way to generate free publicity for your business or organizati - Writing on the Hoof
Finding inspiration when you are writing is often a haphazard affair. When you are physically ready - Focus On Nigeria
Focus on Nigeria Nigеria is a natural gas and oil rich country that is bordеrеd b - How to Write Great Dialogue in Your Book
Dialogue isn't so much read as it is heard by the reader. The eyes see the words on the page, the b - Women SUV Driver from www.thefrap.com
Why do so many women drive around in the oversized SUV's, the Tahoe, Excursion, Escalade - How To Write Good Articles
As a writer you may be ready to cash in on the need for web content. There is a lot of money that c - NEWS FLASH: Technical Communicator Saves World
I had a boss several years ago who was amused by my earnest and relentless preaching about the impor - Writers Resources
Writers use certain inherent talents to come up with their pieces of writing. However, they do need - Popular Articles
Articles are those that are available in plenty these days in the internet. The articles are written