Oops! I thought we had removed the faq by now. Sorry for that Tony. I will
remove it immediately.
The docbook version of the FAQ was replaced by maintaining it in HTML (in
2002). Actually I notice some commits in 2004 and 2006. I wonder why.
/Linus
2007/11/30, Tony Rogers <[EMAIL PROTECTED]>:
>
> 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"
>
>
>
