Prerequisites

Building a static website with Wowchemy Academic theme requires Hugo and Go to be installed. Go is used by Wowchemy to download and use the theme files. In addition, Git and Rsync are very convenient, but not required.

Here is a short description on how to install these prerequisites on most common platforms. If you have all the prerequisites, the four following commands should display something:

hugo version
go version
git version
rsync --version

Installation on Linux

Download the extended version of Hugo (hugo_extended_*_Linux-64bit.tar.gz) from github.com/gohugoio/hugo/releases or using the command:

wget https://github.com/gohugoio/hugo/releases/download/v0.88.1/hugo_extended_0.88.1_Linux-64bit.tar.gz

and install it by executing:

sudo tar -C /usr/local/bin -xzf hugo_extended_*_Linux-64bit.tar.gz

Download the Linux version of Go (go*linux-amd64.tar.gz) from golang.org/dl or using the command:

wget https://golang.org/dl/go1.17.2.linux-amd64.tar.gz

and install it by executing:

sudo tar -C /usr/local -xzf go*.linux-amd64.tar.gz
sudo ln -s /usr/local/go/bin/go /usr/local/bin/go

Install Git and Rsync by using the package repository, for example:
```
 sudo apt install git rsync
```

Unfortunately, as currently written (10.2021), the default version of Go from the Ubuntu packages is outdated and the snap versions of Go and Hugo are unable to work together. But you can use the snap version of Go (sudo snap install go --classic) together with Hugo installed as described above.

Installation on Windows

Download the extended version of Hugo (hugo_extended_*_Windows-64bit.zip) from github.com/gohugoio/hugo/releases, extract the archive to C:\Program Files\Hugo and add it to the path by running the command:
```
setx PATH "%PATH%;C:\Program Files\Hugo"
```
Download the Windows version of Go (go*windows-amd64.msi) from golang.org/dl and install it by clicking on the downloaded file and following the instructions.
Download the Windows version of Git from git-scm.com/download/win and install it by clicking on the downloaded file and following the instructions.
Download the Windows version of Rsync (cwrsync_*_x64_free.zip) from itefix.net/cwrsync, extract the archive to C:\Program Files\Rsync and add it to the path by running the command:
```
setx PATH "%PATH%;C:\Program Files\Rsync\bin"
```

If you have Chocolatey installed, you should be able to install all the prerequisites using:

choco install hugo-extended golang git rsync

Installation on MacOS

Download the extended version of Hugo (hugo_extended_*_macOS-64bit.tar.gz or hugo_extended_*_macOS-ARM64.tar.gz) from github.com/gohugoio/hugo/releases and extract the file hugo to /usr/local/bin.
Download the MacOS version of Go (go*darwin-amd64.pkg or go*darwin-arm64.pkg) from golang.org/dl and install it by following the instructions.
Install Git by running the command:
```
git
```

If you have Brew installed, you should be able to install all the prerequisites using:

brew install go hugo git rsync

Dernière mise à jour le 25 Oct 2021