Merge pull request #216 from nunocoracao/213-lists-should-support-coverfeature-images

213 lists should support coverfeature images

assets/css/compiled/main.css

@@ -1425,6 +1425,10 @@ select {
   top: 5rem;
 }
 
+.z-\[500\] {
+  z-index: 500;
+}
+
 .z-50 {
   z-index: 50;
 }

exampleSite/config/_default/menus.en.toml

@@ -20,22 +20,27 @@
   pageRef = "samples"
   weight = 20
 
+[[main]]
+  name = "Showcase"
+  pageRef = "examples"
+  weight = 30
+
 [[main]]
   name = "Users"
   pageRef = "users"
-  weight = 30
+  weight = 40
 
 [[main]]
   identifier = "github"
   pre = "github"
   url = "https://github.com/nunocoracao/blowfish"
-  weight = 40
+  weight = 50
 
 [[main]]
   identifier = "twitter"
   pre = "twitter"
   url = "https://twitter.com/burufugu"
-  weight = 50
+  weight = 60
 
 
 # -- Footer Menu --

exampleSite/config/_default/params.toml

@@ -62,6 +62,8 @@ mainSections = ["docs"]
   sharingLinks = [ "linkedin", "twitter", "whatsapp", "pinterest", "reddit", "facebook", "email"]
 
 [list]
+  showHero = true
+  heroStyle = "background" # valid options: basic, big, background
   showBreadcrumbs = false
   showSummary = false
   showTableOfContents = true

exampleSite/content/docs/_index.md

@@ -12,8 +12,6 @@ cascade:
 Simple, yet powerful. Learn how to use Blowfish and its features.
 {{< /lead >}}
 
-![Featured Blowfish image](featured.png)
-
 This section contains everything you need to know about Blowfish. If you're new, check out the [Installation]({{< ref "docs/installation" >}}) guide to begin or visit the [Samples]({{< ref "samples" >}}) section to see what Blowfish can do.
 
 ---

exampleSite/content/docs/configuration/index.md

@@ -155,8 +155,8 @@ 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.                                                                                                                                                                                                                                |
-| `heroStyle`                     | `basic`                | Style to display the hero image, valid options are: `basic`, `big`, `background`.                                                                                                                                                                                                                                  |
+| `article.showHero`              | `false`                | Whether the thumbnail image will be shown as a hero image within each article page.                                                                                                                                                                                                                                |
+| `article.heroStyle`             | _Not set_              | Style to display the hero image, valid options are: `basic`, `big`, `background`.                                                                                                                                                                                                                                  |
 | `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.                                                                                                                                                                                                                                           |
@@ -173,6 +173,8 @@ Many of the article defaults here can be overridden on a per article basis by sp
 | `article.showWordCount`         | `false`                | Whether or not article word counts are displayed.                                                                                                                                                                                                                                                                  |
 | `article.showComments`          | `false`                | Whether or not the [comments partial]({{< ref "partials#comments" >}}) is included after the article footer.                                                                                                                                                                                                       |
 | `article.sharingLinks`          | _Not set_              | Which sharing links to display at the end of each article. When not provided, or set to `false` no links will be displayed.                                                                                                                                                                                        |
+| `list.showHero`                 | `false`                | Whether the thumbnail image will be shown as a hero image within each list page.                                                                                                                                                                                                                                   |
+| `list.heroStyle`                | _Not set_              | Style to display the hero image, valid options are: `basic`, `big`, `background`.                                                                                                                                                                                                                                  |
 | `list.showBreadcrumbs`          | `false`                | Whether or not breadcrumbs are displayed in the header on list pages.                                                                                                                                                                                                                                              |
 | `list.showTableOfContents`      | `false`                | Whether or not the table of contents is displayed on list pages.                                                                                                                                                                                                                                                   |
 | `list.showSummary`              | `false`                | Whether or not article summaries are displayed on list pages. If a summary is not provided in the [front matter]({{< ref "front-matter" >}}), one will be auto generated using the `summaryLength` parameter in the [site configuration](#site-configuration).                                                     |

exampleSite/content/examples/_index.md

@@ -0,0 +1,19 @@
+---
+title: "Showcase"
+description: "See what's possible with Blowfish."
+
+cascade:
+  showEdit: false
+  showReadingTime: false
+  showSummary: true
+  showLikes: false
+  showViews: false
+---
+
+{{< lead >}}
+See what's possible with Blowfish.
+{{< /lead >}}
+
+This section contains links to example templates and pages created using Blowfish to get you inspired.
+
+---

exampleSite/content/examples/blowfish-template-repo/_index.md

@@ -0,0 +1,8 @@
+---
+title: "Blowfish Template - GitHub Repo"
+date: 2022-11-06
+externalUrl: "https://github.com/nunocoracao/blowfish_template"
+summary: "A simple template project to get you started. Blowfish theme already installed with a simple github pages action configured."
+---
+
+A simple template project to get you started. Blowfish theme already installed with a simple github pages action configured.

exampleSite/content/examples/blowfish-template/_index.md

@@ -0,0 +1,8 @@
+---
+title: "Blowfish Template"
+date: 2022-11-06
+externalUrl: "https://nunocoracao.github.io/blowfish_template/"
+summary: "A simple template project to get you started. Blowfish theme already installed with a simple github pages action configured."
+---
+
+A simple template project to get you started. Blowfish theme already installed with a simple github pages action configured.

layouts/_default/list.html

@@ -1,10 +1,20 @@
 {{ define "main" }}
+
+{{ if .Site.Params.list.showHero | default false }}
+{{ $heroStyle := print "partials/hero/" .Site.Params.list.heroStyle ".html" }}
+{{ if templates.Exists $heroStyle }}
+{{ partial $heroStyle . }}
+{{ else }}
+{{ partial "partials/hero/basic.html" . }}
+{{ end }}
+{{- end -}}
+
 {{ $toc := and (.Params.showTableOfContents | default (.Site.Params.list.showTableOfContents | default false)) (in
 .TableOfContents "<ul") }} <header>
   {{ if .Params.showBreadcrumbs | default (.Site.Params.list.showBreadcrumbs | default false) }}
   {{ partial "breadcrumbs.html" . }}
   {{ end }}
-  <h1 class="mt-0 text-4xl font-extrabold text-neutral-900 dark:text-neutral">{{ .Title }}</h1>
+  <h1 class="mt-5 text-4xl font-extrabold text-neutral-900 dark:text-neutral">{{ .Title }}</h1>
   </header>
   <section class="{{ if $toc -}}
       mt-12

layouts/partials/search.html

@@ -1,6 +1,6 @@
 <div
   id="search-wrapper"
-  class="invisible fixed inset-0 z-50 flex h-screen w-screen cursor-default flex-col bg-neutral-500/50 p-4 backdrop-blur-sm dark:bg-neutral-900/50 sm:p-6 md:p-[10vh] lg:p-[12vh]"
+  class="invisible z-[500] fixed inset-0 z-50 flex h-screen w-screen cursor-default flex-col bg-neutral-500/50 p-4 backdrop-blur-sm dark:bg-neutral-900/50 sm:p-6 md:p-[10vh] lg:p-[12vh]"
   data-url="{{ "" | absLangURL }}"
 >
   <div