Christopher Currie wrote: > Given that this stylesheet still has issues with chunking, and doesn't > pick up some of the lesser used Docbook markup, I'd like to propose that > we use boostbook/xsl/html.xsl as a starting point; it's what I've been > using to sanity check the Boost.Build user manual. There's definitely > improvements we can make to it, but a lot of work has gone into it > already that we should leverage.
I surely agree. It would be bad if I try to use some non-mainstream Docbook element just to find out it's not supported. So using Boost.Book is really good idea. Besides, I really liked when I saw Christopher's checkin, run bjam, and immediately got html docs. > Several people commented on the Boost.Build list that they like the look > of the Spirit docs; do we want to copy this exact template, or simply > evoke the spirit (no pun intended) of them? I'm not sure about taking the entire template. For example, non-write background is a bit too progressive ;-) And in general, I think it's good to stay close to look of ordinary Boost docs. But there are some spirit elements that I personally like. 1. Section headers which a visually distinguished -- in Spirit they are right at the top with prominent background. That's the same in Reece stylesheet, BTW. 2. Nagivation arrows at the top of the page (not only bottom). It's much easier this way. 3. Nice table. Tables with 3D borders that Docbook generates by default are not even near that. 4. Prominent code examples: with background and boundaries I'm not anyway a designer, so those are just wish-list items. But OTOH, it looks like existing attempts are in like with those items. Probably the most prominent elements of Zbynek's style were table of contents and highligting for code examples. He also had nagivation arrows both on top and and botton. Reece added background for headers and top-level header. He also added background for examples. So it looks like there's no much conflicting designs. All that is needed is someone who can reskin Boost.Book ;-) - Volodya ------------------------------------------------------- The SF.Net email is sponsored by EclipseCon 2004 Premiere Conference on Open Tools Development and Integration See the breadth of Eclipse activity. February 3-5 in Anaheim, CA. http://www.eclipsecon.org/osdn _______________________________________________ Boost-docs mailing list [EMAIL PROTECTED] Unsubscribe and other administrative requests: https://lists.sourceforge.net/lists/listinfo/boost-docs
