Welcome to Blowfish! :tada: on Blowfish

n9o.xyz

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

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.

madoke.org

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

code-chimp.com

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

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.

mucahitkurtlar.github.io

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

brendanwallace.github.io

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

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.

pmnxis.github.io

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

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.

ciicadalab.github.io

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

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.

georgiancodeclub.github.io

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

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.

fahru.my.id

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

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.

loisvelasco.is-a.dev

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

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.

Content Examples

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

insidemordecai.com

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

blastomussa.dev

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

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.

jam.dsg.li

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

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.

priyakdey.com

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

Firebase: Views & Likes

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

sdehm.dev

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

dizzytech.de

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

alejandro-ao.com

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

adir1.com

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

blog.muffn.io

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

nick.bouwhuis.net

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

vividscc.com

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

technicat.com

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

fugugames.com

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

hyperbowl3d.com

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

talkdimsum.com

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

alanctanner.com

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

rdgo.dev

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

clemsau.com

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

weaxsey.org

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

nikarashihatsu.github.io

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

halcyonstraits.com

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

50-nuances-octets.fr

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

marupanda.art/marucomics

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

m3upt.com

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

pacochan.net

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

vkmki001.github.io

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

bbagwang.com

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

jamiemoxon.tech

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

theindiecoder.cloud

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

gma.name

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

mayer.life

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

scottmckendry.tech

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

ohdmire.github.io

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

ricklan.photography

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

deepumohan.com/tech

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

joush007.github.io

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

blog.stonegarden.dev

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

renaud.warnotte.be

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

BoringTech.net

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

technicaldc.github.io

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

alxhslm.github.io

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

the-maze.net

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

DXPetti.com

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

asterisk.lol

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

ekwska.com

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

aakashnand.com

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

karlukle.site

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

Adam Madej - Gameplay Animator

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

eallion.com

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

Synaptic Sugar

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

michaeldorner.de

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

Ignacio Conde

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

UmmIt - Blog

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

nveshaan

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

kumacat.pages.dev

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

andrealucchini.com

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

glomyer.dev

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

utrodus.com

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

lazarusoverlook.com

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

p3rception.github.io

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

Handbook on Teaching Empirical Software Engineering: Online Materials

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

blog.lofibean.cc

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

Academy Customize

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

mrtruongvu.com

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

StepaniaH

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

Laterre Dev

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

Lazy Product Reviews

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

zzzhome

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

Bootleg Coal Rebellion

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

Chill-Try

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

Hudson McNamara

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

Weg um Weg

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

The Space 🌍

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

blog.francescopapini.com

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

Adri Antunez's Cloud Site

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

irusukan

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

FEEC/UNICAMP IA382 - Seminar in Computer Engineering

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

blog.francescopapini.com

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

Kyo's Garden

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

abantikabhuti.github.io

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

yag0x1.github.io

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

Learn-Software.com

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

mitri.lol

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

kieranlowe.io

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

eike.in

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

tbsch.de | Smart Home, Technik, Kram

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

metalhearf.fr

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

encelo.github.io

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

ncine.github.io

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

István Merza

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

daytaur.com

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

zzamboni.org

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

Tower of Kubes

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

monpetitdev.fr

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

Noor Khafidzin

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

Reyneese on WoW

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

David Writes

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

GOODJINC

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

Artur Tyloch

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

Tats Shibata

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

Radek Průša

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

jbetzen.net

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

alst.ovh

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

Zarvelion Zynji

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

Airika

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

Cook Like A Nerd

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

Cintia Ching

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

luizcarloscf.github.io

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

Robin Fairchild

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

Paraguay4Life

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

www.gsking.co.uk

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

Build your homepage using Blowfish and Hugo

nuno@n9o.xyz (Blowfish) — Wed, 04 Oct 2023 00:00:00 +0000

Just one year ago, I created Blowfish, a Hugo theme crafted to build my unique vision for my personal homepage. I also decided to make it an open-source project. Fast-forward to today, and Blowfish has transformed into a thriving open-source project with over 600 stars on GitHub and a user base of hundreds. In this tutorial, I’ll show you how to get started and have your website running in a couple of minutes.

Multiple Authors

nuno@n9o.xyz (Blowfish) — Wed, 12 Oct 2022 00:00:00 +0000

A quick example of how multiple authors could be used.

Thumbnails

nuno@n9o.xyz (Blowfish) — Mon, 26 Sep 2022 00:00:00 +0000

A quick example of how to start using Thumbnails in your artciles.

Icons

nuno@n9o.xyz (Blowfish) — Fri, 14 Aug 2020 00:00:00 +0000

Blowfish has built-in support for a number of FontAwesome 6 icons. These can be included in your website through either the icon partial or icon shortcode.

Additionally, custom icons are also fully supported. Simply provide your own SVG icon assets by placing them in the assets/icons/ directory in the root of your project. Any icons in the icons directory will then be available to use throughout the theme. In order to achieve automatic color filling, every SVG path needs the fill="currentColor" XML attribute.

Markdown

nuno@n9o.xyz (Blowfish) — Mon, 11 Mar 2019 00:00:00 +0000

This article offers a sample of basic Markdown formatting that can be used in Blowfish, also it shows how some basic HTML elements are decorated.

Rich Content

nuno@n9o.xyz (Blowfish) — Sun, 10 Mar 2019 00:00:00 +0000

This is an example of a rich content summary.

Placeholder Text

nuno@n9o.xyz (Blowfish) — Sat, 09 Mar 2019 00:00:00 +0000

Lorem est tota propiore conpellat pectoribus de pectora summo.

Mathematical notation

nuno@n9o.xyz (Blowfish) — Fri, 08 Mar 2019 00:00:00 +0000

KaTeX can be used to render mathematical notation within articles.

Charts

nuno@n9o.xyz (Blowfish) — Wed, 06 Mar 2019 00:00:00 +0000

Blowfish includes Chart.js for powerful charts and data visualisations.

Diagrams and Flowcharts

nuno@n9o.xyz (Blowfish) — Wed, 06 Mar 2019 00:00:00 +0000

It’s easy to add diagrams and flowcharts to articles using Mermaid.

Emoji :parachute:

nuno@n9o.xyz (Blowfish) — Tue, 05 Mar 2019 00:00:00 +0000

📖🏞️🧗🏽🐉🧙🏽‍♂️🧚🏽👸

Recipe Template

nuno@n9o.xyz (Blowfish) — Tue, 22 Dec 1987 00:00:00 +0000

Thank you for wanting to contribute to Blowfish’s community.

How to start?
#

This is a template article that will explain how to create a new article for Blowfish’s guide section.

Welcome to Blowfish! :tada: on Blowfish

n9o.xyz

Welcome to Blowfish

Installation

Installation #

madoke.org

code-chimp.com

Getting Started

Configuration

mucahitkurtlar.github.io

brendanwallace.github.io

Homepage Layout

pmnxis.github.io

Shortcodes

Alert #

ciicadalab.github.io

Front Matter

georgiancodeclub.github.io

Multiple Authors

fahru.my.id

Partials

Analytics #

loisvelasco.is-a.dev

Thumbnails

Thumbnails #

Content Examples

insidemordecai.com

blastomussa.dev

Series

Advanced Customisation

jam.dsg.li

Hosting & Deployment

priyakdey.com

Firebase: Views & Likes

sdehm.dev

dizzytech.de

alejandro-ao.com

adir1.com

blog.muffn.io

nick.bouwhuis.net

vividscc.com

technicat.com

fugugames.com

hyperbowl3d.com

talkdimsum.com

alanctanner.com

rdgo.dev

clemsau.com

weaxsey.org

nikarashihatsu.github.io

halcyonstraits.com

50-nuances-octets.fr

marupanda.art/marucomics

m3upt.com

pacochan.net

vkmki001.github.io

bbagwang.com

jamiemoxon.tech

theindiecoder.cloud

gma.name

mayer.life

scottmckendry.tech

ohdmire.github.io

ricklan.photography

deepumohan.com/tech

joush007.github.io

blog.stonegarden.dev

renaud.warnotte.be

BoringTech.net

technicaldc.github.io

alxhslm.github.io

the-maze.net

DXPetti.com

asterisk.lol

ekwska.com

aakashnand.com

karlukle.site

Adam Madej - Gameplay Animator

eallion.com

Synaptic Sugar

Installation
#

Alert
#

Analytics
#

Thumbnails
#