1, 下载 hugo

打开官方release地址 ,根据当前操作系统类型下载和安装相应的 hugo 程序。本文以 Windows 10 操作系统为例。

2, 新建一个本地Website

$ hugo.exe new site blog

执行完该命令后,当前目录下回生成一个 blog 文件。

3, 新建一篇文章

创建一个 about 页面:

$ hugo.exe new content/posts/about.md

如果想要显示about内容,则需要删除生成 about.md 文件里的draft = true

4, 给网站添加一个Theme

本文以 beautifulhugo 主题为例,将 beautifulhugo 主题 clone 到 themes 目录下。

$ cd themes
$ git clone https://github.com/rootsongjc/beautifulhugo.git beautifulhugo

为了使 Theme 生效,需要修改 blog 目录下的 config.toml 文件的 theme 值。 本文设置为 theme = "beautifulhugo"

5, 本地预览Web效果

$ hugo.exe server

用本机浏览器里打开 http://localhost:1313 预览网页效果。

6, 生成静态网页

$ hugo.exe

执行完该命令后,在当前文件夹下会生成一个 public 目录,该目录包含了 Web 网站运行所需的文件,需要上传到 github pages 。

7, 上传到github

$ git push origin master

在 github 新建一个 Repository ,并在 Settings 里面设置好 GitHub Pages 的 branch 。然后将 public 目录下的所有文件上传到该 Repository 对应的 branch 。

主题

官方主题
ezhil

参考

零基础使用Hugo和GitHub Pages创建自己的博客
如何使用Hugo在GitHub Pages上搭建免费个人网站
使用Hugo搭建静态站点