General Configuration

[!IMPORTANT] Please note that Hugo is extensible configurable with more generic or more specific configuration. Please read the documentation about configuration files and configuration directories to learn more about this topic. Whenever Ananke’s documentation refers to the configuration file it refers to any of these possible locations.

Ananke’s sample repositories are using configuration directories and you can find all referred configuration parameters in config/_default/hugo.toml and config/_default/params.toml.

Activate the contact form #

This theme includes a shortcode for a contact form that you can add to any page (there is an example on the contact page in the exampleSite folder). One option is to use formspree.io as proxy to send the actual email. Each month, visitors can send you up to fifty emails without incurring extra charges. Visit the Formspree site to get the “action” link and add it to your shortcode like this:

{{< form-contact action="https://formspree.io/your@email.com" >}}

You can replace the title of your site in the top left corner of each page with your own logo. To do that put your own logo into the static directory of your website, and add the site_logo parameter to the site params in your config file. For example:

[params]
site_logo = "img/logo.svg"

The navigation shown in the header (the hero area at the top of every page) is built from Hugo’s main menu. Define entries for it in your site configuration and they appear next to the social links.

[menus]
[[menus.main]]
name = "About"
url = "/about/"
weight = 10

[[menus.main]]
name = "Posts"
url = "/posts/"
weight = 20

Entries are ordered by their weight, lowest first. url can point to an internal section or page (for example /about/) or to an external address.

You can also add a single page to the menu from its own front matter instead of listing it in the configuration:

---
title: About
menus: main
---

For nested entries, menu parameters, and other options, see Hugo’s menu templates documentation.

Localize date format #

Dates of blog posts and single pages are rendered with the default date format commonly used in the USA and Canada. It is possible to specify a different format.

[params]
date_format = "2. January 2006"

With hugo 0.87.0 and above, you can also use predefined date layouts, like :date_full, and it will output localized dates or times. See hugo’s documentation of the time.Format function for more details.

Show taxonomies on pages #

Ananke shows linked terms for the categories and tags taxonomies on single pages when they are set in page front matter. For example:

categories:
  - Beginner
  - Server
tags:
  - cicd
  - docker
  - free

The terms use Hugo’s taxonomy links, so the corresponding taxonomy must be enabled in your site configuration if you customise the default taxonomies.

Categories are shown by default. To hide the category terms on single pages site-wide, set show_categories to false in the ananke parameters:

[params.ananke]
show_categories = false

Show or hide dates on pages #

Ananke shows page dates by default where the template includes date output. You can hide dates across pages and summary cards by setting ananke.pages.show_date to false.

[params.ananke.pages]
show_date = false

You can override this per page with front matter:

ananke:
  show_date: true

Show images on list page cards #

By default, list pages render compact summary cards without images. You can opt in to image cards for list pages by enabling the ananke.pages.show_list_images parameter.

[params.ananke.pages]
show_list_images = true

When enabled, list pages use the same image summary card that is used for recent posts on the home page. Pages without a configured featured image still render without an image. Date display is controlled separately with ananke.pages.show_date.

See Hero section for information about configuring featured images.