Re: [boost] [Boost.Book] How to go full-bleed on documentation image headers?

Subject: Re: [boost] [Boost.Book] How to go full-bleed on documentation image headers?
From: Daniel James (dnljms_at_[hidden])
Date: 2016-08-29 06:21:34

On 26 August 2016 at 15:16, Vinnie Falco <vinnie.falco_at_[hidden]> wrote:
> On the Boost website, the image in documentation headers is full bleed
> (no white border). For example:
> http://www.boost.org/doc/libs/1_61_0/doc/html/boost_asio.html
>
> How do I achieve this in my own documentation? I have set the image in
> the Jamfile, but I have no idea how to adjust the border:
> http://vinniefalco.github.io/beast/index.html
>
> The Jamfile and supporting source files are here:
> https://github.com/vinniefalco/Beast/tree/master/doc

The header on the website is actually added by a php script, not by
boostbook. I was going to suggest doing it in CSS, which is possible
but the markup boostbook generates for the header is pretty bad and
makes it difficult, so instead I think I'll implement an alternative
header style that you can set. Maybe using something like
'nav.border=Fullbleed', or perhaps by adding an option to let you use
your own css class and style it yourself? I'll try to get that done
after the new release.

I put up a quick attempt at:

https://github.com/danieljames/boostbook/commits/feature/header-image-options

Although it won't work properly without extra CSS along the lines of:

.header-fullbleed { margin: -1em -1em 0 -1em; overflow: hidden; }
.header-fullbleed img { display: block; }