hexo操作
欢迎使用 Hexo,本文档将帮助您快速上手。Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。
安装Hexo
1 | npm install -g hexo-cli |
建立博客
1 | hexo init <你所放置的文件地址> |
此时你就会看到以下的目录结构

这就是基础的目录了
这里就介绍几个关键的文件和文件夹
_config.yml
网站的配置的信息都存储在这里面,很关键的文件,文章后面会做到详细阐述
source
这里面是存放用户资源的地方,什么意思呢?
也就是博客内容都放在这里面
进到目录中,就会发现有一个 _post文件夹 ,这个文件夹就是之后的文档主要文件。
themes
主题文件夹
hexo常用的命令
新建文章
1 | hexo new <文章标题> # 可以简写hexo n <文章标题> |
生成静态文件
由于Hexo是用Node.js来进行页面渲染,所以需要生成对应的静态文件
1 | hexo generate # 可以简写hexo g |
启动本地服务器
每篇文章总得查看无论是编排、内容,所以我们需要测试,这时候我们就需要本地服务了
1 | hexo server # 可以简写hexo s |
但是运行之前需要确保已经安装 hexo-server 插件
1 | npm install hexo-server --save |
此时服务器就会开启4000端口供你使用,但是可能你的服务器端口被占用了,会提示以下错误
1 | FATAL Port 4000 has been used. Try other port instead. |
此时你需要切换一个端口
1 | hexo s -p 5000 # -p 是可以指定端口的操作 |
部署网站
辛辛苦苦打理了这么久的博客,不上传到服务器上展(zhuang)示(bi)一下,怎么对得起自己
1 | hexo deploy # 可以简写 hexo d |
这里涉及到几个知识点
- 需要先渲染博客,也就是hexo g(可以hexo g -d一步操作)
- 还需要配置博客目录下 _config.yml 文件中的deploy模块
1 | # 之后会教大家如何操作 |
其余的命令实际上用到真的不多,万一需要,百度就可以了
安装主题
这几就看个人喜好了,俗人这就不一一举例了,基本上每一个都是大同小异的,就按俗人所使用的这个吧
该博客的主题hexo-theme-butterfly 是基于Molunerfinn的hexo-theme-melody的基础上进行开发的。
安装hexo-theme-butterfly
在博客的根目录
1 | git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/Butterfly |
或者想用最新的分支的话
1 | git clone -b dev https://github.com/jerryc127/hexo-theme-butterfly.git themes/Butterfly |
替换主题
博客根目录
1 | vim _config.yml |
然后将
1 | theme: Butterfly |
这时候就成为俗人首页的大致样子了。
博客配置
文章front-matter
1 | --- |
1 | # 节选内容 |
系统中英文替换
替换主题后你会发现首页的菜单一开始是英文名字,或者不是自己想要的样子,怎么办?
配置 _config.yml
1 | language: zh-CN |
但是有人反馈,此时还没有全量变更为中文
1 | # 进入主题文件夹 |
会发现这里也有一个 _config.yml 文件,这个文件是掌管整套系统主题相关的配置,个人觉得重要程度的比重要比前面博客根目录的同名文件要重要,当然缺一不可。
编辑这个文件
1 | # 可以像俗人一样把原本的英文名修改成中文,这样就会完全解决切换不彻底问题 |
这里如果需要新增菜单栏目的话,记得这样的规律
- 名称 || 路径 || icon
新增菜单
此时发现点击页面都是空白
这时候就需要新增页面的操作了,但是注意这里的新增和新增文章不同,这里需要加上分类
1 | # 新增标签 |
在博客的根目录访问
1 | source/tags/index.md |
发现这是一个文档文件
是的,基本上大同小异,但是要注意,由于主题的底层已经加上了对该页面的效果,所以需要遵循命名规范后修改文档
1 | title: 标签 |
此时首页的标签按钮已经展示对应的页面内容了,其余的页面同理。
友情链接
- 前往你的Hexo根目录
- 输入
hexo new page link - 找到
source/link/index.md这个文件 - 编辑这个文件
1 | title: 链接 |
注意,主题中配置友情链接的位置不是在该文件本身,而是需要你去 创建 source/_data 目录,并且新建文件 link.yml
1 | class: |
同时,可以在themes/Butterfly/_config.yml文件中,写上个人博客的信息,方便他人帮忙转载
1 | Flink: |
代码高亮
Butterfly支持五种高亮样式:
- default
- darker
- pale night
- light
- ocean
配置 _config.yml
1 | highlight_theme: light |
复制
配置 _config.yml
1 | # Highlight theme |
换行
在默认情况下,配置中是不开启换行功能的,如果不希望在代码中有横向滚动条,可以开启这个功能。
配置 _config.yml
1 | code_word_wrap: true |
社交图标
戳这里到对应的图标中心
配置 _config.yml
1 | social: |
文章版权
配置 _config.yml
1 | post_copyright: |
是否开启版权
1 | copyright: false |
文章打赏
配置 _config.yml
1 | reward: |
头像
配置 _config.yml
1 | avatar: https://xxxx/avatar.png |
文章目录
配置 _config.yml
1 | toc: |
相关文章
配置 _config.yml
1 | related_post: |
博客年份
配置 _config.yml
1 | since: 2018 |
页脚
配置 _config.yml
1 | footer_custom_text: <a href="https://blog.thatwang.com/">Everybody's good at something.</a> |
夜间模式
Apple都有这模式了,我们也不能输呀
配置 _config.yml
1 | darkmode: |
阅读模式
阅读模式会去除文章以外的内容
配置 _config.yml
1 | readmode: |
侧边栏设置
配置 _config.yml
1 | aside: |
访问人数
配置 _config.yml
1 | busuanzi: |
运行时间
配置 _config.yml
1 | runtimeshow: |
相册
文章页面编辑以下markdown格式内容
1 | {% gallery %} |
评论
其实Hexo能支持很多评论系统,但是用下来,就leancloud这个最舒服,最方便
配置 _config.yml
1 | valine: |

注册登录

创建应用

获取key
此时就安装好了评论系统,就这么简单

评论
音乐
同样是使用leancloud服务
前面的注册逻辑与评论一样,接下来就是存储环节
[图片上传失败…(image-62aa11-1573183671188)]
加入单条音乐播放器的页面
1 | {% aplayer "可以了" "陈奕迅" "https://xxx.xxx.com/92b3af330d2274b1fa55.mp3" "https://xxx.xxx.com/xx.png" "autoplay" %} |
加入列表音乐播放器的页面
1 | {% aplayerlist %}{"narrow": false,"autoplay": true,"showlrc": 3,"mode": "random","music": [{"title": "美好事物","author": "房东的猫","url": "http://xxx.xxx.com/945198c4909674765644.mp3","pic": "http://xxx.xxx.com/6e0e9e63cb0733f7ff12.png","lrc": ""},{"title": "尚好的青春","author": "云の泣","url": "http://xxx.xxx.com/5b42b829b8ae08ccabe0.mp3","pic": "http://xxx.xxx.com/889df742eca5261f2fc5.png","lrc": ""},{"title": "预谋邂逅","author": "阿肆","url": "http://xxx.xxx.com/1bd4f91441982710bcad.mp3","pic": "http://xxx.xxx.com/f72d61579f74d4ff9ce0.png","lrc": ""}]}{% endaplayerlist %} |
即可

音乐播放器
分享
配置 _config.yml
1 | sharejs: |
搜索
安装 hexo-generator-search,根据文档做对应配置
配置 _config.yml
1 | local_search: |
自定义主题
配置 _config.yml
1 | theme_color: |
打字效果
配置 _config.yml
1 | activate_power_mode: |
动态彩带
配置 _config.yml
1 | canvas_ribbon_piao: |
背景线条
配置 _config.yml
1 | canvas_nest: |
鼠标点击效果
配置 _config.yml
1 | fireworks: |
首页弹幕座右铭
配置 _config.yml
1 | # 主頁subtitle |