• 快速开始
  • 安装Hugo
    • 1. 二进制安装（推荐：简单、快速）
    • 2. 源码安装
  • 生成站点
  • 创建文章
  • 安装皮肤
  • 运行Hugo
  • 部署

快速开始

安装Hugo

1. 二进制安装（推荐：简单、快速）

到 Hugo Releases 下载对应的操作系统版本的Hugo二进制文件（hugo或者hugo.exe）

Mac下直接使用Homebrew安装：

1brew install hugo

2. 源码安装

源码编译安装，首先安装好依赖的工具：

• Git
• Mercurial
• Go 1.3+ (Go 1.4+ on Windows) 设置好GOPATH环境变量，获取源码并编译：

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

源码会下载到 $GOPATH/src 目录，二进制在$GOPATH/bin/

如果需要更新所有Hugo的依赖库，增加-u参数：

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

生成站点

使用Hugo快速生成站点，比如希望生成到 /path/to/site 路径：

1$ hugo new site /path/to/site

这样就在/path/to/site目录里生成了初始站点，进去目录：

1$ cd /path/to/site

站点目录结构：

1  ▸ archetypes/
2  ▸ content/
3  ▸ layouts/
4  ▸ static/
5    config.toml

创建文章

创建一个 about 页面：

1hugo new about.md

about.md 自动生成到了content/about.md，打开about.md看下：

1+++
2date = "2015-10-25T08:36:54-07:00"
3draft = true
4title = "about"
5
6+++
7
8正文内容

内容是Markdown格式的，+++之间的内容是 TOML 格式的，根据你的喜好，你可以换成 YAML 格式（使用 --- 标记）或者 JSON 格式。

创建第一篇文章，放到post目录，方便之后生成聚合页面。

1hugo new post/first.md

打开编辑post/first.md：

 1---
 2date: "2015-10-25T08:36:54-07:00"
 3title: "first"
 4 
 5---
 6
 7### Hello Hugo
 8
 9 1. aaa
10 1. bbb
11 1. ccc

安装皮肤

到 皮肤列表 挑选一个心仪的皮肤，比如你觉得 Hyde 皮肤不错，找到相关的 GitHub 地址，创建目录 themes，在 themes 目录里把皮肤 git clone 下来：

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

运行Hugo

在你的站点根目录执行 Hugo 命令进行调试：

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

（注明：v0.15 版本之后，不再需要使用 –watch 参数了）

浏览器里打开： http://localhost:1313

部署

假设你需要部署在 GitHub Pages 上，首先在GitHub上创建一个Repository，命名为：xzeu.github.io（xzeu替换为你的github用户名）。

在站点根目录执行 Hugo 命令生成最终页面：

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

（注意，以上命令并不会生成草稿页面，如果未生成任何文章，请去掉文章头部的 draft=true 再重新生成。）

如果一切顺利，所有静态页面都会生成到 public 目录，将pubilc目录里所有文件 push 到刚创建的Repository的 master 分支。

1$ cd public
2$ git init
3$ git remote add origin https://github.com/xzeu/xzeu.github.io.git
4$ git add -A
5$ git commit -m "first commit"
6$ git push -u origin master

浏览器里访问：http://xzeu.github.io/