首先需要一个GitHub账号,没有的话就需要自己注册。

怎么注册的就不赘述了,在注册完成后前往hexo-template的仓库。

点击Use this template,选择Create a new repository,接着就到下一个界面。

在Repository name一栏里填入”[你的用户名].github.io(推荐这样做,其实不这样也行)”。

然后就可以点击Creating repository from template了,接下来稍作等待,就可以看见一个仓库已经被创建了。

接下来点击Setting,找到Actions一栏下的General

把读写权限打开,大概设置为如图所示

然后回到你自己复制过来的仓库的code页面,找到_config.yml这个文件

点击右上角的编辑按钮,进入编辑模式,然后将title设置为你想使用的网站的主标题,subtitle为你网站的副标题(可以不设置),author设置为你想使用的默认文章作者名(也就是博客主人),language设置为zh-CN,CN一定要大写,url处改成”https://[你的用户名].github.io

最后翻到最下面的root: /hexo-template,将其删除即可保存

最后去settings的pages页面,在branch处选择gh-pages分支(刚改完可能会没有,耐心等会儿然后刷新就行了),save之后,稍等几分钟即可在上方看见被发布的网站了,至此,基础的hexo框架已经搭建完成。

如果你成功了,点击visit site应该会看到类似如下的界面


接下来就是对接主题,让你的博客更好看更易用,此处以butterfly为例

首先回到你的仓库,点击<>code,创建一个新的codespaces。

接着去butterfly的仓库复制config

回到刚刚创建的codespaces的根目录下新建一个_config.butterfly.yml,然后再把刚刚复制的butterfly的仓库里的config粘贴进去

按Ctrl+~呼出终端,使用npm命令安装butterfly

1
npm install hexo-theme-butterfly

在_config.yml里找到theme,改成butterfly

最后,点击旁边代码管理提交并同步(每次更改都需要这样做一次才会生效,但是内容可以随便填)即可使用butterfly主题了

安装hexo-cli以使用hexo命令

1
npm install hexo-cli -g

本文章非专业性教程,作者本人也是纯纯萌新,如有失误还请轻喷

本文章资料来源于

HEXO博客框架:https://hexo.io/zh-cn/docs/configuration.html

Butterfly主题:https://butterfly.js.org/posts/21cfbf15/

剩下的内容基本可以靠上方butterfly提供的文档自主学习使用,本教程到此结束


提供几个可能你用得到的命令:

生成静态页面文件

1
hexo generate

生成新文章

1
hexo new [Blog name]

本地调试服务

1
hexo Server

清除缓存和生成的静态页面

1
hexo clear