Mac环境下使用Hugo搭建github博客

第一步：安装hugo

mac环境下用homebrew工具安装hugo，一句命令即可

1

$ brew install hugo

第二步：生成站点

利用 hugo 生成站点，(比如生成在myblog目录下)执行如下命令

1

$ hugo new site myblog

第三步：创建文章

创建的文章一般放在post下，方便之后聚合生成页面。

1

$ hugo new post/文章名称.md

文章内容为MarkDown格式，可用vim命令编辑，亦可以其他编辑器如Typora等编辑。

第四步：安装主题

去官网找喜欢的主题，本文以Tailwind Journal为例。

找到其github地址，将其克隆到Themes/目录下

1
2


$ cd Themes
$ git clone https://github.com/ianrodrigues/hugo-tailwind-journal.git

第五步：运行站点

在myblog目录下，执行一下命令

1

$ hugo server -t hugo-tailwind-journal —-buildDrafts

运行站点后，可以在本地测试 http://localhost:1313

第六步：部署到Github公网

1，首先在Github上创建一个仓库，这里⚠️注意仓库名称需要和Github用户名一致，并拼接上.github.io 后缀。

2，在站点根目录下，执行命令生成页面。

1

$ hugo --theme=hugo-tailwind-journal --baseUrl="https://zhangxiongfeiv.github.io" --buildDrafts

3, 执行完毕，会生成public文件夹，所有的静态页面存放在此。将public目录下所有文件push到刚刚创建Git仓库master目录下。

1
2
3
4
5
6


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

第七步: 使用sh脚本简化过程

(2020.7.5更新)

在编写博客过程中，发现在运行站点和部署到github公网时，每次都需要写一长串的各种配置。何不使用 sh脚本让部署过程变得简单呢？

所以就写了两个 sh脚本文件

local.sh 用来部署本地测试站点
1

hugo server -t even --buildDrafts

github.sh 用来部署到 github公网

1

hugo -t even --baseUrl="https://zhangxiongfeiv.github.io" --buildDrafts

这样就可以非常方便的部署站点
- 部署到本地和公网时，只需要轻松的执行对应的脚本就可以啦
  - sh local.sh
  - sh github.sh

Contents