Documentation on Blowfish

Shortcodes

Mon, 01 Jan 0001 00:00:00 +0000

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’s useful for drawing attention to important information that you don’t want the reader to miss.

Multiple Authors

Mon, 01 Jan 0001 00:00:00 +0000

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.

Partials

Mon, 01 Jan 0001 00:00:00 +0000

Analytics
#

Blowfish provides built-in support for Fathom Analytics and Google Analytics. Fathom is a paid alternative to Google Analytics that respects user privacy.

Thumbnails

Mon, 01 Jan 0001 00:00:00 +0000

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 but we recommend .png or .jpg) that starts with feature* inside your article’s main directory, as shown in the example below.

Content Examples

Mon, 01 Jan 0001 00:00:00 +0000

If you’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.

Series

Mon, 01 Jan 0001 00:00:00 +0000

Blowfish provides a feature to group a set of articles together under a “series”. 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. You can see an example of this above.

Advanced Customisation

Mon, 01 Jan 0001 00:00:00 +0000

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.

Hosting & Deployment

Mon, 01 Jan 0001 00:00:00 +0000

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. This enables sites to easily be deployed to sub-folders and hosts like GitHub Pages. There’s usually no special configuration required for this to work as long as the baseURL parameter has been configured in the hugo.toml file.

Firebase: Views & Likes

Mon, 01 Jan 0001 00:00:00 +0000

In order to be able to support dynamic data across your website we’ve added the support to integrate Firebase. This will allow you to use the views feature across lists and posts.

Documentation on Blowfish

Shortcodes

Alert #

Multiple Authors

Partials

Analytics #

Thumbnails

Thumbnails #

Content Examples

Series

Advanced Customisation

Hosting & Deployment

Firebase: Views & Likes

Alert
#

Analytics
#

Thumbnails
#