使用hexo框架在github.io上搭建博客网站.
咕咕咕 fishing

安装相关软件

安装git

Git是一个开源的分布式版本控制系统,可以有效、高速地处理从很小到非常大的项目版本管理。也是Linus Torvalds为了帮助管理Linux内核开发而开发的一个开放源码的版本控制软件。
据说他开发git只花了两周时间,大佬不愧是大佬。
git官网
windows:到git官网上下载,下载后会有一个Git Bash的命令行工具,用这个工具就可以使用git了。
linux:因为开发git就是为了管理linux内核开发的,所以linux的非常简单,只需要下面这行代码

1
sudo apt-get install git

当然你像我一样使用IDE自动安装
安装完成后,可以使用git --version查看版本

安装nodejs

因为Hexo是基于nodeJS编写的,所以需要安装一下nodejs和里面的npm工具。
windows:到nodejs下载地址,选择LTS版本(稳定版本)就行了。
linux:使用以下命令

1
2
sudo apt-get install nodejs
sudo apt-get install npm

安装完后,使用node -vnpm -v 查看版本

安装hexo

可以参考官方文档,真的非常好用
所有必备的应用程序(git和nodejs)安装完成后,即可使用 npm 安装 Hexo。
全局安装

1
npm install -g hexo-cli

关于github pages

可以参考官方文档

创建github仓库

新建一个名字为username.github.io的仓库
仓库名必须为username.github.io,否则不会被github识别。其中username为github账户的用户名。

生成ssh添加到github(如果之前没有添加过的话)

在git bash中,配置账户信息

1
2
git config --global user.name "yourname"
git config --global user.email "youremail"

这里的yourname为GitHub用户名,youremail为GitHub的邮箱。不要瞎写,不然无法push到github

可以查看配置的信息。以防写错

1
2
git config user.name
git config user.email

然后创建SSH,一路回车。

1
ssh-keygen -t rsa -C "youremail"

创建完成后,会生成C:\Users\Username.ssh文件夹
.shh文件夹
其中id_rsa是生成的私钥,id_rsa.pub是生成的公钥。将id_rsa.pub用记事本打开,复制其内容,添加到github的设置中。
.githubSSHKey
添加完成后,在gitbash中查看是否添加成功

1
ssh -T git@github.com

成功会有 Hi username/username.github.io! You’ve successfully authenticated, but GitHub does not provide shell access. 这句话。

关于hexo

hexo的初始化

前面给的官方文档也包含了hexo的配置,以及命令等其他相关的功能。 所以这里就简单写一下。
执行下列命令,Hexo将会在当前目录的指定文件夹中新建所需要的文件,请确保指定文件夹为空。

1
2
3
hexo init <folder>
cd <folder>
npm install

新建完成后,指定文件夹下会生成一些文件,其中:
_config.yml——hexo的配置文件
package.json——应用程序信息
scaffolds——模板文件夹,创建文章时,会根据模板来创建
source——资源文件夹,写的markdown和图片资源什么的都在这
themes——主题文件夹,比如我在使用的butterfly主题就放在这

将hexo部署到GitHub

将hexo生成的文章部署到GitHub上
打开hexo配置文件 _config.yml,翻到最后,修改deploy
其中YourgithubName是你的GitHub账户,branch是分支,一般设置为main或者master

1
2
3
4
deploy:
type: git
repo: https://github.com/YourgithubName/YourgithubName.github.io.git
branch: master

修改完后,需要先安装deploy-git(部署的命令),这样才能用命令部署到GitHub。

1
npm install hexo-deployer-git --save

之后是hexo的部署命令

1
2
3
hexo clean
hexo generate
hexo deploy

其中 hexo clean 清除了你之前生成的东西。
hexo generate 生成静态文章,可以用 hexo g缩写
hexo deploy 部署文章,可以用hexo d缩写
hexo generate 和 hexo deploy 也可以合并写成 hexo g -d 或者 hexo d -g

出现 INFO Deploy done: git 时,说明部署成功了。
稍微等一会,便可以在 https://yourname.github.io 这个网站看到你的博客了,其中yourname是github的用户名。
刷新显示404,请不要着急。心急吃不了热豆腐

到这里,使用hexo在github.io上搭建博客网站就成功了。
就可以开始写博客了。
但,是不是有点单调。所以我们可以使用主题来装饰他,来实现更多的功能。 github官方建议你使用博客生成工具 Jekyll。

关于hexo的主题butterfly

可以参考官方安装文档

安装butterfly

在hexo的根目录里
github:

1
git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

gitee:

1
git clone -b master https://gitee.com/immyw/hexo-theme-butterfly.git themes/butterfly

应用主题

修改 Hexo 根目录下的 _config.yml,把主题改为butterfly

1
theme: butterfly

安裝插件

如果你沒有 pug 以及 stylus 的渲染器,請下載安裝:

1
npm install hexo-renderer-pug hexo-renderer-stylus --save

butterfly的相关配置

相关配置请看文档,有详细的解释。在此不作赘述。

可能会产生的错误

错误的原因可能很多,解决方法并不一定有用。在这里列出我碰到的问题。
因为github连接不稳定,所以要有耐心。

OpenSSL SSL_read: Connection was aborted, errno 10053

原因
Git默认限制推送的大小,运行命令更改限制大小
解决方法

1
git config --global http.postBuffer 524288000

Failed to connect to github.com port 443: Timed out

原因
代理的设置问题
解决方法:
进入项目目录中,使用命令行取消代理设置:

1
2
git config --global --unset http.proxy
git config --global --unset https.proxy
  • 本文标题:使用hexo框架在github.io上搭建博客网站.
  • 本文作者:咕咕咕
  • 创建时间:2022-03-12 13:54:21
  • 本文链接:https://cooooing.github.io/学习记录/使用hexo框架在github-io上搭建博客网站/
  • 版权声明:本博客所有文章除特别声明外,均采用 BY-NC-SA 许可协议。转载请注明出处!