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 "文章名"
发布顺序
-
先清理缓存:hexo clean
-
再重新生成博客页面:hexo g
-
预览:hexo serve
-
上传到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
Node.js安装
plain
https://www.cnblogs.com/liuqiyun/p/8133904.html
Git安装
Vscode安装
-
后面涉及到代码的修改,建议大家使用 Vscode 软件
-
安装链接: 「VSCodeUserSetup-x64-1.65.0.exe」 https://pan.quark.cn/s/f64b7413660c 提取码:7eMQ
-
本文软件需要用到的操作说明:
-
打开终端,本文用到的命令都是在终端里面输入命令+回车的
-
ctrl + f 查找内容的快捷键,因为配置文件的代码太多了,需要用到这个快捷键,然后在搜索框输入要搜索的内容,就能实现快速查找
Typroa
-
用于写文章
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命令:
plain
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
-
具体效果如下:
发布博客到互联网
建议先将网站美化了,然后在用此步骤发布到互联网上
- 修改-config.yml文件
- 将改配置文件最后的 deploy 部分完善,type和 branch 是固定不变的,repository修改为你的 github 地址 , 注意:注意网址前面,冒号后面有一个空格
plain
deploy:
type: 'git'
repository: '刚刚新建的GitHub仓库地址,完整地址复制到这里'
branch: main
- 你的github地址:在github找到你之前新建的仓库,然后找到仓库地址,复制仓库地址,将我的地址替换为你的即可。
- 修改好配置文件后,在你的博客文件夹下git bash,将本地文件上传到github里面,根据以下命令,一步一步的走即可:
安装 hexo-deployer-git
自动部署发布工具: npm install hexo-deployer-git --save
- 生成页面:
hexo g
- 然后输入下面命令,用户名和邮箱根据你注册github的信息自行修改。
bash
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,这个文件的作用就是帮我们过滤掉不需上传到仓库的文件,注意文件位置:根目录下
-
代码内容如下:
plain
.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
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
plain
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,这样就推送到自己的仓库了。
-
当你仓库有内容时完成将代码推送到远程分支上面,后面就算你更换设备,都可以将代码从远程克隆下来
-
克隆步骤
plain
git clone 仓库地址
切换到你下载好的文件目录
npm install 这是安装依赖
拉取远程仓库
git
git clone <repositories> # 拉取默认分支
git clone -b <branch> <repositories> 拉取远程仓库中指定的分支
以HTTPS方式拉取 一般都是这个克隆
plain
git clone https://github.com/kongshier/blog.git
以SSH方式拉取仓库
plain
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终端安装
plain
npm update hexo-theme-butterfly # 更新主题
-
修改配置文件
-
在终端 清理缓存 hexo clean,然后我这里报错了
解决办法:
在自己对应的"nodejs"文件夹下的"node_global" 下找到对应的"指令名.ps1"删除掉,然后再运行对应的指令即可
- hexo s 运行,将网址在浏览器粘贴,最终效果如下
- 其余的主题的安装方式和这一样,不管安装什么都要先看帮助文档。然后记得用
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 主题官方文档 的内容后再来进行魔改。以避免不必要的兼容性问题。
主页基本信息修改
- 先将主页的基本信息进行完善,就是 包含 title 的部分,前面已经详细说过,这里就不详细讲述了
博客关键页面生成
博客有一些关键页面需要手动生成。
标签页
进入 Hexo 博客的根目录,执行:
plain
hexo new page tags
打开 source/tags/index.md
文件,修改如下:
plain
---
title: 标签
date: 2022-08-03 12:53:45
type: "tags"
---
分类页
进入 Hexo 博客的根目录,执行:
plain
hexo new page categories
打开 source/categories/index.md 文件
,修改如下:
plain
---
title: 分类
date: 2022-03-11 12:56:06
type: "categories"
---
友情链接
创建友情链接页面
进入 Hexo 博客的根目录,执行:
plain
hexo new page link
打开 source/link/index.md
文件,修改如下:
plain
---
title: 友情链接
date: 2022-03-11 12:57:48
type: "link"
---
友情链接添加
在Hexo博客目录中的 source/friends/创建一个文件
lndex.md`
plain
---
title: friends
date: 2022-08-03 08:18:23
type: "friends"
layout: "friends"
---
# 友链交换
想要交换友链的小伙伴,欢迎在留言板留言,留言格式:
* **名称:**你的博客名称
* **地址:**你的博客地址
* **简介:**一句话简介
* **头像:**你的头像地址
例如我的博客友链,大家可以加到自己博客里哦:
* **名称:**十二
* **地址:**https://kongshier.github.io/
* **简介:**无处不在
* **头像:**头像地址
- 预览效果如下,就表示成功了,然后直接跳到帮助文档的404页面
关于我
进入 Hexo 博客的根目录,执行:
plain
hexo new page about
打开 source/about-me/index.md
文件,修改如下:
plain
---
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 文件中添加:(如果没有这个路径的话添加即可)
plain
// 背景
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
plain
"server": "hexo clean && hexo generate && hexo server"
修改第九行,这行代码可以省去每次都要清理,然后生成静态页面,这个步骤,
然后每次运行的时候也可以不用去输入命令行,可以找到这行代码然后点击 server 运行即可
- 都开始主题配置了,大多数修改的文件都是_ config.butterfly.yml 这个文件
导航栏的说明:
-
注意:
-
圆圈是你要在 source 文件夹下建立的文件夹,名称相同,然后在新建的文件夹下,新建index.md 文件
-
方框的内容是自己随意更改的
-
注意一下文档的缩进
-
详解:
-
分类 是指标签栏的名称
-
/ 内容 / 是指路径,source文件夹下----->categories文件夹下----->i ndex.md 文件【自动去匹配】
-
fas fa-home 是图标
- 导航栏的修改(注意二级的格式)
plain
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
顶部图
字数统计
plain
BASH
cnpm install hexo-wordcount --save
修改主题配置文件:
plain
YMLwordcount:
enable: true
post_wordcount: true
min2read: true
total_wordcount: true
如需调整右侧卡片网站信息内项目的数据,在文件/butterfly/layout/includes/widgets/card_webinfo.pug
中操作。
目录折叠
由于我个人的目录比较大,完全展开三级目录的话,右边栏就完全被目录铺满了。butterfly
主题提供了目录可折叠的选项,只需要在主题配置文件/butterfly/config.yml
设置:
yaml
card_categories:
enable: true
limit: 0 # if set 0 will show all
expand: true # none/true/false
sort_order: # Don't modify the setting unless you know how it works
主题配置(二)
重点看下我提的内容,其余想加的可以自己看下文档,然后添加上即可
-
评论系统 (我目前使用来必力,但是我觉得没必要,为了给你们演示下,后期应该会关掉,毕竟也没多少人看我的文章)
-
搜索系统
-
直接点 本地搜素 ------> hexo-algoliasearch 然后看帮助文档,按照文档步骤一步一步操作即可
-
打开终端 使用命令:
npm install hexo-algoliasearch --save
,安装需要的插件 -
项目的根目录 _config.yml 配置文件下,将如下我修改过的代码复制到文件末尾(官方给的那个有 坑 )。
plain
search:
path: search.xml
field: post
format: html
limit: 10000
- 看下 _config.butterfly.yml 文件的 local_search 有没有打开,打开了就预览一下效果,有搜索框了就欧克了!!
-
页面美化
-
根据官方文档和我修改的beautifly,在结合你的喜好,修改一下就好了
plain
beautify:
enable: true
field: post # site/post
title-prefix-icon: # '\f0c1'
title-prefix-icon-color: # '#F47466'
- 网站的副标题,根据自己的喜好调试即可,附上我的样式
- 设置主页面高度,根据自己的喜好设置即可
-
字数统计
根据文档自己设置一下
-
prefetch (預加載)、pangu、pjax,将这些服务开启。(false改为true即可)
进阶文档
PS:
-
这部分根据自己喜好,看官方文档配置即可
-
魔改官方主题的尽头其实就是默认就好哈哈
-
gulp压缩 【 这一部分 官方文档移除了 不用作用也不大 】
随着网站的发展,你的文件会越来越多,安装这个插件,可以压缩代码,从而实现代码部分的优化,根据我的步骤一步一步操作即可
配置了淘宝的镜像源所以使用 cnpm
bash
npm install -g cnpm --registry=https://registry.npm.taobao.org
plain
安装gulp的cli:
cnpm install --global gulp-cli
安装gulp本身工具:
cnpm install gulp -g
cnpm install gulp-htmlclean --save-dev
cnpm install --save gulp-html-minifier-terser
cnpm install gulp-clean-css --save-dev
cnpm install --save-dev gulp-uglify
cnpm install --save-dev gulp-babel @babel/core @babel/preset-env
cnpm 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主页就能看到发布的文章啦。
plain
hexo clean
hexo g
hexo s
hexo d
问题汇总
这是我在操作过程中遇见的一些bug ,在这里汇总一下
- 安装Hexo时遇见的报错
解决办法:
重新配置了下npm安装的全局模块所在的路径,以及缓存cache的路径,又检查了一下环境变量是否正确
设置全局模块命令:
plain
npm config set prefix "D:\node\node_global"
设置cache模块命令
plain
npm config set cache "D:\node\node_cache"
- 上传到GitHub碰到 " Deployer not found " 问题
解决办法:重新 deploy 即可。
plain
npm install hexo-deployer-git --save
然后 hexo d 就能提交成功
总结
按照步骤本教程一个基本的网页就搭建出来了,后面就是对网页的美化和优化,如果想简洁一点的话直接看 hexo框架-文章篇 即可
其他博主的教程: