hugo-the best static website builder

This is a creation in Article, where the information may have evolved or changed.

Hugo is a static site builder implemented by the go language. Simple, easy to use, efficient, easy to scale, fast to deploy.

Quick Start

Install Hugo

1. Binary installation (recommended: simple, fast)

Hugo binaries to Hugo releases download the corresponding operating system version (Hugo or Hugo.exe)

Use the installation directly under Mac Homebrew :

brew install hugo

2. Source code Installation

The source code compiles the installation, first installs the dependent tool:

• Git
• Mercurial
• Go 1.3+ (Go 1.4+ on Windows)

Set up GOPATH environment variables, get the source code and compile:

$ export GOPATH=$HOME/go$ go get -v github.com/spf13/hugo

The source code will be downloaded to the $GOPATH/src directory, binary in$GOPATH/bin/

If you need to update all Hugo's dependent libraries, add -u parameters:

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

Build site

Use Hugo to quickly generate a site, such as the path you want to generate /path/to/site :

$ hugo new site /path/to/site

This /path/to/site creates the initial site in the directory, in the directory:

$ cd /path/to/site

Site Directory structure:

  ▸ archetypes/  ▸ content/  ▸ layouts/  ▸ static/    config.toml

Create an article

To create a about page:

$ hugo new about.md

about.mdAutomatically generated to content/about.md , open to about.md look under:

+++date = "2015-10-25T08:36:54-07:00"draft = truetitle = "about"+++正文内容

The content is Markdown formatted, and +++ the content is in TOML format, depending on your preference, you can change to YAML format (using --- tags) or JSON format.

Create the first article, put it in the post table of contents, and then build the aggregated page.

$ hugo new post/first.md

Open Edit post/first.md :

---date: "2015-10-25T08:36:54-07:00"title: "first"---### Hello Hugo 1. aaa 1. bbb 1. ccc

Installing the Skin

To the skin list pick a favorite skin, such as you feel Hyde good skin, find the relevant GitHub address, create a directory themes , in the themes directory to put the skin git clone down:

# 创建 themes 目录$ cd themes$ git clone https://github.com/spf13/hyde.git

Run Hugo

Execute the command at your site root Hugo to debug:

$ hugo server --theme=hyde --buildDrafts --watch

Use --watch parameters to have the browser refresh automatically when you modify the content of the article.

Open in Browser:http://localhost:1313

Deployment

Suppose you need to deploy on GitHub Pages , first create a repository on GitHub, named: coderzh.github.io (Coderzh replaced by your GitHub username).

Execute commands at the site root to Hugo generate the final page:

$ hugo --theme=hyde --baseUrl="http://coderzh.github.io/"

If all goes well, all static pages are generated to the public directory, and all the files in the PUBILC directory push go to the branch of the repository you just created master .

$ cd public$ git init$ git remote add origin https://github.com/coderzh/coderzh.github.io.git$ git add -A$ git commit -m "first commit"$ git push -u origin master

Browser access:http://coderzh.github.io/

This web site, Java Union, is what I built with Hugo. This site template is written by myself (except for the Styles section), so if you have questions about Hugo's and go templates you can ask me.