mirror of https://github.com/theNewDynamic/gohugo-theme-ananke.git
edit | blame | history | raw

Ananke Theme for Hugo

Ananke is a flexible, production-ready starter theme for Hugo focused on accessibility, performance, and maintainable defaults.

Ananke screenshot

[!IMPORTANT]

Ananke moved to its own organisation on April 23, 2026. Please update your references from github.com/theNewDynamic/gohugo-theme-ananke to github.com/gohugo-ananke/ananke. Bear with us as we update all documentation and links to reflect this change. Until then, both URLs will continue to work as links as well as in the git operations for cloning and submodules.

The following steps should suffice to update your references if you have not changed the setup:

For Hugo Modules: search and replace all instances of github.com/theNewDynamic/gohugo-theme-ananke/v2 with github.com/gohugo-ananke/ananke/v2 in your site's configuration and run hugo mod tidy to update the module dependencies.

For Git Submodules: To change the remote URL for your existing submodule, run:

cd path/to/your/repo/themes/ananke # <-- adjust path as needed, keep the 'themes/ananke' part
git remote set-url origin https://github.com/gohugo-ananke/ananke.git

Then find .gitmodules in the root of your repository and replace all instances of theNewDynamic/gohugo-theme-ananke with gohugo-ananke/ananke in that file as well.
Finally, run git submodule sync to update the submodule configuration.

Issues? Get in touch via GitHub Discussions.

Features

  • Responsive layouts and accessible markup
  • Configurable hero/header behaviour
  • Configurable social follow/share links
  • Optional contact form shortcode
  • Localized i18n strings in many languages
  • SEO defaults with Hugo internal templates
  • Reading time/word count support
  • Robots.txt handling by environment

Installation

Ananke supports both installation methods:

If you are new to Hugo, see Hugo's official quick start: gohugo.io/getting-started/quick-start.

Getting Started

After installation, use these guides to configure your site:

Basic configuration examples

A post can define common metadata in its front matter. The default archetype already includes date, tags, featured_image, and description; add author and categories when you need them:

---
title: "Post title example"
author: "Jane Example"
date: 2026-05-15T00:00:00+07:00
categories:
  - News
  - Updates
tags:
  - hugo
  - ananke
featured_image: "/images/post-image.jpg"
description: "A short description for listings and metadata."
---

Use featured_image for the smaller image shown with post teasers and previews. Store the image in your site, for example under static/images/, and reference it from the site root as /images/post-image.jpg.

Add header navigation through Hugo's menu configuration:

[[menus.main]]
name = "About"
pageRef = "/about"
weight = 10

[[menus.main]]
name = "Authors"
pageRef = "/authors"
weight = 20

Add footer follow links, including email, through the social follow configuration. The available network definitions live in config/_default/params.toml.

[params.ananke.social.follow]
networks = ["email", "github"]

[params.ananke.social.github]
username = "example"

[params.ananke.social.email]
username = "hello@example.com"

Support and Contributions