GitHub部署hexo博客

环境配置

搭建hexo首先需要有nodejs的环境，可以从官网直接下载。

需要安装git

查看版本信息确认配置环境

1
2
node -v # 查看node版本信息
npm -v # 查看npm版本信息

安装git

安装之前可以先安装一下淘宝的镜像源，这样以后安装其他东西会快一点

1
npm install -g cnpm --registry=https://registry.npm.taobao.org

安装hexo

1
npm install hexo-cli -g

创建博客文件夹

  • blog：可以任意取名
1
hexo init blog

然后进入blog

1
cd blog

安装npm

1
npm install

开启hexo服务

1
hexo server

就可以正常访问了

安装码云的上传插件

1
npm install hexo-deployer-git --save

gitee配置sshkey

打开.ssh路径下的id_rsa.pub

将密钥复制到gitee

打开仓库管理-初始化

可以看到有了pages服务，点进去

目前gitee的pages服务已停止

github配置sshKey

首先在桌面右键打开git bash here

1
ssh-keygen -t rsa -C "邮箱地址"

敲击三次回车

在C:\Users\用户名.ssh下找到id_rsa.pub文件并将内容复制

打开GitHub，右上角找到Settings，点击SSH and GPG keys，New ssh key，title随便起名字，key内容粘贴进去完后保存Add ssh key

打开git bash here输入

1
ssh -T git@github.com

输入yes可以看到连通是否成功

配置hexo

找到合适的存放hexo文件位置

在当前的文件下右键git bash here

1
npm install hexo-cli -g

创建博客文件夹

  • blog：可以任意取名
1
hexo init blog

然后进入blog

1
cd blog

安装npm

1
npm install

开启hexo服务

1
hexo server

就可以正常访问了

  • hexo cl清除缓存
  • hexo g生成
  • hexo s本地部署
  • ctrl+c停止本地服务器

首先打开博客文件夹中config滑动到底部将type””替换成

1
2
3
type: git
repository:
branch: main

回到github仓库点code复制链接粘贴到repository后面保存退出

接着hexo cl;hexo g生成

hexo d部署线上

如果不行前面加上npx

因为第一次执行需要配置邮箱

复制上面git config –global user.email “邮箱.com”

到下面执行

配置完成后再次hexo d执行

在弹出的GitHub窗口页面进行登录,点击Sign in with your browser跳转浏览器进行登录

hexo d命令报错

ERROR Deployer not found: git

则是缺少插件

我已经在站点配置文件中写入了：

1
2
3
4
deploy:
  type: git
  repo: # Github pages地址
  branch: master

但是执行hexo d仍然报错

1
ERROR Deployer not found: git

解决方案：

这是因为没安装hexo-deployer-git插件，在站点目录下输入下面的插件安装就好了：

1
npm install hexo-deployer-git --save

然后在使用Hexo d命令就可以推送了。

使用文档

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
参数 解释
title 【必需】页面标题
date 【必需】页面创建日期
type 【必需】标签、分类和友情链接三个页面需要配置
updated 【可选】页面更新日期
description 【可选】页面描述
keywords 【可选】页面关键词
comments 【可选】显示页面评论模块 （默认 true）
top_img 【可选】页面顶部图片
mathjax 【可选】显示 mathjax （当设置 mathjax 的 per_page： false 时，才需要配置，默认 false）
katex 【可选】显示 katex （当设置 katex 的 per_page： false 时，才需要配置，默认 false）
aside 【可选】显示侧边栏 （默认 true）
aplayer 【可选】在需要的页面加载 aplayer 的 js 和 css，请参考文章下面的 配置音樂
highlight_shrink 【可选】配置代码框是否展开 （true/false） （默认为设置中 highlight_shrink 的配置）
random 【可选】配置友情链接是否随机排序（默认为 false）
limit 【可选】配置说显示数量
limit.type 【可选】配置说显示数量的类型 （date 或者 num）
limit.value 【可选】配置说显示数量的值

常用指令

1
2
3
4
5
hexo new "postName"        //新建文章
hexo new page "pageName"        //新建页面
hexo g          //生成静态页面至public目录
hexo server         //开启预览访问端口（默认端口4000，'ctrl + c'关闭server）
hexo deploy         //将.deploy目录部署到GitHub

常用组合

1
2
3
4
5
hexo clean
hexo g
hexo d
hexo d -g #生成部署
hexo s -g #生成预览

新建文章

1
hexo new "xxx"

名为xxx.md的文件会建在目录.../blog/source/_posts下。所有的文章都会以md形式保存在_post文件夹中，只要在_post文件夹中新建md类型的文档，就能在执hexo g的时候被渲染。新建的文章头需要添加一些信息，如下所示：

主题配置

Butterfly 文檔(三) 主題配置 | Butterfly