一、什么是hexo

hexo是一个个人博客网站的创建和管理工具,关于hexo可以看官网:https://hexo.io/zh-cn

二、从零开始搭建hexo

2.1 安装npm

我们需要使用nodejs的npm工具来安装hexo,下载地址:http://nodejs.cn/download

Windows系统选择.msi的64位版本,一路点Next安装即可。安装完后打开cmd命令行工具,输入npm -v看看是否有输出版本号,有的话说明安装成功。另外由于国内使用npm比较慢,可以在cmd输入以下命令切换国内源加快速度:

npm config set registry https://registry.npmmirror.com

2.2 用npm安装hexo

cmd命令:

npm install -g hexo

同样输入hexo -v查看是否有版本号输出来确定是否安装成功

2.3 生成hexo模板

在电脑上新建一个文件夹,用来存放所有博客文档,然后打开cmd,使用cd命令移动到这个文件夹内,例如:

cd C:\Users\95744\Documents\Blog

Blog是我用来存放所有博客文档的空文件夹,然后再执行初始化命令:

hexo init

等待hexo模板生成后,输入以下命令就可以在浏览器中预览了:

hexo s

预览地址:http://localhost:4000

顺便加了篇文章

可以按ctrl+c关闭预览(cmd里ctrl+c是中断操作,并不是复制)

三、托管到Github上

第二章的内容完成了本地浏览博客的功能,为了能远程访问博客,可以选择托管到Github页面上

3.1 新建仓库

首先需要创建一个GitHub仓库,仓库名称为:你的用户名.github.io

访问权限需要选择public,不能用private,否则无法访问(如果要private还能访问的话需要买商业版的Github)

3.2 安装Git

Git工具可以方便提交个人博客的代码到Github上,下载地址:https://git-scm.com

安装时一路点Next即可,安装完后会有新的右键菜单可以选择

我们选择Open Git Bash here可以打开Git的命令窗口

3.3 生成SSH密钥,链接Github

Git需要一串名为SSH的密码来链接你的Github,以方便提交你的个人博客。在Git命令窗口中,输入命令:

ssh-keygen -t rsa -C "你的邮箱"

然后一路按回车完成邮箱设置并生成密钥,接着输入以下命令查看生成的密钥是什么:

cat ~/.ssh/id_rsa.pub

选中输出的一整串密码,右键选择Copy(或者按快捷键ctrl+insert,并不能用ctrl+c快捷键复制)

然后打开你的Github,点击你的头像,选择Settings,选择SSH and GPG keys,点击New SSH key按钮新增密钥

Title一栏随便填,Key一栏把刚刚Git命令窗口里面生成的一整串密码粘贴进去,然后点Add SSH key完成密钥的添加

完成添加后,还需要在Git命令窗口中输入绑定命令:

ssh -T git@github.com

回车,然后输入yes确认绑定,绑定成功会收到Github的邮件提醒

最后设置一下Git的用户名和邮箱

git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"

3.4 最终提交

我们需要一个提交工具,输入命令:

npm install -g hexo-deployer-git

然后在博客文件夹中,有一个_config.yml配置文件,用文本编辑器打开后找到最后的deploy一栏,填入以下信息并保存:

deploy:
  type: git
  repo: git@github.com:你的用户名/你的用户名.github.io.git
  branch: main

完成配置后,在命令行中可以用hexo g来生成最终的网页文件,然后用hexo d来把生成的网页文件最终提交到Github页面上。提交进度可以在Github仓库上看到,右侧的Deployments就是你的网页提交情况了

在完成提交后,可以在浏览器中打开你的网页进行查看,网页链接:https://你的用户名.github.io

(注意,刚刚提交的内容不会那么快就显示出来,可以多等几分钟再刷新页面看看)

四、hexo的使用

4.1 添加文章

hexo的文章都放在/source/_posts文件夹内,文章是markdown格式,可以使用typora这个markdown文档编辑器来方便写文章,typora下载地址:https://typoraio.cn

添加文章的方式就是简单的新建.md后缀的文件就行,文章标题填在最上面,用三个减号括起来(可以使用typora的源代码模式编写)

4.2 文章添加图片

/source文件夹内,新建一个不带前下划线的文件夹,名称随意,我这边用/source/img,把需要用到的图片都放在里面

然后在typora中插入图片,写这样的代码:

![](/img/图片名称)

例如:

![](/img/how-to-create-a-blog-with-hexo-006.png)

写完后,可以用命令hexo s,就可以在浏览器中打开链接查看图片了:http://localhost:4000

4.3 修改博客皮肤

可以去hexo的皮肤列表中下载,有些皮肤可能需要折腾一下配置:https://hexo.io/themes