diff --git a/README.md b/README.md index ac841281..38c7b56e 100644 --- a/README.md +++ b/README.md @@ -33,6 +33,7 @@ Blowfish is designed to be a powerful, lightweight theme for [Hugo](https://gohu - Support for multiple authors - Support for series of articles - Flexible with any content types, taxonomies and menus +- Support for header, footer, and nested menus - Multilingual content support inlcuding support for RTL languages - Ability to link to posts on third-party websites - Buymeacoffee integration diff --git a/exampleSite/content/docs/getting-started/index.md b/exampleSite/content/docs/getting-started/index.md index 379d8a6c..3f6aaedf 100644 --- a/exampleSite/content/docs/getting-started/index.md +++ b/exampleSite/content/docs/getting-started/index.md @@ -151,9 +151,9 @@ When you create a new taxonomy, you will need to adjust the navigation links on ## Menus -Blowfish has 3 menus that can be customised to suit the content and layout of your site. The `main` menu appears in the site header, the `subnavigation` menu just below `main` and the `footer` menu appears at the bottom of the page just above the copyright notice. +Blowfish has two menus that can be customised to suit the content and layout of your site. The `main` menu appears in the site header and the `footer` menu appears at the bottom of the page just above the copyright notice. -All of them can be configured in the `menus.en.toml` file. Similarly to the languages config file, if you wish to use another language, rename this file and replace `en` with the language code you wish to use. +Both menus are configured in the `menus.en.toml` file. Similarly to the languages config file, if you wish to use another language, rename this file and replace `en` with the language code you wish to use. ```toml # config/_default/menus.toml @@ -180,16 +180,6 @@ All of them can be configured in the `menus.en.toml` file. Similarly to the lang url = "https://github.com/nunocoracao/blowfish" weight = 40 -[[subnavigation]] - name = "An interesting topic" - pageRef = "tags/interesting-topic" - weight = 10 - -[[subnavigation]] - name = "My Awesome Category" - pageRef = "categories/awesome" - weight = 20 - [[footer]] name = "Privacy" url = "https://external-link" @@ -205,6 +195,40 @@ Menu links will be sorted from lowest to highest `weight`, and then alphabetical Both menus are completely optional and can be commented out if not required. Use the template provided in the file as a guide. +### Nested Menus + +bla bla bla + +```toml +# config/_default/menus.toml + +[[main]] + name = "Blog" + pageRef = "posts" + weight = 10 + +[[main]] + name = "Topics" + pageRef = "topics" + weight = 20 + +[[main]] + pre = "github" + name = "GitHub" + url = "https://github.com/nunocoracao/blowfish" + weight = 30 + +[[main]] + identifier = "github2" + pre = "github" + url = "https://github.com/nunocoracao/blowfish" + weight = 40 + +[[footer]] + name = "Privacy" + url = "https://external-link" +``` + ## Thumbnails & Backgrounds Blowfish was built so it would be easy to add visual support to your articles. If your familiar with Hugo article strucutre, you just need to place an image file (almost all formats are supported bue we recommend `.png` or `.jpg`) that starts with `feature*` inside your article folder. And that's it, Blowfish will then able to both use the image as a thumbnail within your website as well as for oEmbed cards across social platforms. @@ -215,4 +239,4 @@ Additionally, Blowfish also supports background hero images in articles and list ## Detailed configuration -The steps above are the bare minimum configuration. If you now run `hugo server` you will be presented with a blank Blowfish website. Detailed configuration is covered in the [Configuration]({{< ref "configuration" >}}) section. +The steps above are the bare minimum configuration. If you now run `hugo server` you will be presented with a blank Blowfish website. Detailed configuration is covered in the [Configuration]({{< ref "configuration" >}}) section. \ No newline at end of file diff --git a/layouts/partials/head.html b/layouts/partials/head.html index a85fd39c..839b554b 100644 --- a/layouts/partials/head.html +++ b/layouts/partials/head.html @@ -86,6 +86,11 @@ {{ end }} + {{/* Header */}} + {{ $headerLib := resources.Get "js/header.js" }} + {{ $headerLib := $headerLib | resources.Minify }} + {{ $headerJS := $headerLib | resources.Fingerprint "sha512" }} + {{/* Site Verification */}} {{ with .Site.Params.verification.google }} @@ -147,10 +152,4 @@ {{ end }} {{ end }} - - {{/* Header */}} - {{ $headerLib := resources.Get "js/header.js" }} - {{ $headerLib := $headerLib | resources.Minify }} - {{ $headerJS := $headerLib | resources.Fingerprint "sha512" }} -