使用Hexo搭建Github个人博客

发表于

网上关于hexo搭建博客的文章已经有很多，这里只做为个人博客的试笔文章，记录下hexo博客搭建的过程和心得。

Hexo

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。

搭建准备

  • Node.js
  • Git & Github

Node.js安装方式很多，见 如何安装Node.js 文章
Git 安装方法，见 如何安装Git 文章

node.js 和 git 都安装完成后即可开始搭建hexo个人博客了。

开始搭建

安装 hexo

1
2
3
4
5
6
7
$ cd d:/hexo
$ npm install hexo-cli -g
$ hexo init blog
$ cd blog
$ npm install
$ hexo g # 或者hexo generate
$ hexo s # 或者hexo server，可以在http://localhost:4000/ 查看

这里有必要提下Hexo常用的几个命令：

1
2
3
4
$ cd/themes
hexo generate (hexo g) 生成静态文件，会在当前目录下生成一个新的叫做public的文件夹/
hexo server (hexo s) 启动本地web服务，用于博客的预览
hexo deploy (hexo d) 生成部署

目前我安装所用的本地环境如下：(可以通过hexo -v查看)

1
2
3
4
5
6
7
8
9
10
11
12
hexo: 3.2.0
hexo-cli: 1.0.1
os: Windows_NT 6.3.9600 win32 x64
http_parser: 2.5.2
node: 4.4.1
v8: 4.5.103.35
uv: 1.8.0
zlib: 1.2.8
ares: 1.10.1-DEV
icu: 56.1
modules: 46
openssl: 1.0.2g

安装主题

1
$ hexo clean

应用主题

1
2
3
4
5
$ cd/themes
$ git clone git@github.com:iissnan/hexo-theme-next.git
$ git pull
$ hexo g # 生成
$ hexo s # 启动本地web服务器

二：Github Pages设置

什么是Github Pages

GitHub Pages 本用于介绍托管在GitHub的项目，不过，由于他的空间免费稳定，用来做搭建一个博客再好不过了。

每个帐号只能有一个仓库来存放个人主页，而且仓库的名字必须是username/username.github.io，这是特殊的命名约定。你可以通过http://username.github.io 来访问你的个人主页。

这里特别提醒一下，需要注意的个人主页的网站内容是在master分支下的。

使用hexo deploy部署

hexo deploy可以部署到很多平台，具体可以参考这个链接. 如果部署到github，需要在配置文件_config.xml中作如下修改：

1
2
3
4
5
6
7
deploy:
  type: git
  repo: git@github.com:jiji262/jiji262.github.io.git
  branch: master
$ cd/blog
$ npm install hexo-deployer-git --save

然后在命令行中执行

1
hexo d

即可完成部署。

1）如果出现下面这样的错误：

1
2
3
4
Permission denied (publickey).
fatal: Could not read from remote repository.
Please make sure you have the correct access rights
and the repository exists.

则是因为没有设置好public key所致。
在本机生成public key(参考github帮助)：

1
2
3
4
5
6
7
＃ssh-keygen -t rsa -b 4096 -C "963022018@qq.com"
回车
Overwrite (y/n)? y
yuying$ ls -a
cd /Users/yuying/.ssh/
.ssh yuying$ ls -a
cat id_rsa.pub

然后在#user_id/.ssh目录下会生成两个文件，id_rsa.pub和id_rsa.
然后登陆github，在SSH设置页面添加上刚才的public key文件也就是id_rsa.pub的内容即可。

Hexo 主题配置

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
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
# Header
menu:
  主页: /
  所有文章: /archives
  # 随笔: /tags/随笔
# SubNav
subnav:
  github: "dushao103500"
  weibo: "DanD逆光之处是暖伤"
  rss: "#"
  zhihu: "#"
  #douban: "#"
  #mail: "dushao1314@foxmail.com"
  #facebook: "#"
  #google: "#"
  #twitter: "#"
  #linkedin: "#"
rss: /atom.xml
# Content
excerpt_link: more
fancybox: true
mathjax: true
# Miscellaneous
google_analytics: ''
favicon: /favicon.png
#你的头像url
avatar: ""
#是否开启分享
share: true
#是否开启多说评论，填写你在多说申请的项目名称 duoshuo: duoshuo-key
#若使用disqus，请在博客config文件中填写disqus_shortname，并关闭多说评论
duoshuo: true
#是否开启云标签
tagcloud: true
#是否开启友情链接
#不开启——
#friends: false
#是否开启“关于我”。
#不开启——
#aboutme: false
#开启——
aboutme: 我是谁，我从哪里来，我到哪里去？我就是我，是颜色不一样的吃货…

至此，Hexo+Github Pages搭建个人博客完成