这篇博客介绍了如何使用Hexo和Github Pages搭建免费独立博客。
近来,Hexo凭借简洁的外观,定制的界面,完善的功能吸引了大量的用户。然而,初次上手Hexo时,大多数人都会遇到或多或少的问题,在这里总结下自己搭建的过程,希望能给予些许帮助。
准备工作
在搭建博客前,建议先了解以下内容:
- Git
- Github
- Github Pages
- Hexo
- Markdown
必要配置
Github配置
首先,要注册一个自己的Github账号,并在账号下创建一个新的仓库,命名为username.github.io, username是账号名。
需要知道,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,并没有介绍如何编辑博客,美化主题,若有兴趣可以先自行了解。