使用hexo+github pages搭建博客
Hexo主题选择
Hexo 是一个快速、简洁且高效的博客框架,可托管于github pages,可免去维护服务器的麻烦,博主们可更专注于内容的创作,并且Hexo主题众多,总有一款适合你。
我对主题的要求主要有:
不要太大众
大气美观
功能齐全
经过了几天的搜索之后,筛选了几个比较满意的Hexo主题如下:
Hueman
jacman
大道至简
Loo’s Blog
3-hexo
最终选择了 3-hexo 这款主题,当然还有很多不错的主题。
搭建步骤
1. 根据 Hexo官网 步骤安装 git,node.js
2. 安装Hexo
npm install -g hexo-cli
安装 Hexo 完成后,新建一个博客的主目录,然后执行以下命令:
hexo init <folder>
cd <folder>
npm install
新建完成之后该目录的目录结构如下:
.
├── _config.yml # 网站的 配置 信息
├── package.json # 应用程序的信息
├── scaffolds # 模板文件夹
├── source # 博文源文件目录
| ├── _drafts # 草稿文件夹
| └── _posts # 博文文件夹
└── themes # 主题文件夹
再执行以下命令,访问 http://localhost:4000 即可快速体验Hexo
hexo g
hexo s
3. 根据 Hexo文档 对网站做一些简单的配置,然后修改主题为 3-hexo
安装
git clone https://github.com/yelog/hexo-theme-3-hexo.git themes/3-hexo
修改hexo根目录的_config.yml中的theme参数
theme: 3-hexo
然后执行 hexo clean & hexo g & hexo s 即可看到效果
更多的主题配置可见 3-hexo使用说明
4. 配置 github pages
到github上创建一个新的空仓库,名字格式为 账户名.github.io,譬如我的github账户名是 whirlys,所以我的github pages 仓库的名字应为 whirlys.github.io
安装插件
npm install hexo-deployer-git --save
然后配置 Hexo根目录的 _config.yml,xxx为你的用户名,注意还需要加入你的 github 用户名和密码,不然后面推送失败(但是上传代码时注意防止密码泄露)
deploy:
type: git
repo: https://[github用户名]:[github密码]@github.com/xxx/xxx.github.io.git
branch: master
如果你是第一次配置 github 远程仓库,你还须将你电脑的ssh key 配置到 github 上,具体可参考 git远程仓库
推送Hexo到github
hexo deploy
访问 xxx.github.io 即可看到你的 github pages 博客了
5. 绑定私有域名
我的域名为 laijianfeng.org,是一年前买 腾讯云1元学生主机 时送的,当然可以选择其他域名提供商
在 hexo source 目录下新建一个 CNAME 文件(没有后缀名),在文件里填入你的域名,然后 hexo d 推送到github
登录域名提供商网站,进入域名解析页面,分别添加两条记录
主机记录 | 记录类型 | 线路类型 | 记录值 |
---|---|---|---|
@ | CNAME | 默认 | xxx.github.io |
www | CNAME | 默认 | www.xxx.github.io |
等待十分钟之后,访问你的域名即可跳转到你的博客
6. 其他的配置
接入评论,3-hexo主题中已经集成了多种评论,我选择了gitment,具体的配置参考 完美替代多说-gitment,如果gitment遇到问题,譬如报Error:validation failed异常,可参考 添加Gitment评论系统踩过的坑 以及 gitment issue上的解决方法
代码高亮,字数统计