RE: XML/DocBook for newbies
From: "Lisa Hickling" <Lisa -dot- Hickling -at- realsuitesoftware -dot- com>
Subject: RE: XML/DocBook for newbies
Date: Wed, 17 Aug 2005 08:37:17 -0400
Bottom-up: First type/classify information into topics --> then your
wrap it into a package
In this sense, DITA allows you to physically classify and write your
information according to topic types (procs, concepts, references). Only
later do you concern yourself with how the information will be presented
(ie grouping topics to form a chapter, which can be easily done through
XSLT). All of this spells enhanced opportunities to reuse topics,
possibly across multiple logical chapters in different document sets.
Using DITA, information becomes more granular and flexible.
Top-down: First define a package --> then squeeze the information into
the packaged mold.
In DocBook's case, you physically encapsulate your information in
chapters, articles, etc in the following order. After you have decided
whether you're writing an <article>..or..wait..maybe it's a
<chapter>...then you proceed to create the meat of the information.
Finally you hope that the structure you started with suffices for your
project. IMHBOMO, Docbook's great if you've got a publishing deal with
SAMS. I find however that it may require more massaging than DITA does
for single sourcing. Docbook has been good to those who use it and is
certainly better supported than DITA.
This is just my rant valued at $.02. For more info/points of view stay
tuned to this or maybe later threads and don't forget to google!
Don?t just search. Find. Check out the new MSN Search! http://search.msn.click-url.com/go/onm00200636ave/direct/01/
Now Shipping -- WebWorks ePublisher Pro for Word! Easily create online
Help. And online anything else. Redesigned interface with a new
project-based workflow. Try it today! http://www.webworks.com/techwr-l
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- techwr-l -dot- com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.
- Adobe Professional glitch driving me crazy, Sarah Stegall
RE: XML/DocBook for newbies: From: Lisa Hickling
Previous by Author:
RE: Silly question on Word Styles
Next by Author: RE: Quick Frame question
Previous by Thread: Re: XML/DocBook for newbies
Next by Thread: Adobe Professional glitch driving me crazy
Search our Technical Writing Archives & Magazine