第一步:安装hugo

brew install hugo

检查是否安装好

hugo version

第二步:创建站点

hugo new site my-blog

第三步:添加主题

不添加主题在本地跑,啥都看不到。

主题可以从themes.gohugo.io上找自己喜欢的,有很多漂亮的主题。

安装和配置主题需要看主题页面的安装指南。

下面我们按官方文档的,简单安装一个主题。

cd quickstart;\
git init;\
git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke;\

# Edit your config.toml configuration file
# and add the Ananke theme.
echo 'theme = "ananke"' >> config.toml

第四步:添加内容

可以使用命令添加

hugo new posts/my-first-post.md

也可以直接在项目文件夹的content/posts/下直接新建markdown文件。

通过命令创建的markdown文件默认是草稿

---
title: "My First Post"
date: 2017-11-29T17:21:47+08:00
draft: true

发布时记得将draft改为false否则生成的静态文件将没有草稿

但是本地跑的时候没事

运行

hugo server -D

就可以在http://localhost:1313/看到效果

第五步:在github创建项目

在github 创建一个项目

我创建的是 https://github.com/huayun321/hugo.git

第六步:部署本地站点到github

本地的站点git项目添加远程地址

git remote add origin https://github.com/huayun321/hugo.git

将publishDir = “docs”添加到配置文件config.toml

echo publishDir = '"docs"' >> config.toml

生成静态文件

hugo

会将生成的静态文件放到docs目录

将项目推送到git hub

git add * 

git commit -am "init"

然后回到github 所创建的项目页面 在setting -> GitHub Pages -> source

将none改为 master branch / docs folder

然后就完成了

然后访问 https://huayun321.github.io/hugo 会发现 样式没有出来

将本地public文件夹下的静态文件 复制到docs文件夹下再推一下就可以了

注意 如果创建的项目与你的github昵称重名,则不能选择source