Hugo Theme Ananke on Ananke Documentation

Introduction to Hooks & Filters

Sun, 17 May 2026 08:00:00 +0700

Hooks and filters
Difference between hooks and filters
- Hooks
- Filters
Terminology
Simple hook calls
Extended hook calls
Extended hook options
- hook
- context
- cache
Hook partial location
Disabling unused hook messages
Recommended usage pattern

Hooks and filters #

Ananke provides a small hooks system that lets site projects inject or transform markup without changing the theme templates directly.

Hook examples

Sun, 17 May 2026 08:00:00 +0700

since 2.17.0

This page collects worked examples for the theme’s hook points. Each one shows the partial you create, where the output lands, and why you would reach for that particular hook.

If you have not read it yet, start with the introduction for the call mechanics, and keep the list of all hooks handy for the available hook names.

Before you start
Add a third-party script in the head
Defer analytics to the end of the body
Add a site-wide announcement bar
Extend the footer (and cache it)
Add secondary navigation using the page context
Add an author bio after the content
Override the article section link
Use a hook as a filter

Before you start #

Every example below is a file you create in your site, never in the theme:

All Hooks & Filters

Sun, 17 May 2026 08:00:00 +0700

since 2.17.0

This page lists every hook point the theme wires into its templates. Each entry is the value you pass as the hook key (see the introduction for how to call hooks and filters).

A hook point does nothing until your site provides a matching partial at layouts/_partials/hooks/<name>.html. Until then the hook is “unused” — the theme prints an optional debug notice and renders nothing.

Contributors

Wed, 15 Apr 2026 08:00:00 +0700

Contributors

Ananke lives from the work of its contributors.

Contributors #

Total contributors: 1

Contributor	Contributions	Repositories
Patrick Kollitsch	`bug`, `code`, `doc`	`documentation`

Calculate and show reading time

Fri, 16 Jan 2026 08:00:00 +0700

Configuration
Notes

The reading time displayed in layouts/_default/single.html can now be configured via a reading_speed parameter, instead of always using Hugo’s computed .ReadingTime. (GitHub)

The theme still only shows reading time when show_reading_time = true is enabled (page param or section param). (GitHub)
The displayed value is now computed like this:

Colours

Fri, 16 Jan 2026 08:00:00 +0700

Set Content Font Color

Set Content Font Color #

You can set the font color of the main content both globally and on individual pages:

Globally: Set the text_color param in the config.toml file.

[params]
text_color = "green"

Individual Page (prioritized over global): Set the text_color param in a page’s markdown file front matter.

note: The value of text_color must be a valid tachyons color class. A list can be found here.

Comments

Fri, 16 Jan 2026 08:00:00 +0700

Disqus
Commento.io

Ananke currently supports two commenting systems: Disqus and Commento.

Disqus #

Using Disqus as a comment system for your website is an internal feature of Hugo. For more information see the official Hugo documentation.

[services.disqus]
shortname = 'YOURSHORTNAME'

Note that the setup for Disqus is NOT done inside of the params section, but with in the services section of your config file. To turn off Disqus, remove, or comment out the preceding lines.

External Links

Fri, 16 Jan 2026 08:00:00 +0700

a.ananke-social-link[target="_blank"]::after {
 content: "↗";
 display: inline-block;
 margin-inline-start: 0.25em;
 font-size: 0.85em;
 line-height: 1;
 vertical-align: 0.1em;
}

.new-window {
 opacity: 0;
 display: inline-block;
 vertical-align: top;
}
.link-transition:hover .new-window{
 opacity: 1;
}

Frontmatter

Fri, 16 Jan 2026 08:00:00 +0700

Using a canonical url
Common Options
Example: Disabling Breadcrumbs
Example: Custom Layout
Example: Using linktitle
Defaults & Fallbacks
Notes

Using a canonical url #

If you want to publish content that is already published on a different site you need to reference a canonical URL of the original content. By defining the canonicalUrl in the front matter definition the canonical url is set in the headers.

General

Fri, 16 Jan 2026 08:00:00 +0700

Read more link
Show Reading Time and Word Count

General Configuration

Fri, 16 Jan 2026 08:00:00 +0700

Activate the contact form
Logo
Localize date format

[!IMPORTANT] Please note that Hugo is extensible configurable with more generic or more specific configuration. Please read the documentation about configuration files and configuration directories to learn more about this topic. Whenever Ananke’s documentation refers to the configuration file it refers to any of these possible locations.

Ananke’s sample repositories are using configuration directories and you can find all referred configuration parameters in config/_default/hugo.toml and config/_default/params.toml.

Getting Started

Fri, 16 Jan 2026 08:00:00 +0700

1) Install the theme
2) Confirm Hugo version compatibility
3) Configure required basics
4) Add content and front matter
5) Customize visual style
6) Run and verify locally

This guide summarizes the first configuration steps after installing Ananke.

1) Install the theme #

Choose one installation method:

2) Confirm Hugo version compatibility #

Check what Hugo version you have installed with hugo version and then compare against the minimum requirement in config/_default/module.toml.

Hero Section

Fri, 16 Jan 2026 08:00:00 +0700

Change the hero background
Use the images front matter array
Featured image as Page Resources
Other hero settings

Change the hero background #

For any page or post you can add a featured image by including the local path in front matter (see content in the exampleSite/content/en/_readme file for examples): featured_image = '/images/gohugo-default-sample-hero-image.jpg'

Use the images front matter array #

If featured_image is not set, Ananke will use the first value from the page’s images front matter array as the featured image.

Installation as a Hugo Module (recommended)

Fri, 16 Jan 2026 08:00:00 +0700

Methods
Requirements
Installation

Hugo Module based installation for the Ananke theme for Hugo.

Methods #

Install Ananke as Hugo Module - this page
Install Ananke as Git Submodule

Requirements #

Install Hugo (extended or extended/deploy edition, 0.128.0 or later)
Install Git
Install Golang

Installation #

To install or create a GoHugo website from scratch with the Ananke theme using the GoHugo Module method, follow these steps:

Installation as Git Submodule

Fri, 16 Jan 2026 08:00:00 +0700

Methods
Requirements
Installation

Git Submodule based installation for the Ananke theme for Hugo.

Methods #

Install Ananke as Hugo Module
Install Ananke as Git Submodule - this page

Requirements #

Install Hugo (extended or extended/deploy edition, 0.128.0 or later)
Install Git

Installation #

To install or create a Hugo website from scratch with the Ananke theme using the submodule method, follow these steps:

Introduction

Fri, 16 Jan 2026 08:00:00 +0700

Installing the Ananke Theme for Hugo
Comparison: Hugo Module vs. Git Submodule

Installing the Ananke Theme for Hugo #

There are two primary ways to install Ananke:

Hugo Module — Uses Hugo’s built-in Go module system to fetch and manage the theme as a package.
Git Submodule — Links the theme repository as a submodule inside your Hugo project.

If you’re following the Hugo Quickstart guide, you’ll notice that it currently recommends installing the Ananke theme as a Git submodule. While this is a valid approach, Hugo also offers a more powerful alternative: Hugo Modules, which leverage Go’s module system for better dependency management.

SEO

Fri, 16 Jan 2026 08:00:00 +0700

Content indexing

Content indexing #

If the theme is run in production, pages will be indexed by search engines. To prevent indexing on some given pages, add private: true to its Front Matter.

Social Media Networks

Fri, 16 Jan 2026 08:00:00 +0700

Configuration
Available networks
Icons
- Adding new icons
- Further Reading
Migrate from versions before v2.11
- Development changes
Notes

Ananke automatically adds “follow” link icons to the header and footer and “Share” link icons to pages unless the disable_share parameter is set to true either on the site level (site params) or page level (front matter). Each services can show a label, an icon, and be formatted in a custom color.

Styles

Fri, 16 Jan 2026 08:00:00 +0700

Update font or body classes
Stylesheet Generation

Update font or body classes #

The theme is set, by default, to use a near-white background color and the “Avenir” or serif typeface. You can change these in your config file with the body_classes parameter, like this:

[params]
 body_classes = "avenir bg-near-white"

which will give you a body class like this:

Troubleshooting

Fri, 16 Jan 2026 08:00:00 +0700

Sorry, but “$FEATURE does not work” doesn’t work for us

Sorry, but “$FEATURE does not work” doesn’t work for us #

Long story short, ask yourself: If you start bleeding out of all your orifices, will you tell the doctor “Doctor please help, I am quite new to this whole health thing and know you will laugh about me but I suddenly started bleeding out of all my orifices.”? Or will you tell the doctor “Doctor, after ingesting a couple of razor blades I suddenly started bleeding. The razor blades were quite sharp. Can you help me?”

Hugo Theme Ananke on Ananke Documentation

Introduction to Hooks & Filters

Hooks and filters #

Hook examples

Before you start #

All Hooks & Filters

Contributors

Contributors #

Calculate and show reading time

Colours

Set Content Font Color #

Comments

Disqus #

External Links

Frontmatter

Using a canonical url #

General

Read more link #

General Configuration

Getting Started

1) Install the theme #

2) Confirm Hugo version compatibility #

Hero Section

Change the hero background #

Use the images front matter array #

Installation as a Hugo Module (recommended)

Methods #

Requirements #

Installation #

Installation as Git Submodule

Methods #

Requirements #

Installation #

Introduction

Installing the Ananke Theme for Hugo #

SEO

Content indexing #

Social Media Networks

Styles

Update font or body classes #

Troubleshooting

Sorry, but “$FEATURE does not work” doesn’t work for us #