Re: [boost] RE: [Poll] New look-n-feel for Boost documentation

From: Reece Dunn (msclrhd_at_[hidden])
Date: 2004-09-30 12:13:46

Manfred Doudar wrote:
> Vladimir Prus wrote:
>> Reid Sweatman wrote:
>>>> Eric Niebler wrote:
>>>>
>>>>> Joel de Guzman and I, with the help of many smart folks on the
>>>>> boost-docs list[*], have been working on improving the
>>>> look-n-feel of
>>>>> Boost's documentation. We're ready to commit the new style,
>>>> but wanted to check here first.
>>>>>
>>>>> Volodya was good enough to put up a copy of Boost's docs
>>>> with the new
>>>>> style applied. You can preview them here:
>>>>> http://zigzag.lvk.cs.msu.su/~ghost/boost_docs/
>>>>>
>>>>> Please say whether you like the new style or not. If not,
>>>> be specific about why.
>>>>
>>>> Speaking strictly as a user of these pages, I think it's
>>>> definitely an
>>>> improvement, much cleaner, and better from where we were.
>>>>
>>>> I would however suggest that an option (and only as an option) be
>>>> provided to view a chapter in one page rather than having to navigate
>>>> back and forth (with <- , -> at the bottom of the pages).
>>>> Even better
>>>> still, the "Table of Contents" for each chapter, if it were
>>>> to appear on
>>>> each page of the chapter would be very desirable, most useful and
>>>> convenient.
>>>
>>> <snipped>
>>>
>>> I agree, especially with the remark concerning a single-page option; why
>>> not
>>> turn that into a "print version" if possible?    
>>
>> Does ability to generate PDF output amounts to "print version"? 
>> Personally,
>> I find PDF output which can be printed with one click one of the killer
>> features of BoostBook.
>>
> As long as we can print that's ok by me, but on the otherhand, it's 
> always a convenience to be printer-friendly with HTML

Indeed. And this is very easy to do: place all the 
colouring/"screen"-specific styles inside a
    @media screen{ ... }
block in the CSS code and the printer stuff in
    @media print{ ... }

Therefore, placing the link colours in screen will ensure they do not 
appear blue or whatever in the printed versions.

Regards,
Reece