博客搭建

框架: hexo

主题: butterfly

服务器: githubPage

域名: blog.zhangmingke.top

HEXO

前提:

node.js

git

安装hexo

全局安装:

1
npm install -g hexo-cli

指令

init

新建网站,一般一个网站只是用一次

1
2
3
4
5
6
7
8
9
10
hexo init [folder(文件夹路径,没有指定这个该参数,默认在当前文件夹下)]


├── _config.yml 网站的配置信息
├── package.json 应用程序信息
├── scaffolds 模板文件夹
├── source
| ├── _drafts 草稿文章目录
| └── _posts 发布文章目录
└── themes 主题

new

新建文章

1
2
3
4
hexo new [layout]<title>
# 不指定layout默认是用_config.yml指定的defaultlayout,一般是post
# 默认有三个布局,post,page,draft
# 我只需要post

generate

生成静态文件

1
2
3
hexo generate
可以省略为 hexo g
也可以添加参数,在生成静态文件的同时部署项目,比如 hexo g -d

publish

发表草稿

1
hexo publish <filename>

deploy

部署项目

1
2
hexo deploy
可以省略为hexo d

clean

1
2
3
hexo clean
清除缓存文件 (db.json) 和已生成的静态文件 (public)。
在某些情况(尤其是更换主题后),如果发现您对站点的更改无论如何也不生效,您可能需要运行该命令

server

1
2
hexo server
本地启动服务,可以查看具体的样子

主题

hexo 所有主题都要遵守hexo主题结构要求

所以配置信息的所在位置是相通的!

butterfly主题

安装

butterfly提供两种安装方法:

​ 通过下载主题文件到theme文件下

​ npm安装,可以到node_modules\hexo-theme-butterfly修改文件进行魔改

具体安装可以参照butterfly官网安装教程

1
https://butterfly.js.org/posts/21cfbf15/#%E5%AE%89%E8%A3%9D

文章封面

1
cover: 图片地址(在编写markdown页面的时候使用)

网址图标

butterfly 主题加载图标地址是/favicon.png ,但是自带的图标图片却在/img目录下,找不到图片而不显示图标

解决方法:

​ 把favicon.png直接放在source目录下,生成页面时,会放到根目录下!

自定域

github上每次提交代码,自定义域都会消失,需要重新设置

解决方法:
在source中新建CNAME文件里面写入自己的域名用来替换github中Custom domain的设置