hugo/docs/content/overview/installing.md

66 lines
1.7 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
2014-03-24 07:19:25 -04:00
Hugo is written in Go with support for Windows, Linux, FreeBSD and OSX.
2013-07-04 11:32:55 -04:00
2013-07-05 00:37:59 -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 386 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
2013-07-24 11:43:23 -04:00
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.
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.
### 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+
* Mercurial
* Bazaar
2013-07-04 13:03:16 -04:00
2013-07-24 11:43:23 -04:00
### Get directly from Github:
go get 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
2013-08-03 03:30:34 -04:00
Please see the [contributing guide](/doc/contributing)