-
Notifications
You must be signed in to change notification settings - Fork 1.2k
Installation
Patrick Kollitsch edited this page Apr 12, 2025
·
1 revision
If you're following the Hugo Quickstart guide, you'll notice that it currently recommends installing the Ananke theme as a Git submodule. While this is a valid approach, Hugo also offers a more powerful alternative: Hugo Modules, which leverage Go's module system for better dependency management.
There are two primary ways to install Ananke:
- Hugo Module --- Uses Hugo's built-in Go module system to fetch and manage the theme as a package.
- Git Submodule (Legacy Method) --- Links the theme repository as a submodule inside your Hugo project.
Method | Pros | Cons |
---|---|---|
Hugo Module (Preferred) | Easier version management, automatic updates, better integration | Requires Go installed and initial setup |
Git Submodule (Legacy Method) | Simple if you're already using Git | Requires manual updates, can be tricky with Git workflows |
Recommendation: The Hugo Module approach is preferred, as it provides a more flexible and future-proof way to manage themes.
For step-by-step installation instructions, refer to these work-in-progress sample repositories:
- Hugo Module installation (preferred): gohugo-theme-ananke-template-mod
- Git Submodule installation (Legacy Method): gohugo-theme-ananke-template-submod
Tip
We offer two sample repositories for Ananke's use. Feel free to clone them and play around to test out features described here:
- gohugo-theme-ananke-template-mod --- Hugo Module installation (preferred)
- gohugo-theme-ananke-template-submod --- Git Submodule installation (legacy method)
- Home
- Installation (notes)
- Configuration (notes)
- Content (notes)
- Design and customization
- FAQ