Re: [Tads3] Eric Eve's Getting Started guide

["Nikos Chantziaras" <realnc@xxxxxxxx>]

On Monday, September 15, 2003 10:11 PM, Mike Roberts wrote:
> [...]
> So I feel a pressing need to create the documentation in such a way
> that I can automatically generate all target formats off of a single
> source base.  As long as the process is automated, there will be
> minimal cost to incremental updates to the base version, since I can
> just crank it through the generator on each update.  At first blush,
> the various after-the-fact conversions are just like this, in that
> they use some automated tool to convert from TeX to WinHelp or
> whatever; but in actual practice, the after-the-fact conversions
> always involve an enormous amount of manual tweaking, and that
> manual tweaking is never automatable because the tweaking
> information isn't ever merged back into the source material.
> [...]

Why not DocBook then?  It's somewhat funky to learn, but when you do, it's
quit useful.  A quick intro is at:

  http://opensource.bureau-cornavin.com/crash-course/

The setup can be quite compicated though; I wouldn't know how to install it
if it weren't pre-installed in my Linux-Distro.  With LyX, it's very easy to
write DocBook-Ready documentation that can be rendered in many other
formats, since you don't have to care much about XML and stuff like that.
It's worth a thought.


-- Niko