基于macOS Catalina 10.15.7的GitHub Pages + Hexo 5.3.0 + 阿里云博客部署
0. 参考博客
http://forsweet.github.io/hexo/用Hexo搭建Github博客/
1. 前置安装
1. git安装
可以选择homebrew
2. nodejs安装
https://nodejs.org/en/ 官网直接下载LTS的pkg安装包,也可以用homebrew,暂时没有发现问题。
注意下载完后最好不要随便更改prefix和cache的路径。
2. Hexo安装
命令行直接输入
npm install -g hexo-cli
如果显示permission denied, access之类的报错需要在最前面加sudo。
如果命令行输入hexo显示command not found:首先命令行输入which node查看node的路径,如果安装目录下没有hexo说明hexo装错位置了。找到hexo的路径后命令行输入vi ~/.zshrc,添加export PATH=$PATH:xxxx,其中xxxx就是hexo的路径,然后esc退出insert模式,再依次输入:wq保存退出,最后命令行输入source ~/.zshrc。
在Hexo3以上的版本中,hexo-server独立安装:
先cd到hexo-cli的安装路径(默认是/usr/local/lib/node_modules),然后:
npm install hexo-server --save
同时独立出来的还包括类似hexo-deployer-git等模块,其影响后面的部署,因此要手动安装:
npm install hexo-generator-index --save
npm install hexo-generator-archive --save
npm install hexo-generator-category --save
npm install hexo-generator-tag --save
npm install hexo-server --save
npm install hexo-deployer-git --save
npm install hexo-renderer-marked@0.2 --save
npm install hexo-renderer-stylus@0.2 --save
npm install hexo-generator-feed@1 --save
npm install hexo-generator-sitemap@1 --save
如上若显示
npm WARN checkPermissions Missing write access to /usr/local/lib/node_modules
npm ERR! code EACCES
npm ERR! syscall access
...
也都需要加上sudo。
由于最新版(截至2021.2.9)的hexo-deployer-git有一些问题,后续需要调整,这里暂且先装上。
3. Hexo部署
安装完成后先建一个文件夹Blog,然后:
$ hexo init <folder>
$ cd <folder>
$ npm install
之后生成静态文档
$ hexo generate
开启本地server调试
$ hexo server
打开localhost:4000就可以看到生成的默认页面。
4. 上传GitHub
首先在GitHub上新建一个repo,名字一定要是用户名.github.io,branch需要是main(可以创建项目的时候把readme勾选上)。
然后进入Blog文件夹,找到_config.yml这个文件,打开拖到最下面,按照如下填写
deploy:
type: git
repo: https://github.com/Lipoicyclic/Lipoicyclic.github.io.git
branch: main
注意冒号后面要有空格,repo的地址后面要加上git,保存退出。
此时理论上要回到 Blog 文件夹中,打开 Git Bash,安装Git部署插件,输入命令:
npm install hexo-deployer-git --save
但是由于最近(2021.2.8)出现的一些问题,没法将博客部署到github(参考请问在hexo deploy的时候无法成功部署该怎么解决? - StandingGroup的回答 - 知乎 https://www.zhihu.com/question/443345975/answer/1722933331)
解决方法是进入Blog文件夹,输入:
npm un hexo-deployer-git
npm i hexojs/hexo-deployer-git
即卸载原来的 deployer ,直接从 main分支安装 hexo-deployer-git 。
然后依次输入
hexo clean
hexo g
hexo d
之后浏览器输入https://GitHub用户名.github.io就能看到初始博客界面了。
5. 域名解析(待补充
基于macOS Catalina 10.15.7下GitHub Pages + Hexo 5.3.0 + 阿里云的博客部署