Update package.json

Optionally disable footer menu. Enabled by default

README.md

@@ -57,7 +57,7 @@ Detailed instructions for each method can be found in the [Installation](https:/
 
 ### Quick start using git submodules
 
-> **Note:** Ensure you have **git**, **Go**, and **Hugo** installed, and that you have created a new Hugo project before proceeding.
+> **Note:** Ensure you have **Git**, **Go**, and **Hugo** installed, and that you have created a new Hugo project before proceeding.
 
 1. From your project directory, initialise git:
 
@@ -73,11 +73,8 @@ Detailed instructions for each method can be found in the [Installation](https:/
 
 3. In the root folder of your website, delete the `config.toml` file that was generated by Hugo. Copy the `*.toml` config files from the theme into your `config/_default/` folder.
 
-   > **Note:** Do not overwrite the `module.toml` file you created above!
-
    You will find these theme config files in the Hugo cache directory, or [download a copy](https://minhaskamal.github.io/DownGit/#/home?url=https://github.com/nunocoracao/blowfish/tree/main/config/_default) from GitHub.
 
-
 4. Follow the [Getting Started](https://nunocoracao.github.io/blowfish/docs/getting-started/) instructions to configure your website.
 
 ### Quick start using Hugo

config/_default/params.toml

@@ -16,6 +16,7 @@ enableCodeCopy = true
 # robots = ""
 
 [footer]
+ # showMenu = true
   showCopyright = true
   showThemeAttribution = true
   showAppearanceSwitcher = true

exampleSite/config/_default/params.toml

@@ -16,6 +16,7 @@ mainSections = ["docs"]
 # robots = ""
 
 [footer]
+  showMenu = true
   showCopyright = true
   showThemeAttribution = true
   showAppearanceSwitcher = true

exampleSite/content/docs/configuration/index.md

@@ -133,6 +133,8 @@ Many of the article defaults here can be overridden on a per article basis by sp
 |`logo`|_Not set_|The relative path to the site logo file within the `assets/` folder. The logo file should be provided at 2x resolution and supports any image dimensions.|
 |`mainSections`|_Not set_|The sections that should be displayed in the recent articles list. If not provided the section with the greatest number of articles is used.|
 |`robots`|_Not set_|String that indicates how robots should handle your site. If set, it will be output in the page head. Refer to [Google's docs](https://developers.google.com/search/docs/advanced/robots/robots_meta_tag#directives) for valid values.|
+|`disableImageZoom`|`false`|Disables image zoom feature across all the images in the site.|
+|`footer.showMenu`|`true`|Show/hide the footer menu, which can be configured in the `[[footer]]` section of the `config/_default/menus.en.toml` file.|
 |`footer.showCopyright`|`true`|Whether or not to show the copyright string in the site footer. Note that the string itself can be customised using the `copyright` parameter in the [languages configuration](#language-and-i18n).|
 |`footer.showThemeAttribution`|`true`|Whether or not to show the "powered by" theme attribution in the site footer. If you choose to disable this message, please consider attributing the theme somewhere else on your site (for example, on your about page).|
 |`footer.showAppearanceSwitcher`|`false`|Whether or not to show the appearance switcher in the site footer. The browser's local storage is used to persist the visitor's preference.|
@@ -192,4 +194,4 @@ Many of the article defaults here can be overridden on a per article basis by sp
 
 The theme also includes a `markup.toml` configuration file. This file contains some important parameters that ensure that Hugo is correctly configured to generate sites built with Blowfish.
 
-Always ensure this file is present in the config directory and that the required values are set. Failure to do so may cause certain features to fucntion incorrectly and could result in unintended behaviour.
+Always ensure this file is present in the config directory and that the required values are set. Failure to do so may cause certain features to function incorrectly and could result in unintended behaviour.

exampleSite/content/samples/mathematical-notation.md

@@ -11,9 +11,12 @@ KaTeX can be used to render mathematical notation within articles.
 
 {{< katex >}}
 
-Blowfish will only bundle the KaTeX assets into your project if you make use of mathematical notation. In order for this to work, simply include the [`katex` shortcode]({{< ref "docs/shortcodes#katex" >}}) within the article. Any KaTeX syntax on that page will then be automatically rendered.
+Blowfish will only bundle the KaTeX assets into your project if you make use of mathematical notation. In order for this to work, simply include the [`katex` shortcode]({{< ref "docs/shortcodes#katex" >}}) within the article. Example below:
 
-Use the online reference of [supported TeX functions](https://katex.org/docs/supported.html) for the available syntax.
+```md
+{{</* katex */>}}
+```
+Any KaTeX syntax on that page will then be automatically rendered. Use the online reference of [supported TeX functions](https://katex.org/docs/supported.html) for the available syntax.
 
 ## Inline notation
 

layouts/_default/_markup/render-link.html

@@ -1,3 +1,2 @@
 <a href="{{ .Destination | safeURL }}" {{ with .Title}} title="{{ . }}"{{ end }} {{ if or (strings.HasPrefix .Destination "http:") (strings.HasPrefix .Destination "https:") }} target="_blank"{{ end }}>
-    {{ .Text | safeHTML }}
+    {{ .Text | safeHTML }}</a>
-</a>

layouts/partials/footer.html

@@ -1,16 +1,18 @@
 <footer class="py-10 print:hidden">
   {{/* Footer menu */}}
-  {{ if .Site.Menus.footer }}
+  {{ if .Site.Params.footer.showMenu | default true }}
-  <nav class="pb-4 text-base font-medium text-neutral-500 dark:text-neutral-400">
+    {{ if .Site.Menus.footer }}
-    <ul class="flex flex-col list-none sm:flex-row">
+    <nav class="pb-4 text-base font-medium text-neutral-500 dark:text-neutral-400">
-      {{ range .Site.Menus.footer }}
+      <ul class="flex flex-col list-none sm:flex-row">
-      <li class="mb-1 ltr:text-right rtl:text-left sm:mb-0 ltr:sm:mr-7 ltr:sm:last:mr-0 rtl:sm:ml-7 rtl:sm:last:ml-0">
+        {{ range .Site.Menus.footer }}
-        <a class="decoration-primary-500 hover:underline hover:decoration-2 hover:underline-offset-2" href="{{ .URL }}"
+        <li class="mb-1 ltr:text-right rtl:text-left sm:mb-0 ltr:sm:mr-7 ltr:sm:last:mr-0 rtl:sm:ml-7 rtl:sm:last:ml-0">
-          title="{{ .Title }}">{{ .Name | markdownify | emojify }}</a>
+          <a class="decoration-primary-500 hover:underline hover:decoration-2 hover:underline-offset-2" href="{{ .URL }}"
-      </li>
+            title="{{ .Title }}">{{ .Name | markdownify | emojify }}</a>
-      {{ end }}
+        </li>
-    </ul>
+        {{ end }}
-  </nav>
+      </ul>
+    </nav>
+    {{ end }}
   {{ end }}
   <div class="flex items-center justify-between">
 
@@ -41,11 +43,13 @@
 
   </div>
   <script>
+    {{ if not .Site.Params.disableImageZoom | default true }}
     mediumZoom(document.querySelectorAll("img:not(.nozoom)"), {
       margin: 24,
       background: 'rgba(0,0,0,0.5)',
       scrollOffset: 0,
     })
+    {{ end }}
   </script>
   {{ $jsProcess := resources.Get "js/process.js" }}
   {{ $jsProcess = $jsProcess | resources.Minify | resources.Fingerprint "sha512" }}

layouts/partials/home/background.html

@@ -17,7 +17,7 @@
                     {{ end }}
                     {{ end }}
                 </div>
-                <div class="relative px-4 py-16 sm:px-6 sm:py-24 lg:py-32 lg:px-8 flex flex-col items-center">
+                <div class="relative px-4 py-16 sm:px-6 sm:py-24 lg:py-32 lg:px-8 flex flex-col items-center justify-center text-center">
                     {{ with .Site.Author.image }}
                     {{ $authorImage := resources.Get . }}
                     {{ if $authorImage }}

layouts/partials/home/hero.html

@@ -14,7 +14,7 @@
                     {{ end }}
                     {{ end }}
                 </div>
-                <div class="relative px-4 py-16 sm:px-6 sm:py-24 lg:py-32 lg:px-8 flex flex-col items-center">
+                <div class="relative px-4 py-16 sm:px-6 sm:py-24 lg:py-32 lg:px-8 flex flex-col items-center justify-center text-center">
                     {{ with .Site.Author.image }}
                     {{ $authorImage := resources.Get . }}
                     {{ if $authorImage }}

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "hugo-blowfish-theme",
-  "version": "2.3.1",
+  "version": "2.4.5",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "hugo-blowfish-theme",
-      "version": "2.3.1",
+      "version": "2.4.5",
       "hasInstallScript": true,
       "license": "MIT",
       "dependencies": {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "hugo-blowfish-theme",
-  "version": "2.4.4",
+  "version": "2.5.0",
   "description": "Blowfish theme for Hugo",
   "scripts": {
     "preinstall": "rimraf assets/vendor",