hexo+github搭建个人专属博客

Posted by FanHao on 2018-04-20

  一直以来想搭建属于自己的博客,终于前段时间集中精力与时间去做了这件事情。

什么是hexo?

  Hexo是一个快速,简洁且高效的博客框架,并且免费。

安装软件环境

安装node.js

  访问node.js官网,根据自己计算机的操作系统选择相应的安装版本。然后再选择stable版本点击下载。双击下载的安装包,点击安装。注意:windows系统平台安装node.js的过程中,需要勾选添加到path选项,以便能在cmd中直接调用node和npm。
  打开cmd命令框或者终端,分别输入node -v和npm -v,能够查看到版本信息,即表示安装完成。

安装git

  访问git官网,下载与自己计算机系统平台相对应的安装版本。双击下载的安装包,点击安装。注意:windows系统平台安装git过程中,同样需要选择安装到path下。
  打开cmd命令或者终端,输入git –version,能够查看到版本信息,即表示安装成功。

安装hexo

  首先在你想要存放站点配置文件和博客文章的路径下创建一个文件夹。以windows系统为例,在D盘路径下创建hexo文件夹。mac os系统
  打开cmd命令框,输入D:,然后输入命令:cd hexo。将工作路径切换至D:\hexo路径下。
  在命令行中输入命令:npm install hexo-cli -g等待安装完成
  然后在命令行中输入npm install hexo –save等待安装完成
  最后在命令行中输入hexo -v,能够查看到hexo版本信息,即表示安装完成。

注册github帐号

  进入github官网,输入帐号名、登录密码、自己邮箱,点击sign in注册github帐号。
  打开邮箱自己刚才填写的邮箱,点开Github发送给你的注册确认链接,确认注册,结束注册流程
  登录github后,点击New repository,创建代码库。
  进入代码库创建页面,在Repository name下填写yourname.github.io。然后点击保存。注意yourname表示你的github帐号名。

初始化Hexo

  输入如下命令初始化、开启hexo服务

1
2
3
4
hexo init
hexo g
hexo server
`

部署

配置Git个人信息

  设置Git的user name和email:

1
2
git config --global user.name "yourusername"
git config --global user.email "youre-mail@example.com"

  生成密钥

1
ssh-keygen -t rsa -C "youre-mail@example.com"

将生成的公钥贴至github上

  通过cd命令进入C:\Users\Administrator.ssh;有两个文件:id_rsa为私钥、id_rsa.pub为公钥。主要将公钥贴到github上,私钥是要自己保存的。
  登陆github,进入setting-SSH and GPG keys页面,新建一个new ssh key,将id_rsa.pub里的内容贴进去。
  使用如下命令测试是否连接github成功。

1
ssh -T git@github.com

配置Deployment

在_config.yml文件中,找到deploy,然后按照如下修改:

1
2
3
4
deploy:
type: git
repo: git@github.com:yourname/yourname.github.io.git
branch: master

注意:yourname代表你的github帐号名

主题推荐

  博主目前用的是next主题,下载地址推荐去github上下载,链接请点。安装好next主题后,打开根目录下的_config.yml,此文件也可以被称为站点配置文件,通过编辑theme字段,将其更换为next。注意配置yml文件时,字段与数值之间必须有空格。不然会报错!如果需要对主题进行个性化配置,请打开myblog/themes/next/下的_config.yml文件,此文件被称为主题配置文件。具体的配置过程这里就不做详细介绍了。毕竟个人喜欢不同。
  另外一个比较值得推荐主题为yilia,有兴趣可以点击该链接进入github下载。

写文章与博客发表

  博客文章全是使用markdown语言语法写的,如果不清楚,请点击。mac平台推荐使用Sublime文本编辑器,windows平台推荐使用nodepad++进行写作,最后文件保存为example.md格式。博客文章放置到

1
/myblog/source/_posts路径下

通过使用如下命令进行发表

1
2
3
hexo clean    
hexo g
hexp d

当然发表文章前,最好可以使用如下命令在本地预览一下效果

1
2
hexo g
hexo sever

其他一些tips

  mac用户请在配置开始前开启root用户权限,因为后续配置需要root权限。博主前面没开启root权限,使用普通用户权限生成了ssh公钥。但后面配置需要开root权限后,用ssh一直连接github失败,最后竟然是坑爹的root用户与普通用户的公钥私钥均不一致。最后博主又把root用户下的公钥贴到github上才解决。