XunselF's Blog.

使用hexo+github搭建个人博客

Word count: 1.3kReading time: 4 min
2020/12/07 Share

前言

下面的内容是我在第一次配置hexo时候写的,在今年又进行了一些修改。
没错,我又又配置了一次(因为重装系统记录没了),这次在配置hexo我又重新换了个主题,出现了一些小问题但是都可以解决。 好了,接下来进入正文吧。

配置hexo

之前做博客一直自己找模板自己弄,找到的一些模板有一些不合自己的心意,听说hexo很强大,就赶紧来试试了。教程我就随便在网上找了来看看,但是总觉得不是很全面,在配置的过程中经常遇到了一些问题需要自己重新查阅,为了让自己不用重新去查,我就将它记录起来。

安装git

这个就不用讲了,git的用处很大,在以后的工作中会经常使用,所以在我的电脑中就已经有它啦。

git下载地址

下面这个就是教程啦,我觉得git很实用,所以在安装之后也顺便学学指令吧

廖雪峰的git教程

安装Node

Node.js是一个Javascript运行环境(runtime),发布于2009年5月,由Ryan Dahl开发,实质是对Chrome V8引擎进行了封装。Node.js对一些特殊用例进行优化,提供替代的API,使得V8在非浏览器环境下运行得更好。

Node.Js下载地址安装成功后,你需要查看下你的环境变量path是否已经配置好了Node.Js,如果已经配置好,输入以下指令可查看Node版本

1
node -v

安装hexo

首先,你需要创建一个文件夹用于存放你的blog博客
在创建后,进入该文件夹
输入安装hexo命令:

1
npm i -g hexo

然后输入命令查看hexo版本

1
hexo -v

初始化命令:

1
hexo init

这时候会发现所存放的博客文件夹里出现了以下几个文件:

node_modules:是依赖包

public:存放的是生成的页面

scaffolds:命令生成文章等的模板

source:用命令创建的各种文章

themes:主题

_config.yml:整个博客的配置

db.json:source解析所得到的

package.json:项目所需模块项目的配置信息

创建github项目

github就是存放你个人博客的一个远程仓库,当然他不只可以存放你的博客,包括你所开发的项目等等,都可以放在github。 github有多重要呢,其实相当于程序员的简历。 如果没有账号的话就快去申请一个吧。

当你有账号之后,就创建一个项目。 将项目命名为:yourname(你的名称).github.io 只有这样改才可以使用。

需要配置SSH key才可以将博客上传到github

首先生成密钥,输入命令后按三次回车确定:

1
ssh-keygen -t rsa -C "xunself@hotmail.com"

获取生成的密钥文件id_rsa.pub,Windows位置在C:\Users\用户.ssh。

访问网址,添加刚刚生成的SSH key

测试是否配置成功,可通过以下命令

1
ssh -T git@github.com

如果出现

Hi xxx! You’ve successfully authenticated, but GitHub does not provide shell access.

说明配置成功

使用hexo

打开你blog文件夹里面的_config.yml配置文件,
修改一下的代码:

1
2
3
4
deploy:
type: git
repository: https://github.com/(用户名)/(用户名).github.io
branch: master

repository修改为你自己的github项目地址

执行git命令:

1
2
3
hexo clean
hexo g
hexo s

在浏览器输入 https://yourname(你的名称).github.io 既可以看到自己的博客啦

编写文章创建好了博客,当然是需要写篇文章啦

我们只需在git中输入命令:

1
hexo n "name"

文章已经自动在 source\ _posts 中生成

hexo文章中大多都是使用markdown语法进行编写因为markdown语法少,功能多,而且能兼容html

markdown语法说明

上传到Github

当我们编写完文章后我们应该如何提交到github呢

安装插件

1
npm install --save hexo-deployer-git

跟之前上传步骤一样,这次我们只需使用两个命令:

1
2
hexo g
hexo d

在无弹出错误的情况下,该文章已经自动上传到github

备份与恢复

为了防止我下次重装电脑导致博客文件丢失,我打算备份下我的博客配置文件。

首先在博客文件下初始化git

1
git init

创建并切换分支,并添加远程仓库

1
2
git checkout -b hexo
git remote add origin https://github.com/用户名/用户名.github.io.git

提交到远程仓库即可完成备份

1
2
3
git add .
git commit -m "备份hexo"
git push origin hexo

总结

总体配置就是这样,在其中所遇到的一些问题也很多,不过都解决了。自己在做的时候慢慢理解hexo的原理:首先hexo自身整体框架,在使用命令hexo clean清除缓存,再通过hexo generate命令去调用hexo本身的配置文件,识别所要使用的hexo主题,生成html代码,这样一个网站就生成啦

我希望把这个博客作为自己的一个笔记,用来记录生活与学习

CATALOG
  1. 1. 前言
  2. 2. 配置hexo
  3. 3. 安装git
  4. 4. 安装Node
  5. 5. 安装hexo
  6. 6. 创建github项目
  7. 7. 使用hexo
  8. 8. 上传到Github
  9. 9. 备份与恢复
  10. 10. 总结