1、新建仓库

在 github 新建一个仓库,仓库名必须为 .github.io 格式,其中 是你 github 的昵称。

2. 全局安装hexo

全局安装 hexo。

1
npm install -g hexo

3. 初始化项目

Just one 命令,hexo init,就会自动构建一个 hexo 项目,紧接着执行 hexo s,浏览器访问 localhost:4000 就可以看到效果

1
2
3
4
5
hexo init

// 本地运行

hexo s

4. 部署到github

在项目根目录下找到 _congif.yml,找到 deploy 字段并填写完整.这里使用git地址,因为https需要设置token,比较麻烦,这里已设置好ssh公钥。

1
2
3
4
5
6
7
8
9
10
11
\# Deployment

\## Docs: https://hexo.io/docs/deployment.html

deploy:

type: git

repo: git@github.com:<yourname>/<yourname>.GitHub.io.git

branch: master

安装 hexo-deployer-git。注意,如果新建个项目,则还需安装这个插件

1
npm install hexo-deployer-git --save

执行下面两个命令,可以把项目自动部署到 github 上。

1
2
3
hexo clean

hexo deploy

5、更换主题皮肤

如果默认风格不喜欢,那可以去官网换之。

更换主题流程:下载主题(可以去官网查看) -> 配置主题,一般git仓库上有使用帮助,照着来就行。

比如这个主题:https://github.com/tufu9441/maupassant-hexo

更新主题后再运行hexo g && hexo d,把代码更新到github。打开自己的github地址.github.io,就能看到新的主题样式了。

常用命令

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
npm install hexo -g #安装Hexo

npm update hexo -g #升级

hexo init #初始化博客

命令简写

hexo n "我的博客" == hexo new "我的博客" #新建文章

hexo g == hexo generate #生成

hexo s == hexo server #启动服务预览

hexo d == hexo deploy #部署

hexo server #Hexo会监视文件变动并自动更新,无须重启服务器

hexo server -s #静态模式

hexo server -p 5000 #更改端口

hexo server -i 192.168.1.1 #自定义 IP

hexo clean #清除缓存,若是网页正常情况下可以忽略这条命令

6、绑定域名

虽然在Internet上可以访问我们的网站,但是网址是GitHub提供的:http://xxxx.github.io ,而想使用我们自己的个性化域名,这就需要绑定我们自己的域名。去阿里云买个便宜的域名,添加解析:

6BFE1B35-FD0A-4240-B1EB-98DFCDE79A63

185.199.108.153是GitHub的地址,你也可以ping你的 http://xxxx.github.io 的ip地址,填入进去。另一个记录类型是CNAME,CNAME的记录值是:你的用户名.http://github.io

第二步,登录GitHub,进入之前创建的仓库,点击settings,设置Custom domain,输入你的域名,保存。

B6D51194-B287-4CF1-9AAF-DE5FDBCCEF3C

第三步,进入本地博客文件夹 ,进入blog/source目录下,创建一个记事本文件,输入你的域名,保存,命名为CNAME。

06650714-B48D-471E-9B52-B62C7D19CF5B

最后,进入blog目录中,更新并推到github上。这时候打开浏览器在地址栏输入你的个性化域名将会直接进入你自己搭建的网站。