Hero images for articles

exampleSite/config/_default/params.toml

@@ -35,6 +35,7 @@ mainSections = ["docs"]
   showLikes = true
   showDateUpdated = false
   showAuthor = true
+  showHero = true
   showBreadcrumbs = true
   showDraftLabel = true
   showEdit = true

exampleSite/content/docs/configuration/index.md

@@ -145,6 +145,7 @@ Many of the article defaults here can be overridden on a per article basis by sp
 |`article.showLikes`|`false`|Whether or not article likes are displayed. This requires firebase integrations to be enabled, look below.|
 |`article.showDateUpdated`|`false`|Whether or not the dates articles were updated are displayed.|
 |`article.showAuthor`|`true`|Whether or not the author box is displayed in the article footer.|
+|`article.showHero`|`true`|Whether the thumbnail image will be shown as a hero image within each article page.|
 |`article.showBreadcrumbs`|`false`|Whether or not breadcrumbs are displayed in the article header.|
 |`article.showDraftLabel`|`true`|Whether or not the draft indicator is shown next to articles when site is built with `--buildDrafts`.|
 |`article.showEdit`|`false`|Whether or not the link to edit the article content should be displayed.|

exampleSite/content/docs/front-matter/index.md

@@ -26,6 +26,7 @@ Front matter parameter default values are inherited from the theme's [base confi
 |`showAuthor`|`article.showAuthor`|Whether or not the author box for the deafult author is displayed in the article footer.|
 |`authors`|_Not set_|Array of values for authors, if set it overrides `showAuthor` settings for page or site. Used on the multiple authors feature, check [this page]({{< ref "multi-author" >}}) for more details on how to configure that feature.|
 |`showAuthorsBadges`|`article.showAuthorsBadges`|Whether the `authors` taxonomies are are displayed in the article or list header. This requires the setup of `multiple authors` and the `authors` taxonomy. Check [this page]({{< ref "multi-author" >}}) for more details on how to configure that feature.|
+|`showHero`|`article.showHero`|Whether the thumbnail image will be shown as a hero image within the article page.|
 |`showBreadcrumbs`|`article.showBreadcrumbs` or `list.showBreadcrumbs`|Whether the breadcrumbs are displayed in the article or list header.|
 |`showDate`|`article.showDate`|Whether or not the article date is displayed. The date is set using the `date` parameter.|
 |`showDateUpdated`|`article.showDateUpdated`|Whether or not the date the article was updated is displayed. The date is set using the `lastmod` parameter.|

exampleSite/content/docs/thumbnails/index.md

@@ -36,4 +36,8 @@ content
 └── awesome_article
     └── featured.png
 ```
-The you just need to add an image like explain earlier. If you want to see a sample of this you can consult [this sample]({{< ref "thumbnail_sample" >}}).
+The you just need to add an image like explain earlier. If you want to see a sample of this you can consult [this sample]({{< ref "thumbnail_sample" >}}).
+
+## Hero Images
+
+Thumbnails will be used by default as hero images withing each article. Use the global `article.showHero` or the front-matter parameter `showHero` to control this feature across the entire site or for each specific post.