前言
什么是Hexo,什么是TravisCI就不介绍了,不知道的自行Google。因为自己现在的笔记本快要退休了,工作公司一台电脑,自己一台,所以就想着能不能在不同电脑上都能愉快的写自己的博文。查了一圈,把Hexo放在阿里云上,每次编写好md文件再拷到服务器发布算比较好的方式了,但不是人人都是学生党能买到这么便宜的服务器,写个博客买台服务器也不划算,恰好自己最近在弄Jenkins,最后就决定采用TravisCI来自动化部署博文了。
本地环境安装(Windows)
Hexo依赖Node.js,另外需用Git来进行版本控制,下载对应系统的Node.js和Git一路确定安装即可~~
- Node.js
- Git
安装完成后,使用以下命令确认是否安装成功,成功会输出具体的软件版本
node -v
git --version
确认无误后,这里使用 Git bash 来执行之后的操作,不使用CMD的原因是我使用CMD的过程中出现了permission denied等一些估计和权限有关的错误。Git bash 是Windows下的命令行工具,如下所示
安装Hexo
npm install hexo-cli -g
完成后进入一个新目录存放博客资源,这里我放在D盘下
cd d:
hexo init blog
cd blog
npm install
hexo server
若一切正常,你将会看到如下输出
INFO Start processing
INFO Hexo is running at http://localhost:4000/. Press Ctrl+C to stop.
打开浏览器输入地址http://localhost:4000/,你将会看到
开始博客
编写博客
Hexo编写博客很简单,打开一个新的git bash,切换到blog目录,使用下面的命令可以初始化一篇博客的md文件,产生的源码位置在\blog\source_posts下
hexo new post test
使用编辑器打开文件,适当编辑
---
title: test
date: 2018-11-26 22:50:36
tags:
---
### 这是测试文档
刷新http://localhost:4000/页面,会发现新建的测试博客已经生效
博客站点的一些基本信息,可以在根目录的_config.yaml中配置,如
title: 與誠的博客小站
subtitle: To be honest ~~~
language: zh-CN
note:key和value之间有空格,更多的使用方式详见Hexo的官方文档。编写博客使用的是markdown,具体的语法可以自行查询,都比较简单,一早也就支持了markdown语法,详细介绍见这里
主题定制
Hexo有很多优秀的主题,可以在主题页面选择一款你钟爱的主题。这里我选择的是经典的NexT主题,因为之后的自动化部署,Hexo和主题都是即安即用的,本地的配置不再起作用,所以用自己的github账号fork一份NexT主题的代码,在这上面更新个人配置。按NexT的使用文档一步一步配置就可完成主题的定制,使用hexo server 重启,刷新页面,就可以看到主题生效了,所有配置完成后就可以推送自己的Github仓库中。具体配置可以参考我的配置文件。
NexT由iissnan开发,现在已经交给组织,这里使用文档有个别有误的地方,官方使用文档最近还在更新中。
在线部署
以上都只能在本地访问我们的博客,要想在互联网上都能访问到,需要有一个博客托管的地方,这里使用免费的Github Pages来部署博客。
SSH key 配置
每次操作使用账号密码比较麻烦,这里先配置ssh密钥来免密访问Github和Coding。首先配置一下用户名和邮箱。
git config --global user.name "your name"
git config --global user.email "[email protected]"
使用命令行生成SSH key或者Git GUI工具的帮助--》show ssh key--》generate key,产生的文件具体位置在C:\Users\用户名.ssh下
ssh-keygen -t rsa
按提示一路回车即可。或者
拷贝一份生成的id_rsa.pub公钥信息到github和coding账号中。
验证ssh是否生效
ssh -T [email protected]
Hi renyuzh! You've successfully authenticated, but GitHub does not provide shell
access.
创建托管仓库
Github中创建一个仓库名为yourname.github.io的仓库
发布配置
Hexo支持 Git、Heroku、Rsync、OpenShift、FTPSync 等部署方式,这里使用Git,先安装对应的插件
npm install hexo-deployer-git --save
在博客根目录下有一个_config.yaml文件,拉到最后配置关联仓库地址
deploy:
type: git
repo: [email protected]:renyuzh/renyuzh.github.io.git
branch: master
保存配置后使用命令发布
hexo generate
hexo deploy
或者
hexo g -d
第一行命令将source目录中的markdown文件转化为html文件,第二行将内容发布到配置的仓库中。本质上pages展示的是public中的内容,所以不使用hexo deploy的方式,直接将public 中的内容push到远程仓库也是一样的效果。访问https://renyuzh.github.io,预览最新的博客
自定义域名
自带的二级域名稍微难看点,我们可以自己购买想要的域名,价格几元到几万不等,这里使用在阿里云上购买的域名,登录阿里云账号,进入控制台,选择左侧域名
首先完善域名服务里的信息模板以便进行实名认证。然后选择自己购买的域名,点击解析,新建两个CNAME指向yourname.github.io地址,同时在Github的仓库根目录新建一个CNAME文件,内容是你的域名地址。等待10分钟后就可以使用我们购买的域名访问博客了。
TravisCI
TravisCI是开源的持续集成项目,和Github的整合度很高,使用持续集成开源自动化的发布构建项目。整个自动化部署的原理很简单:
- 新建分支blog-source维护源码,一旦有push等更改操作时通知TravisCI拉取源码
- TravisCI根据分支blog-source中.travis.yml配置信息自动构建发布博客,再把内容推送到master分支上
首先使用Github账号登录TravisCI官网,同步我们的Github项目,开启pages项目
要想TravisCI有操作Github的权限,必须使用Github提供的Personal access tokens,如图所示在Settings-》Developer settings下
复制token信息,添加到对应的TravisCI项目中,这里只选择push时触发自动构建
上面说到源码是托管在blog-source分支中的,生成的文件放在master分支中,现在任意打开一个目录,初始化git仓库,在本地新建分支,配置好.travis.yml文件即可推送到Github中
git init
git remote add origin [email protected]:renyuzh/renyuzh.github.io.git
git checkout -b blog-source
分支中,复制原blog根目录下的db.json、package.json、source目录以及.travis.yml和_config.yml配置文件,这些是必须的
language: node_js
node_js: stable
# assign build branches
branches:
only:
- blog-source
# cache this directory
cache:
directories:
- node_modules
#- themes 主题没有更改时可以缓存
# S: Build Lifecycle
before_install:
- npm install -g hexo-cli # 安装 hexo
- git clone https://github.com/renyuzh/hexo-theme-next.git themes/next # 主题没有更改时不用每次都下载安装一遍
install:
- npm install # 安装 package.json 中的插件
script:
- hexo generate
after_success:
- git config --global user.name "zhangrenyu"
- git config --global user.email "[email protected]"
- sed -i "s/gh_token/${GH_TOKEN}/g" _config.yml #使用travisCI中配置的token替换掉_config.yml中对应的占位符
- hexo deploy
# E: Build LifeCycle
同时更改_config.yaml中的发布地址
deploy:
type: git
repo: https://[email protected]/renyuzh/renyuzh.github.io.git
将更改后的分支推送到远程分支
git add .
git commit -m"test TravisCI"
git push origin blog-source
可以看到TravisCI自动部署成功了
参考文章
1.基于 Hexo 的全自动博客构建部署系统
2.Hexo遇上Travis-CI:可能是最通俗易懂的自动发布博客图文教程
3.hexo搭建个人博客--NexT主题优化
4.30分钟快速搭建hexo3.7.0 + next主题6.4教程(持续更新)
关于我
我的博客地址:與誠的博客小站