Anaconda documents

[Paul W. Frields]

On Thu, 2003-11-20 at 13:02, Tom Diehl wrote:
> > Taking a look at the Documentation project site, I see that I need
> > Docbook XML, stylesheets, Emacs PSGML (or NXML), etc.  What is the
> > learning curve for these?  I have never done XML, and I am not an Emacs
> > user (sorry to start a flamewar).  Perhaps I could write the text and
> > someone with more knowledge of XML/Emacs could put it into the right
> > format.  I am not unwilling to learn XML/Emacs, but my time might be
> > spent better elsewhere.
> 
> Are there non-Emacs solutions available for this??

I hadn't used Emacs or PSGML before trying them for this project; it is
not too hard to learn. If you follow the Documentation Guide up at the
Fedora pages, that's the best intro available right now for that
toolbox, at least insofar as it concerns FDP. Also you can try out the
RPM available at:

ftp://people.redhat.com/twaugh/docbook/nxml-mode

This makes the process a little easier and more automated, apparently. I
don't particularly enjoy writing markup like this, and think it would be
great if someone got templates for OO.o or LyX that worked correctly for
the FDP, but I've got the hang of it under Emacs at this point. I've
already written a very short updfstab tutorial. If someone would like me
to edit their document and do the markup, let me know and I'll be happy
to help. Furthermore, if anyone is interested in making OO.o or LyX work
for FDP, we could try that too.

The hardest part of the process, IMHO, is remembering where you need to
use the markups. The way I'm getting used to it is assuming that anytime
I need to make a point, there's probably a markup available. Then it
just becomes a task of (1) finding the most appropriate one, and (2)
trying to remember it for next time.

-- 
Paul W. Frields, RHCE