Hexo博客的搭建及Butterfly主题的应用。以及可能会遇到的问题

本页面写于2023年9月，此内容仅适用Hexo稳定版
截至目前Butterfly 已更新到 4.9.0

环境

以下内容皆默认电脑本地环境已安装好Git，Nodejs。如无安装请自行搜索。

安装Hexo

由于种种原因，国内安装镜像源会很慢，所以利用cnpm进行安装会比较快，所以本文用到的绝大部分为cnpm。
修改淘宝镜像的方法：

npm install -g cnpm --registry=https://registry.npm.taobao.org

以上修改完后就可以用cnpm了。

正文开始

在本地打开终端输入以下命令

1. npm install hexo-cli-g

创建Blog

2. hexo init daniel

此处我用的是 daniel ，可替换成你自己想要的名字 , 执行成功后, 会创建出一个名为 daniel 的文件夹

• [ ] 问题1：Failed to connect to github.com port 443 after…………..

• [x] 解决方法如下

1. 开启魔法
2. 不会魔法的同学请直接使用以下命令，然后将hexo-starter修改为喜欢的名字即可。

   git clone https://hub.fgit.cf/hexojs/hexo-starter.git

   
   当看到Reselving deltas：100%….done. 说明克隆成功。
   紧接着需要进入到danie文件夹进行下一步操作。

   3. cd danie
   
   4. cnpm install

   
   以上步骤成功后再输入hexo s
   
   按照提示打开 http://localhost:4000 即可看到一个初始化博客搭建成功。
   

为照顾部分不会魔法的同学，下面直接将Github的源链接替换为镜像地址。

安裝Butterfly主题

在你的 Hexo 根目录输入

git clone -b master https://hub.fgit.cf/jerryc127/hexo-theme-butterfly.git themes/butterfly

应用主題

修改 Hexo 根目录下的 _config.yml，把主題改為 butterfly

安装插件

如果你没有 pug 以及 stylus 的渲染器，请下载安装：

cnpm install hexo-renderer-pug hexo-renderer-stylus --save

完成以上步骤后输入hexo clean && hexo g
如果有如下提示那么说明你已经成功了，可以直接跳转至这里。

如果有如下类似的提示

• [ ] 问题2：Cannot load module ‘hexo-util’
• [x] 解决方法如下

  cnpm install hexo-util --save

  

现在重新输入hexo clean && hexo g就会看到如下页面

紧接着输入hexo s

再次按照提示打开 http://localhost:4000 即可看到Butterfly主题的Hexo博客。