v2.10.0

New Maintainer

Hi there, I am Patrick, @davidsneighbour, and I have taken over maintenance of Ananke from the team of theNewDynamic. Let's thank @regisphilibert and @budparr for their work.

You may know me from my bunch of modules for GoHugo or from trying to answer questions on the GoHugo discourse. I will try to get Ananke up to date and from there we go. Having said that, let's get to the hard parts of this release.

Feature freeze and design freeze

For now, until Ananke is back up to date with the latest GoHugo features we will add no new features or design changes to the theme. This does not mean that we are not open for changes. But there are more core features like Hugo Pipelines, extended vs. base version, deprecations and so on, that should receive primary focus for now.

I will open a poll, or polls, about what features to work on next, so you might keep an eye on the discussion forum.

Requirements

To use this release you need to update your local installation. We require GoHugo v0.128.0+ and newer for this to work.

If you installed Ananke as Git Submodule run git pull from within the submodule directory (probably themes/ananke/).

If you installed Ananke as Hugo Module run hugo mod get -u ./... inside of your repository root directory.

In both cases don't forget to add the changes to your own repository after you updated.

On some build systems (for instance on Netlify) I would suggest to "clear cache and rebuild" to get things going if this update breaks the build.

Build system

Recent releases did not update the changelog and I use a different method of releases in my own projects, so I did rework the release/build system slightly. The old changelog can be found at ### and the new changelog will be automatically created at ### per release. For the user nothing will change, we will keep using the same name, the same repository, the same versioning system.

All new releases will have a required GoHugo version (this one needs v0.128.0+) because features are deprecated and released more often in GoHugo and older versions will fail to build with new features/methods/variables.

Community/Maintenance

Feel free to add problems and questions in the discussion forum --- be kind. If you experience a bug please open an issue report. I will however move questions and general issues into the forum to keep the issues to what needs to be fixed. That is an organisatorial move, not judgement :]

The future

This release fixed some common easily fixable issues and recent deprecations.

For v2.11 I am planning to rework the social media integration (share and social network links). The reworked version will allow you to add any arbitrary social media profile with your own icons/links.

For v2.12 I am planning to add GoHugo's pipelines into the build system and fix the common issues coming up for less experienced users between base and extended GoHugo versions.

Parallel to this documentation is created in the Wiki of this repository.

Disclaimer

This is my first release for Ananke, so I would expect things I have overlooked to break and bugs that I introduced to rear their dirty faces. Bear with me. That's what patch releases are for.

Quickstart templates of hosting providers

If you are using a version of the theme provided by a quick start ("deploy now") button on Vercel, Netlify, or any such provider and run into any issues please open a discussion forum post so I am aware of it. Vercel for instance has a hard-coded Ananke version from 2 years ago in their layout and that will obviously not work with latest Hugo versions and I am not sure how they update it. I guess I will have to contact each instance to see how to optimize their integrations.

2.10.0 (2024-09-28)

Documentation

• fix: add note about powershell environment (c1530b7)
• fix: move old changelog (e086aa9)
• fix: proper TOML format for frontmatter sample (#717) (ca6da48)
• fix: remove todo note that can't be traced to any issue (b1f6a28)

Features

• add canonical url support (#650) (221a0d8)

Theme

• fix: replace deprecated resources.ToCSS with css.Sass (321680f), closes #712
• i18n: add indonesian language (#672) (53463ff)

Refactors

• indentation and file formatting changes (76460d7)

Chore

• add package lockfile (8a7847f)
• config: add dependabot configuration (3c3478a)
• config: add github templates for issues and pull requests (7c5c9c3)
• config: add resources to ignored files (549d735)
• config: add workspace configuration file for vscode (1a4ad28)
• config: move configuration into config subfolder structure and require 0.128.0 (4e613a9)
• config: update dependencies and package.json content (d0490cb)
• fix: being maintained again (9a0a974)
• fix: full URL to discussion forum (791c400)
• release: v2.10.0-prerelease.0 (6367ffa)

Build System

• fix: add release scripts (a889122)
• fix: recover build system (dccde1e)

v2.10.0-prerelease.0 - Pleasant Anticipation

To be done:

• checking quick start in GoHugo documentation with this release
• if nothing breaks, write release notes
• release

v2.9.2

Just a cherry-pick of @ramiro's #685

Full Changelog: v2.9.1...v2.9.2

v2.9.1

This is minor release with bug fixes and some improvements.

Social: Disable sharing/follow per services

You can now decide to opt out of "Follow on..." or "Share on..." for some social services. Many users want their visitors to be able to "Share on Facebook" while not having a "Facebook Page" themselves to promote. See here for more information.

Others

• Add Hebrew localization strings.
• Fix nasty featured image URL bug when deploying site in a sub directory

What's Changed

• Added Hebrew translations by @MeirKriheli in #544
• Enable/Disable Social follow/share per service by @regisphilibert in #550
• Fixing typo, changing links from http:// to https:// by @deining in #551
• Only apply the absURL on images served through satic directory by @regisphilibert in #557

New Contributors

• @deining made their first contribution in #551

Full Changelog: v2.9.0...v2.9.1

v2.9.0

minVersion

The most important change is the theme updating it's minVersion to Hugo 0.84.0 from Hugo 0.64.0.
This is never a light decision and the last time we did it was January of last year! But in order to maintain retro-compatibility, sometimes you do have to upgrade... (Read about the motivation here)

While this might not break your site yet (unless you're running 0.67.1 or lower), it's strongly encouraged to upgrade your project to Hugo 0.84.0 or newer.

Localization

Dates

If you're using Hugo 0.87.0 and above, the project's dates can be localized using Hugo's date formatting layouts as date_format parameter

Language Direction

The theme now supports language direction with a layer of dedicated CSS. It also adds the dir attribute on the HTML if languageDirection is set.

Other

• Japanese localization has been added.
• The "By {author}" string is now localized. Except for language where it's not applicable, in which case it's absent.
• more localization fixes are listed below.

What's Changed

• Update about page ft img to match demo site by @tlindsay42 in #507
• Use theme repo for demo site by @regisphilibert in #515
• Change section name to section title in summary by @metbril in #520
• Translate for Japanese and add to i18n by @ssatosays in #529
• Remove Section mention from single/page by @regisphilibert in #531
• Localize "By" by @regisphilibert in #530
• Update sv.toml by @besynnerlig in #533
• Add missing French translation by @cbrunet in #538
• Upgrade "minVersion" of theme to 84 by @regisphilibert in #543
• use time.Format to format dates. It allows dates to be localized. by @cbrunet in #537
• Added support for Right-To-Left languages by @MeirKriheli in #532

New Contributors

• @metbril made their first contribution in #520
• @ssatosays made their first contribution in #529
• @besynnerlig made their first contribution in #533
• @cbrunet made their first contribution in #538
• @MeirKriheli made their first contribution in #532

Full Changelog: v2.8.1...v2.9.0

v2.8.1

This release introduces one potential styling change for users overwriting some limited template files with their own. Read below

Set Content Font Color

You can now set the font color of the main content both globally and on individual pages. See README

Private Content

User can now use private: true Front Matter key to use a prevent search engine indexing on a given page. See README

Render vs partial

This release enforce the use of .Render vs partial for two template files, namely "summary" and "summary-with-image".
For users overwriting one of those files you should:
Move the file to the layouts/_default directory.

For users overwriting a template file which call of one those file using {{ partial "summary.html . }} or {{ partial "summary-with-image.html . }} your should:
replace it with a .Render method like illustrated below.

- {{ partial "summary" . }}
+ {{ .Render "summary" }}

What's Changed

• Allow certain pages to not be indexed: by SE by @regisphilibert in in 87f97e5
• Remove template language from social svg files by @funcsec in #461
• Make text color editable/configurable by @mountainbug95 in #286
• Featured image detection refactoring: by @regisphilibert in #462
• Fix _styles.css bad reference in GetMainCSS by @regisphilibert in #463
• Make disable_share settings on both page and site level by @regisphilibert in #465
• Ignore Hugo build lock file by @tlindsay42 in #483
• Fix zh* translation by @peter-jerry-ye in #479
• Update compiled main.css resource by @tlindsay42 in #485
• Standardize featured_image logic by @tlindsay42 in #474
• Fix support for site config featured image by @tlindsay42 in #490
• Use .Render for summary and summary-with-image throughout by @regisphilibert in #498
• Add German translation for taxonomyPageList by @thomham in #495
• Update about page bundle branch -> leaf by @tlindsay42 in #487
• Use i18n string for taxonomy layout by @scubbo in #500
• Finnish Translation by @larihuttunen in #493
• 433 fix tags layout by @fullstack-jack in #472
• Fix support for img width by @tlindsay42 in #481

New Contributors

• @funcsec made their first contribution in #461
• @tlindsay42 made their first contribution in #483
• @thomham made their first contribution in #495
• @scubbo made their first contribution in #500
• @larihuttunen made their first contribution in #493
• @fullstack-jack made their first contribution in #472

Full Changelog: v2.8.0...v2.8.1

New Social Follow and Share!

This is a complete backward compatible refactoring of the social service logic of the theme.

Project's social services are now registered in the site params as follow:

# config.yaml
params:
  ananke_socials:
  - name: twitter
    url: https://twitter.com/theNewDynamic
  - name: github
    url: https://github.com/theNewDynamic

The theme currently sports 14 built-in services with their own SVG icon, label and hover color. Any user can add their own service by adding it to the list above and optionally add a custom color and/or a matching SVG to their project.

It also sports its own "Share" icons for Facebook, Twitter and LinkedIn.

More here

What's Changed

• Refactor social service logic and UX by @regisphilibert in #425
• added tiktok to available social media links by @saufrecht in #444
• Base content title on ContentBaseName by @jmooring in #440

New Contributors

• @saufrecht made their first contribution in #444
• @jmooring made their first contribution in #440

Full Changelog: v2.7.0...v2.8.0

Style with Pipes

This release major improvements is the refactoring of the style processing logic which now relies on Hugo Pipes.
Another improvement is the ability to set a default date format to your project, this is great for localization.

Improvements

• Refactor style processing pipeline. (6eb54ab) More here
• Add ability to override date format throughout (b0bf3cc) More here

Fixes

• Fixes date being printed when no date is set (1ae24ad)
• Use relative permalink throughout when applicable (e3f7fbe)

Localization:

• Localize site navigation title attributes (08d842f)
• Localize WordCount and Reading time, de, fr, en included (7752770, 869b03e)

Thanks to @jan-xyz, @diamonster, @imander, @littleninja, @MarcoWagner, @sumpfralle for their help on improving Ananke on this release!

For any question about this release, please use its dedicated discussion:

Various Contributions

Improve Sitemap #404 by @zar3bski
Translate for Hindi and add to i18n #411 by @neeraj9

Add Turkish Translation

Create tr.toml (#371)