TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
----- Original Message -----
From: <lisava -at- psitek -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Sent: Monday, August 18, 2003 3:49 PM
Subject: DITA?
>
> Hi There,
>
> I am trying to find out more about DITA, Could
someone help me.
>
> I have been looking into using docbook, but am
sceptical. I came across
> DITA, but would like to know what makes DITA better
than Docbook?
>
> Thanks
No need to be sceptical about DocBook.
While DARWIN has a DTD, but imo it's more about the
architecture of
information, than about the DTD. Considering the
history of DITA I can
understand why the DTD provided by IBM is limited. In
my experience it
usually requires major customisation to fit the needs
of most projects. Not
a good idea if you're just starting down the XML
route. It also has a poor
following, making support an issue.
You will find that most of the leading XML Editors
(http://www.xmlspy.com , http://www.oxygenxml.com , http://www.morphon.com
etc.), provide support for
DocBook. Same goes for most of the leading XML
document database systems.
This all makes the DocBook Tool Chain very flexible
and portable. Take your
choice of processors such as XALAN, SAXON, XSLTPROC,
XT, MSXML, Sablotron,
4XSLT.
DocBook is an OASIS Standard and is well documented
(http://http://docbook.sourceforge.net/ , http://www.sagehill.net)
available in XML Schema and will move to RelaxNG. The
DTD is currently at
4.3b2, meaning that it is very stable. The XSL's are
at 1.61.3 and support
transformation to TXT, PS, MAN pages, HTML, XHTML,
PDF, XSL-FO (Good for
Transform to RTF), HTMLHelp, JavaHelp.
Take a look around and you will find that rarely is
DARWIN ever mentioned.
For instance, look at this resource of XML tools http://www.garshol.priv.no/download/xmltools/cat_ix.html
. It's not
complete, but it's close. Visit the href's and you
will find DocBook
mentioned.
With these points in mind consider that more authors
know DocBook than DITA.
This broadens the talent pool from which you can
choose when you want to
outsource projects.
The mailing list (docbook-apps) is very helpful. If
you can find it in the
archives then somebody is bound to know and they are
not shy to help, see
for yourself
(http://docbook.org/wiki/moin.cgi/DocBookAppsMailingList).
A big plus for Linux users is that DocBook ships with
most distributions.
Check your /usr/share/SGML/.
However, if you want an alternative you may try TEI
(http://www.tei-c.org).
TEI is powerful, but I found the scope to all
inclusive for my needs,
DocBook is more suited to the work I do, manuals of a
technical nature.
Best of luck,
Sean
__________________________________
Do you Yahoo!?
Yahoo! SiteBuilder - Free, easy-to-use web site design software http://sitebuilder.yahoo.com