FuzzyBot: Updating to match new version of source page

2025-10-07T20:52:22Z

Updating to match new version of source page

← Older revision		Revision as of 20:52, 7 October 2025
Line 112:		Line 112:
	[[Category:Applications]]		[[Category:Applications]]
	[[Category:Server]]		[[Category:Server]]
			[[Category:Go]]

FuzzyBot: Updating to match new version of source page

2025-05-19T06:59:40Z

Updating to match new version of source page

New page

<languages/>
'''Hugo''' is a static site generator written in Go. It builds websites from content files and templates, supporting features such as Markdown content, themes, and flexible deployment options. Hugo is available in the NixOS ecosystem and can be used for a variety of web publishing tasks.<ref>https://gohugo.io/documentation/</ref>

== Installation ==

==== Shell ====

To temporarily use Hugo in a shell environment, you can run:
<syntaxhighlight lang="bash">
nix-shell -p hugo
</syntaxhighlight>

This will provide a shell with Hugo available without adding it to your system configuration.

==== System setup ====

To install Hugo, add it to either the system-wide <code>environment.systemPackages</code> in <code>/etc/nixos/configuration.nix</code> or to the user-specific <code>home.packages</code> in <code>~/.config/nixpkgs/home.nix</code>.<ref>https://nixos.org/manual/nixos/stable/</ref>
<syntaxhighlight lang="nix">
# System-wide installation (in /etc/nixos/configuration.nix)
environment.systemPackages = with pkgs; [
hugo
git # Useful for managing Hugo themes and site repositories
];

# User-specific installation (in ~/.config/nixpkgs/home.nix)
home.packages = with pkgs; [
hugo
git
];
</syntaxhighlight>

Then, rebuild your system or apply your Home Manager configuration:
<syntaxhighlight lang="bash">
# For system-wide installation
sudo nixos-rebuild switch

# For Home Manager
home-manager switch
</syntaxhighlight>

== Configuration ==

==== Basic ====

Basic Hugo configuration involves creating a new site and choosing themes. Use the following command to create a new Hugo site:
<syntaxhighlight lang="bash">
hugo new site my-site
</syntaxhighlight>
Navigate to the site directory and add a theme as a git submodule or download it directly. For detailed steps, refer to the official Hugo documentation.

==== Advanced ====

{{Expansion|reason=Section incomplete, needs detailed content on advanced configuration with NixOS}}

== Tips and tricks ==

=== Development Shell ===

You may want to limit Hugo installation to your project only. This allows contributors to use the exact dependencies specified for the project:
{{file|shell.nix|nix|<nowiki>
{ pkgs ? import <nixpkgs> {} }:
pkgs.mkShellNoCC {
packages = [
pkgs.hugo
# Other dependencies for your project.
];
}
</nowiki>}}

To avoid typing <code>nix-shell</code> or <code>nix develop</code> to access the dev shell, consider [[Direnv|enabling nix-direnv]].

=== Theming ===

Nix can be used to deterministically import Hugo themes by pinning them to a specific revision:
{{file|shell.nix|nix|<nowiki>
{ pkgs ? import <nixpkgs> {} }: let
hugo-theme = pkgs.fetchFromGitHub {
owner = "vaga";
repo = "hugo-theme-m10c";
rev = "862c6e941be9bc46ce8adc6a2fa9e984ba647d6f";
hash = "sha256-wcJSGjL/u43hPLblPmUhusqiMmadVBWJhihRinRXqzg=";
};
in
pkgs.mkShellNoCC {
packages = [
pkgs.hugo
# Other dependencies for your project.
];
shellHook = ''
mkdir -p themes
ln -snf "${hugo-theme}" themes/m10c
'';
}
</nowiki>}}

After creating a <code>hugo.toml</code> file like the following, activate the theme with <code>hugo new site . --force</code>:
{{file|hugo.toml|toml|<nowiki>
baseURL = 'https://example.com/'
languageCode = 'en-us'
title = 'example-site'
theme = 'm10c'
</nowiki>}}

== Troubleshooting ==

{{Expansion|reason=Section incomplete, needs detailed troubleshooting steps}}

== References ==

[[Category:Applications]]
[[Category:Server]]

Hugo/en - Revision history

FuzzyBot: Updating to match new version of source page

FuzzyBot: Updating to match new version of source page