使用hugo+GitHub pages搭建博客,使用tranquilpeak主题。

目录

为什么要搭建个人博客

以前一直没有养成写博客的好习惯,但近期逐渐发现学的知识不仅变得越来越广,还变得越来越深入,如果不及时进行相应的记录,往往会出现以前非常熟的知识,现在要用的时候已经不怎么记得了,但是由于缺少用于快速回顾的相关资料,要花费大量的时间重新学习。

这就体现出经常写博客的好处,一方面通过写博客可以帮助自己梳理刚刚学的知识,另一方面博客还可以在将来帮助你对相关知识进行高效的回顾、复习。

可以在第三方博客网站(csdn,cnblog,简书)写博客,也可以搭建自己的博客网站在上面写博客。由于本人觉得第三方博客网站广告太多,界面不够美观,不能定制,所以选择搭建自己的博客网站。

搭建个人博客方案选择

搭建博客网站可以完全自建也可以借助第三方框架,为了快速建立自己的个人博客,我选择借助第三方框架。现在主流的第三方框架主要有HugoHexojekyll,它们都可用来搭建静态博客网站(无后端)。Hugo相比其它的web框架具有使用方便、几乎无依赖、生成速度快的优点,而且Hugo是基于Go语言开发的,个人对其有一定的好感。

Hugo+github pages搭建个人博客初步

安装Hugo

windows环境:

这里下载相应的版本,并将.exe程序的路径添加到系统环境变量path

Linux环境:

使用命令安装即可

使用Hugo建立一个新的博客网站

hugo new site myblog

命令执行完后,会生成一个myblog文件夹,文件夹下包含config.toml、content、themes等文件或文件夹。

使用Hugo主题

这里找到自己喜欢的主题,里面也会有主题的下载方法和使用方法。一般情况下主题的下载方法如下:

cd themes
git clone https://github.com/kakawait/hugo-tranquilpeak-theme.git

然后可以在themes目录下找到相应的主题,找到exampleSite文件夹,将其中的文件(一般包括config.toml、content、static、layouts)复制到myblog主目录下,执行

hugo server -t hugo-tranquilpeak-theme --buildDrafts

若config.toml文件已经配置好,直接执行命令

hugo server

在本地通过访问localhost::1313查看主题效果。比较比较推荐的主题有,EvenLearntranquilpeak

写一篇博客

首先稍微熟悉下markdown语法,内容挺多,但掌握基本语法足以写出一篇普通的博客了。

然后还要学习一下,所使用的主题下markdown的一些特殊写法

最常见的写在最前面的

---
title: "博客搭建(1)"
date: 2019-12-12

categories:
- 博客搭建
tags:
- hugo
- blog
- github
- markdown
---

其中categories可以有两级目录但如果一级目录有中文的话会导致一个搜索的小bug,影响不是很大,注意一下就行。

<!--more-->    	//用于生成摘要
<!--toc-->		//用于生成目录

上面只介绍了几种基本的用法,其他更多有趣的用法可以看这里

将博客网站部署到github

新建一个仓库,仓库名一定要为

XXX.github.io

在myblog文件夹下,执行命令

hugo --themes hugo-tranquilpeak-theme --baseUrl="https://jameshzq.github.io" --buildDrafts

若config.toml已经配置好,直接执行命令

hugo

然后会生成public文件夹,在该文件下执行下列git命令

git init
git add .
git commit -m "new theme"
git remote add origin https://github.com/JamesHZQ/JamesHZQ.github.io.git
git push -f origin master

将博客网站部署到github,让后就可以通过https://jameshzq.github.io网址访问到自己的博客网站了。

推荐几个小工具

  • markdown编辑器:typora
  • 图床使用工具:PicGo

主要参考

https://www.bilibili.com/video/av51574688