Hugo - Revision history

Klinger: Category Go added

2025-06-25T20:31:00Z

Category Go added

← Older revision		Revision as of 20:31, 25 June 2025
Line 147:		Line 147:
	[[Category:Applications]]		[[Category:Applications]]
	[[Category:Server]]		[[Category:Server]]
			[[Category:Go]]

Layer-09: Marked this version for translation

2025-05-19T06:59:36Z

Marked this version for translation

← Older revision		Revision as of 06:59, 19 May 2025
Line 68:		Line 68:
	</syntaxhighlight>		</syntaxhighlight>
	<translate>		<translate>
			<!--T:12-->
	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.		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.
	</translate>		</translate>
Line 81:		Line 82:

	<translate>		<translate>
	<!--T:devshell-->		=== Development Shell === <!--T:devshell-->
	~~=== Development Shell ===~~

			<!--T:13-->
	You may want to limit Hugo installation to your project only. This allows contributors to use the exact dependencies specified for the project:		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>		{{file\|shell.nix\|nix\|<nowiki>
Line 95:		Line 96:
	</nowiki>}}		</nowiki>}}

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

	<translate>		<translate>
	<!--T:theming-->		=== Theming === <!--T:theming-->
	~~=== Theming ===~~

			<!--T:15-->
	Nix can be used to deterministically import Hugo themes by pinning them to a specific revision:		Nix can be used to deterministically import Hugo themes by pinning them to a specific revision:
	{{file\|shell.nix\|nix\|<nowiki>		{{file\|shell.nix\|nix\|<nowiki>
Line 124:		Line 126:
	</nowiki>}}		</nowiki>}}

			<!--T:16-->
	After creating a <code>hugo.toml</code> file like the following, activate the theme with <code>hugo new site . --force</code>:		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>		{{file\|hugo.toml\|toml\|<nowiki>

Layer-09: Added back old content to "Tips and tricks"

2025-05-19T06:58:36Z

Added back old content to "Tips and tricks"

@@ Line 81: / Line 81: @@
 <translate>
-<!--T:10-->
+<!--T:devshell-->
-{{Expansion|reason=Section incomplete, needs more tips and tricks}}
+=== Development Shell ===
 </translate>

Layer-09: Cleaned up and clarified the page

2025-05-19T06:53:29Z

Cleaned up and clarified the page

Show changes

SigmaSquadron: /* Theming */ typo

2025-05-17T16:00:41Z

Theming: typo

← Older revision		Revision as of 16:00, 17 May 2025
Line 55:		Line 55:
	</nowiki>}}		</nowiki>}}

	The theme can be activated using <code>hugo new site . --force</code>, after creating a <code>hugo.toml</code> similar to the following:		The theme can be activated using <code>hugo new site . --force</code>, after creating a <code>hugo.toml</code> file similar to the following:

	{{file\|hugo.toml\|toml\|<nowiki>		{{file\|hugo.toml\|toml\|<nowiki>

SigmaSquadron: Categories

2025-05-17T15:56:59Z

SigmaSquadron: Imported from the old wiki. (Except off-topic parts)

2025-05-17T15:55:39Z

Imported from the old wiki. (Except off-topic parts)

New page

'''[https://gohugo.io Hugo]''' is one of the most popular open-source static site generators.

The easiest way to use Hugo on NixOS is to add Hugo to the <code>environment.systemPackages</code> attribute:
{{file|configuration.nix|nix|<nowiki>
{ pkgs, ... }: {
environment.systemPackages = [
pkgs.git
pkgs.hugo
];
}
</nowiki>}}
{{Evaluate}}

You can now follow the [https://gohugo.io/getting-started/quick-start/ Hugo Quick Start] guide, as not much is different from running Hugo on other Linux distributions.

=== Development Shell ===

You may, however, want to limit the installation to your Hugo-specific projects. This makes it possible for you or others to download your repository and work with its dependencies, since they are fully specified within the project.
{{file|shell.nix|nix|<nowiki>
{ pkgs ? import <nixpkgs> {} }:
pkgs.mkShellNoCC {
packages = [
pkgs.hugo
# Other dependencies for your project.
];
}
</nowiki>}}

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

=== Theming ===

Nix can be used to deterministically import themes by pinning them to a specific revision and linking the resulting derivation:

{{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>}}

The theme can be activated using <code>hugo new site . --force</code>, after creating a <code>hugo.toml</code> similar to the following:

{{file|hugo.toml|toml|<nowiki>
baseURL = 'https://example.com/'
languageCode = 'en-us'
title = 'example-site'
theme = 'm10c'
</nowiki>}}

← Older revision		Revision as of 15:56, 17 May 2025
Line 63:		Line 63:
	theme = 'm10c'		theme = 'm10c'
	</nowiki>}}		</nowiki>}}

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