hugo/docs/content/overview/installing.md

69 lines
1.9 KiB
Markdown
Raw Normal View History

2013-07-06 19:36:30 -04:00
---
2014-05-29 18:42:05 -04:00
aliases:
- /doc/installing/
date: 2013-07-01
menu:
main:
2014-05-29 18:42:05 -04:00
parent: getting started
next: /overview/usage
prev: /overview/quickstart
title: Installing Hugo
weight: 20
---
2013-07-06 19:36:30 -04:00
Hugo is written in Go with support for Windows, Linux, FreeBSD and OS X.
2013-07-04 11:32:55 -04:00
The latest release can be found at [Hugo Releases](https://github.com/spf13/hugo/releases).
We currently build for Windows, Linux, FreeBSD and OS X for x64
and i386 architectures.
2013-07-04 11:32:55 -04:00
2013-07-24 11:43:23 -04:00
## Installing Hugo (binary)
Installation is very easy. Simply download the appropriate version for your
platform from [Hugo Releases](https://github.com/spf13/hugo/releases).
2013-07-24 11:43:23 -04:00
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.
2013-07-04 11:32:55 -04:00
Ideally you should install it somewhere in your path for easy use. `/usr/local/bin`
2013-07-04 11:32:55 -04:00
is the most probable location.
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).
2013-07-04 13:03:16 -04:00
## Upgrading Hugo
Upgrading Hugo is as easy as downloading and replacing the executable youve
placed in your path.
2013-07-04 13:03:16 -04:00
## Installing from source
### Dependencies
2013-07-24 11:43:23 -04:00
* Git
* Go 1.1+ (Go 1.4+ on Windows, see Go [Issue #8090](https://code.google.com/p/go/issues/detail?id=8090))
2013-07-24 11:43:23 -04:00
* Mercurial
* Bazaar
2013-07-04 13:03:16 -04:00
### Get directly from GitHub:
2013-07-24 11:43:23 -04:00
go get -v github.com/spf13/hugo
2013-07-04 13:03:16 -04:00
### Building Hugo
2013-07-24 11:43:23 -04:00
cd /path/to/hugo
go build -o hugo main.go
2013-07-24 11:43:23 -04:00
mv hugo /usr/local/bin/
## Contributing
Please see the [contributing guide](/doc/contributing).