基于 Github pages + Hexo 搭建个人博客

发表于 更新于 本文字数： 1.4k 阅读时长 ≈ 3 分钟

为什么要搭建个人博客？

做学习笔记这件事情在我身上发生过很多次变化。最早追溯到大一开始用ipad进行无纸化学习，写下了几乎所有本科课程的笔记。大四时候读论文，为了让Windows端和Ipad端的Endnote论文笔记同步，开始用markdown记录一些随心所得。研究生之后接触到了神级的笔记软件Obsidian，加上用电脑敲代码的时间越来越多，经常随手就在Obsidian里记下了小知识点以及ideas。就这样，现在在我的本地电脑上已经形成了一个庞大的知识图谱体系，甚至于我有时能用Obsidian取代浏览器搜索一些遗忘的小知识点。

随着本地碎片化的知识体系越来越多，我生出了搭建个人博客的想法，权当有处地方记录我的读论文笔记。第一篇就记录一下搭建博客的经历和踩过的坑吧。

以下内容均在Windows上进行。

前置工作

  1. 本地安装git以及nodejs。
  2. 本地仓库部署Hexo环境。首先创建一个空文件夹，我命令为Blog，它就是博客站点的根目录。在根目录执行以下命令：
1
2
3
4
5
cd Blog #进入根目录
npm install -g hexo-cli #安装Hexo
hexo init #初始化Hexo框架
npm install #安装相关依赖包
hexo s #启动Hexo服务

没问题的话执行hexo s（等同hexo server）即可在本地浏览器访问localhost:4000看到默认站点了。

配置主题

我选择了Github上Hexo使用人数最多的Next主题。

将Next主题相关文件克隆到themes文件夹中git clone git@github.com:next-theme/hexo-theme-next.git themes/next。接着在根目录的配置文件_config.yml中修改参数theme: next，即可。

按需按照官方文档配置个人信息、主题美化之类。

借助Github Pages部署

  • Github新建仓库，仓库名称必须是<username>.github.io

  • 执行命令npm install hexo-deployer-git --save以安装deploy-git

  • 接着修改站点配置文件_config.yml的deploy部分为：

1
2
3
4
deploy:
  type: git
  repo: https://github.com/YourgithubName/YourgithubName.github.io.git
  branch: master
  • 执行命令即可在<username>.github.io链接上看到博客了。
1
2
3
hexo clean
hexo g
hexo d

其实插件deployer-git的作用就是把站点的public文件夹push到了远端仓库，可以手动设置。

写文章

有两种方式

  1. 根目录执行hexo new <title>，在/source/_posts/下创建名为title的空markdown文件
  2. 在/source/_posts/下新建md文件，然后在开头部分写下：
1
2
3
---
title: xxx
---

Reference