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.
Subject:RE: XML in documentation From:"Brierley, Sean" <Sean -at- Quodata -dot- Com> To:"'Techwhirl Reader'" <techwhirl -at- mail -dot- technicalcommunication -dot- com>, TECHWR-L <techwr-l -at- lists -dot- raycomm -dot- com> Date:Thu, 16 Dec 1999 09:25:42 -0500
What are you looking to do with XML? How does XML streamline your
documentation process more than SGML would . . .? XML is getting a lot of
hype right now, but is there anything beyond the hype, at this point?
For example, I write once in FrameMaker. I publish to PDF for online book
and MS HTML Help via WebWorks publisher, all without changing the source. If
I chose, I could import a second Frame template into my book to create a
radically different look from my one document source, such as a 4:3 aspect
ratio. Similarly, WebWorks Publisher, heck even FrameMaker's native filters,
take me to HTML ( with CSS and, Frame has XML export, after a fashion). With
FrameMaker + SGML, XML is even more approachable.
So, what are you getting XML to do for you. Where are you publishing, and
are you getting there by swapping DTDs?
I was wondering if anybody is currently implementing XML in any
fashion in their documentation systems
What are some tips you might have for someone looking to do a full
implementation of XML? How are you handling online display (XSL, CSS,
etc.?), and the print format (maybe you use Frame+SGML or some other tool?).
Sure you can go with something like BladeRunner and pay $40,000, or
something similar if not more for Arbortext's Epic, but what are some
feasible options you might be aware of or you might currently use?
The problem I'm experiencing is trying to evaluate the right tools
for the job. Sure you can create XML in Frame+SGML, but I don't believe it
has any XSL tool. Plus it's XML functionality is not embedded--it just has a
"Save As" option as far as I know. I imagine this may present problems.
Especially since I don't think you can use an XML DTD with it--only SGML.