这篇博客介绍了如何使用Hexo和Github Pages搭建免费独立博客。

近来,Hexo凭借简洁的外观,定制的界面,完善的功能吸引了大量的用户。然而,初次上手Hexo时,大多数人都会遇到或多或少的问题,在这里总结下自己搭建的过程,希望能给予些许帮助。

准备工作

在搭建博客前,建议先了解以下内容:

  • Git
  • Github
  • Github Pages
  • Hexo
  • Markdown

必要配置

Github配置

首先,要注册一个自己的Github账号,并在账号下创建一个新的仓库,命名为username.github.iousername是账号名。

需要知道,Github Pages分为用户/组织Pages项目Pages两种类型,这里我们需要的为第一种,具体差异,可以在这里查看。

Git配置

安装Git请在官方网站依照提示进行下载安装。

安装完成后需要设置全局用户名称与邮件地址,以后每一次Git的提交都将使用这些信息,且不可更改

$ git config --global user.name "username"
$ git config --global user.email "username@example.com"

Github上邮件地址默认设置所有人可见,若比较重视隐私,请在Github网站上将Settings选项的Personal settings中的Emails设置为private

SSH配置

SSH是一种加密算法,可以对Git服务器进行授权,详情可以参考百科。我们需要ssh生成的密钥上传文件到Github。 首先检查电脑上是否已经生成了SSH Keys

$ ls -al ~/.ssh

默认情况下,SSH Keys保存在id_rsa,id_dsa.pub文件中,如果发现存在这两个文件,说明存在密钥,否则,需要生成新的密钥

$ ssh-keygen -t rsa -C "username@example.com"

之后一路回车即可,然后再输入

$ ssh-agent -s
$ ssh-add ~/.ssh/id_rsa

就成功生成了SSH key文件。然后,拷贝id_dsa.pub中的内容,将其粘贴在Github网站上将Settings选项的Personal settings中的SSH Keys中,并输入下列命令测试

$ ssh -T git@github.com

如果出现

 Are you sure you want to continue connecting (yes/no)?

的字样,请输入yes,若出现

Hi username! You've successfully authenticated, but GitHub does not
provide shell access.

字样,则说明密钥添加成功。

Hexo安装

若电脑中已安装了Nodejs 和 Git软件,则接下来使用npm命令安装Hexo

$ npm install -g hexo

建立博客

本地博客

安装完Hexo后,在任意一个文件夹下运行如下命令

$ hexo init
$ npm install

就建立了一个本地的Hexo博客,执行如下命令进行查看 $ hexo g $ hexo s 即可在浏览器中输入localhost:4000看到默认的本地博客了。

上传github

在上述文件夹中找到_config.yml文件,修改其中的

deploy:
  type:

deploy:
  type: git
  repo: github上对应仓库的SSH地址
  branch: 分支名称,默认为master

然后,在本地文件夹下安装部署插件

npm install hexo-deployer-git --save

然后,执行如下命令

$ hexo g
$ hexo d

输入username.github.io就可以浏览博客了。

最后,这篇文章只是简单介绍了如何搭建Hexo博客并部署到Github,并没有介绍如何编辑博客,美化主题,若有兴趣可以先自行了解。