<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Get started on Ananke Documentation</title><link>https://gohugo-ananke.github.io/documentation/get-started/</link><description>Recent content in Get started on Ananke Documentation</description><generator>Hugo</generator><language>en-gb</language><lastBuildDate>Sun, 22 Nov 2026 00:00:00 +0700</lastBuildDate><atom:link href="https://gohugo-ananke.github.io/documentation/get-started/index.xml" rel="self" type="application/rss+xml"/><item><title>Hugo version compatibility</title><link>https://gohugo-ananke.github.io/documentation/get-started/compatibility/</link><pubDate>Sat, 21 Nov 2026 00:00:00 +0700</pubDate><guid>https://gohugo-ananke.github.io/documentation/get-started/compatibility/</guid><description>&lt;p&gt;The compatibility table below records which stable Ananke releases build with specific Hugo versions. Hugo versions before 1.0 can introduce breaking changes between minor releases. Use tested results when selecting a Hugo version for an existing site.&lt;/p&gt;&#10;&lt;p&gt;A declared minimum is the requirement recorded by a theme release. A tested minimum is the earliest passing Hugo version in this audit, which begins at v0.128.0. These values can differ. A successful build verifies the tested configuration; it does not guarantee every theme feature or site configuration.&lt;/p&gt;</description></item><item><title>Choose an installation method</title><link>https://gohugo-ananke.github.io/documentation/get-started/installation/</link><pubDate>Fri, 16 Jan 2026 08:00:00 +0700</pubDate><guid>https://gohugo-ananke.github.io/documentation/get-started/installation/</guid><description>&lt;p&gt;You can add Ananke to a site in two ways. Both give the same theme and the same site; they differ in how the theme gets into your project and how you update it.&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;strong&gt;Hugo Module&lt;/strong&gt;: Hugo downloads the theme through Go&amp;rsquo;s module system into a cache outside your project. Your project records the exact release in &lt;code&gt;go.mod&lt;/code&gt; and &lt;code&gt;go.sum&lt;/code&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Git submodule&lt;/strong&gt;: Git places the theme repository in &lt;code&gt;themes/ananke&lt;/code&gt; inside your project. Your repository records the exact theme commit.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;&lt;strong&gt;We recommend the Hugo Module method.&lt;/strong&gt; One command updates the theme or selects a release, and the version is a readable line in &lt;code&gt;go.mod&lt;/code&gt;.&lt;/p&gt;</description></item><item><title>Install as a Hugo Module (recommended)</title><link>https://gohugo-ananke.github.io/documentation/get-started/hugo-module/</link><pubDate>Fri, 16 Jan 2026 08:00:00 +0700</pubDate><guid>https://gohugo-ananke.github.io/documentation/get-started/hugo-module/</guid><description>&lt;p&gt;This guide creates a new Hugo site named &lt;code&gt;quickstart&lt;/code&gt; and installs the &lt;a href="https://github.com/gohugo-ananke/ananke"&gt;Ananke theme&lt;/a&gt; as a Hugo Module. Hugo then downloads the theme and records its exact version in your project. To compare this method with a Git submodule, read &lt;a href="https://gohugo-ananke.github.io/documentation/get-started/installation/"&gt;Choose an installation method&lt;/a&gt;.&lt;/p&gt;&#10;&lt;!-- markdownlint-disable-next-line MD033 --&gt;&#10;&lt;p&gt;&lt;span id="installation-methods"&gt;&lt;/span&gt;&lt;/p&gt;&#10;&lt;h2 id="requirements"&#10; class="heading-permalink"&#10;&gt;Requirements&#10; &lt;a class="heading-anchor" href="#requirements" aria-label="Link to this section"&gt;#&lt;/a&gt;&#10;&lt;/h2&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;a href="https://gohugo.io/installation/"&gt;Hugo&lt;/a&gt;, in a version that the current Ananke release supports. See &lt;a href="https://gohugo-ananke.github.io/documentation/get-started/compatibility/"&gt;Hugo version compatibility&lt;/a&gt;. We recommend the latest Hugo release.&lt;/li&gt;&#10;&lt;li&gt;&lt;a href="https://git-scm.com/book/en/v2/Getting-Started-Installing-Git"&gt;Git&lt;/a&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;a href="https://go.dev/doc/install"&gt;Go&lt;/a&gt;. Hugo uses Go to download modules.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;Check the installed versions:&lt;/p&gt;</description></item><item><title>Install as a Git submodule</title><link>https://gohugo-ananke.github.io/documentation/get-started/git-submodule/</link><pubDate>Fri, 16 Jan 2026 08:00:00 +0700</pubDate><guid>https://gohugo-ananke.github.io/documentation/get-started/git-submodule/</guid><description>&lt;p&gt;This guide creates a new Hugo site named &lt;code&gt;quickstart&lt;/code&gt; and adds the &lt;a href="https://github.com/gohugo-ananke/ananke"&gt;Ananke theme&lt;/a&gt; as a Git submodule in &lt;code&gt;themes/ananke&lt;/code&gt;. Your repository then records the exact theme commit. To compare this method with a Hugo Module, read &lt;a href="https://gohugo-ananke.github.io/documentation/get-started/installation/"&gt;Choose an installation method&lt;/a&gt;.&lt;/p&gt;&#10;&lt;!-- markdownlint-disable-next-line MD033 --&gt;&#10;&lt;p&gt;&lt;span id="installation-methods"&gt;&lt;/span&gt;&lt;/p&gt;&#10;&lt;h2 id="requirements"&#10; class="heading-permalink"&#10;&gt;Requirements&#10; &lt;a class="heading-anchor" href="#requirements" aria-label="Link to this section"&gt;#&lt;/a&gt;&#10;&lt;/h2&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;a href="https://gohugo.io/installation/"&gt;Hugo&lt;/a&gt;, in a version that the current Ananke release supports. See &lt;a href="https://gohugo-ananke.github.io/documentation/get-started/compatibility/"&gt;Hugo version compatibility&lt;/a&gt;. We recommend the latest Hugo release.&lt;/li&gt;&#10;&lt;li&gt;&lt;a href="https://git-scm.com/book/en/v2/Getting-Started-Installing-Git"&gt;Git&lt;/a&gt;.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;Check the installed versions:&lt;/p&gt;</description></item><item><title>Update Ananke</title><link>https://gohugo-ananke.github.io/documentation/get-started/update-ananke/</link><pubDate>Sun, 22 Nov 2026 00:00:00 +0700</pubDate><guid>https://gohugo-ananke.github.io/documentation/get-started/update-ananke/</guid><description>&lt;p&gt;Your site uses one exact Ananke release until you update it. This guide updates the theme to the latest release or to a release that you select, and checks the result.&lt;/p&gt;&#10;&lt;h2 id="before-you-update"&#10; class="heading-permalink"&#10;&gt;Before you update&#10; &lt;a class="heading-anchor" href="#before-you-update" aria-label="Link to this section"&gt;#&lt;/a&gt;&#10;&lt;/h2&gt;&#10;&lt;ol&gt;&#10;&lt;li&gt;Find your current release. For a Hugo Module, run &lt;code&gt;hugo mod graph&lt;/code&gt;. For a Git submodule, run &lt;code&gt;git -C themes/ananke describe --tags&lt;/code&gt;.&lt;/li&gt;&#10;&lt;li&gt;Read the &lt;a href="https://github.com/gohugo-ananke/ananke/releases"&gt;release notes&lt;/a&gt; of every release after yours. They name new features, changed defaults, and deprecations.&lt;/li&gt;&#10;&lt;li&gt;Check that your Hugo version supports the new release: see &lt;a href="https://gohugo-ananke.github.io/documentation/get-started/compatibility/"&gt;Hugo version compatibility&lt;/a&gt;.&lt;/li&gt;&#10;&lt;li&gt;Commit or back up your site, so that you can return to the current state.&lt;/li&gt;&#10;&lt;/ol&gt;&#10;&lt;h2 id="update-a-hugo-module"&#10; class="heading-permalink"&#10;&gt;Update a Hugo Module&#10; &lt;a class="heading-anchor" href="#update-a-hugo-module" aria-label="Link to this section"&gt;#&lt;/a&gt;&#10;&lt;/h2&gt;&#10;&lt;p&gt;To update to the latest release:&lt;/p&gt;</description></item><item><title>Upgrade from theNewDynamic to gohugo-ananke</title><link>https://gohugo-ananke.github.io/documentation/get-started/upgrade-from-thenewdynamic/</link><pubDate>Sat, 06 Jun 2026 08:00:00 +0700</pubDate><guid>https://gohugo-ananke.github.io/documentation/get-started/upgrade-from-thenewdynamic/</guid><description>&lt;p&gt;Ananke moved to its own organisation in April 2026. The repository changed from: &lt;code&gt;github.com/theNewDynamic/gohugo-theme-ananke&lt;/code&gt; to &lt;code&gt;github.com/gohugo-ananke/ananke&lt;/code&gt;.&lt;/p&gt;&#10;&lt;p&gt;Existing sites keep building with the release that they use now. To update to a current release, change your references to the new location:&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;strong&gt;Hugo Module:&lt;/strong&gt; Ananke v2.13.0 and later declare the module path &lt;code&gt;github.com/gohugo-ananke/ananke/v2&lt;/code&gt;. With the old path, Hugo can still download v2.12.1 and earlier, but it cannot update the theme: &lt;code&gt;hugo mod get&lt;/code&gt; fails with &lt;code&gt;module declares its path as: github.com/gohugo-ananke/ananke/v2&lt;/code&gt;.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Git submodule:&lt;/strong&gt; GitHub redirects the old repository address, so &lt;code&gt;git fetch&lt;/code&gt; still works. Change the address anyway, because a redirect can stop working.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h2 id="what-changed"&#10; class="heading-permalink"&#10;&gt;What changed&#10; &lt;a class="heading-anchor" href="#what-changed" aria-label="Link to this section"&gt;#&lt;/a&gt;&#10;&lt;/h2&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;strong&gt;Organisation and repository name&lt;/strong&gt; changed as shown above.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Module path&lt;/strong&gt; changed from&#10;&lt;code&gt;github.com/theNewDynamic/gohugo-theme-ananke/v2&lt;/code&gt; to&#10;&lt;code&gt;github.com/gohugo-ananke/ananke/v2&lt;/code&gt;, starting with Ananke v2.13.0. The &lt;code&gt;/v2&lt;/code&gt; suffix is unchanged and still&#10;required.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Installation methods are unchanged.&lt;/strong&gt; If you are installing fresh rather than migrating, follow &lt;a href="https://gohugo-ananke.github.io/documentation/get-started/hugo-module/"&gt;Install as a Hugo Module&lt;/a&gt; or &lt;a href="https://gohugo-ananke.github.io/documentation/get-started/git-submodule/"&gt;Install as a Git submodule&lt;/a&gt; instead of this page.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h2 id="migrate-a-hugo-module-install"&#10; class="heading-permalink"&#10;&gt;Migrate a Hugo Module install&#10; &lt;a class="heading-anchor" href="#migrate-a-hugo-module-install" aria-label="Link to this section"&gt;#&lt;/a&gt;&#10;&lt;/h2&gt;&#10;&lt;ol&gt;&#10;&lt;li&gt;&#10;&lt;p&gt;In your site configuration, replace the import path &lt;code&gt;github.com/theNewDynamic/gohugo-theme-ananke/v2&lt;/code&gt; with &lt;code&gt;github.com/gohugo-ananke/ananke/v2&lt;/code&gt;. The import is usually in &lt;code&gt;config/_default/module.toml&lt;/code&gt; or in your root configuration file.&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li&gt;&#10;&lt;p&gt;In &lt;code&gt;go.mod&lt;/code&gt;, delete the line that requires &lt;code&gt;github.com/theNewDynamic/gohugo-theme-ananke/v2&lt;/code&gt;. Do not only replace the path there: the old version number does not exist under the new path, and Hugo stops with &lt;code&gt;module declares its path as: github.com/theNewDynamic/gohugo-theme-ananke/v2&lt;/code&gt;.&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;li&gt;&#10;&lt;p&gt;Download the theme under the new path:&lt;/p&gt;&#10;&lt;div class="code-block"&gt;&#10; &lt;div class="code-block-header"&gt;&#10; &lt;span class="code-language"&gt;bash&lt;/span&gt;&#10; &lt;button class="code-copy" type="button" aria-label="Copy code to clipboard" hidden&gt;&#10; &lt;span class="code-copy-label" aria-hidden="true"&gt;Copy&lt;/span&gt;&#10; &lt;/button&gt;&#10; &lt;/div&gt;&#10; &lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;hugo mod get github.com/gohugo-ananke/ananke/v2&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;hugo mod tidy&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;/div&gt;&#10;&lt;p&gt;Hugo adds the latest release to &lt;code&gt;go.mod&lt;/code&gt;. To select a release, add it to the path, for example &lt;code&gt;github.com/gohugo-ananke/ananke/v2@v2.23.0&lt;/code&gt;.&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;/ol&gt;</description></item><item><title>Upgrade social links from Ananke 2.10 or earlier</title><link>https://gohugo-ananke.github.io/documentation/get-started/upgrade-social-links/</link><pubDate>Sun, 22 Nov 2026 00:00:00 +0700</pubDate><guid>https://gohugo-ananke.github.io/documentation/get-started/upgrade-social-links/</guid><description>&lt;p&gt;Ananke 2.11.0 replaced the social settings. Later releases ignore the old settings, so a site that still uses them shows no follow links. This guide moves your settings to the current structure.&lt;/p&gt;&#10;&lt;h2 id="find-the-old-settings"&#10; class="heading-permalink"&#10;&gt;Find the old settings&#10; &lt;a class="heading-anchor" href="#find-the-old-settings" aria-label="Link to this section"&gt;#&lt;/a&gt;&#10;&lt;/h2&gt;&#10;&lt;p&gt;Ananke 2.10 and earlier read two forms. Search your site configuration for both:&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&#10;&lt;p&gt;A list of tables named &lt;code&gt;ananke_socials&lt;/code&gt;:&lt;/p&gt;&#10;&lt;div class="code-block"&gt;&#10; &lt;div class="code-block-header"&gt;&#10; &lt;span class="code-language"&gt;toml&lt;/span&gt;&#10; &lt;button class="code-copy" type="button" aria-label="Copy code to clipboard" hidden&gt;&#10; &lt;span class="code-copy-label" aria-hidden="true"&gt;Copy&lt;/span&gt;&#10; &lt;/button&gt;&#10; &lt;/div&gt;&#10; &lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-toml" data-lang="toml"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c"&gt;# config/_default/params.toml (old)&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;[[&lt;/span&gt;&lt;span class="nx"&gt;ananke_socials&lt;/span&gt;&lt;span class="p"&gt;]]&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;name&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;github&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;url&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;https://github.com/jdoe&amp;#34;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&#10;&lt;/div&gt;&#10;&lt;/li&gt;&#10;&lt;li&gt;&#10;&lt;p&gt;A flat parameter with the network name, for example &lt;code&gt;github = &amp;quot;https://github.com/jdoe&amp;quot;&lt;/code&gt; directly under &lt;code&gt;[params]&lt;/code&gt;. Ananke 2.10 read these names: &lt;code&gt;facebook&lt;/code&gt;, &lt;code&gt;twitter&lt;/code&gt;, &lt;code&gt;instagram&lt;/code&gt;, &lt;code&gt;youtube&lt;/code&gt;, &lt;code&gt;github&lt;/code&gt;, &lt;code&gt;gitlab&lt;/code&gt;, &lt;code&gt;keybase&lt;/code&gt;, &lt;code&gt;linkedin&lt;/code&gt;, &lt;code&gt;medium&lt;/code&gt;, &lt;code&gt;mastodon&lt;/code&gt;, &lt;code&gt;slack&lt;/code&gt;, &lt;code&gt;stackoverflow&lt;/code&gt;, and &lt;code&gt;rss&lt;/code&gt;.&lt;/p&gt;&#10;&lt;/li&gt;&#10;&lt;/ul&gt;</description></item></channel></rss>