赞
踩
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是高效的静态站点生成框架,它基于Node.js。通过Hexo,你可以直接使用Markdown语法来撰写博客。相信很多小伙伴写工程都写过README.md文件吧,对,就是这个格式的!写完后只需两三条命令即可将生成的网页上传到你的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
https://www.cnblogs.com/liuqiyun/p/8133904.html
后面涉及到代码的修改,建议大家使用 Vscode 软件
安装链接: 「VSCodeUserSetup-x64-1.65.0.exe」 https://pan.quark.cn/s/f64b7413660c 提取码:7eMQ
本文软件需要用到的操作说明:
打开终端,本文用到的命令都是在终端里面输入命令+回车的
ctrl + f 查找内容的快捷键,因为配置文件的代码太多了,需要用到这个快捷键,然后在搜索框输入要搜索的内容,就能实现快速查找
用于写文章
github访问加速
「fastgithub_win版-x64.zip」 链接:https://pan.quark.cn/s/4c170f5763d2 提取码:sFNj
其余版本建议访问: https://github.com/dotnetcore/FastGithub
接下来就去注册一个github账号,用来存放我们的网站,注册、使用教程 CSDN自己搜,这里就不提供了
打开https://github.com/,新建一个项目
.github.io
后缀,README初始化可选可不选。名称一定要和你的github名字完全一样,比如你github名字叫**abc**
,那么仓库名字一定要是**abc.github.io**
。 最后选择Create 创建,项目就建成功了一定要保证前面的步骤成功后,在执行该章节后面的步骤
在你的电脑上任意位置,新建一个文件夹,用来存放自己的博客文件,比如我的博客存放位置D:\boke\blog
目录下。
在该根目录下,鼠标右击,选择Git Bash Here
,打开git的控制台窗口,输入npm i hexo-cli -g
安装Hexo。会有几个报错,无视它就行。
安装完成后,验证是否安装成功,该窗口输入hexo -v
验证是否安装成功。
在任意文件夹位置,鼠标右击,选择Git Bash Here
,输入 ssh 检查有没有安装ssh
生成ssh命令:
ssh-keygen -t rsa -C "2927527234@qq.com"
或者
git bash中输入cat ~/.ssh/id_rsa.pub
下命令,将输出的内容复制到框中,点击确定保存。
打开github,在头像下面点击settings
,在新出的导航栏,找到 ssh,点击后,在新的页面点击 ssh keys 的新建钥匙,新建钥匙的 title(名称)随意起名,如:blog,将 id_rsa.pub 文件复制的公钥,粘贴到 key 里面,保存。
然后浏览器打开http://localhost:4000/,就可以看到我们的博客啦,按ctrl+c
关闭本地服务器。
具体效果如下:
建议先将网站美化了,然后在用此步骤发布到互联网上
deploy:
type: 'git'
repository: '刚刚新建的GitHub仓库地址,完整地址复制到这里'
branch: main
安装 hexo-deployer-git
自动部署发布工具: npm install hexo-deployer-git --save
hexo g
git config --global user.name "kongshier"
git config --global user.email "2927527234@qq.com"
本地文件上传到Github上面:hexo d
如果出现这个界面关掉即可
setting--------->developer settings(开发者设置)---------> 后续步骤按照下方图片操作
在有的时候代码可能会丢失,代码有些错误,这种时候我们可以通过版本控制,来回退我们的版本,从而保证我们的代码不会丢失。
如果没有git基础的有些地方不理解的,可以先去看下git 几十分钟搞定,当然按照我的步骤一步一步来,没有任何问题!!!
新建文件 .gitignore,这个文件的作用就是帮我们过滤掉不需上传到仓库的文件,注意文件位置:根目录下
代码内容如下:
.DS_Store
Thumbs.db
db.json
*.log
node_modules/
public/
.deploy*/
.vscode/
/.idea/
.deploy_git*/
.idea
themes/butterfly/.git
终端输入,生成仓库命令 : git init
建好仓库后,将仓库推送到远程上面去
在建立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,它的文档写得也非常的详细,还有中英文两个版本,按照文档教程安装一遍主题,然后是可以正常打开的,如果你是一般使用的话,基本没啥问题了。
PS:
使用vscode软件进行文件的修改,直接将整个文件拖进该软件即可
这后面的章节其实就是带大家看帮助文档,然后一些 bug 的处理,建议大家看不懂文档的结合我这篇文章理解
使用npm 的方式,在vscode终端安装
npm update hexo-theme-butterfly # 更新主题
修改配置文件
在终端 清理缓存 hexo clean,然后我这里报错了
解决办法:
在自己对应的”nodejs“文件夹下的“node_global" 下找到对应的“指令名.ps1"删除掉,然后再运行对应的指令即可
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 主题官方文档 的内容后再来进行魔改。以避免不必要的兼容性问题。
博客有一些关键页面需要手动生成。
进入 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/ * **简介:**无处不在 * **头像:**头像地址
进入 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 其实就是对应的你要实现功能的名称,需要预览什么 功能,就修改成对应的功能名称
找到:node_modules------------>hexo-theme-butterfly------------>_config.yml
将文件里面的内容全部复制,执行图下面的操作,然后将所有代码粘贴到新建的文件里,这个文件就是我们主题配置的文件
方式一:
更改其图标、主页背景等部分内容,在主题的配置文件下
更改背景的话建议使用占位图(就是将本地图片上传到图床)
更改主页 主题背景的时候,如果要使用本地图片记得创建文件夹 img ,将图片放进此文文件,复制其路径,粘贴到对应位置,然后在注意一下本地图片的格式即可, .表示当前路径
/
,使用本地图片时,需加上你的根目录。https://yoursite.com/blog
,引用一张img/xx.png
图片,则设置background
为 url(/blog/img/xx.png)
// 背景 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 运行即可
注意:
圆圈是你要在 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: true
post_wordcount: true
min2read: true
total_wordcount: true
如需调整右侧卡片网站信息内项目的数据,在文件/butterfly/layout/includes/widgets/card_webinfo.pug
中操作。
由于我个人的目录比较大,完全展开三级目录的话,右边栏就完全被目录铺满了。butterfly
主题提供了目录可折叠的选项,只需要在主题配置文件/butterfly/config.yml
设置:
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 配置文件下,将如下我修改过的代码复制到文件末尾(官方给的那个有 坑 )。
search:
path: search.xml
field: post
format: html
limit: 10000
页面美化
根据官方文档和我修改的beautifly,在结合你的喜好,修改一下就好了
beautify:
enable: true
field: post # site/post
title-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 -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 里面
新建文件夹,按照箭头位置创建即可,名称随意
效果:
首先在博客根目录下右键打开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 ,在这里汇总一下
解决办法:
重新配置了下npm安装的全局模块所在的路径,以及缓存cache的路径,又检查了一下环境变量是否正确
设置全局模块命令:
npm config set prefix "D:\node\node_global"
设置cache模块命令
npm config set cache "D:\node\node_cache"
解决办法:重新 deploy 即可。
npm install hexo-deployer-git --save
然后 hexo d 就能提交成功
按照步骤本教程一个基本的网页就搭建出来了,后面就是对网页的美化和优化,如果想简洁一点的话直接看 hexo框架-文章篇 即可
其他博主的教程:
Copyright © 2003-2013 www.wpsshop.cn 版权所有,并保留所有权利。