> On Thu, 23 Jan 2003, David Abrahams wrote: > > I've been watching this thread go by; kept a bunch of messages in my > > inbox because I didn't know what to make of them, and now I realize I > > still don't. It looks like there is going to be a big learning curve > > for me; I have practically no XML/XSLT experience to begin with, not > > to mention that I don't understand lots of other issues. Should I be > > doing something other than sitting on the sidelines? > > > > -Dave > > You won't need to know any XSLT unless you want to introduce additional > features into BoostBook. > > The learning curve for XML is practically nonexistant. There's a few lines > of boilerplate code for identifying a particular document as a BoostBook > document. From there on, it's just a matter of matching tags :). I've > found XML tools to be quite good: parser error messages are generally > quite obvious, and some text editors can help avoid lots of dumb mistakes. > > In the next few days I'll be writing a tutorial on BoostBook, describing > the documentation of a small library (boost::any). That should drastically > reduce the hassle of learning BoostBook, and make it feasible for others > to try it out. > > Doug
One area I would be interested in seeing some thoughts from you Dave is on how to structure the XML toolchain and build. Doug has a recommended XSLT engine and a Makefile in the sandbox, but these things are a bit outside the boost norm. The other day I got motivated to start trying out Doug's stuff, but I got bogged down in the usual Open Source issue of successfully downloading and installing Doug's recommended toolset (still haven't got it working). So I was thinking about moving over to the Apache toolset (which I am more used to) instead just too get going. But then I have to modify the makefiles etc... In the long run I would imagine we would want to treat XSLT engines just like C++ compilers -- have Jam configurations and Jam targets etc. and possibly even a list of tools that have been tried. I'm assuming we will be able to do this without modifing bjam, but given that my knowledge of the innerworkings of Jam is minimal I'm not certain what all is involved... Jeff ------------------------------------------------------- This SF.NET email is sponsored by: SourceForge Enterprise Edition + IBM + LinuxWorld = Something 2 See! http://www.vasoftware.com _______________________________________________ Boost-docs mailing list [EMAIL PROTECTED] Unsubscribe and other administrative requests: https://lists.sourceforge.net/lists/listinfo/boost-docs
