Joel de Guzman wrote:
David Abrahams wrote:
Joel de Guzman <[EMAIL PROTECTED]> writes:
Hi,
I still don't understand why there needs to be a difference
between the L&F of the "standalone" documentation and the "web"
based documentation. Is there a rationale?
I personally think that the website documentation and downloaded
documentation should have the same L&F (which should be true as they are
taken from the same source). However, the PDF documentation should look
professional for that media without any artifacts taken from the HTML
versions.
NOTE: This is another reason for moving to BoostBook -- the documentation
will get pulled into the generated PDF.
continuing this discussion. Maybe we should just let it be
and let each author choose his own L&F just as, say, W3C
does (there's no commom L&F, each document has its own style).
This would most likely make the documentation less professional and look
like it was all just grouped together in an ad hoc manner. Consistency is
good.
I agree that having a little color is a really nice thing. And
Spirit's banner is beautiful.
Color is good! Otherwise, we'll still be viewing monochrome
TVs and monitors ;)
Both colour and monochrome should be used (e.g. the red dress in Schindler's
List). Ideally, the colour scheme shouldn't be consciously noticed.
Font Sizes:
I prefer Rene's choice of font sizes over those we have in the
BoostBook scheme. I think the current ones we have are too big.
They work well for the headings, paragraphs and the code. I think
Rene's choice is just perfect for my taste.
Agreed.
I think everyone is in agreement of this.
Look at the Table of Contents: http://tinyurl.com/85erh
How awfully distracting (too busy). Compare:
http://tinyurl.com/b98fs
FYI, I have started to have a look at this and have removed the link
style/bullets on the ToC. Replace lines 54-63 of
/style/css_0/section-header.css with:
#content div.toc dt
, #content .section div.contents ul.simple li
{
display: block;
margin: 0em;
padding: 0em 0em 0em 1em;
list-style-type: none;
text-indent: 0em;
}
#content div.toc dt a:link
{
border: none;
}
#content .section div.contents ul.simple li
{
background: url(boost_bullet.gif) no-repeat 0em 0.5em;
}
This also means that the ToC links are displayed like normal text and become
blue when you hover over them. It doesn't affect the other links.
I am going to see what I can do when I have some spare time, and experiment
with BoostBook to get a hybrid between the current L&F and Rene's redesign.
- Reece
-------------------------------------------------------
This SF.net email is sponsored by: Splunk Inc. Do you grep through log files
for problems? Stop! Download the new AJAX search engine that makes
searching your log files as easy as surfing the web. DOWNLOAD SPLUNK!
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=103432&bid=230486&dat=121642
_______________________________________________
Boost-docs mailing list
[email protected]
Unsubscribe and other administrative requests:
https://lists.sourceforge.net/lists/listinfo/boost-docs
