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

How-to guides

Install, configure, customise, upgrade, and troubleshoot an Ananke site.

Use these guides when you have a specific result in mind. If you want a guided learning exercise, start with your first Ananke site.

Install and upgrade #

  • Install as a Hugo Module, the recommended method.
  • Install as a Git submodule.
  • Update Ananke to a newer release, including social links from Ananke 2.10 or earlier.
  • Upgrade from theNewDynamic.

Configure your site #

  • Configure the homepage and navigation menus.
  • Add social follow and share links.
  • Publish in more than one language.
  • Configure analytics and search engine indexing.
  • Set up robots.txt and sitemaps on GitHub Pages for project sites on a shared domain.

Write and customise #

  • Add images and organise content with taxonomies.
  • Control summaries and reading time.
  • Add a contact form or comments.
  • Add custom CSS, configure page headers, or override a partial.
  • Use Sass or another preprocessor with your custom CSS.
  • Use a hook, for example to add an edit link below every page, or add a LinkedIn icon.

Recipes and diagnostics #

  • Minimal blog.
  • Multilingual site.
  • Site without a blog.
  • Troubleshoot common problems.

Some linked pages also contain settings and background information while we organise the documentation. Use Reference for lookup material and Explanation for concepts.

In this section

  • Set up robots.txt and sitemaps on GitHub Pages

    Configure a root robots.txt file and a sitemap index for Hugo project sites on a shared github.io domain.

Ananke Documentation © Ananke Documentation 2026
Mastodon