使用Hexo搭建Github page

发表于

使用Hexo搭建Github page

环境准备

Node.js安装（链接）
Git安装（链接）

Hexo安装

打开git bash.exe, 进入适当的文件夹路径 ，输入

1
$npm install -g hexo-cli

检查hexo是否安装成功

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
$ hexo -v
hexo-cli: 1.0.4
os: Windows_NT 10.0.15063 win32 x64
http_parser: 2.7.0
node: 8.9.4
v8: 6.1.534.50
uv: 1.15.0
zlib: 1.2.11
ares: 1.10.1-DEV
modules: 57
nghttp2: 1.25.0
openssl: 1.0.2n
icu: 59.1
unicode: 9.0
cldr: 31.0.1
tz: 2017b

初始化hexo

1
2
hexo init
npm install

安装Hexo关于启动服务器的插件

1
npm install hexo-server --save

启动服务器

1
hexo server

查看效果，网页打开localhost:4000,即可

搭建Git pages

github上新建仓库，命名为yourname.github.io

安装Hexo关于git的组件

1
npm install hexo-deployer-git --save

在_config.yml 中为 git 添加配置

1
2
3
4
5
// 这个一般是在最后,直接往下滑
deploy:
type: git
repository: 你的仓库地址(https://github.com/用户名/用户名.github.io.git)
branch: master

执行(每次修改都要执行这些命令才能在github pages看到效果)

1
2
hexo generate
hexo deploy

写博客

新建博客
​
//这个地方，当文章名为中文的时候，内容有中文不会出现乱码。但是当文章名是英文的时候，若内容中有中文就会出现乱码，摸索中
hexo new “文章名”

命令结束后,会在 source/_post下自动生成一个 “文章名.md文件”.(你会看到一个 hello world.md 这个是默认的那个,可以删除)

写好后,生成 部署即可. （需先进入博客目录，如cd d/blog）

1
2
hexo generate
hexo deploy

删除博客的话,直接将source/_post下对应的 .md文件删除即可 ;重新编译文章,找到这个.md文件打开重新编辑,最后 再次生成部署即可,有时候会存在一定的延迟,这跟网速有关.

命令

1
2
3
hexo g = hexo generate
hexo d = hexo deploy
hexo s = hexo server

HEXO主题设置

默认的hexo主题不喜欢的话可以自定义主题，就以最多使用的next主题为例，介绍一下主题设置流程

进入blog下的themes文件夹，下载next主题

1
git clone https://github.com/iissnan/hexo-theme-next themes/next

这样 D:\blog\themes就会出现next文件夹，下载的主题就在里面了

绑定域名

首先，需要在阿里云或者其他渠道购买域名，以笔者在阿里云购买的域名(www.wanyajing.top)为例
Alt text

注意第一行和第二行记录值设置，CNAME设置为你的github.pages域名，如yestermorrow.github.io，A设置为你的github.pages指向的ip地址（ping一下yestermorrow.github.io就能知道ip啦）。等待五分钟左右，直接输入自己域名就能进入你的github.pages了。

注意
1：每次修改_config.yml或者md文件时，本机起服务能看见效果，github.io博客看不见效果时

1
2
hexo clean
hexo d -g

2： 启动hexo服务器显示端口被占用时

1
hexo s -p 5000

3：新建博客时，先hexo new “文章名”，再用马克飞象打开。若直接使用马克飞象新建文件，会出现hexo打开后显示文件名为———-未命名等异常情况。

4：使用Typora软件编辑md文件的时候，如下图，tag:与”原创”之间要有空格

tag

否则会出现如下错误

cmd