Header alt tags (#1138)

* Added support for an alt tag for the header image

This allows using page.header.image_description as the alt tag. It
will still default to site.title if unset.

* Added documentation

_includes/page__hero.html

@@ -45,7 +45,11 @@ <h1 class="page__title" itemprop="headline">
       {% endif %}
     </div>
   {% else %}
+    {% if page.header.image_description %}
+    <img src="{{ img_path }}" alt="{{ page.header.image_description }}" class="page__hero-image">
+    {% else %}
     <img src="{{ img_path }}" alt="{{ page.title }}" class="page__hero-image">
+    {% endif %}
   {% endif %}
   {% if page.header.caption %}
     <span class="page__hero-caption">{{ page.header.caption | markdownify | remove: "<p>" | remove: "</p>" }}</span>

docs/_docs/10-layouts.md

@@ -273,6 +273,14 @@ header:
   image: http://some-site.com/assets/images/image.jpg
 ```
 
+To provide a custom alt tag for screen readers:
+
+```yaml
+header:
+  image: /assets/images/unsplash-image-1.jpg
+  image_description: "A description of the image"
+```
+
 To include a caption or attribution for the image:
 
 ```yaml