# Ananke, a starter theme for GoHugo

The intent of this theme is to provide a solid starting place for [GoHugo](https://gohugo.io/) sites with basic features and include best practices for performance, accessibility, and rapid development.

![screenshot](images/screenshot.png)

[DEMO](https://ananke-theme.netlify.app/)

Features

* Responsive
* Accessible
* Contact form
* Custom Robots.txt (changes values based on environment)
* Internal templates for meta data, google analytics, and DISQUS or COMMENTO comments
* RSS Discovery
* Table of Contents (must declare `toc: true` in post parameter)

Also includes examples of Hugo Features or Functions:

* Pagination (internal template)
* Taxonomies
* Archetypes
* Custom shortcode
* Related content
* Hugo built-in menu
* i18n
* `with`
* `first`
* `after`
* `sort`
* Site LanguageCode
* `where`
* Content Views
* Partials
* Template layouts (type "post" uses a special list template, single template, and a content view)
* Tags
* `len`
* Conditionals
* `ge` (greater than or equal to)
* `.Site.Params.mainSections` to avoid hard-coding "blog," etc. [[release note](https://github.com/gohugoio/hugo/blob/66ec6305f6cb450ddf9c489854146bac02f7dca1/docs/content/meta/release-notes.md#enhancements)]

This theme uses the [Tachyons CSS library](https://tachyons.io/). This will allow you to manipulate the design of the theme by changing class names in HTML without touching the original CSS files.

## Compatibility

> [!IMPORTANT]  
> The [main](https://github.com/theNewDynamic/gohugo-theme-ananke) branch contains the latest version of Ananke that is tested and working with GoHugo v0.146.0+. If you wish to use an older version of GoHugo, use the [v2.12 branch](https://github.com/theNewDynamic/gohugo-theme-ananke/tree/release/v2.12) that is working with GoHugo v0.128.1 to v0.145.0. To get the theme working with an even older version of GoHugo feel free to peruse the [releases page](https://github.com/theNewDynamic/gohugo-theme-ananke/tags) to find a version that is working with your GoHugo version.

## Installation

Dive into our [documentation on installing the theme as GoHugo Module or Git Submodule](https://github.com/theNewDynamic/gohugo-theme-ananke/wiki/Installation). [The official setup guide](https://gohugo.io/getting-started/quick-start/) of GoHugo covers the installation of the theme as Git Submodule.

## Getting started

After installing the theme successfully it requires [a few more steps to get your site running](https://github.com/theNewDynamic/gohugo-theme-ananke/wiki/Getting-Started). Read on for a quick overview of the most important steps. Or follow one of the more detailed guides following.

## Latest Changes

See the [CHANGELOG](CHANGELOG.md) for details about what has changed recently. For a list of older changes, see the [changelog-old.md](.github/changelog-old.md) file.

## Contributing

If you find a bug feel free to use the [issue tracker](https://github.com/theNewDynamic/gohugo-theme-ananke/issues) to let me know. If you are having issues setting up your site with the theme, or have an idea for a feature, please use the [discussions](https://github.com/theNewDynamic/gohugo-theme-ananke/discussion) for support.

Join me on my [ananke-theme Discord channel](https://discord.gg/MykHvyU5P3) for direct support, but please remember that I am doing this in my spare time.

If you would like to contribute code, please read the [CONTRIBUTING.md](CONTRIBUTING.md) file for guidelines on how to contribute.