John Maddock wrote: > Rene Rivera wrote: >> The big warning about the docs, as they are presented on the beta web >> site: They override, disregard, and literally throw away the style >> information in the source docs. How that happens is that the ZIP
> I thought that one of Matias's aims was to develop "one true style" > suitable for the web, Boostbook .css and pdf formats. Especially now > that more and more of Boost is getting "quickbooked". The point to realize about web site vs. boostbook vs. pdf is that they each target different audiences. If you try to make the all the same you'll end up with inferior results in all of them. One simple aspect is one can use different fonts in pdf as it has better rendering. I agree that it is worth having similar look for them, but there are some things that are not likely to change in the web site versions, link colors come to mind. This is because we, meaning me, already spent considerable effort in finding a style that everyone was happy with. I really don't want to repeat that process. >> The content of the header, i.e. the search box, will not be available >> on the web site. And hence will *only* be available in the downloaded >> release. This also happens to be the one context under which it's >> likely not usable as the person might not have network access. > > IMO that would be a huge shame: have you seen the navigation lists > Matias has added : > http://www.drivehq.com/web/matias.capeletto/bimap/doc/html/index.html > these are just so cool and *useful* that propagation of these to the web > site is surely a must have feature, once Matias has the details worked out. Yes, it's good. But it's not going to be available in the header. But we will have to find some other way to present them on the web site. >> Not specific to Matias doc style, but the BoostBook style. The >> headings are too big. This is likely because of the usual style >> escalation >> present in so many documents. > > I disagree, and find the heading in the website syle too small. Sorry. Interestingly... that's a bug in the boostbook XSLT. It's spitting out headers that are too small, for the context. Most likely someone though the headers where coming out too big and decided to change from say H2 to H3, and H3 to H4. > Difficult one this, I'm very much in the "less is more" camp here, but I > do find that a slight tint to code blocks helps out. I'm neutral on the > border issue. * How does the tint help out for you? * A thin light border is fine. A think border is not. Any border plus a tint is also too much. You always have to ask yourself: Why do I need this style element? If the answer is: To make it stand out. Then you need to really think if you should fix what it's trying to stand out against. > I agree the code should be smaller than the body text, and I believe it > is: 9pt rather than 10pt, and IMO about right. That would be fine... But Matias has both at 10pt. I can't compare what I have the same way as the font size changes depending on the browser used, so I use relative font sizes. Regular text is 100%, and the code is at 90%. > Maybe I'm just getting > old, but I find the web page you reference really rather hard to read: > in the code blocks especially the font is too small, OK. > and full of some > strange symbols? See screenshot attached (Firefox on Windows). Yep... It's a character decoding issue when extracting from the zip (since I have to use an external program). > I also find your titles rather hard to spot next to the body source. OK. -- -- Grafik - Don't Assume Anything -- Redshift Software, Inc. - http://redshift-software.com -- rrivera/acm.org - grafik/redshift-software.com -- 102708583/icq - grafikrobot/aim - grafikrobot/yahoo ------------------------------------------------------------------------- This SF.net email is sponsored by DB2 Express Download DB2 Express C - the FREE version of DB2 express and take control of your XML. No limits. Just data. Click to get it now. http://sourceforge.net/powerbar/db2/ _______________________________________________ Boost-docs mailing list [email protected] Unsubscribe and other administrative requests: https://lists.sourceforge.net/lists/listinfo/boost-docs
