The world’s fastest framework for building websites.
Find a file
2016-03-24 14:05:08 +01:00
bufferpool bufferpool: Add test 2016-02-06 18:01:27 +01:00
commands parser: Spring code cleaning 2016-03-23 14:51:16 +01:00
create create: Refactor NewContent to be testable 2016-03-20 23:51:17 +01:00
docs Add Scratch to shortcode 2016-03-21 21:11:20 -04:00
examples Update Hugo examples 2015-12-26 20:02:21 -07:00
helpers helpers: Fix and add Godoc in path* 2016-03-23 10:03:29 +01:00
hugofs Fix copyright headers in source files 2015-12-07 19:57:01 +01:00
hugolib hugoblib: Clean up the time tests 2016-03-24 13:30:08 +01:00
livereload livereload: Add missing GoDoc 2016-03-24 14:05:08 +01:00
parser parser: Make the constant vars ... constants 2016-03-23 15:05:32 +01:00
source source: Consolidate if conditions 2016-03-22 19:49:16 +01:00
target target: Fix some Golint warnings 2016-03-23 00:44:51 +01:00
tpl Add plainify template function 2016-03-21 20:27:25 -04:00
transform transform: Group vars and consts in chain_test 2016-03-23 21:55:14 +01:00
utils utils: Add godoc 2016-03-23 00:04:28 +01:00
watcher Fix copyright headers in source files 2015-12-07 19:57:01 +01:00
.gitignore Add convenience script to run benchmarks 2015-05-14 23:17:45 +02:00
.goxc.json add more architectures to .goxc 2015-12-08 16:46:43 -05:00
.mailmap Add .mailmap to get a more correct author log 2015-01-28 16:50:36 +01:00
.travis.yml Do make check in Travis 2016-03-22 23:14:17 +01:00
bench.sh Add benchmark for sort and reverse 2015-07-21 21:08:20 +02:00
CONTRIBUTING.md Add package prefix to the commit message guidelines 2016-03-11 10:30:17 +01:00
Dockerfile Update Dockerfile to use golang:1.6 base image 2016-03-10 10:59:52 +01:00
LICENSE.md Change the license to Apache 2.0 2015-11-23 22:16:36 -05:00
main.go Exit with error code on any error 2016-03-11 10:57:13 +01:00
Makefile hugo: Add check tasks to Makefile 2016-03-22 19:40:27 +01:00
README.md Revert "Add Codebeat badge" 2016-03-17 23:50:42 +01:00
requirements.txt Bump Pygment version to 2.1.3 2016-03-13 22:16:00 +01:00
wercker.yml Create wercker.yml 2014-01-15 11:02:24 -05:00

Hugo

A Fast and Flexible Static Site Generator built with love by spf13 and friends in Go.

Website | Forum | Dev Chat | Documentation | Installation Guide | Twitter

Travis CI status wercker status Appveyor status Dev chat at https://gitter.im/spf13/hugo Go Report Card

Overview

Hugo is a static HTML and CSS website generator written in Go. It is optimized for speed, easy use and configurability. Hugo takes a directory with content and templates and renders them into a full HTML website.

Hugo relies on Markdown files with front matter for meta data. And you can run Hugo from any directory. This works well for shared hosts and other systems where you dont have a privileged account.

Hugo renders a typical website of moderate size in a fraction of a second. A good rule of thumb is that each piece of content renders in around 1 millisecond.

Hugo is designed to work well for any kind of website including blogs, tumbles and docs.

Supported Architectures

Currently, we provide pre-built Hugo binaries for Windows, Linux, FreeBSD, NetBSD and OS X (Darwin) for x64, i386 and ARM architectures.

Hugo may also be compiled from source wherever the Go compiler tool chain can run, e.g. for other operating systems including DragonFly BSD, OpenBSD, Plan 9 and Solaris.

Complete documentation is available at Hugo Documentation.

Choose How to Install

If you want to use Hugo as your site generator, simply install the Hugo binaries. The Hugo binaries have no external dependencies.

To contribute to the Hugo source code or documentation, you should fork the Hugo GitHub project and clone it to your local machine.

Finally, you can install the Hugo source code with go, build the binaries yourself, and run Hugo that way. Building the binaries is an easy task for an experienced go getter.

Install Hugo as Your Site Generator (Binary Install)

Use the installation instructions in the Hugo documentation.

Clone the Hugo Project (Contributor)

  1. Make sure your local environment has the following software installed:

  2. Fork the Hugo project on GitHub.

  3. Clone your fork:

     git clone https://github.com/YOURNAME/hugo
    
  4. Change into the hugo directory:

     cd hugo
    
  5. Install the Hugo projects package dependencies:

     go get -u -v github.com/spf13/hugo
    
  6. Use a symbolic link to add your locally cloned Hugo repository to your $GOPATH, assuming you prefer doing development work outside of $GOPATH:

    rm -rf "$GOPATH/src/github.com/spf13/hugo"
    ln -s `pwd` "$GOPATH/src/github.com/spf13/hugo"
    

    Go expects all of your libraries to be found in$GOPATH.

Build and Install the Binaries from Source (Advanced Install)

Add Hugo and its package dependencies to your go src directory.

go get -v github.com/spf13/hugo

Once the get completes, you should find your new hugo (or hugo.exe) executable sitting inside $GOPATH/bin/.

To update Hugos dependencies, use go get with the -u option.

go get -u -v github.com/spf13/hugo

Contribute to Hugo

We welcome contributions to Hugo of any kind including documentation, themes, organization, tutorials, blog posts, bug reports, issues, feature requests, feature implementation, pull requests, answering questions on the forum, helping to manage issues, etc.

The Hugo community and maintainers are very active and helpful and the project benefits greatly from this activity.

Throughput Graph

If you have any questions about how to contribute or what to contribute, please ask on the forum.

Code Contribution Guideline

We welcome your contributions. To make the process as seamless as possible, we ask for the following:

  • Go ahead and fork the project and make your changes. We encourage pull requests to discuss code changes.
  • When youre ready to create a pull request, be sure to:
    • Sign the CLA
    • Have test cases for the new code. If you have questions about how to do it, please ask in your pull request.
    • Run go fmt
    • Squash your commits into a single commit. git rebase -i. Its okay to force update your pull request.
    • Write a good commit message. This blog article is a good resource for learning how to write good commit messages, the most important part being that each commit message should have a title/subject in imperative mood starting with a capital letter and no trailing period: "Return error on wrong use of the Paginator", NOT "returning some error." Also, if your commit references one or more GitHub issues, always end your commit message body with See #1234 or Fixes #1234. Replace 1234 with the GitHub issue ID. The last example will close the issue when the commit is merged into master. Sometimes it makes sense to prefix the commit message with the packagename (or docs folder) all lowercased ending with a colon. That is fine, but the rest of the rules above apply. So it is "tpl: Add emojify template func", not "tpl: add emojify template func.", and "docs: Document emoji", not "doc: document emoji."
    • Make sure go test ./... passes, and go build completes. Our Travis CI loop (Linux and OS X) and AppVeyor (Windows) will catch most things that are missing.

Build Hugo with Your Changes

cd /path/to/hugo
go build -o hugo main.go
mv hugo /usr/local/bin/

Add Compile Information to Hugo

To add compile information to Hugo, replace the go build command with the following (replace /path/to/hugo with the actual path):

go build -ldflags "-X /path/to/hugo/hugolib.CommitHash=`git rev-parse --short HEAD 2>/dev/null` -X github.com/spf13/hugo/hugolib.BuildDate=`date +%FT%T%z`"

This will result in hugo version output that looks similar to:

Hugo Static Site Generator v0.13-DEV-8042E77 buildDate: 2014-12-25T03:25:57-07:00

Alternatively, just run make — all the “magic” above is already in the Makefile. 😉

Run Hugo

cd /path/to/hugo
go install github.com/spf13/hugo/hugolib
go run main.go

Complete documentation is available at Hugo Documentation.

Analytics Bitdeli Badge