v2.11.2 - Social profile `rel` attribute

A quick fix for the rel-attribute in your social profile settings. It works now as advertised.

Full Changelog: v2.11.1...v2.11.2

v2.11.1 - some smaller fixes

This release updates the module path to v2, which should fix some issues with installing the theme as module.
The documentation for this needs an update, but basically if you require the module with this line:

hugo mod get github.com/theNewDynamic/gohugo-theme-ananke/v2

then it will properly install the latest tagged and released version. After that hugo mod get -u ./... will also update the module to the latest version.

Note: Not sure if that breaks something else though ;)

Other changes:

What's Changed

• Update README.md by @patrickbenkoetter in #766
• build(deps): bump postcss-preset-env from 10.0.7 to 10.0.8 by @dependabot in #771
• Fix share link building when params particle is present by @ramiro in #769

New Contributors

• @patrickbenkoetter made their first contribution in #766

Full Changelog: v2.11.0...v2.11.1

v2.11.0

Social Media Network Integration

🎉 We've given the social media network integration in Ananke a complete makeover! The old system was replaced with something more powerful, flexible, and user-friendly. We've packed it with a host of preconfigured networks, so you'll be ready to share your awesome content in no time! 🎉

How to set it up? Check out our handy Social Media Network Setup Guide to get started.

The best part? It's expandable and highly customizable, meaning we can accommodate just about any social network setup you can think of. Over time, we plan to cover more possible use cases (well, most of them). Don't stress, it's not too hard to configure (we promise 😉). Head over to the wiki to see the list of networks already included.

🔍 If you run into any issues – no sweat! Just open an issue on our GitHub and include your full ananke.social configuration so we can help you sort it out.

Lets move to the other changes:

The Default Branch Has a New Name: Say Hello to main! 🌱

Goodbye, master! In keeping with the latest best practices, we've renamed the default branch of Ananke to main. If you have a local clone and need to get everything in sync with this change, don't worry! Here's a quick and easy fix. Just run the following commands in your terminal:

git branch -m master main
git fetch origin
git branch -u origin/main main
git remote set-head origin -a

And just like that, you're all set! 🚀

Less Confusion, More Consistency: Let's Talk Formats

To make life simpler for everyone, we've streamlined the formats we use in the documentation. From now on, you'll see all configuration samples in TOML, and front matter examples in YAML. These formats are more commonly used, and this should clear up any confusion.

Need to convert between formats? No worries! We've got you covered with these handy tools:

• TOML to JSON transformer
• TOML to YAML transformer

This way, you can easily switch between formats whenever you need to. 😊

---

That's all for this release! 🎉 We hope these changes make your experience with the Ananke theme even smoother. As always, feel free to reach out if you have any questions or need a hand. Happy building!

The following is a list of all changes since v2.10.0.

2.11.0 (2024-10-24)

Documentation

• fix: update theme.toml with min version and authors (ae14ccf)
• fix: add note about WIP on the README.md (0a307d7)
• fix: update link to demo (e22c428)
• add fontawesome license remark to README.md (d7a12f3)
• fix: add discord link (a41140e)
• fix: remove obsolete docs (e7f28b0)
• typo (e38869b)
• typo (f68e6ff)
• update LICENSE.md (0aec28f)

Theme

• fix: add transform.Plainify to the summary body content of the share links (#758) (2cfb09e)
• fix: paths to social func partials (1bcc471)
• fix: remove caching of share links (#757) (473c7c1)
• fix: bring some logic into /disabled sharing (a9cd70d)
• fix: header image positioning (#731) (9fc4b73), closes #729
• fix: proper configuration for all networks (9df0c0a)
• fix: use internal methods to evaluate environment (cc6da23), closes #625 #733 #453 #574

Chore

• deps: update dependencies (088c3e7)
• config: add markdownlint configuration (65c8a11)
• fix: no default networks, move networks config to exampleSite (396d013)

What's Changed

• refactor: Simplify lang attribute in html element by @jmooring in #738
• build(fix): proper configuration for netlify by @davidsneighbour in #740
• build(deps-dev): bump @davidsneighbour/tools from 2024.3.46 to 2024.4.5 by @dependabot in #744
• build(deps): bump postcss-preset-env from 10.0.5 to 10.0.7 by @dependabot in #743
• build(deps-dev): bump @davidsneighbour/release-config from 2024.3.46 to 2024.4.5 by @dependabot in #742
• docs: update README.md with markup changes by @davidsneighbour in #739
• wip: feat: rework social media network integration by @davidsneighbour in #745
• Add control over header image by @miaucl in #731
• complete the feature for the cover dimming class in page by @miaucl in #732
• Add missing params on ananke.social.follow by @melroy89 in #754
• Fix social share cache by @melroy89 in #755
• Fix social share link to wiki page by @melroy89 in #753
• Add transform.Plainify to the summary body content of the share links by @melroy89 in #758
• Do not cache share links by @melroy89 in #757

New Contributors

• @dependabot made their first contribution in #744
• @miaucl made their first contribution in #731

Full Changelog: v2.10.0...v2.11.0

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