基于macOS Catalina 10.15.7下GitHub Pages + Hexo 5.3.0 + 阿里云的博客部署

基于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. 域名解析（待补充