部署及托管

转载自： http://www.xuebuyuan.com/651322.html 假设你需要部署在 GitHub Pages 上，首先在GitHub上创建一个Repository， 命名为：sunduoze.github.io （sunduoze替换为你的github用户名）。

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

hugo --theme=hugo-theme --baseUrl="http://sunduoze.github.io/"

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

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

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

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

撤销push

git revert <SHA> 哈希值 7位

使用github托管代码

提交

git remote add xxx https://github.com/sunduoze/sunduoze.github.io.git
git push -u xxx master

如里有报错误：

git push -f 

ERROR: Total 2332669 (delta 1949888), reused 2330461 (delta 1949349)
fatal: The remote end hung up unexpectedly

git config http.postBuffer 524288000

ok.

### 克隆代码

git clone git@github..com:用户名/项目名.git

<br/>
<br/>
**将Hugo官方的所有主题模板都下载下来**

git clone –recursive https://github.com/spf13/hugoThemes themes

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

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

<br/>
## **Start**


Hello Hugo

Hugo官方主页：https://gohugo.io/

Hugo的安装方式有两种，一种是直接下载编译好的Hugo二进制文件。如果只是使用Hugo推荐用这种方式。另一种方式是获取Hugo的源码，自己编译。由于各种不可预料的网络问题，第二种方式不是那么轻易能成功，虽然最后我还是折腾出来了。

Hugo二进制下载地址：https://github.com/spf13/hugo/releases

下载下来后，只有一个叫hugo或者hugo.exe的程序，接下来开始生成自己的站点：

hugo new site /path/to/site

然后hugo会自动生成这样一个目录结构：
<br/>
▸ archetypes/
	▸ content/
    ▸ layouts/
    ▸ static/
        config.toml
<br/>
简要介绍一下，config.toml是网站的配置文件，这是一个TOML文件，全称是Tom’s Obvious, Minimal Language，这是它的作者GitHub联合创始人Tom Preston-Werner 觉得YAML不够优雅，捣鼓出来的一个新格式。如果你不喜欢这种格式，你可以将config.toml替换为YAML格式的config.yaml，或者 json格式的config.json。hugo都支持。

content目录里放的是你写的markdown文章，layouts目录里放的是网站的模板文件，static目录里放的是一些图片、css、js等资源。

### 创建一个页面：

hugo new about.md

如果是博客日志，最好将md文件放在content的post目录里。

hugo new post/first.md

执行完后，会在content/post目录自动生成一个MarkDown格式的first.md文件：

+++ date = “2015-01-08T08:36:54-07:00” draft = true title = “first” +++ +++可以替换为Jekyll一样的—，里面的内容是这篇文章的一些信息。下面就可以开始写你的文章内容，比如：

+++ date = “2015-01-08T08:36:54-07:00” draft = true title = “first” +++ ### Hello Hugo 1. aaa 1. bbb 1. ccc OK，刚才的about.md也有内容，该看看最后的效果了。然后你屁颠屁颠的使用hugo server启动，打开浏览器里一看，发现毛都没有！这是肿么了！

这是Hugo对初学者非常不友好的地方，默认生成的网站是没有任何皮肤模板的。为了看看第一个写的示例，还得去Github上把一个网页模板下载下来。如果你网络够好，网速够快，你可以在刚才的目录将Hugo官方的所有模板都下载下来：

git clone –recursive https://github.com/spf13/hugoThemes themes

我尝试过，也失败过，且从未成功一次性将所有的模板下载下来。所以，我们还是老老实实只下载其中一个模板来看看效果吧：

cd themes $ git clone https://github.com/spf13/hyde.git

启动本地调试：

hugo server –theme=hyde –buildDrafts –watch ``` 浏览器里打开：http://127.0.0.1:1313

HugoFirstPost

–watch或者-w 选项打开的话，将会监控到文章的改动从而自动去刷新浏览器，不需要自己手工去刷新浏览器，非常方便。 官方文档：https://gohugo.io/overview/introduction/ 皮肤列表：https://github.com/spf13/hugoThemes

常用文档：

Configuring Hugo：https://gohugo.io/overview/configuration/ Front Matter：https://gohugo.io/content/front-matter/ Menus：https://gohugo.io/extras/menus/ Template Variables：https://gohugo.io/templates/variables/ Hosting on GitHub Pages：https://gohugo.io/tutorials/github-pages-blog/