General revisions to (hopefully) make the documentation easier to understand and more comprehensive. Revise "Strange EOF error" troubleshooting page to say that a fix is in place for the upcoming Hugo v0.13. Also add more external links, and cute icons from Font Awesome.
2.2 KiB
aliases | date | menu | next | prev | title | weight | |||||
---|---|---|---|---|---|---|---|---|---|---|---|
|
2013-07-01 |
|
/overview/usage | /overview/quickstart | Installing Hugo | 20 |
Hugo is written in Go with support for multiple platforms.
The latest release can be found at Hugo Releases. We currently build for Windows, Linux, FreeBSD and OS X for x64 and i386 architectures.
Installing Hugo (binary)
Installation is very easy. Simply download the appropriate version for your platform from Hugo Releases. Once downloaded it can be run from anywhere. You don't need to install it into a global location. This works well for shared hosts and other systems where you don't have a privileged account.
Ideally, you should install it somewhere in your PATH
for easy use.
/usr/local/bin
is the most probable location.
On OS X, if you have Homebrew, installation is even
easier: just run brew install hugo
.
Installing Pygments (optional)
The Hugo executable has one optional external dependency for source code highlighting (Pygments).
If you want to have source code highlighting using the highlight shortcode, you need to install the Python-based Pygments program. The procedure is outlined on the Pygments home page.
Upgrading Hugo
Upgrading Hugo is as easy as downloading and replacing the executable you’ve
placed in your PATH
.
Installing from source
Dependencies
- Git
- Go 1.1+ (Go 1.4+ on Windows, see Go Issue #8090)
- Mercurial
- Bazaar
Get directly from GitHub
$ export GOPATH=$HOME/go
$ go get -v github.com/spf13/hugo
go get
will then fetch Hugo and all its dependent libraries to your
$GOPATH/src
directory, and compile everything into the final hugo
(or hugo.exe
) executable, which you will find sitting in the
$GOPATH/bin/hugo
directory, all ready to go!
Contributing
Please see the contributing guide.