Merge pull request #764 from nunocoracao/dev

🔖 release v2.35.0

assets/js/appearance.js

@@ -26,16 +26,19 @@ window.addEventListener("DOMContentLoaded", (event) => {
   const switcher = document.getElementById("appearance-switcher");
   const switcherMobile = document.getElementById("appearance-switcher-mobile");
 
-  updateMeta()
+  updateMeta();
+  this.updateLogo?.(getTargetAppearance());
 
   if (switcher) {
     switcher.addEventListener("click", () => {
       document.documentElement.classList.toggle("dark");
+      var targetAppearance = getTargetAppearance();
       localStorage.setItem(
         "appearance",
-        document.documentElement.classList.contains("dark") ? "dark" : "light"
+        targetAppearance
       );
-      updateMeta()
+      updateMeta();
+      this.updateLogo?.(targetAppearance);
     });
     switcher.addEventListener("contextmenu", (event) => {
       event.preventDefault();
@@ -45,11 +48,13 @@ window.addEventListener("DOMContentLoaded", (event) => {
   if (switcherMobile) {
     switcherMobile.addEventListener("click", () => {
       document.documentElement.classList.toggle("dark");
+      var targetAppearance = getTargetAppearance();
       localStorage.setItem(
         "appearance",
-        document.documentElement.classList.contains("dark") ? "dark" : "light"
+        targetAppearance
       );
-      updateMeta()
+      updateMeta();
+      this.updateLogo?.(targetAppearance);
     });
     switcherMobile.addEventListener("contextmenu", (event) => {
       event.preventDefault();
@@ -66,10 +71,31 @@ var updateMeta = () => {
   document.querySelector('meta[name="theme-color"]').setAttribute('content', style.backgroundColor);
 }
 
+{{ if and (.Site.Params.Logo) (.Site.Params.SecondaryLogo) }}
+{{ $primaryLogo := resources.Get .Site.Params.Logo }}
+{{ $secondaryLogo := resources.Get .Site.Params.SecondaryLogo }}
+{{ if and ($primaryLogo) ($secondaryLogo) }}
+var updateLogo = (targetAppearance) => {
+  var elems;
+  elems = document.querySelectorAll("img.logo")
+  targetLogoPath = 
+    targetAppearance == "{{ .Site.Params.DefaultAppearance }}" ?
+    "{{ $primaryLogo.RelPermalink }}" : "{{ $secondaryLogo.RelPermalink }}"
+  for (const elem of elems) {
+    elem.setAttribute("src", targetLogoPath)
+  }
+}
+{{ end }}
+{{- end }}
+
+var getTargetAppearance = () => {
+  return document.documentElement.classList.contains("dark") ? "dark" : "light"
+}
+
 window.addEventListener("DOMContentLoaded", (event) => {
   const scroller = document.getElementById("top-scroller");
   const footer = document.getElementById("site-footer");
-  if(scroller.getBoundingClientRect().top > footer.getBoundingClientRect().top) {
+  if(scroller && footer && scroller.getBoundingClientRect().top > footer.getBoundingClientRect().top) {
     scroller.hidden = true;
   }
-});
+});

config.toml

@@ -1,5 +1,5 @@
 [module]
   [module.hugoVersion]
     extended = true
-    min = "0.87.0 "
+    min = "0.87.0"
-    max = "0.111.3"
+    max = "0.113.0"

config/_default/languages.en.toml

@@ -1,16 +1,17 @@
 languageCode = "en"
 languageName = "English"
-displayName = "EN"
-isoCode = "en"
 weight = 1
-rtl = false
-
 title = "Blowfish"
-# logo = "img/logo.png"
-# description = "My awesome website"
-# copyright = "Copy, _right?_ :thinking_face:"
 
-dateFormat = "2 January 2006"
+[params]
+  displayName = "EN"
+  isoCode = "en"
+  rtl = false
+  dateFormat = "2 January 2006"
+  # logo = "img/logo.png"
+  # secondaryLogo = "img/secondary-logo.png"
+  # description = "My awesome website"
+  # copyright = "Copy, _right?_ :thinking_face:"
 
 # [author]
 #   name = "Your name here"

config/_default/params.toml

@@ -9,13 +9,13 @@ colorScheme = "blowfish"
 defaultAppearance = "light" # valid options: light or dark
 autoSwitchAppearance = true
 
-enableSearch = false
+enableSearch = true
 enableCodeCopy = false
 
 # mainSections = ["section1", "section2"]
 # robots = ""
 
-disableImageOptimization = false
+disableImageOptimization = true
 
 # defaultBackgroundImage = "IMAGE.jpg" # used as default for background images 
 # defaultFeaturedImage = "IMAGE.jpg" # used as default for featured images in all articles
@@ -31,7 +31,7 @@ disableImageOptimization = false
   showMenu = true
   showCopyright = true
   showThemeAttribution = true
-  showAppearanceSwitcher = false
+  showAppearanceSwitcher = true
   showScrollToTop = true
 
 [homepage]

exampleSite/config/_default/languages.en.toml

@@ -1,16 +1,17 @@
 languageCode = "en"
 languageName = "English"
-displayName = "EN"
-isoCode = "en"
 weight = 1
-rtl = false
-
 title = "Blowfish"
-logo = "img/blowfish_logo_transparent.png"
-description = "A powerful, lightweight theme for Hugo built with Tailwind CSS."
-# copyright = "Copy, _right?_ :thinking_face:"
 
-dateFormat = "2 January 2006"
+[params]
+  displayName = "EN"
+  isoCode = "en"
+  rtl = false
+  dateFormat = "2 January 2006"
+  logo = "img/blowfish_logo_transparent.png"
+  # secondaryLogo = "PATH"
+  description = "A powerful, lightweight theme for Hugo built with Tailwind CSS."
+  # copyright = "Copy, _right?_ :thinking_face:"
 
 [author]
   name = "Blowfish"
@@ -22,3 +23,5 @@ dateFormat = "2 January 2006"
     { mastodon = "https://masto.ai/@blowfish" },
     { github = "https://github.com/nunocoracao/blowfish" },
   ]
+
+  

exampleSite/config/_default/menus.en.toml

@@ -19,8 +19,6 @@
 #  name = "Examples"
 #  weight = 20
 
-
-
 [[main]]
   name = "Samples"
   pageRef = "samples"

exampleSite/content/docs/configuration/index.md

@@ -57,7 +57,7 @@ The theme currently supports the following languages by default:
 
 | Language                       | Code    |
 | ------------------------------ | ------- |
-| 🇧🇬 Bulgarian                   | `bg`    |
+| 🇧🇬 Bulgarian                    | `bg`    |
 | 🇧🇩 Bengali                      | `bn`    |
 | 🇨🇿 Czech                        | `cs`    |
 | 🇩🇪 German                       | `de`    |
@@ -95,24 +95,43 @@ The default file can be used as a template to create additional languages, or re
 **Note:** Ensure the `defaultContentLanguage` parameter in the [site configuration](#site-configuration) matches the language code in your language config filename.  
 {{< /alert >}}
 
+
+#### Global
+
 <!-- prettier-ignore-start -->
-| Name              | Default            | Description                                                                                                                                                                                                                                                                                                                 |
+| Name           | Default      | Description                                                                                                                                                                                                                                                                                            |
-| ----------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| -------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `languageCode`    | `"en"`             | The Hugo language code for this file. It can be a top-level language (ie. `en`) or a sub-variant (ie. `en-au`) and should match the language code in the filename. Hugo expects this value to always be in lowercase. For proper HTML compliance, set the `isoCode` parameter which is case-sensitive.                      |
+| `languageCode` | `"en"`       | The Hugo language code for this file. It can be a top-level language (ie. `en`) or a sub-variant (ie. `en-au`) and should match the language code in the filename. Hugo expects this value to always be in lowercase. For proper HTML compliance, set the `isoCode` parameter which is case-sensitive. |
-| `languageName`    | `"English"`        | The name of the language.                                                                                                                                                                                                                                                                                                   |
+| `languageName` | `"English"`  | The name of the language.                                                                                                                                                                                                                                                                              |
-| `displayName`     | `"EN"`             | The name used when the language appears on the website.                                                                                                                                                                                                                                                                     |
+| `weight`       | `1`          | The weight determines the order of languages when building multilingual sites.                                                                                                                                                                                                                         |
-| `isoCode`         | `"en"`             | The ISO language code for HTML metadata purposes. It can be a top-level language (ie. `en`) or a sub-variant (ie. `en-AU`).                                                                                                                                                                                                 |
+| `title`        | `"Blowfish"` | The title of the website. This will be displayed in the site header and footer.                                                                                                                                                                                                                        |
-| `weight`          | `1`                | The weight determines the order of languages when building multilingual sites.                                                                                                                                                                                                                                              |
+<!-- prettier-ignore-end -->
-| `rtl`             | `false`            | Whether or not this is a RTL language. Set to `true` to reflow content from right-to-left. Blowfish fully supports using RTL and LTR languages at the same time and will dynamically adjust to both.                                                                                                                        |
+
-| `dateFormat`      | `"2 January 2006"` | How dates are formatted in this language. Refer to the [Hugo docs](https://gohugo.io/functions/format/#gos-layout-string) for acceptable formats.                                                                                                                                                                           |
+#### Params
-| `title`           | `"Blowfish"`       | The title of the website. This will be displayed in the site header and footer.                                                                                                                                                                                                                                             |
+
-| `description`     | _Not set_          | The website description. This will be used in the site metadata.                                                                                                                                                                                                                                                            |
+<!-- prettier-ignore-start -->
-| `copyright`       | _Not set_          | A Markdown string for the site footer copyright message can include the placeholder { year } to dynamically insert the current year. If none is provided, Blowfish will automatically generate a copyright string using the site `title`.                                                                                   |
+| Name            | Default            | Description                                                                                                                                                                                                                                                                                                                |
-| `author.name`     | _Not set_          | The author's name. This will be displayed in article footers, and on the homepage when the profile layout is used.                                                                                                                                                                                                          |
+| --------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `author.image`    | _Not set_          | Path to the image file of the author. The image should be a 1:1 aspect ratio and placed in the site's `assets/` folder.                                                                                                                                                                                                     |
+| `params.displayName`   | `"EN"`             | The name used when the language appears on the website.                                                                                                                                                                                                                                                                    |
-| `author.headline` | _Not set_          | A Markdown string containing the author's headline. It will be displayed on the profile homepage under the author's name.                                                                                                                                                                                                   |
+| `params.isoCode`       | `"en"`             | The ISO language code for HTML metadata purposes. It can be a top-level language (ie. `en`) or a sub-variant (ie. `en-AU`).                                                                                                                                                                                                |
-| `author.bio`      | _Not set_          | A Markdown string containing the author's bio. It will be displayed in article footers.                                                                                                                                                                                                                                     |
+| `params.rtl`           | `false`            | Whether or not this is a RTL language. Set to `true` to reflow content from right-to-left. Blowfish fully supports using RTL and LTR languages at the same time and will dynamically adjust to both.                                                                                                                       |
-| `author.links`    | _Not set_          | The links to display alongside the author's details. The config file contains example links which can simply be uncommented to enable. The order that the links are displayed is determined by the order they appear in the array. Custom links can be added by providing corresponding SVG icon assets in `assets/icons/`. |
+| `params.dateFormat`    | `"2 January 2006"` | How dates are formatted in this language. Refer to the [Hugo docs](https://gohugo.io/functions/format/#gos-layout-string) for acceptable formats.                                                                                                                                                                          |
+| `params.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.                                                                                                                                                                  |
+| `params.secondaryLogo` | _Not set_          | The relative path to the secondary site logo file within the `assets/` folder. The logo file should be provided at 2x resolution and supports any image dimensions. This should have an inverted/contrasting colour scheme to `logo`. If set, this logo will be shown when users toggle from the `defaultAppearance` mode. |
+| `params.description`   | _Not set_          | The website description. This will be used in the site metadata.                                                                                                                                                                                                                                                           |
+| `params.copyright`     | _Not set_          | A Markdown string for the site footer copyright message can include the placeholder { year } to dynamically insert the current year. If none is provided, Blowfish will automatically generate a copyright string using the site `title`.                                                                                  |
+
+
+<!-- prettier-ignore-end -->
+
+#### Author
+| Name              | Default   | Description                                                                                                                                                                                                                                                                                                                 |
+| ----------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `author.name`     | _Not set_ | The author's name. This will be displayed in article footers, and on the homepage when the profile layout is used.                                                                                                                                                                                                          |
+| `author.image`    | _Not set_ | Path to the image file of the author. The image should be a 1:1 aspect ratio and placed in the site's `assets/` folder.                                                                                                                                                                                                     |
+| `author.headline` | _Not set_ | A Markdown string containing the author's headline. It will be displayed on the profile homepage under the author's name.                                                                                                                                                                                                   |
+| `author.bio`      | _Not set_ | A Markdown string containing the author's bio. It will be displayed in article footers.                                                                                                                                                                                                                                     |
+| `author.links`    | _Not set_ | The links to display alongside the author's details. The config file contains example links which can simply be uncommented to enable. The order that the links are displayed is determined by the order they appear in the array. Custom links can be added by providing corresponding SVG icon assets in `assets/icons/`. |
 <!-- prettier-ignore-end -->
 
 ### Menus
@@ -140,7 +159,6 @@ Many of the article defaults here can be overridden on a per article basis by sp
 | `autoSwitchAppearance`          | `true`       | Whether the theme appearance automatically switches based upon the visitor's operating system preference. Set to `false` to force the site to always use the `defaultAppearance`.                                                                 |
 | `enableSearch`                  | `false`      | Whether site search is enabled. Set to `true` to enable search functionality. Note that the search feature depends on the `outputs.home` setting in the [site configuration](#site-configuration) being set correctly.                            |
 | `enableCodeCopy`                | `false`      | Whether copy-to-clipboard buttons are enabled for `<code>` blocks. The `highlight.noClasses` parameter must be set to `false` for code copy to function correctly. Read more about [other configuration files](#other-configuration-files) below. |
-| `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.                                                                                                      |
 | `showViews`                     | _Not set_    | Whether or not articles and list views are displayed. This requires firebase integrations to be enabled, look below.                                                                                                                              |
 | `showLikes`                     | _Not set_    | Whether or not articles and list likes are displayed. This requires firebase integrations to be enabled, look below.                                                                                                                              |

exampleSite/content/docs/getting-started/index.md

@@ -197,7 +197,7 @@ Both menus are completely optional and can be commented out if not required. Use
 
 ### Nested menus
 
-The theme also supports nested menus. In order to use them you just need to define a parent entry in `menu.toml` and its sub-menus using the `parent` parameter to reference the parent. All properties can be used for sub-menus. Note that `pageRef` and `url` will be ignored for the parent entry. Nested menus is only available in the main menu not for the footer.
+The theme also supports nested menus. In order to use them you just need to define a parent entry in `menu.toml` and its sub-menus using the `parent` parameter to reference the parent. All properties can be used for sub-menus. `pageRef` and `url` can also be used in the parent entry. Nested menus are only available in the main menu not for the footer.
 
 ```toml
 # config/_default/menus.toml

exampleSite/content/users/index.md

@@ -75,6 +75,11 @@ Real websites that are built with Blowfish.
 | [hellstabber.github.io](https://hellstabber.github.io/)               | Personal site                |
 | [clemsau.com](https://clemsau.com/)                                   | Personal site                |
 | [lelouvincx.github.io](https://lelouvincx.github.io/)                 | Personal site                |
+| [weaxsey.org](https://weaxsey.org/)                                   | Personal site                |
+| [nikarashihatsu.github.io](https://nikarashihatsu.github.io/)         | Personal site                |
+| [blog.enmanuelmoreira.com](https://blog.enmanuelmoreira.com)          | Personal site                |
+| [halcyonstraits.com](https://www.halcyonstraits.com/)                 | Doll photography             |
+| [50-nuances-octets.fr](https://www.50-nuances-octets.fr/)             | Organization site            |
 
 {{< alert >}}
 

i18n/fr.yaml

@@ -18,7 +18,7 @@ article:
   part_of_series: "Cet article fait partie d'une série."
   part: "Partie"
   this_article: "Cet article"
-  related_articles: "Related"
+  related_articles: "Articles connexes"
 
 author:
   byline_title: "Auteur"
@@ -30,7 +30,7 @@ code:
 error:
   404_title: "Cette page n'existe pas :confused:"
   404_error: "Erreur 404"
-  404_description: "Il semble que la page que vous cherchiez n'existe pas."
+  404_description: "Il semble que la page que vous cherchez n'existe pas."
 
 footer:
   dark_appearance: "Passer au thème sombre"
@@ -62,4 +62,4 @@ shortcode:
   recent_articles: "Articles récents"
 
 recent:
-  show_more: "Montre Plus"
+  show_more: "Voir plus"

layouts/_default/baseof.html

@@ -1,4 +1,3 @@
-{{- partial "partials/functions/warnings.html" .Site -}}
 <!DOCTYPE html>
 <html lang="{{ with .Site.Params.isoCode | default (.Site.LanguageCode | default " en") }} {{- . -}} {{ end }}" dir="{{ if .Site.Params.rtl | default false -}}
     rtl

layouts/partials/analytics.html

@@ -1,10 +1,9 @@
-{{ if hugo.IsProduction }}
+{{ with site.Params.fathomAnalytics.site }}
-  {{ with .Site.Params.fathomAnalytics.site }}
+{{ if isset $.Site.Params.fathomanalytics "domain" }}
-    {{ if isset $.Site.Params.fathomanalytics "domain" }}
+<script defer src="https://{{ $.Site.Params.fathomanalytics.domain }}/script.js" data-site="{{ . }}"></script>
-      <script defer src="https://{{ $.Site.Params.fathomanalytics.domain }}/script.js" data-site="{{ . }}"></script>
+{{ else }}
-    {{ else }}
+<script defer src="https://cdn.usefathom.com/script.js" data-site="{{ . }}"></script>
-      <script defer src="https://cdn.usefathom.com/script.js" data-site="{{ . }}"></script>
-    {{ end }}
-  {{ end }}
-  {{ template "_internal/google_analytics.html" . }}
 {{ end }}
+{{ end }}
+{{/* template "_internal/google_analytics.html" . */}}
+{{ partial "ga-analytics.html" }}

layouts/partials/functions/warnings.html

@@ -1,6 +0,0 @@
-{{ if ne .Site.Params.showAppearanceSwitcher nil }}
-  {{ warnf "[BLOWFISH] Theme parameter `showAppearanceSwitcher` has been renamed to `footer.showAppearanceSwitcher`. Please update your site configuration." }}
-{{ end }}
-{{ if ne .Site.Params.showScrollToTop nil }}
-  {{ warnf "[BLOWFISH] Theme parameter `showScrollToTop` has been renamed to `footer.showScrollToTop`. Please update your site configuration." }}
-{{ end }}

layouts/partials/ga-analytics.html

@@ -0,0 +1,10 @@
+{{ if site.Config.Services.GoogleAnalytics.ID }}
+<script async src="https://www.googletagmanager.com/gtag/js?id={{ site.Config.Services.GoogleAnalytics.ID }}"></script>
+<script>
+  window.dataLayer = window.dataLayer || [];
+  function gtag(){dataLayer.push(arguments);}
+  gtag('js', new Date());
+
+  gtag('config', '{{ site.Config.Services.GoogleAnalytics.ID }}');
+</script>
+{{ end }}

layouts/partials/head.html

@@ -14,7 +14,7 @@
   <meta name="title" content="{{ .Title | emojify }} &middot; {{ .Site.Title | emojify }}" />
   {{- end }}
   {{/* Metadata */}}
-  {{ with .Params.Summary | default .Site.Params.description -}}
+  {{ with (.Params.Summary | default .Params.Description) | default .Site.Params.description -}}
   <meta name="description" content="{{ . }}" />
   {{- end }}
   {{ with  .Params.Tags | default .Site.Params.keywords -}}
@@ -50,7 +50,7 @@
   <link type="text/css" rel="stylesheet" href="{{ $bundleCSS.RelPermalink }}"
     integrity="{{ $bundleCSS.Data.Integrity }}" />
   {{ $jsAppearance := resources.Get "js/appearance.js" }}
-  {{ $jsAppearance = $jsAppearance | resources.Minify | resources.Fingerprint "sha512" }}
+  {{ $jsAppearance = $jsAppearance | resources.ExecuteAsTemplate $jsAppearance.RelPermalink . | resources.Minify | resources.Fingerprint "sha512" }}
   <script type="text/javascript" src="{{ $jsAppearance.RelPermalink }}"
     integrity="{{ $jsAppearance.Data.Integrity }}"></script>
   {{ if .Site.Params.enableSearch | default false }}
@@ -113,7 +113,7 @@
   {{/* Vendor */}}
   {{ partial "vendor.html" . }}
   {{/* Analytics */}}
-  {{ partialCached "analytics.html" .Site }}
+  {{ partial "analytics.html" .Site }}
   {{/* Extend head - eg. for custom analytics scripts, etc. */}}
   {{ if templates.Exists "partials/extend-head.html" }}
   {{ partialCached "extend-head.html" .Site }}

layouts/partials/header/basic.html

@@ -8,7 +8,7 @@
             <span class="sr-only">{{ .Site.Title | markdownify | emojify }}</span>
 
             <img src="{{ $logo.RelPermalink }}" width="{{ div $logo.Width 2 }}" height="{{ div $logo.Height 2 }}"
-                class="max-h-[5rem] max-w-[5rem] object-scale-down object-left nozoom" alt="{{ .Site.Title }}" />
+                class="logo max-h-[5rem] max-w-[5rem] object-scale-down object-left nozoom" alt="{{ .Site.Title }}" />
 
         </a>
     </div>
@@ -23,7 +23,7 @@
 
 
         </nav>
-        <nav class="hidden md:flex items-center space-x-5 md:ml-12">
+        <nav class="hidden md:flex items-center space-x-5 md:ml-12 h-12">
 
             {{ if .Site.Menus.main }}
             {{ range .Site.Menus.main }}
@@ -34,7 +34,7 @@
             {{ partial "translations.html" . }}
 
             {{ if .Site.Params.enableSearch | default false }}
-            <button id="search-button" aria-label="Search" class="text-base hover:text-primary-600 dark:hover:text-primary-400"
+            <button id="search-button" aria-label="Search" class="text-base hover:text-primary-600 dark:hover:text-primary-400 h-12"
                 title="{{ i18n " search.open_button_title" }}">
                 {{ partial "icon.html" "search" }}
             </button>

layouts/partials/header/header-option-nested.html

@@ -5,7 +5,8 @@
       {{ partial "icon.html" .Pre }}
     </span>
     {{ end }}
-    <a class="text-base font-medium text-gray-500 hover:text-gray-900" title="{{ .Title }}">
+    <a {{ if .URL }} href="{{ .URL }}" {{ if or (strings.HasPrefix .URL "http:" ) (strings.HasPrefix .URL "https:" ) }}
+      target="_blank" {{ end }} {{ end }} class="text-base font-medium text-gray-500 hover:text-gray-900" title="{{ .Title }}">
       {{ .Name | markdownify | emojify }}
     </a>
     <span>
@@ -31,4 +32,4 @@
       </div>
     </div>
   </div>
-</div>
+</div>

layouts/shortcodes/gallery.html

@@ -1,12 +1,11 @@
-{{ $time := now.UnixNano }}
+{{ $id := delimit (slice "gallery" .Ordinal) "-" }}
-{{ $id := delimit (slice "gallery" $time) "-" }}
 
 <div id="{{ $id }}">
   {{ .Inner }}
 </div>
 
 <script>
-  $(document).ready(function () {
+  $(window).on("load", function () {
     $('#{{ $id }}').packery({
       percentPosition: true,
       gutter: 5,

package.json

@@ -1,6 +1,6 @@
 {
   "name": "hugo-blowfish-theme",
-  "version": "2.33.1",
+  "version": "2.35.0",
   "description": "Blowfish theme for Hugo",
   "scripts": {
     "fullinstall": "npm run preinstall && npm install && npm run postinstall",
@@ -37,13 +37,13 @@
     "@tailwindcss/typography": "^0.5.9",
     "chart.js": "^4.3.0",
     "fuse.js": "^6.6.2",
-    "jquery": "^3.6.4",
+    "jquery": "^3.7.0",
     "katex": "^0.16.7",
     "packery": "^2.1.2",
     "prettier": "^2.8.8",
     "prettier-plugin-go-template": "^0.0.13",
-    "prettier-plugin-tailwindcss": "^0.2.8",
+    "prettier-plugin-tailwindcss": "^0.3.0",
-    "rimraf": "^5.0.0",
+    "rimraf": "^5.0.1",
     "tailwindcss": "^3.3.2",
     "tw-elements": "1.0.0-beta2",
     "typeit": "^8.7.1",
@@ -93,8 +93,8 @@
     }
   ],
   "dependencies": {
-    "@headlessui/react": "^1.7.14",
+    "@headlessui/react": "^1.7.15",
-    "@heroicons/react": "^2.0.17",
+    "@heroicons/react": "^2.0.18",
     "@tailwindcss/forms": "^0.5.3",
     "commander": "^10.0.1"
   }

public/authors/index.xml

@@ -1,10 +1 @@
-<?xml version="1.0" encoding="utf-8" standalone="yes"?>
+<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Authors Taxonomy Listing Example on Blowfish</title><link>https://nunocoracao.github.io/blowfish/authors/</link><description>Recent content in Authors Taxonomy Listing Example on Blowfish</description><generator>Hugo -- gohugo.io</generator><language>en</language><lastBuildDate>Wed, 12 Oct 2022 00:00:00 +0000</lastBuildDate><atom:link href="https://nunocoracao.github.io/blowfish/authors/index.xml" rel="self" type="application/rss+xml"/><item><title>Dummy Second Author</title><link>https://nunocoracao.github.io/blowfish/authors/secondauthor/</link><pubDate>Wed, 12 Oct 2022 00:00:00 +0000</pubDate><guid>https://nunocoracao.github.io/blowfish/authors/secondauthor/</guid><description>Dummy Second Author&amp;rsquo;s awesome dummy bio.</description></item><item><title>Nuno Coração</title><link>https://nunocoracao.github.io/blowfish/authors/nunocoracao/</link><pubDate>Wed, 12 Oct 2022 00:00:00 +0000</pubDate><guid>https://nunocoracao.github.io/blowfish/authors/nunocoracao/</guid><description>Nuno&amp;rsquo;s awesome dummy bio.</description></item></channel></rss>
-<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
-  <channel>
-    <title>Authors on Blowfish</title>
-    <link>/authors/</link>
-    <description>Recent content in Authors on Blowfish</description>
-    <generator>Hugo -- gohugo.io</generator>
-    <language>en</language><atom:link href="/authors/index.xml" rel="self" type="application/rss+xml" />
-  </channel>
-</rss>

public/authors/nunocoracao/index.xml

@@ -0,0 +1 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Nuno Coração on Blowfish</title><link>https://nunocoracao.github.io/blowfish/authors/nunocoracao/</link><description>Recent content in Nuno Coração on Blowfish</description><generator>Hugo -- gohugo.io</generator><language>en</language><lastBuildDate>Wed, 12 Oct 2022 00:00:00 +0000</lastBuildDate><atom:link href="https://nunocoracao.github.io/blowfish/authors/nunocoracao/index.xml" rel="self" type="application/rss+xml"/><item><title>Multiple Authors</title><link>https://nunocoracao.github.io/blowfish/samples/multiple-authors/</link><pubDate>Wed, 12 Oct 2022 00:00:00 +0000</pubDate><guid>https://nunocoracao.github.io/blowfish/samples/multiple-authors/</guid><description>A quick example of how multiple authors could be used.</description></item><item><title>Multiple Authors</title><link>https://nunocoracao.github.io/blowfish/docs/multi-author/</link><pubDate>Mon, 10 Aug 2020 00:00:00 +0000</pubDate><guid>https://nunocoracao.github.io/blowfish/docs/multi-author/</guid><description>Some websites have more than one author contributing with content and therefore require more than a single default author across the entire website. For those use-cases, Blowfish allows users to extend the list of authors using the multiple authors feature.</description></item></channel></rss>

public/authors/nunocoracao/page/1/index.html

@@ -0,0 +1 @@
+<!doctype html><html lang=en><head><title>https://nunocoracao.github.io/blowfish/authors/nunocoracao/</title><link rel=canonical href=https://nunocoracao.github.io/blowfish/authors/nunocoracao/><meta name=robots content="noindex"><meta charset=utf-8><meta http-equiv=refresh content="0; url=https://nunocoracao.github.io/blowfish/authors/nunocoracao/"></head></html>

public/authors/secondauthor/index.xml

@@ -0,0 +1 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Dummy Second Author on Blowfish</title><link>https://nunocoracao.github.io/blowfish/authors/secondauthor/</link><description>Recent content in Dummy Second Author on Blowfish</description><generator>Hugo -- gohugo.io</generator><language>en</language><lastBuildDate>Wed, 12 Oct 2022 00:00:00 +0000</lastBuildDate><atom:link href="https://nunocoracao.github.io/blowfish/authors/secondauthor/index.xml" rel="self" type="application/rss+xml"/><item><title>Multiple Authors</title><link>https://nunocoracao.github.io/blowfish/samples/multiple-authors/</link><pubDate>Wed, 12 Oct 2022 00:00:00 +0000</pubDate><guid>https://nunocoracao.github.io/blowfish/samples/multiple-authors/</guid><description>A quick example of how multiple authors could be used.</description></item></channel></rss>

public/authors/secondauthor/page/1/index.html

@@ -0,0 +1 @@
+<!doctype html><html lang=en><head><title>https://nunocoracao.github.io/blowfish/authors/secondauthor/</title><link rel=canonical href=https://nunocoracao.github.io/blowfish/authors/secondauthor/><meta name=robots content="noindex"><meta charset=utf-8><meta http-equiv=refresh content="0; url=https://nunocoracao.github.io/blowfish/authors/secondauthor/"></head></html>

public/blowfish/js/appearance.min.516a16745bea5a9bd011138d254cc0fd3973cd55ce6e15f3dec763e7c7c2c7448f8fe7b54cca811cb821b0c7e12cd161caace1dd794ac3d34d40937cbcc9ee12.js

@@ -0,0 +1 @@
+const sitePreference=document.documentElement.getAttribute("data-default-appearance"),userPreference=localStorage.getItem("appearance");(sitePreference==="dark"&&userPreference===null||userPreference==="dark")&&document.documentElement.classList.add("dark"),document.documentElement.getAttribute("data-auto-appearance")==="true"&&(window.matchMedia&&window.matchMedia("(prefers-color-scheme: dark)").matches&&userPreference!=="light"&&document.documentElement.classList.add("dark"),window.matchMedia("(prefers-color-scheme: dark)").addEventListener("change",e=>{e.matches?document.documentElement.classList.add("dark"):document.documentElement.classList.remove("dark")})),window.addEventListener("DOMContentLoaded",e=>{const t=document.getElementById("appearance-switcher"),n=document.getElementById("appearance-switcher-mobile");updateMeta(),this.updateLogo?.(getTargetAppearance()),t&&(t.addEventListener("click",()=>{document.documentElement.classList.toggle("dark");var e=getTargetAppearance();localStorage.setItem("appearance",e),updateMeta(),this.updateLogo?.(e)}),t.addEventListener("contextmenu",e=>{e.preventDefault(),localStorage.removeItem("appearance")})),n&&(n.addEventListener("click",()=>{document.documentElement.classList.toggle("dark");var e=getTargetAppearance();localStorage.setItem("appearance",e),updateMeta(),this.updateLogo?.(e)}),n.addEventListener("contextmenu",e=>{e.preventDefault(),localStorage.removeItem("appearance")}))});var updateMeta=()=>{var e=document.querySelector("body"),t=getComputedStyle(e);document.querySelector('meta[name="theme-color"]').setAttribute("content",t.backgroundColor)},getTargetAppearance=()=>document.documentElement.classList.contains("dark")?"dark":"light";window.addEventListener("DOMContentLoaded",e=>{const t=document.getElementById("top-scroller"),n=document.getElementById("site-footer");t&&n&&t.getBoundingClientRect().top>n.getBoundingClientRect().top&&(t.hidden=!0)})

public/categories/index.xml

@@ -1,10 +1 @@
-<?xml version="1.0" encoding="utf-8" standalone="yes"?>
+<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Categories on Blowfish</title><link>https://nunocoracao.github.io/blowfish/categories/</link><description>Recent content in Categories on Blowfish</description><generator>Hugo -- gohugo.io</generator><language>en</language><atom:link href="https://nunocoracao.github.io/blowfish/categories/index.xml" rel="self" type="application/rss+xml"/></channel></rss>
-<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
-  <channel>
-    <title>Categories on Blowfish</title>
-    <link>/categories/</link>
-    <description>Recent content in Categories on Blowfish</description>
-    <generator>Hugo -- gohugo.io</generator>
-    <language>en</language><atom:link href="/categories/index.xml" rel="self" type="application/rss+xml" />
-  </channel>
-</rss>

public/docs/index.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Documentation on Blowfish</title><link>https://nunocoracao.github.io/blowfish/docs/</link><description>Recent content in Documentation on Blowfish</description><generator>Hugo -- gohugo.io</generator><language>en</language><lastBuildDate>Wed, 19 Jan 2022 00:00:00 +0000</lastBuildDate><atom:link href="https://nunocoracao.github.io/blowfish/docs/index.xml" rel="self" type="application/rss+xml"/><item><title>Welcome to Blowfish</title><link>https://nunocoracao.github.io/blowfish/docs/welcome/</link><pubDate>Wed, 19 Jan 2022 00:00:00 +0000</pubDate><guid>https://nunocoracao.github.io/blowfish/docs/welcome/</guid><description>Blowfish is packed with tons of features. The original aim of Blowfish was to develop a theme that was simple and lightweight. The theme is a fork of Congo and expands its initial vision.</description></item><item><title>Installation</title><link>https://nunocoracao.github.io/blowfish/docs/installation/</link><pubDate>Sun, 16 Aug 2020 00:00:00 +0000</pubDate><guid>https://nunocoracao.github.io/blowfish/docs/installation/</guid><description>Simply follow the standard Hugo Quick Start procedure to get up and running quickly.
+Detailed installation instructions can be found below. Instructions for updating the theme are also available.
+Installation # These instructions will get you up and running using Hugo and Blowfish from a completely blank state.</description></item><item><title>Getting Started</title><link>https://nunocoracao.github.io/blowfish/docs/getting-started/</link><pubDate>Sat, 15 Aug 2020 00:00:00 +0000</pubDate><guid>https://nunocoracao.github.io/blowfish/docs/getting-started/</guid><description>This section assumes you have already installed the Blowfish theme. The config files that ship with Blowfish contain all of the possible settings that the theme recognises. By default, many of these are commented out but you can simply uncomment them to activate or change a specific feature.</description></item><item><title>Configuration</title><link>https://nunocoracao.github.io/blowfish/docs/configuration/</link><pubDate>Fri, 14 Aug 2020 00:00:00 +0000</pubDate><guid>https://nunocoracao.github.io/blowfish/docs/configuration/</guid><description>Blowfish is a highly customisable theme and uses some of the latest Hugo features to simplify how it is configured.
+The theme ships with a default configuration that gets you up and running with a basic blog or static website.</description></item><item><title>Homepage Layout</title><link>https://nunocoracao.github.io/blowfish/docs/homepage-layout/</link><pubDate>Thu, 13 Aug 2020 00:00:00 +0000</pubDate><guid>https://nunocoracao.github.io/blowfish/docs/homepage-layout/</guid><description>Blowfish provides a fully flexible homepage layout. There are two main templates to choose from with additional settings to adjust the design. Alternatively, you can also provide your own template and have complete control over the homepage content.</description></item><item><title>Front Matter</title><link>https://nunocoracao.github.io/blowfish/docs/front-matter/</link><pubDate>Wed, 12 Aug 2020 00:00:00 +0000</pubDate><guid>https://nunocoracao.github.io/blowfish/docs/front-matter/</guid><description>In addition to the default Hugo front matter parameters, Blowfish adds a number of additional options to customise the presentation of individual articles. All the available theme front matter parameters are listed below.</description></item><item><title>Thumbnails</title><link>https://nunocoracao.github.io/blowfish/docs/thumbnails/</link><pubDate>Wed, 12 Aug 2020 00:00:00 +0000</pubDate><guid>https://nunocoracao.github.io/blowfish/docs/thumbnails/</guid><description>Thumbnails # Blowfish was enhanced in order to make it easy to add visual support to your posts. To do so, you just need to place an image file (almost all formats are supported bue we recommend .</description></item><item><title>Shortcodes</title><link>https://nunocoracao.github.io/blowfish/docs/shortcodes/</link><pubDate>Tue, 11 Aug 2020 00:00:00 +0000</pubDate><guid>https://nunocoracao.github.io/blowfish/docs/shortcodes/</guid><description>In addition to all the default Hugo shortcodes, Blowfish adds a few extras for additional functionality.
+Alert # alert outputs its contents as a stylised message box within your article. It&amp;rsquo;s useful for drawing attention to important information that you don&amp;rsquo;t want the reader to miss.</description></item><item><title>Multiple Authors</title><link>https://nunocoracao.github.io/blowfish/docs/multi-author/</link><pubDate>Mon, 10 Aug 2020 00:00:00 +0000</pubDate><guid>https://nunocoracao.github.io/blowfish/docs/multi-author/</guid><description>Some websites have more than one author contributing with content and therefore require more than a single default author across the entire website. For those use-cases, Blowfish allows users to extend the list of authors using the multiple authors feature.</description></item><item><title>Partials</title><link>https://nunocoracao.github.io/blowfish/docs/partials/</link><pubDate>Mon, 10 Aug 2020 00:00:00 +0000</pubDate><guid>https://nunocoracao.github.io/blowfish/docs/partials/</guid><description>Analytics # Blowfish provides built-in support for Fathom Analytics and Google Analytics. Fathom is a paid alternative to Google Analytics that respects user privacy.
+Fathom Analytics # To enable Fathom Analytics support, simply provide your Fathom site code in the config/_default/params.</description></item><item><title>Content Examples</title><link>https://nunocoracao.github.io/blowfish/docs/content-examples/</link><pubDate>Sun, 09 Aug 2020 00:00:00 +0000</pubDate><guid>https://nunocoracao.github.io/blowfish/docs/content-examples/</guid><description>If you&amp;rsquo;ve been reading the documentation in order, you should now know about all the features and configurations available in Blowfish. This page is designed to pull everything together and offer some worked examples that you might like to use in your Hugo project.</description></item><item><title>Series</title><link>https://nunocoracao.github.io/blowfish/docs/series/</link><pubDate>Sun, 09 Aug 2020 00:00:00 +0000</pubDate><guid>https://nunocoracao.github.io/blowfish/docs/series/</guid><description>Blowfish provides a feature to group a set of articles together under a &amp;ldquo;series&amp;rdquo;. Placing an article under a series will display the rest of the series articles in each single page and provide a quick way to navigate amongst them.</description></item><item><title>Advanced Customisation</title><link>https://nunocoracao.github.io/blowfish/docs/advanced-customisation/</link><pubDate>Sat, 08 Aug 2020 00:00:00 +0000</pubDate><guid>https://nunocoracao.github.io/blowfish/docs/advanced-customisation/</guid><description>There are many ways you can make advanced changes to Blowfish. Read below to learn more about what can be customised and the best way of achieving your desired result.</description></item><item><title>Hosting &amp; Deployment</title><link>https://nunocoracao.github.io/blowfish/docs/hosting-deployment/</link><pubDate>Fri, 07 Aug 2020 00:00:00 +0000</pubDate><guid>https://nunocoracao.github.io/blowfish/docs/hosting-deployment/</guid><description>There are many ways to deploy your Hugo website built with Blowfish. The theme is designed to be flexible in almost any deployment scenario.
+Blowfish is built using relative URLs throughout the theme.</description></item><item><title>Firebase: Views &amp; Likes</title><link>https://nunocoracao.github.io/blowfish/docs/firebase-views/</link><pubDate>Mon, 03 Aug 2020 00:00:00 +0000</pubDate><guid>https://nunocoracao.github.io/blowfish/docs/firebase-views/</guid><description>In order to be able to support dynamic data across your website we&amp;rsquo;ve added the support to integrate Firebase. This will allow you to use the views feature across lists and posts.</description></item></channel></rss>

public/docs/page/1/index.html

@@ -0,0 +1 @@
+<!doctype html><html lang=en><head><title>https://nunocoracao.github.io/blowfish/docs/</title><link rel=canonical href=https://nunocoracao.github.io/blowfish/docs/><meta name=robots content="noindex"><meta charset=utf-8><meta http-equiv=refresh content="0; url=https://nunocoracao.github.io/blowfish/docs/"></head></html>