I've got the following as valid DocBook v5:
* cookbook
* manual
* quickstart guide
* faq
However, although building the documentation now succeeds for me, the
existing buildfile/stylesheets don't output most of the documentation
they are supposed to. This is due to a combination of the different
lexicon of DocBook 5, and to the XSL not understanding things like
XInclude.
I've solved the XInclude problem before on a personal project, so I went
to look at the XSL…and was absolutely overwhelmed by the complexity and
the number of XSL files.
Then I went to the Ant buildfile to see if I could make some sense of
things, and the buildfile is equally intimidating. (And on top of that,
although I love the spirit of Ant and in my admittedly very, very
limited experience with build tools, I hate Ant's use of XML. It runs
very counter-intuitive to a great deal that I've learned about markup in
the past.)
I could start by writing an HTML XSL from scratch, which is not a
terribly big deal for me. But I don't know if it would start to exceed
my boundaries as a newcomer to begin tinkering with the Ant buildfile or
much more.
I think it's starting to sink in that this is probably the most complex
project I've ever worked on, so I'm feeling a little out of my element.
Does anybody have some advice?
-- Tony | "Zearin"
