Docs on Blowfish

Welcome to Blowfish

nuno@n9o.xyz (Blowfish) — Mon, 01 Jan 0001 00:00:00 +0000

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.

Installation

nuno@n9o.xyz (Blowfish) — Mon, 01 Jan 0001 00:00:00 +0000

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. Most of the dependencies mentioned in this guide can be installed using the package manager of choice for your platform.

Getting Started

nuno@n9o.xyz (Blowfish) — Mon, 01 Jan 0001 00:00:00 +0000

This section assumes you have already installed the Blowfish theme.

We just launched a CLI tool to help you get started with Blowfish. It will help you with installation and configuration. Install the CLI tool globally using:

Configuration

nuno@n9o.xyz (Blowfish) — Mon, 01 Jan 0001 00:00:00 +0000

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.

Homepage Layout

nuno@n9o.xyz (Blowfish) — Mon, 01 Jan 0001 00:00:00 +0000

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.

Shortcodes

nuno@n9o.xyz (Blowfish) — 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.

Front Matter

nuno@n9o.xyz (Blowfish) — Mon, 01 Jan 0001 00:00:00 +0000

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.

Multiple Authors

nuno@n9o.xyz (Blowfish) — 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

nuno@n9o.xyz (Blowfish) — Mon, 01 Jan 0001 00:00:00 +0000

Analytics
#

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

Thumbnails

nuno@n9o.xyz (Blowfish) — 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.

Series

nuno@n9o.xyz (Blowfish) — 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

nuno@n9o.xyz (Blowfish) — 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

nuno@n9o.xyz (Blowfish) — 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.

Docs on Blowfish

Welcome to Blowfish

Installation

Installation #

Getting Started

Configuration

Homepage Layout

Shortcodes

Alert #

Front Matter

Multiple Authors

Partials

Analytics #

Thumbnails

Thumbnails #

Series

Advanced Customisation

Hosting & Deployment

Installation
#

Alert
#

Analytics
#

Thumbnails
#