Hexo学习记录
本节主要参考以下网站,大概写了我主要操作的一些步骤
主要学习参考:
1、https://hexo.io/zh-cn/docs/ hexo官方中文网站
2、https://www.lixint.me/hexo-theme-diy.html 学习参考前人经验,文章写得非常好,推荐。
一、hexo安装并创建运行第一个页面
1、修改git用户名为博客的用户名
2、建立网站跟目录,并安装hexo
进入根目录,并执行以下代码
npm install -g hexo-cli
3、建立hexo自己的博客目录,hexo init
-
hexo init 失败
-
hexo init 成功
3、cd 到项目目录
4、npm install
5、npm_audit_fix
6、生成一个静态页面
hexo g
7、启动服务器
hexo s
8、访问本地服务器
二、本地博客发布为github page
1、进入博客目录,执行以下命令,安装发布的软件
不是根目录,否则部署会报错误。
npm install hexo-deployer-git --save
2、生成ssh的rsa密钥
参考:
1、https://git-scm.com/book/zh/v1/服务器上的-Git-生成-SSH-公钥、
2、ssh-keygen的使用方法以及参数
指令:
ssh-keygen -t rsa -C "邮箱地址"
然后一直回车
3、进入到C:\Users\用户名
,文件夹内寻找.ssh
文件夹,并打开此文件夹
5、进入到github账户setting部分,选择SSH and GPG keys
并点击New SSH key
6、打开步骤4找到的id_ras.pub
文件,并把内容输入到Key
部分,并点击add SSH key
7、验证ssh,进入github bash界面,输入ssh -T git@github.com
,显示以下内容,表示成功
8、进入博客文件夹下,找到博客配置文件_config.yml,打开后根据下图进行修改
可参考:https://hexo.io/zh-cn/docs/configuration
在此配置文件下,查找deploy
并且进行配置
https://hexo.io/zh-cn/docs/deployment
9、生成静态页面hexo g
10、部署 hexo d
部署报错,ERROR Deployer not found: git
以下命令执行目录不正确
npm install hexo-deployer-git --save
需要重新再博客目录(hexo init 文件名)下面进行重新执行以上命令,完成后,再执行hexo d
11、部署完成后,进入https://xiao-bai-yuan.github.io/ 进行验证。
12、映射域名访问返回404。
hexo d部署完之后,发现 https://xiao-bai-yuan.github.io 可以正常访问,但是映射域名访问返回404。经过定位,发现github pages的仓库目录下面的CNAME不见了。
原因以及解决方法:
因为hexo部署会把之前目录下面的文件给清除掉,所以CNAME会被清除掉。
如果有不想被清除的资源,那么就可以放在 source目录下面,这样hexo部署的时候,会把source目录下的文件放到仓库的主目录下面,这样就可以正常使用了。
如下图:
把CNAME放到此目录下面,重新hexo g,会发现有CNAME生成
再进行hexo d,会发现仓库里面已经有了这个CNAME文件了
至此,域名以及github.io都可以正常访问我们的博客了。