+++
Categories = ["tool",]
Tags = ["tool","Hugo",]
date = "2014-06-21T00:12:23+08:00"
title = "Hugo 静态网站快速生成"
+++
安装
如果说速度快是Hugo的第一大优点，那么安装简单应该就是Hugo的第二大优点。对于Mac用户，没有brew的话先安装brew，在命令行里敲：
$ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
然后再敲一行安装Hugo:
$ brew new Hugo
你也可以直接下载对应系统的binary文件，解压就行了:下载地址
建站
首先建立自己的网站，mysite是网站的路径
$ hugo new site mysite
然后进入该路径
$ cd mysite
在该目录下你可以看到以下几个目录和config.toml文件
▸ archetypes/
▸ content/
▸ layouts/
▸ static/
config.toml
config.toml是网站的配置文件，包括baseurl, title, copyright等等网站参数。
这几个文件夹的作用分别是：
- archetypes：包括内容类型，在创建新内容时自动生成内容的配置
- content：包括网站内容，全部使用markdown格式（/post）
- layouts：包括了网站的模版，决定内容如何呈现
- static：包括了css, js, fonts, media等，决定网站的外观
Hugo提供了一些完整的主题可以使用，下载这些主题：
$ git clone --recursive https://github.com/spf13/hugoThemes themes
此时现成的主题存放在themes/文件夹中。
现在我们先熟悉一下Hugo，创建新页面：
$ hugo new about.md
进入content/文件夹可以看到，此时多了一个markdown格式的文件about.md，打开文件可以看到时间和文件名等信息已经自动加到文件开头，包括创建时间，页面名，是否为草稿等。
---
+++
date = "2015-02-01T18:19:54+08:00"
draft = true
title = "about"
+++
contents here
我在页面中加入了主题，然后运行Hugo:
$ hugo server -t hyde --buildDrafts
-t参数的意思是使用hyde主题渲染我们的页面，注意到about.md目前是作为草稿，即draft参数设置为true，运行Hugo时要加上--buildDrafts参数才会生成被标记为草稿的页面。 在浏览器输入localhost:1313，就可以看到我们刚刚创建的页面。
注意观察当前目录下多了一个文件夹public/，这里面是Hugo生成的整个静态网站，如果使用Github pages来作为博客的Host，你只需要将public/里的文件上传就可以，这相当于是Hugo的输出。
评论功能
Hugo默认支持Disqus的评论，需要在模版中添加以下代码：
{{ template "_internal/disqus.html" . }}
spf13在/layouts/partials/disqus.html中已经添加好了。
只需要去Disqus注册一个账号，然后在config.toml里加上：
disqusShortname = "yourdisqusShortname"
插入图片
图片文件放在static/media文件中，插入图片：
{{ % img src="/media/example.jpg" alt="example" %}}
注意这里的{{和%之间也加上了空格，避免这行代码起作用，实际使用也需要把空格去掉。
