Hi Tony, A couple of years ago, I did a whole bunch of work on DocBook for a different project, creating a user manual from scratch, but that was all v4.x, so I can't comment on upgrading the source code from v4 to v5.
However, I can say that my greatest learning resource was other open source projects. Specifically - GIMP (http://docs.gimp.org/help.html) - mplayer (http://www.mplayerhq.hu) have good docbook implementations. I don't know if these projects have changed docbook version, but I am sure that other people must have gone through what you are going through now. My advice would be to look for how someone else has done it for hints. If you haven't already been reading the 4.x 5.0 transition guide you should take a look: http://www.docbook.org/docs/howto/ Finally I would add that docbook V5.0 is not fully finalised yet. My guess is that in time, the support (i.e. validators, stylesheets, translators, etc) for it will improve. The XSLT stylesheet for doing the transform may improve too: http://www.docbook.org/docs/howto/#convert4to5. It probably won't help fix a build script though. Dave P.S. Right now your best asset is your enthusiasm! Don't give up! On Fri, 30 Nov 2007 11:47:05 -0500, "Tony Rogers" <[EMAIL PROTECTED]> said: > 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" > --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
