Background Image in Header

[abradshaw]

Id like to request the ability to place an image in the header of pages. Maybe even a different ones for left/right pages

[DavidGamba]

Haven't tried it on the header, but it works on the footer:

footer:
   height: 0.5in
   border_color: #000000
   recto: # odd pages
      content:
         left: '{page-number}'
         center: '©2015 {company} v{docversion}, {docdate}'
         right: 'image:common/logo.png[width=150]'
   verso: # even pages
      content:
         left: 'image:common/logo.png[width=150]'
         center: '©2015 {company} v{docversion}, {docdate}'
         right: '{page-number}'

Just make sure your imagesdir and base_dir is set.

[abradshaw]

Thanks David, you are right that does work and is even documented here https://github.com/asciidoctor/asciidoctor-pdf/blob/master/docs/theming-guide.adoc#running-header-footer

I described my issue wrong, what I actually want is to be able to place a background image across the whole width of the header and place text on top of it

So I guess my issue should read "Background Image in Header" [just edited it to say that]

Thanks for the info though

[mojavelinux]

This certainly seems like a reasonable request. We should probably support a background image or background color.

[mojavelinux]

As it turns out, background color is already supported. We just need support for a background image then.

[mojavelinux]

Currently, if a background color is specified, it will span the width of the page. Should we use this same behavior for a background image?

The fit attribute can be used in this context to adjust the size of the image. However, if the background bleeds outside the bounds of the running content, it will not be cropped. I don't know how to work around this. So you'll need to size your images accordingly.

[abradshaw]

Many thanks @mojavelinux

[mojavelinux]

You're welcome!

Keep an eye out for #994 in 2.0.0, which will slightly change how this works. Once that's merged, you'll be able to control whether the background image spans the width of the page or the content column.