图记创建博客的过程

以前用的是 Spring boot 创建的博客，现在转 Golang 这么久了，想换个与之相关技术的，于是乎有了这个 hugo 创建的博客

开始

下载安装包, 写此篇文章时版本为 0.81

解压缩后放入 /usr/bin 文件夹

创建博客

1
2
3


hugo new site blog       
git init && git add .
git commit -m "create blog"

添加主题，首次创建可以使用该主题下的例子，将 exampleSite 文件夹下的 config.yaml ， content，plugins 拷贝到 blog 目录

1
2
3
4
5


git submodule add https://github.com/CaiJimmy/hugo-theme-stack ./themes/hugo-theme-stack

cd ./themes/hugo-theme-stack/exampleSite
rm LICENSE README.md
mv * ../../../

回到 blog 目录，commit 代码后，创建服务器查看博客

1
2
3
4


git add .
git commit -m "add theme"

hugo server 

部署到公网

这里部署到 Github

创建仓库，仓库名必须以 github.io 结尾

创建好仓库，回到项目，执行命令创建 html 页面

1

hugo

项目文件夹中自动创建了 public 文件夹，存放着博客的静态文件，将此文件夹推送到刚刚创建的仓库

1
2
3
4
5
6


cd public
git init
git add .
git commit -m "blog"
git remote add origin 仓库地址
git push -u origin master

回到远程仓库，选择菜单栏中的 settings ，页面翻到底部

如何自定义域名?

在域名控制面板，比如我在 xxx 买的域名，就登录 xxx 官方，后台控制页面，选择域名解析。

记录类型为 CNAME ，我使用二级域名 blog.golang.space，记录值填写博客仓库名.

进入博客目录，创建 CNAME 文件，写入自定义域名，将修改推送到远程

1
2
3
4
5
6


cd public
echo "blog.golang.space" > CNAME

git add .
git commit -m "add cname"
git push

创建自动化脚本

若是每次写了新博文，都要 hugo 推送等等一堆命令, 是很麻烦的。

在 blog 目录下创建一个自动化脚本。

1

vim Makefile

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


build:
	rm -rf ./docs
	./hugo -d docs >> build.log
	@cp ./googlec03aeb90afb546ce.html ./docs
	@echo "blog.golang.space" > ./docs/CNAME
	@echo -e "打包完成"
	
push:
	git add .
	git commit -m $(m) >> build.log
	@echo "正在发送到服务器..."
	git push
	@echo "OK"

执行

1

make build push m=初始化博客

添加评论功能

Github 安装 utterances ，配置时我仅仅选择博客存储仓库.

服务端配置完成后，在网站配置中填写仓库地址，保存文件后执行自动化脚本推送，再次打开博文拉到底部已经有评论面板啦。

1
2
3
4


cd blog
vim config.yaml
# 修改并保存文件后
./auto.sh

创建自己的博文

删除 项目/content/post 下的所有内容，将自己的 markdown 文件复制进来

所有的文件顶部需要加上以下内容

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


---
title: 											{显示在网站内的标题及网址尾部的文件名}
description: 								{描述}
date: 											{创建日期}
slug: 											{文件夹/文件 路径, 会显示在网址中}
image: 											{封面图}
categories:    
    - 杂记   								 {分类}
---


# 正文