Ananke Documentation
  • Get started
    • Choose an installation method
    • Install as a Hugo Module (recommended)
    • Install as a Git submodule
    • Upgrade from theNewDynamic to gohugo-ananke
  • Configuration
    • General configuration
    • Homepage
    • Menus
    • Social media networks
    • SEO
    • robots.txt and environments
    • Analytics
    • Multilingual and i18n
    • Configuration reference
  • Content
    • Front matter
    • Authors and read more links
    • Content types and archetypes
    • Images
    • Summaries and reading time
    • Taxonomies
    • Shortcodes
  • Customisation
    • Colours
    • Styles
    • Custom CSS
    • Page headers
    • Header layout and hooks
    • Comments
    • Overriding partials
    • Layout map
    • Hooks & filters
  • Examples
    • Minimal blog
    • Multilingual site
    • No-blog static site
    • External links
    • Add a LinkedIn icon
  • Help
    • Troubleshooting
    • Contributing to the documentation
    • Contributors
    • Developing across the Ananke repositories
Mastodon

Get started

This section takes you from an empty Hugo site to a working site with Ananke. Follow the steps below in order. If you already use Ananke from the old theNewDynamic repository, read Upgrade from theNewDynamic to gohugo-ananke first.

1) Install the theme #

Choose one installation method. To compare the two methods, read Choose an installation method.

  • Install as a Hugo Module (recommended)
  • Install as a Git submodule

2) Confirm Hugo version compatibility #

Ananke requires Hugo v0.160.0 or later. The theme declares this minimum in its own config/_default/module.toml file. We recommend the latest Hugo version, because we test Ananke against the latest Hugo release.

Check which Hugo version you have installed:

bash
hugo version

Use the standard edition of Hugo, or the deploy edition if you deploy your site directly from Hugo. Since Hugo v0.170.0, the extended editions are no longer available or needed: the standard and deploy editions encode WebP images, and Hugo uses Dart Sass for Sass. If you use a Hugo version from v0.160.0 to v0.169.x, you need the extended edition only to process WebP images. For details, see Hugo editions.

3) Configure required basics #

At minimum, configure:

  • Site title
  • baseURL
  • Theme/module setup
  • params values you want to customise

See:

  • General configuration
  • Menus
  • SEO
  • Social media networks

All configuration topics are in the Configuration section.

4) Add content and front matter #

Start adding content and use front matter options supported by Ananke:

  • Front matter
  • Content types and archetypes
  • Images
  • Shortcodes

All content topics are in the Content section.

5) Customise the visual style #

For design and UI adjustments:

  • Colours
  • Styles
  • Custom CSS
  • Page headers

All customisation topics are in the Customisation section. For complete site configurations, see Examples and recipes.

6) Run and verify locally #

Run Hugo locally and verify pages, menus, metadata, and social links:

bash
hugo server

If you hit issues, see Troubleshooting.

In this section

  • Choose an installation method

    Compare the two ways to install Ananke: as a Hugo Module or as a Git submodule.

  • Install as a Hugo Module (recommended)

    Install Ananke as a Hugo Module, the recommended method.

  • Install as a Git submodule

    Install Ananke as a Git submodule in the themes folder of your site.

  • Upgrade from theNewDynamic to gohugo-ananke

    Move an existing site from the old theNewDynamic repository to github.com/gohugo-ananke/ananke.

Ananke Documentation © Ananke Documentation 2026
Mastodon