Skip to content

Commit 1a342d1

Browse files
committed
User guide: update info about hugo installation
1 parent d16e0da commit 1a342d1

File tree

1 file changed

+35
-8
lines changed

1 file changed

+35
-8
lines changed

userguide/content/en/docs/get-started/docsy-as-module/installation-prerequisites.md

+35-8
Original file line numberDiff line numberDiff line change
@@ -10,26 +10,49 @@ This page describes the prerequisites for building a site that uses Docsy as a H
1010

1111
## Install Hugo
1212

13-
You need a [recent **extended** version](https://github.com/gohugoio/hugo/releases) (we recommend version 0.73.0 or later) of [Hugo](https://gohugo.io/) to do local builds and previews of sites (like this one) that use Docsy. If you install from the release page, make sure to get the `extended` Hugo version, which supports [SCSS](https://sass-lang.com/documentation/file.SCSS_FOR_SASS_USERS.html); you may need to scroll down the list of releases to see it.
13+
To do local builds and previews of sites (like this one) that use Docsy, you need an [**extended** version](https://github.com/gohugoio/hugo/releases) of [Hugo](https://gohugo.io/), version `v0.110.0` or higher. If you install from the release page, make sure to get the `extended` Hugo version, which supports [SCSS](https://sass-lang.com/documentation/file.SCSS_FOR_SASS_USERS.html); you may need to scroll down the list of releases to see it.
1414

1515
For comprehensive Hugo documentation, see [gohugo.io](https://gohugo.io).
1616

17-
### On Linux
18-
19-
Be careful using `sudo apt-get install hugo`, as it [doesn't get you the `extended` version for all Debian/Ubuntu versions](https://gohugo.io/getting-started/installing/#debian-and-ubuntu), and may not be up-to-date with the most recent Hugo version.
20-
21-
If you've already installed Hugo, check your version:
17+
As of docsy version `v0.7.0`, hugo version `v0.110.0` or higher is required. If you've already installed Hugo, check your version:
2218

2319
```bash
2420
hugo version
2521
```
2622

27-
If the result is `v0.73` or earlier, or if you don't see `Extended`, you'll need to install the latest version. You can see a complete list of Linux installation options in [Install Hugo](https://gohugo.io/getting-started/installing/#linux). The following shows you how to install Hugo from the release page:
23+
If the result is `v0.109.0` or earlier, or if you don't see `Extended`, you'll need to update to the latest version.
24+
25+
### On Linux
26+
27+
You can see a complete list of Linux installation options in the official [hugo documentation](https://gohugo.io/installation/linux/). Below the two most popular installation options are described:
28+
29+
#### Using hugo debian package
30+
31+
The following shows you how to install Hugo from the release page using prebuilt debian packages:
2832

2933
1. Go to the [Hugo releases](https://github.com/gohugoio/hugo/releases) page.
3034
2. In the most recent release, scroll down until you find a list of
3135
**Extended** versions.
32-
3. Download the latest extended version (`hugo_extended_0.1XX_Linux-64bit.tar.gz`).
36+
3. Download the debian package of the latest extended version (`hugo_extended_0.1XX.X_linux-architecture.deb`) to a directory of your choice.
37+
38+
```bash
39+
wget https://github.com/gohugoio/hugo/releases/download/v0.1XX.X/hugo_extended_0.1XX.X_linux-architecture.deb
40+
```
41+
42+
7. Install Hugo using `dpkg` tool from debian package management system:
43+
44+
```bash
45+
sudo dpkg --install hugo_extended_0.1XX.X_linux-architecture.deb
46+
```
47+
48+
#### Using prebuilt binaries
49+
50+
The following shows you how to install Hugo from the release page using prebuilt binaries:
51+
52+
1. Go to the [Hugo releases](https://github.com/gohugoio/hugo/releases) page.
53+
2. In the most recent release, scroll down until you find a list of
54+
**Extended** versions.
55+
3. Download the prebuilt binaries of the latest extended version (`hugo_extended_0.1XX_Linux-64bit.tar.gz`).
3356
4. Create a new directory:
3457

3558
```bash
@@ -50,6 +73,10 @@ If the result is `v0.73` or earlier, or if you don't see `Extended`, you'll need
5073
sudo install hugo /usr/bin
5174
```
5275

76+
{{% alert title="Warning" color="warning" %}}
77+
Be careful using `sudo apt-get install hugo`, as it doesn't get you the `extended` version for all Debian/Ubuntu versions, and may not be up-to-date with the most recent Hugo version.
78+
{{% /alert %}}
79+
5380
### On macOS
5481
5582
Install Hugo using [Brew](https://gohugo.io/getting-started/installing/#homebrew-macos).

0 commit comments

Comments
 (0)