# Ananke Theme for Hugo

Ananke is a flexible, production-ready starter theme for [Hugo](https://gohugo.io/) focused on accessibility, performance, and maintainable defaults.

![Ananke screenshot](images/screenshot.png)

* Demo: [ananke-theme.netlify.app](https://ananke-theme.netlify.app/)
* Documentation: [docs directory](https://github.com/theNewDynamic/gohugo-theme-ananke/tree/main/docs)
* Changelog: [CHANGELOG.md](CHANGELOG.md)

## Features

* Responsive layouts and accessible markup
* Configurable hero/header behavior
* 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

## Compatibility

> [!IMPORTANT]
> The `main` branch is maintained for Hugo **v0.146.0+**.
>
> * For Hugo **v0.128.1 to v0.145.0**, use branch [`release/v2.12`](https://github.com/theNewDynamic/gohugo-theme-ananke/tree/release/v2.12).
> * For older Hugo versions, use a matching tag from the [releases page](https://github.com/theNewDynamic/gohugo-theme-ananke/tags).

## Installation

Ananke supports both installation methods:

* [Install as Hugo Module (recommended)](docs/installation/gohugo-module.md)
* [Install as Git Submodule](docs/installation/git-submodule.md)

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

## Getting Started

After installation, use these guides to configure your site:

* [Getting Started](docs/getting-started.md)
* [Configuration](docs/configuration/_index.md)
* [Customisation](docs/customisation/_index.md)
* [Troubleshooting](docs/troubleshooting.md)

## Support and Contributions

* Bug reports: [GitHub Issues](https://github.com/theNewDynamic/gohugo-theme-ananke/issues)
* Questions and feature ideas: [GitHub Discussions](https://github.com/theNewDynamic/gohugo-theme-ananke/discussions)
* Contribution guide: [CONTRIBUTING.md](CONTRIBUTING.md)