hexo+github搭建博客教程

前言:博主一开始想拥有一个专属域名的网站,于是便有了后来创建博客的折腾路程,此贴是用来总结下搭建博客的过程,所以写得比较细(其实是怕自己以后忘了),希望对大家搭建博客有所帮助。

准备阶段

软件准备:git;node.js;sublime(选用,最好有)

git(需翻墙)
如果你的电脑是window 64位可以点击此处下载

把本地的 hexo 代码提交到 github 上去。

node.js

hexo 运行环境,用来创建 hexo 博客框架。

sublime(选用):

用于修改博客界面

git安装教程,node.js和sublime安装比较简单,这里便不再赘述。

git指令介绍:

hexo g #完整命令为 hexo generate,用于生成静态文件

hexo s #完整命令为 hexo server,用于启动服务器,主要用来本地预览

hexo d #完整命令为 hexo deploy,用于将本地文件发布到github上

hexo n #完整命令为 hexo new,用于新建一篇文章

hexo clean #清除生成的文件

git clone:将远程仓库复制到本地

git init:新建一个仓库

git pull:抓取远程仓库所有分支更新并合并到本地

git commit:提交你的修改

安装方法:

Hexo 是一个快速、简洁且高效的博客框架,我们首先要把这个框架搭起来,方法很简单:
任意位置右键看到Git Bash Here,点击。

打开git的命令窗口后,输入:

npm install -g hexo

如果命令无法运行,可以尝试更换taobao的npm源:

npm config set registry “https://registry.npm.taobao.org

安装完毕后,在自己喜欢的地方建立一个hexo文件(如E:\blog\hexo),直接进入E:\blog\hexo点击鼠标右键执行Git Bash Here,然后在工作窗口执行以下命令:

hexo init

npm install

hexo便安装完毕,在E:\blog\hexo内的目录如下:

本地预览,可以简单的查看一下效果,输入命令:

hexo s

然后用浏览器访问http://localhost:4000,应该能看到默认的效果了(自带主题landscape)。

之后便是部署到github上,这样才能在网上访问,而不是像现在在本地预览

申请一个github账号

教程传送门

建立项目仓库:

注册完登陆后,创建一个我们自己的Github Pages项目。点击New repository。

具体操作要点如下图

创建好后便可以访问了,域名为:username.github.io(可是没有内容),我们需要配置SSH密钥,在本地上传点内容给它。

配置SSH密钥方法:

配置Github的SSH密钥可以让本地git项目与远程的github建立联系,让我们在本地写了代码之后直接通过git操作就可以实现本地代码库与Github代码库同步。

第一次申请账号肯定不会有SSH密钥的,如果你忘记了自己是否已经添加了密钥,也可以打开git bash输入:

cd ~/. ssh

检查你本机用户home目录下是否存在.ssh目录。

如果已经添加则不必重复添加,否则需要执行下列步骤添加密钥:

①创建一对新的SSH密钥(keys)

ssh-keygen -t rsa -C “your_email@example.com”

这会根据你提供的邮箱地址,创建一个密钥,你的邮箱也会有相应的邮箱提醒

在git的命令窗口则会产生下列的回复

Generating public/private rsa key pair.
Enter file in which to save the key (/c/Users/you/.ssh/id_rsa): [Press enter]

直接回车键,密钥就会存放在命令窗口提示的路径中,如:(/c/Users/you/.ssh/id_rsa)。

根据路径,打开密钥存放的文件夹,找到id_rsa文件,打开它,先复制里面的内容,那就是你的密钥(下面的配置会用到它)

而在你的命令窗口,接下来就会有提示,根据提示,你需要输入密码和确认密码(其实有没有密码也无所谓,毕竟没有密码就是最好的密码,手动滑稽)。

相应提示如下:

Enter passphrase (empty for no passphrase): [Type a passphrase]

Enter same passphrase again: [Type passphrase again]

输入完之后,命令窗口便会有类似这样的信息:

Your identification has been saved in /c/Users/you/.ssh/id_rsa.

Your public key has been saved in /c/Users/you/.ssh/id_rsa.pub.
The key fingerprint is:
01:0f:f4:3b:ca:85:d6:17:a1:7d:f0:68:9d:f0:a2:db your_email@example.com

之后便是在github网页上操作打开官网,进入你的Account Settings.

点击settings。

将密钥复制到窗口中

之后SSH的密钥便设置完成。

测试是否配置成功:

输入下列命令

ssh -T git@github.com

若出现

The authenticity of host ‘github.com (207.97.227.239)’ can’t be established.
RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.
Are you sure you want to continue connecting (yes/no)?

回复yes即可。会看到

Hi cnfeat! You’ve successfully authenticated, but GitHub does not provide shell access.

完善个人信息:

$ git config –global user.name “cnfeat”//用户名

$ git config –global user.email “cnfeat@gmail.com”//填写自己的邮箱

现在恭喜你,你的SSH已经配置成功,本地已与github成功连接。

如有问题,请参考

GitHub Help - Generating SSH Keys

Error: Permission denied (publickey)

既然连接好了,我们就要传点东西给它才好,下面是教程。

将本地的Hexo文件更新到Github的库中:
登录Github打开自己的项目 username.github.io;

之后找到clone or download并点击:

复制地址

打开你一开始创建的Hexo文件夹(如F:\Blog\Hexo),用sublime(没有的话,用记事本也行)打开文件夹下的_config.yml文件

在里面修改配置并保存

在hexo下执行

hexo g

hexo d

第一次hexo d可能会报错:

ERROR Deployer not found:git

需要安装一下hexo-deployer-git这个插件:

npm install hexo-deployer-git –save

这时候输入自己的博客域名,地址是 username.github.io(我的是sirlh.github.io) 在网页上就可以看到自己的博客了

另外还有一些资料:

https://www.jianshu.com/p/efbeddc5eb19

http://blog.csdn.net/gdutxiaoxu/article/details/53576018

注:部分图片来自http://www.jianshu.com/p/0b33006a48e6,侵删。

请我喝杯咖啡~
------ 本文结束------
0%