hexo官网：https://hexo.io/zh-cn/

butterfly 主题设置：https://butterfly.js.org/

GitHub地址：https://github.com/jerryc127/hexo-theme-butterfly

基础命令

• 初始化博客命令：hexo init “文件名”

• 开启本地服务（本地运行）的命令：hexo s

• 生成页面（生成博客）： hexo g

• 创建文章（md形式）：hexo n “文章名字”

• 清理缓存：hexo clean

• 依赖安装：npm install

• 新建文章：hexo n “文章名”

发布顺序

1. 先清理缓存：hexo clean

2. 再重新生成博客页面：hexo g

3. 预览：hexo serve

4. 上传到GitHub创库：hexo d

Hexo+Github搭建个人博客

前言

• 完全免费的搭建个人博客，没有任何收费，零基础小白也能上手，不需要编程基础，跟着操作来即可。

• 首先要了解一下我们搭建博客要用到的框架。Hexo是高效的静态站点生成框架，它基于Node.js。通过Hexo，你可以直接使用Markdown语法来撰写博客。相信很多小伙伴写工程都写过README.md文件吧，对，就是这个格式的！写完后只需两三条命令即可将生成的网页上传到你的github上，然后别人就可以看到你的网页啦。是不是很简单？你无需关心网页源代码的具体细节，你只需要用心写好你的博客内容就行。

Hexo环境准备

• 【2021版本】保姆级Hexo+Github搭建个人博客步骤

​ 单纯搭建发布视频讲解地址：https://www.bilibili.com/video/BV1mU4y1j72n?t=2.5&vd_source=71e92a1364cbcaf80125baa05f89bc60
​ 详细视频讲解：https://www.bilibili.com/video/BV1oU4y1n7hn/?spm_id_from=pageDriver&vd_source=91c74d407fc476374430aea2a76f7aca

Node.js安装

https://www.cnblogs.com/liuqiyun/p/8133904.html

Git安装

• 安装步骤参考以下步骤
  https://www.cnblogs.com/xueweisuoyong/p/11914045.html

Vscode安装

• 后面涉及到代码的修改，建议大家使用 Vscode 软件

• 安装链接： 「VSCodeUserSetup-x64-1.65.0.exe」 https://pan.quark.cn/s/f64b7413660c 提取码：7eMQ

• 本文软件需要用到的操作说明：

• 打开终端，本文用到的命令都是在终端里面输入命令+回车的

• ctrl + f 查找内容的快捷键，因为配置文件的代码太多了，需要用到这个快捷键，然后在搜索框输入要搜索的内容，就能实现快速查找

Typroa

• 用于写文章

• Markdown介绍

Github

• github访问加速

  「fastgithub_win版-x64.zip」 链接：https://pan.quark.cn/s/4c170f5763d2 提取码：sFNj

​ 其余版本建议访问： https://github.com/dotnetcore/FastGithub

• 注册Github账号

​ 接下来就去注册一个github账号，用来存放我们的网站，注册、使用教程 CSDN自己搜，这里就不提供了

• 搭建仓库

​ 打开https://github.com/，新建一个项目

• 然后如下图所示，输入自己的项目名字，后面一定要加.github.io后缀，README初始化可选可不选。名称一定要和你的github名字完全一样，比如你github名字叫**abc**，那么仓库名字一定要是**abc.github.io**。 最后选择Create 创建，项目就建成功了

Hexo搭建

一定要保证前面的步骤成功后，在执行该章节后面的步骤

安装Hexo

• 在你的电脑上任意位置，新建一个文件夹，用来存放自己的博客文件，比如我的博客存放位置D:\boke\blog目录下。

• 在该根目录下，鼠标右击，选择Git Bash Here，打开git的控制台窗口，输入npm i hexo-cli -g安装Hexo。会有几个报错，无视它就行。

• 安装完成后，验证是否安装成功，该窗口输入hexo -v验证是否安装成功。

生成ssh keys

• 在任意文件夹位置，鼠标右击，选择Git Bash Here，输入 ssh 检查有没有安装ssh

• 生成ssh命令：

ssh-keygen -t rsa -C "2927527234@qq.com"

• 总共需要敲四次回车。

• 找到 id_rsa.pub 文件，并打开复制里面所有的代码，大致路径： c盘----->用户------>管理员名称-------->.ssh文件夹下

​ 或者

• git bash中输入cat ~/.ssh/id_rsa.pub下命令，将输出的内容复制到框中，点击确定保存。

• 打开github，在头像下面点击settings，在新出的导航栏，找到 ssh，点击后，在新的页面点击 ssh keys 的新建钥匙，新建钥匙的 title（名称）随意起名，如：blog，将 id_rsa.pub 文件复制的公钥，粘贴到 key 里面，保存。

• 测试ssh是否绑定成功命令： ssh -T git@github.com

本地博客生成

• 初始化博客命令：hexo init

• 开启本地服务的命令：hexo s

• 然后浏览器打开http://localhost:4000/，就可以看到我们的博客啦，按ctrl+c关闭本地服务器。

• 具体效果如下：

发布博客到互联网

建议先将网站美化了，然后在用此步骤发布到互联网上

• 修改-config.yml文件

• 将改配置文件最后的 deploy 部分完善，type和 branch 是固定不变的，repository修改为你的 github 地址 ， 注意：注意网址前面，冒号后面有一个空格

deploy:type: 'git'repository: '刚刚新建的GitHub仓库地址，完整地址复制到这里'branch: main

• 你的github地址：在github找到你之前新建的仓库，然后找到仓库地址，复制仓库地址，将我的地址替换为你的即可。

• 修改好配置文件后，在你的博客文件夹下git bash，将本地文件上传到github里面，根据以下命令，一步一步的走即可：

​ 安装 hexo-deployer-git 自动部署发布工具： npm install hexo-deployer-git --save

​

• 生成页面： hexo g

• 然后输入下面命令，用户名和邮箱根据你注册github的信息自行修改。

git config --global user.name "kongshier"
git config --global user.email "2927527234@qq.com"

• 本地文件上传到Github上面：hexo d

• 如果出现这个界面关掉即可

• 然后会出现一个登录界面，输入 GitHub 账号，千万别输错了，要不然有得重来

• 到下面输入密码这一步，先暂缓一下，先创建一个令牌，然后将创建的令牌复制粘贴进去就行【记住不要输入密码，需要将你的令牌输入进去，而不是密码】

• 设置令牌步骤：

​ setting--------->developer settings（开发者设置）---------> 后续步骤按照下方图片操作

• 然后新建令牌，有效期30天，为令牌赋权限，建议把所有选项都选上，然后生成令牌

• 将生成的令牌输入到密码那个对话框，一定要将这个令牌，拍照等方式保存好，后面在去找这个令牌它就不显示了

• 上传到github后，就可以用仓库名称访问你的网址

hexo 博客版本控制（git版本控制）

在有的时候代码可能会丢失，代码有些错误，这种时候我们可以通过版本控制，来回退我们的版本，从而保证我们的代码不会丢失。

如果没有git基础的有些地方不理解的，可以先去看下git 几十分钟搞定，当然按照我的步骤一步一步来，没有任何问题！！！

• 打开github 新建一个仓库，新建完成后不要关掉这个界面

• 新建文件 .gitignore，这个文件的作用就是帮我们过滤掉不需上传到仓库的文件,注意文件位置：根目录下

• 代码内容如下：

.DS_Store
Thumbs.db
db.json
*.log
node_modules/
public/
.deploy*/
.vscode/
/.idea/
.deploy_git*/
.idea
themes/butterfly/.git

• 终端输入，生成仓库命令 ： git init

• 建好仓库后，将仓库推送到远程上面去
  在建立github仓库时，有怎么推送到仓库的说明，只需要将代码按照说明步骤一步一步复制，终端输入即可

• 重要代码说明，其余没有强调的按照文档说明复制就行

上传 GitHub

把本地的上传到 GitHub 仓库

git init
git add .
git commit -m "注解"
git branch -M main
git remote rm origin  # 首次不用执行这个
git remote add origin https://github.com/kongshier/Myblog.git
git push -u origin main

git add .													 将代码提交到暂存区
git commit -m "feat：初始化仓库"			提交到本地

如果你clone下来一个别人的仓库，在此基础上完成你的代码，推送到自己的仓库可能遇到如下问题：
error: remote origin already exists.表示远程仓库已存在。
因此你要进行以下操作：
1、先输入git remote rm origin 删除关联的origin的远程库
2、关联自己的仓库 git remote add origin https://github.com/kongshier/blog.git
3、最后git push origin master，这样就推送到自己的仓库了。

• 当你仓库有内容时完成将代码推送到远程分支上面，后面就算你更换设备，都可以将代码从远程克隆下来

• 克隆步骤

git clone 仓库地址
切换到你下载好的文件目录
npm install												这是安装依赖

拉取远程仓库

git clone <repositories>  # 拉取默认分支git clone -b <branch> <repositories> 拉取远程仓库中指定的分支

以HTTPS方式拉取 一般都是这个克隆

git clone https://github.com/kongshier/blog.git

以SSH方式拉取仓库

git clone 《git@gitee.com:holyking/test-2.git 这个是需要拉取仓库的SSH》

下载到本地后执行以下

• 安装依赖：npm install

• 再重新生成博客页面：hexo g

• 预览：hexo serve

• 上传到GitHub创库：hexo d

博客文件夹的介绍

• _config.yml：俗称站点配置文件，很多与博客网站的格式、内容相关的设置都需要在里面改。

• node_modules:存储Hexo插件的文件，可以实现各种扩展功能。一般不需要管。

• package.json：别问我，我也不知道干嘛的。

• scaffolds：模板文件夹，里面的post.md文件可以设置每一篇博客的模板。具体用起来就知道能干嘛了。

• source：非常重要。所有的个人文件都在里面！

• themes：主题文件夹，可以从Hexo主题官网或者网上大神的Github主页下载各种各样美观的主题，让自己的网站变得逼格高端的关键！

接下来重点介绍source文件夹。新建的博客中，source文件夹下默认只有一个子文件夹——_posts。我们写的博客都放在这个子文件夹里面。我们还可以在source里面新建各种子文件夹满足自己的个性化需求，对初学者而言，我们先把精力放在主线任务上，然后再来搞这些细节。

• _config.yml 文件详解

• 严格注意缩进，缩进不对也会报错，所以这里不推荐使用记事本，使用 Vscode 编辑器

• title部分：
  

• url ：只用配置第一行，其余的都不用动，更换为你的远程地址就可以了

• 文件夹的设置，这些东西都不用管，默认即可
  

• 首页的设置，用默认的就好了
  

• 预设的分类，uncategorized 意思是未分类，先不用管用默认的就好
  

• 日期的显示格式：用默认的就好了
  

• 分页的设置：默认是一页10行数据，数据修改随意

网址的美化

• 下面的这个个性化设置主要针对的是matery主题

​ 主题的原地址在这里：hexo-theme-matery，它的文档写得也非常的详细，还有中英文两个版本，按照文档教程安装一遍主题，然后是可以正常打开的，如果你是一般使用的话，基本没啥问题了。

• butterfly官方主题配置教程
  https://butterfly.js.org/posts/21cfbf15/
  Ps：根据帮助文档，一步一步来即可，两个主题选择一个配置安装即可，原理相同
  我这里选择的是 butterfly，butterfly官方文档地址： https://butterfly.js.org/posts/21cfbf15

butterfly主题安装详细步骤

PS：

• 使用vscode软件进行文件的修改，直接将整个文件拖进该软件即可

• 这后面的章节其实就是带大家看帮助文档，然后一些 bug 的处理，建议大家看不懂文档的结合我这篇文章理解

butterfly的安装

• 使用npm 的方式，在vscode终端安装

npm update hexo-theme-butterfly  # 更新主题

• 修改配置文件
  

• 在终端 清理缓存 hexo clean，然后我这里报错了

​ 解决办法：

​ 在自己对应的”nodejs“文件夹下的“node_global" 下找到对应的“指令名.ps1"删除掉，然后再运行对应的指令即可

• hexo s 运行，将网址在浏览器粘贴，最终效果如下

​

1. 其余的主题的安装方式和这一样，不管安装什么都要先看帮助文档。然后记得用 hexo clean 清理缓存后在运行

更多主题

1、fluid ：https://github.com/fluid-dev/hexo-theme-fluid

2、Volantis：https://github.com/volantis-x/hexo-theme-volantis

3、next ：https://github.com/iissnan/hexo-theme-next/

4、nexmoe：https://github.com/theme-nexmoe/hexo-theme-nexmoe

5、butterfly：https://github.com/jerryc127/hexo-theme-butterfly

6、bamboo：https://github.com/yuang01/hexo-theme-bamboo

主题页面

说明：

• 这一部分和上一部分没什么区别，就是看帮助文档，然后输入对应的命令，如果没有强调的话，就按照帮助文档的命令敲就行，重要的地方会阐明以下！！！

• 后面的内容就是看帮助文档，一定要按照帮助文档划分的步骤来，就比如说主页配置，等这一项弄完了然后在弄下一项，后面章节我会挑重要的部分说一下

• 鉴于每个人的根目录名称都不一样，本帖博客根目录一律以 [Blog] 指代。

• 请读者优先掌握 Butterfly 主题官方文档 的内容后再来进行魔改。以避免不必要的兼容性问题。

主页基本信息修改

1. 先将主页的基本信息进行完善，就是 包含 title 的部分，前面已经详细说过，这里就不详细讲述了
   

博客关键页面生成

博客有一些关键页面需要手动生成。

标签页

进入 Hexo 博客的根目录，执行：

hexo new page tags

打开 source/tags/index.md 文件，修改如下：

---
title: 标签
date: 2022-08-03 12:53:45
type: "tags"
---

分类页

进入 Hexo 博客的根目录，执行：

hexo new page categories

打开 source/categories/index.md 文件，修改如下：

---
title: 分类
date: 2022-03-11 12:56:06
type: "categories"
---

友情链接

创建友情链接页面

进入 Hexo 博客的根目录，执行：

hexo new page link

打开 source/link/index.md 文件，修改如下：

---
title: 友情链接
date: 2022-03-11 12:57:48
type: "link"
---

友情链接添加

在Hexo博客目录中的 source/friends/创建一个文件lndex.md`

---
title: friends
date: 2022-08-03 08:18:23
type: "friends"
layout: "friends"
---# 友链交换
想要交换友链的小伙伴，欢迎在留言板留言，留言格式：
* **名称：**你的博客名称
* **地址：**你的博客地址
* **简介：**一句话简介
* **头像：**你的头像地址例如我的博客友链，大家可以加到自己博客里哦：
* **名称：**十二
* **地址：**https://kongshier.github.io/
* **简介：**无处不在
* **头像：**头像地址

• 预览效果如下，就表示成功了，然后直接跳到帮助文档的404页面

关于我

进入 Hexo 博客的根目录，执行：

hexo new page about

打开 source/about-me/index.md 文件，修改如下：

---
title: 关于作者
date: 2022-03-11 13:01:21
type: "about"
---

• 说明：

​ 重点：所有的文件都在source，这个文件夹下，按照官方文档提示，修改文件即可！

• 修改完成后，通过路由本地预览一下好了没，要养成习惯，完成一步，预览一步！！！！

​ 路由格式：http://localhost:4000/ tags

​ tags 其实就是对应的你要实现功能的名称，需要预览什么 功能，就修改成对应的功能名称

• 预览效果如下，就表示成功了，然后直接跳到帮助文档的404页面

404 页面添加

• 找到：node_modules------------>hexo-theme-butterfly------------>_config.yml

• 将文件里面的内容全部复制，执行图下面的操作，然后将所有代码粘贴到新建的文件里，这个文件就是我们主题配置的文件

• 找到error 404 ，将帮助内容置换即可、

主页背景更改

方式一：

更改其图标、主页背景等部分内容，在主题的配置文件下

• 更改背景的话建议使用占位图（就是将本地图片上传到图床）
  

• 更改主页 主题背景的时候，如果要使用本地图片记得创建文件夹 img ，将图片放进此文文件，复制其路径，粘贴到对应位置，然后在注意一下本地图片的格式即可， .表示当前路径

• 留意: 如果你的网站根目录不是/,使用本地图片时，需加上你的根目录。
  例如：网站是https://yoursite.com/blog,引用一张img/xx.png图片，则设置background为 url(/blog/img/xx.png)
  方式二（通过数据文件的方式）：
  在 source/_data/style.styl 文件中添加：（如果没有这个路径的话添加即可）

// 背景
body {background-image:url(../images/bg.webp);height:100%;width:100%;background-repeat:repeat-x;background-attachment:fixed;background-size:cover;
}//设置透明度
//侧边框的透明度设置
.sidebar-inner {background: rgba(255,255,255,0.8);
}//菜单栏的透明度设置
.header-inner {background: rgba(255,255,255,0.8);
}//搜索框（local-search）的透明度设置
.popup {opacity: 0.8;
}

background-image 就是你的背景图啦。

主题配置（一）

前面章节带大家看了一下文档，当然官方文档还有很多，这里就不罗列了，希望大家掌握方法，仔细阅读文档，重要的我会在这强调

这里只强调几点：

• 官方文档，可能格式没有设置，需要自己调整一下缩进

• 每新增一个功能最好本地预览下，成功了在执行后面的

• 为了以后大家配置方便，最好配置一下package.json

"server": "hexo clean && hexo generate && hexo server"
修改第九行，这行代码可以省去每次都要清理，然后生成静态页面，这个步骤，
然后每次运行的时候也可以不用去输入命令行，可以找到这行代码然后点击 server 运行即可

• 都开始主题配置了，大多数修改的文件都是_ config.butterfly.yml 这个文件

导航栏的说明：

• 注意：

• 圆圈是你要在 source 文件夹下建立的文件夹，名称相同，然后在新建的文件夹下，新建index.md 文件

• 方框的内容是自己随意更改的

• 注意一下文档的缩进

• 详解：

• 分类 是指标签栏的名称

• / 内容 / 是指路径，source文件夹下----->categories文件夹下----->i ndex.md 文件【自动去匹配】

• fas fa-home 是图标

• 导航栏的修改（注意二级的格式）

menu:主页: / || fas fa-home时间线: /archives/ || fas fa-archive标签: /tags/ || fas fa-tags分类: /categories/ || fas fa-folder-open链接||fas fa-list:友链: /link/ || fas fa-link关于: /about/ || fas fa-heart

顶部图

字数统计

BASH
cnpm install hexo-wordcount --save

修改主题配置文件：

YMLwordcount:enable: truepost_wordcount: truemin2read: truetotal_wordcount: true

如需调整右侧卡片网站信息内项目的数据，在文件/butterfly/layout/includes/widgets/card_webinfo.pug中操作。

目录折叠

由于我个人的目录比较大，完全展开三级目录的话，右边栏就完全被目录铺满了。butterfly主题提供了目录可折叠的选项，只需要在主题配置文件/butterfly/config.yml设置：

card_categories: enable: truelimit: 0 # if set 0 will show allexpand: true # none/true/falsesort_order: # Don't modify the setting unless you know how it works

主题配置（二）

重点看下我提的内容，其余想加的可以自己看下文档，然后添加上即可

• 评论系统 （我目前使用来必力，但是我觉得没必要，为了给你们演示下，后期应该会关掉，毕竟也没多少人看我的文章）

• 搜索系统

• 直接点 本地搜素 ------> hexo-algoliasearch 然后看帮助文档，按照文档步骤一步一步操作即可

• 打开终端 使用命令：npm install hexo-algoliasearch --save，安装需要的插件

• 项目的根目录 _config.yml 配置文件下，将如下我修改过的代码复制到文件末尾（官方给的那个有 坑 ）。

search:path: search.xmlfield: postformat: htmllimit: 10000

• 看下 _config.butterfly.yml 文件的 local_search 有没有打开，打开了就预览一下效果,有搜索框了就欧克了！！

• 页面美化

• 根据官方文档和我修改的beautifly，在结合你的喜好，修改一下就好了

beautify:enable: truefield: post # site/posttitle-prefix-icon: # '\f0c1'title-prefix-icon-color: # '#F47466'

• 网站的副标题，根据自己的喜好调试即可，附上我的样式

• 设置主页面高度，根据自己的喜好设置即可

• 字数统计
  根据文档自己设置一下

• prefetch (預加載)、pangu、pjax，将这些服务开启。（false改为true即可）

进阶文档

PS:

• 这部分根据自己喜好，看官方文档配置即可

• 魔改官方主题的尽头其实就是默认就好哈哈

• gulp压缩 【 这一部分 官方文档移除了 不用作用也不大 】
  随着网站的发展，你的文件会越来越多，安装这个插件，可以压缩代码，从而实现代码部分的优化,根据我的步骤一步一步操作即可
  配置了淘宝的镜像源所以使用 cnpm

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

安装gulp的cli：
cnpm install --global gulp-cli安装gulp本身工具：
cnpm install gulp -gcnpm install gulp-htmlclean --save-devcnpm install --save gulp-html-minifier-tersercnpm install gulp-clean-css --save-devcnpm install --save-dev gulp-uglifycnpm install --save-dev gulp-babel @babel/core @babel/preset-envcnpm install --save-dev gulp-imagemin

在根目录下，创建文件 gulpfile.js 文件（ 后面等我学习下在更，没有这块内容也没影响）

添加来必力评论系统

​ 我选择这个系统，是因为这个系统能过滤一些不友好的评论，当然也可以选择其它的，自己根据帮助文档配置下

​ 喜欢折腾，美观的就不建议这个评论系统了，建议 Twikoo

• 在主题配置文件找到 comments

  

• 注册来必力，然后登录，然后右上角管理页面，输入必要的信息，最后出现以下的界面，将对应的uid 输入配置文件即可

​

​ 粘贴的时候注意格式，只粘贴引号里面的内容，还有冒号后面有一个空格

• 在来必力系统进行一些必要的设置，比如：评论邮件提醒，选择登录方式等等

• 最后本地运行，随便找一篇文章，看效果即可

插入代码自定义样式

• 自定义代码的拆入方法

• 先找到 主题配置文件的 inject
  一般样式文件会放到 head 里面 ，js文件放在 bottom 里面

• 新建文件夹，按照箭头位置创建即可，名称随意

• 将新建的文件夹，引入到 inject 里面即可，然后运行项目即可

• 底部的样式修改（掌握方法后，直接去网上找一些别人改好的样式，复制粘贴即可）
  方法：直接F12然后找到你要修改的标签id，然后返回刚才那个建好的css文件，在里面添加css代码，修改对应的样式即可
  比如修改底部样式为透明

• 底部添加多个内容信息，并且点击跳转的说明：（有需要的自行了解一下）

​ 效果：

博客添加文章

• 首先在博客根目录下右键打开git bash，安装一个扩展npm i hexo-deployer-git。

• 然后输入 hexo new post “article title” ，新建一篇文章。

• 然后打开D:blog\source\_posts的目录，可以发现下面多了一个文件夹和一个.md文件，一个用来存放你的图片等数据，另一个就是你的文章文件啦。

• 编写完markdown文件后，根目录下输入hexo g生成静态网页，然后输入hexo s可以本地预览效果，最后输入hexo d上传到github上。这时打开你的github.io主页就能看到发布的文章啦。

hexo clean
hexo g
hexo s
hexo d

问题汇总

​ 这是我在操作过程中遇见的一些bug ，在这里汇总一下

1. 安装Hexo时遇见的报错
   

​ 解决办法：

​ 重新配置了下npm安装的全局模块所在的路径，以及缓存cache的路径，又检查了一下环境变量是否正确

设置全局模块命令：

npm config set prefix "D:\node\node_global"

设置cache模块命令

npm config set cache "D:\node\node_cache"

1. 上传到GitHub碰到 “ Deployer not found ” 问题

​ 解决办法：重新 deploy 即可。

npm install hexo-deployer-git --save

然后 hexo d 就能提交成功

总结

按照步骤本教程一个基本的网页就搭建出来了，后面就是对网页的美化和优化，如果想简洁一点的话直接看 hexo框架-文章篇 即可

其他博主的教程：

• 唐志远博主

• 糖果屋