summaryrefslogtreecommitdiffstats
path: root/docs/content/en/installation/linux.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/content/en/installation/linux.md')
-rw-r--r--docs/content/en/installation/linux.md117
1 files changed, 51 insertions, 66 deletions
diff --git a/docs/content/en/installation/linux.md b/docs/content/en/installation/linux.md
index ba59d0f2a..731cfce4c 100644
--- a/docs/content/en/installation/linux.md
+++ b/docs/content/en/installation/linux.md
@@ -1,25 +1,20 @@
---
title: Linux
description: Install Hugo on Linux.
-categories: [installation]
+categories: []
keywords: []
-menu:
- docs:
- parent: installation
- weight: 30
-weight: 30
-toc: true
+weight: 20
---
## Editions
-{{% include "installation/_common/01-editions.md" %}}
+{{% include "/_common/installation/01-editions.md" %}}
Unless your specific deployment needs require the extended/deploy edition, we recommend the extended edition.
-{{% include "installation/_common/02-prerequisites.md" %}}
+{{% include "/_common/installation/02-prerequisites.md" %}}
-{{% include "installation/_common/03-prebuilt-binaries.md" %}}
+{{% include "/_common/installation/03-prebuilt-binaries.md" %}}
## Package managers
@@ -27,7 +22,7 @@ Unless your specific deployment needs require the extended/deploy edition, we re
[Snap] is a free and open-source package manager for Linux. Available for [most distributions], snap packages are simple to install and are automatically updated.
-The Hugo snap package is [strictly confined]. Strictly confined snaps run in complete isolation, up to a minimal access level that’s deemed always safe. The sites you create and build must be located within your home directory, or on removable media.
+The Hugo snap package is [strictly confined]. Strictly confined snaps run in complete isolation, up to a minimal access level that's deemed always safe. The sites you create and build must be located within your home directory, or on removable media.
To install the extended edition of Hugo:
@@ -49,23 +44,16 @@ sudo snap connect hugo:ssh-keys
sudo snap disconnect hugo:ssh-keys
```
-[most distributions]: https://snapcraft.io/docs/installing-snapd
-[strictly confined]: https://snapcraft.io/docs/snap-confinement
-[Snap]: https://snapcraft.io/
-
-{{% include "installation/_common/homebrew.md" %}}
+{{% include "/_common/installation/homebrew.md" %}}
## Repository packages
Most Linux distributions maintain a repository for commonly installed applications.
-{{% note %}}
-The Hugo version available in package repositories varies based on Linux distribution and release, and in some cases will not be the [latest version].
-
-Use one of the other installation methods if your package repository does not provide the desired version.
-
-[latest version]: https://github.com/gohugoio/hugo/releases/latest
-{{% /note %}}
+> [!note]
+> The Hugo version available in package repositories varies based on Linux distribution and release, and in some cases will not be the [latest version].
+>
+> Use one of the other installation methods if your package repository does not provide the desired version.
### Alpine Linux
@@ -75,8 +63,6 @@ To install the extended edition of Hugo on [Alpine Linux]:
doas apk add --no-cache --repository=https://dl-cdn.alpinelinux.org/alpine/edge/community hugo
```
-[Alpine Linux]: https://alpinelinux.org/
-
### Arch Linux
Derivatives of the [Arch Linux] distribution of Linux include [EndeavourOS], [Garuda Linux], [Manjaro], and others. To install the extended edition of Hugo:
@@ -85,11 +71,6 @@ Derivatives of the [Arch Linux] distribution of Linux include [EndeavourOS], [Ga
sudo pacman -S hugo
```
-[Arch Linux]: https://archlinux.org/
-[EndeavourOS]: https://endeavouros.com/
-[Manjaro]: https://manjaro.org/
-[Garuda Linux]: https://garudalinux.org/
-
### Debian
Derivatives of the [Debian] distribution of Linux include [elementary OS], [KDE neon], [Linux Lite], [Linux Mint], [MX Linux], [Pop!_OS], [Ubuntu], [Zorin OS], and others. To install the extended edition of Hugo:
@@ -100,33 +81,22 @@ sudo apt install hugo
You can also download Debian packages from the [latest release] page.
-[Debian]: https://www.debian.org/
-[Exherbo]: https://www.exherbolinux.org/
-[elementary OS]: https://elementary.io/
-[KDE neon]: https://neon.kde.org/
-[Linux Lite]: https://www.linuxliteos.com/
-[Linux Mint]: https://linuxmint.com/
-[MX Linux]: https://mxlinux.org/
-[Pop!_OS]: https://pop.system76.com/
-[Ubuntu]: https://ubuntu.com/
-[Zorin OS]: https://zorin.com/os/
-
### Exherbo
To install the extended edition of Hugo on [Exherbo]:
1. Add this line to /etc/paludis/options.conf:
- ```text
- www-apps/hugo extended
- ```
+ ```text
+ www-apps/hugo extended
+ ```
1. Install using the Paludis package manager:
- ```sh
- cave resolve -x repository/heirecka
- cave resolve -x hugo
- ```
+ ```sh
+ cave resolve -x repository/heirecka
+ cave resolve -x hugo
+ ```
### Fedora
@@ -136,10 +106,6 @@ Derivatives of the [Fedora] distribution of Linux include [CentOS], [Red Hat Ent
sudo dnf install hugo
```
-[CentOS]: https://www.centos.org/
-[Fedora]: https://getfedora.org/
-[Red Hat Enterprise Linux]: https://www.redhat.com/
-
### Gentoo
Derivatives of the [Gentoo] distribution of Linux include [Calculate Linux], [Funtoo], and others. To install the extended edition of Hugo:
@@ -156,11 +122,6 @@ Derivatives of the [Gentoo] distribution of Linux include [Calculate Linux], [Fu
sudo emerge www-apps/hugo
```
-[Calculate Linux]: https://www.calculate-linux.org/
-[Funtoo]: https://www.funtoo.org/
-[Gentoo]: https://www.gentoo.org/
-[USE]: https://packages.gentoo.org/packages/www-apps/hugo
-
### NixOS
The NixOS distribution of Linux includes Hugo in its package repository. To install the extended edition of Hugo:
@@ -177,10 +138,6 @@ Derivatives of the [openSUSE] distribution of Linux include [GeckoLinux], [Linux
sudo zypper install hugo
```
-[GeckoLinux]: https://geckolinux.github.io/
-[Linux Karmada]: https://linuxkamarada.com/
-[openSUSE]: https://www.opensuse.org/
-
### Solus
The [Solus] distribution of Linux includes Hugo in its package repository. To install the extended edition of Hugo:
@@ -189,8 +146,6 @@ The [Solus] distribution of Linux includes Hugo in its package repository. To in
sudo eopkg install hugo
```
-[Solus]: https://getsol.us/
-
### Void Linux
To install the extended edition of Hugo on [Void Linux]:
@@ -199,9 +154,7 @@ To install the extended edition of Hugo on [Void Linux]:
sudo xbps-install -S hugo
```
-[Void Linux]: https://voidlinux.org/
-
-{{% include "installation/_common/04-build-from-source.md" %}}
+{{% include "/_common/installation/04-build-from-source.md" %}}
## Comparison
@@ -215,3 +168,35 @@ Latest version available?|:heavy_check_mark:|:heavy_check_mark:|varies|:heavy_ch
[^1]: Easy if a previous version is still installed.
[^2]: Snap packages are automatically updated. Homebrew requires advanced configuration.
+
+[Alpine Linux]: https://alpinelinux.org/
+[Arch Linux]: https://archlinux.org/
+[Calculate Linux]: https://www.calculate-linux.org/
+[CentOS]: https://www.centos.org/
+[Debian]: https://www.debian.org/
+[elementary OS]: https://elementary.io/
+[EndeavourOS]: https://endeavouros.com/
+[Exherbo]: https://www.exherbolinux.org/
+[Fedora]: https://getfedora.org/
+[Funtoo]: https://www.funtoo.org/
+[Garuda Linux]: https://garudalinux.org/
+[GeckoLinux]: https://geckolinux.github.io/
+[Gentoo]: https://www.gentoo.org/
+[KDE neon]: https://neon.kde.org/
+[latest version]: https://github.com/gohugoio/hugo/releases/latest
+[Linux Karmada]: https://linuxkamarada.com/
+[Linux Lite]: https://www.linuxliteos.com/
+[Linux Mint]: https://linuxmint.com/
+[Manjaro]: https://manjaro.org/
+[most distributions]: https://snapcraft.io/docs/installing-snapd
+[MX Linux]: https://mxlinux.org/
+[openSUSE]: https://www.opensuse.org/
+[Pop!_OS]: https://pop.system76.com/
+[Red Hat Enterprise Linux]: https://www.redhat.com/
+[Snap]: https://snapcraft.io/
+[Solus]: https://getsol.us/
+[strictly confined]: https://snapcraft.io/docs/snap-confinement
+[Ubuntu]: https://ubuntu.com/
+[USE]: https://packages.gentoo.org/packages/www-apps/hugo
+[Void Linux]: https://voidlinux.org/
+[Zorin OS]: https://zorin.com/os/