Ananke Documentation
  • Overview
  • Tutorials
    • Build your first Ananke site
  • How-to guides
    • Install as a Hugo Module
    • Install as a Git submodule
    • Update Ananke
    • Set up menus
    • Add social links
    • Add custom CSS
    • Configure page headers
    • Use hooks
    • Troubleshooting
  • Explanation
    • Choose an installation method
    • How configuration works
    • How the stylesheet is built
    • Content types and archetypes
    • Hooks and filters
  • Reference
    • Configuration reference
    • Front matter
    • Hugo version compatibility
    • Shortcodes
    • Hook catalogue
    • Layout map
  • Help
    • Contributing to the documentation
    • Developing across the Ananke repositories
    • Contributors
Mastodon

Get started

Install Ananke, check Hugo compatibility, update the theme, or move from the old theNewDynamic repository.

This section covers everything you need before you write content: the requirements, the installation, and later updates of the theme.

New to Ananke and Hugo #

Follow Build your first Ananke site. The exercise installs the theme and creates a homepage, a post, and a menu.

Install the theme #

  • Hugo version compatibility: the Hugo versions that each Ananke release supports, and the standard and Extended editions.
  • Choose an installation method: Hugo Module or Git submodule.
  • Install as a Hugo Module, the recommended method.
  • Install as a Git submodule.

Keep the theme up to date #

  • Update Ananke to a newer release.
  • Upgrade from theNewDynamic to gohugo-ananke if your site still uses the old repository or module path.

After the installation #

  • Configuration: site title, menus, homepage, social links, SEO, and languages.
  • Content: front matter, images, summaries, taxonomies, and shortcodes.
  • Customisation: colours, styles, custom CSS, page headers, and hooks.
  • Examples and recipes: complete site configurations.

If something does not work, see Troubleshooting.

In this section

  • Hugo version compatibility

    The compatibility table below records which stable Ananke releases build with specific Hugo versions. Hugo versions before 1.0 can introduce breaking changes between minor …

  • 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)

    Create a Hugo site and install Ananke as a Hugo Module, the recommended method.

  • Install as a Git submodule

    Create a Hugo site and install Ananke as a Git submodule in the themes directory.

  • Update Ananke

    Update the theme in an existing site to a newer Ananke release, as a Hugo Module or as a Git submodule.

  • Upgrade from theNewDynamic to gohugo-ananke

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

  • Upgrade social links from Ananke 2.10 or earlier

    Move social profile settings from ananke_socials or flat parameters to the ananke.social configuration of Ananke 2.11.0 and later.

Ananke Documentation © Ananke Documentation 2026
Mastodon