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/DocBook for newbies From:tarage -at- bellsouth -dot- net (imac) To:"TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com> Date:Tue, 16 Aug 2005 12:41:03 -0400
No offense to any of the posters nor their opinions, nor to anyone at all, but this level of complexity is why XML is still in diapers.
Cindy Loiselle wrote:
>On Aug 15, 2005, at 12:05 PM, Paul Moloney wrote:
>To get a feel for the process of creating documents using DocBook, I
>found it helpful to walk through the example presented in the article
>"Creating an Online Help System with JavaHelp and DocBook"
>article walks you through getting all the tools, creating a sample
>DocBook document, and processing the file to create JavaHelp. It gives
>you a feel for the tools and the process of converting a document; I
>recommend it even if you're not ultimately interested in JavaHelp. By
>now there are newer versions of some of the tools listed in this
>article--I think you'd probably be fine with the newest version of the
>XSL stylesheets (now 1.69.1), but stick to Saxon 6.5.3.
>If you decide to make the plunge, here are some questions and issues
>you need to consider:
>First, what output formats are you targeting? I convert DocBook to
>help with the tags, such as enforcing DTD compliance. I'm used to
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.