ZhouJiatao's Blog

Hexo+Github搭建自己的博客

此文使用的 hexo版本 3.1.1
已经换过好几个博客平台,国内的用过博客园、51CTO、csdn,总体的感觉是,界面都不够简介,插入代码困难,致命的是侧边栏有广告。国外的用过codrspace,Medium, 界面都很简洁,但是前者很久没更新过了,后者偶尔被墙。这些不利因素都影响到写博客的积极性。
于是有了自己搭建博客的想法。
网上了解到可以在Github上写博客,很是高兴。在开发者眼中,Github就是高端的代名词嘛。
一开始使用Hexo,我是拒绝的。

happy

因为在Google用关键字搜索 “blog github”,满是Jekyll的身影,却不见Hexo。感觉Jekyll资料肯定会更加齐全。
了解到Jekyll的配置有多繁琐后,我欣然接受Hexo。

pipe

事实上Hexo的资料也是很齐全的,并且在Github上有许多主题可以下载。
而且在生成静态页面的效率上,Hexo也是远高于Jekyll的。

安装必要的软件

Node.js

作用:用于生成静态页面。
进入Node.js官网下载安装包即可进行安装。

git

作用:用于提交本地内容,比如主题、hexo生成的静态文件。
Xcode自带git,如果你安装过Xcode,可以跳过这一步。
如果没有,请自觉进入git官网下载安装包。

Hexo

在终端执行以下命令进行安装

$ sudo npm install -g hexo

初始化Hexo

安装完成后,进入你想要存放 本地文件(包含 主题、博客文件、网站的静态文件) 的目录,并执行

$ hexo init
$ npm install

初始化完成后,目录结构就像这样:

. 
├── _config.yml 
├── package.json 
├── scaffolds 
├── source 
| ├── _drafts 
| └── _posts 
└── themes

启动本地服务

用于预览本地文章

$ hexo server

浏览器访问 http://localhost:4000
如果能打开,说明本地的环境配置成功了。

配置Github

你的需要一个Github帐号,没有就到这里免费注册一个。
登录Github,建立仓库(Repository),命名格式为user_name.github.io
比如,你的用户名为RealMeZJT,仓库名称应为”RealMeZJT.github.io”

关联Hexo 和 Github

复制repository url

登录Github,点击进入你的仓库,复制你刚才创建的仓库的url
repositoryUrl

将repository url写入配置文件

用文本编辑器打开 _config.yml 文件,滚动到最低端,编辑最后一部份:

deploy: 
  type: git 
  repo: <repository url>

注意:分号后有空格,不能漏写。
以下是我自己的配置

deploy:
  type: git
  repo: https://github.com/RealMeZJT/RealMeZJT.github.io.git

配置完成后执行:

$ hexo deploy

(首次提交会提示你输入Github密码)
现在你可以通过浏览器访问到你的博客,地址是 http://user_name.github.io
比如我的用户名是RealMeZJT,那么我的博客地址是 http://realmezjt.github.io

附 常用Hexo命令

新建文章

$ hexo new "postName"

新建后在 source/_posts 目录下可以看到.md后缀文件,文件名与文章名相同。打开文件,可用Markdown标记语言编辑你的新文章。

提交到Github

每次都可以依次运行这3个命令

$ hexo clean
$ hexo generate
$ hexo deploy

更多的知识,请参阅官方文档 https://hexo.io/zh-cn/