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

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

上一篇:Linux下以16进制的形式查看二进制文件


下一篇:浅谈Linux下进程相关属性和fork()函数