mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-07 20:30:36 -05:00
4107fd50a8
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.
68 lines
2.2 KiB
Markdown
68 lines
2.2 KiB
Markdown
---
|
||
aliases:
|
||
- /doc/installing/
|
||
date: 2013-07-01
|
||
menu:
|
||
main:
|
||
parent: getting started
|
||
next: /overview/usage
|
||
prev: /overview/quickstart
|
||
title: Installing Hugo
|
||
weight: 20
|
||
---
|
||
|
||
Hugo is written in Go with support for multiple platforms.
|
||
|
||
The latest release can be found at [Hugo Releases](https://github.com/spf13/hugo/releases).
|
||
We currently build for <i class="fa fa-windows"></i> Windows, <i class="fa fa-linux"></i> Linux, FreeBSD and <i class="fa fa-apple"></i> 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](https://github.com/spf13/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](http://brew.sh), 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](/extras/highlighting),
|
||
you need to install the Python-based Pygments program. The procedure is outlined on the [Pygments home page](http://pygments.org).
|
||
|
||
## 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](https://code.google.com/p/go/issues/detail?id=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](/doc/contributing).
|