hexo是一款基于Node.js的静态博客框架, hexo github链接,官网。
配置环境
安装Node
作用:用来生成静态页面的
参考地址:安装Node.js
安装Git
作用:把本地的hexo内容提交到github上去.
下载地址:http://git-scm.com/download/
申请Github账号
作用:是用来做博客的远程创库、域名、服务器之类的,怎么与本地hexo建立连接等下讲。
安装Hexo
|
|
这里有必要提下Hexo常用的几个命令:
另外还有其他几个常用命令:
常用简写
现在我们打开http://localhost:4000/ 已经可以看到一篇内置的blog了。
Hexo主题设置
这里以主题yilia为例进行说明。
安装主题
|
|
启用主题
修改Hexo目录下的_config.yml配置文件中的theme属性,将其设置为yilia。
更新主题
|
|
现在打开http://localhost:4000/ ,会看到我们已经应用了一个新的主题。
Github Pages设置
什么是Github Pages
GitHub Pages 本用于介绍托管在GitHub的项目,不过,由于他的空间免费稳定,用来做搭建一个博客再好不过了。
每个帐号只能有一个仓库来存放个人主页,而且仓库的名字必须是username/username.github.io,这是特殊的命名约定。你可以通过http://username.github.io 来访问你的个人主页。
这里特别提醒一下,需要注意的个人主页的网站内容是在master分支下的。
创建自己的Github Pages
注册GitHub及使用Github Pages的过程已经有很多文章讲过,在此不再详述,可以参考:
一步步在GitHub上创建博客主页 全系列
如何搭建一个独立博客——简明Github Pages与Hexo教程
部署Hexo到Github Pages
这一步恐怕是最关键的一步了,让我们把在本地web环境下预览到的博客部署到github上,然后就可以直接通过http://jiji262.github.io/访问了。不过很多教程文章对这个步骤语焉不详,这里着重说下。
首先需要明白所谓部署到github的原理。
之前步骤中在Github上创建的那个特别的repo(jiji262.github.io)一个最大的特点就是其master中的html静态文件,可以通过链接http://jiji262.github.io来直接访问。
Hexo -g 会生成一个静态网站(第一次会生成一个public目录),这个静态文件可以直接访问。
需要将hexo生成的静态网站,提交(git commit)到github上。
明白了原理,怎么做自然就清晰了。
使用hexo deploy部署
hexo deploy可以部署到很多平台,具体可以参考这个链接. 如果部署到github,需要在配置文件_config.xml中作如下修改:
|
|
然后在命令行中执行
即可完成部署。
踩坑提醒
1)注意需要提前安装一个扩展:
2)如果出现下面这样的错误,
则是因为没有设置好public key所致。
在本机生成public key(参考github帮助):
然后在#user_id/.ssh目录下会生成两个文件,id_rsa.pub和id_rsa.
然后登陆github,在SSH设置页面添加上刚才的public key文件也就是id_rsa.pub的内容即可。