使用hexo与GitPages 搭建个人静态博客
文章目录
写在前面
建站过程中踩了不少坑,许多教程与现状有所出入,本文用以回顾和日后避雷,也方便其他小伙伴参考。
什么是 Git Pages? Git Pages 是 GitHub 推出的一种静态网页托管方案,方便 GitHub 用户展示个人页面与项目页面。 可以作为一种 0 成本托管个人博客的选择,个人页面默认绑定username.github.io。
什么是 Hexo? Hexo 是一种基于 node.js 的博客框架,其通过解析 .md 和主题文件生成包含相应文章内容的静态网页。
PS: 学完了三大件跟 node 才来整,做完才发现都是胶水代码,0 基础也能玩。
开始之前
在开始之前需要准备的有:
- 一个 GitHub 账号
- VSCode
- node.js
- GitHub Desktop/Git
创建本地博客
创建要用作本地博客的文件夹 <folder name> 在 VSCode 中打开文件夹并在终端中输入
> npm install -g hexo-cli
> hexo init
> npm install
初始化完成后可以通过 hexo new <title> 创建新文章 在新生成的 .md 文件中书写博客内容 使用 hexo s 命令运行本地网站并在 localhost:4000 预览效果
_config.yml 文件中可以修改站点的配置信息 themes 文件夹中存放有主题,默认为 landscape clone 其他主题并在 _config.yml 中配置即可切换主题 主题配置参考各主题作者的 Doc
创建 GitHub Pages
登录自己的 GitHub 账号,创建一个名为 _username_.github.io 的库 (其中*username*为自己的用户名)
- 使用 Github Desktop 点击 "Set up in Desktop"
- 使用 Git
git clone https://github.com/username/username.github.io
生成静态页面并上传
使用 hexo g 命令生成静态网页 将 public 目录下的文件 copy 到本地库中并 commit & push 此时访问 username.github.io 即可查看效果
使用持续集成工具
每次发布文章都需要 generate & copy & commit & push 实在是太麻烦了 我们可以使用持续集成工具 Travis CI 来简化这部分工作。
Hexo 官方文档建议的是直接将 blog 文件夹推送到 io 库中 使用 Travis CI 来构建发布到gh-pages分支下并改变 io 的发布分支 然而事实上个人页面只能使用master分支作为发布分支
为了降低学习成本,本文采用的办法是将blog文件夹推送的新建的 hexo 库中 用 Travis CI 监听代码变化来自动构建并 copy 到 io 库的 master 分支
- 新建一个库
- 将 Hexo 站点文件夹推送到库中
- 将 Travis CI 添加到 GitHub 账户
- 打开 Applications settings,使 Travis CI 能够访问你的库
-
新建 Personal Access Token,勾选
repo生成 Token (保存好)。 - 回到 Travis CI,打开设置,在 Environment Variables 下新建一个变量 Name 为
BLOG_TOKEN,Value 为刚才在 GitHub 生成的 Token 不要勾选 DISPLAY VALUE IN BUILD LOG!!! 点击 Add 保存。 - 在 Hexo 站点文件夹中新建一个
.travis.yml文件文件内容直接 copy 下面保存即可
language: node\_js \# 设置语言
node\_js: stable \# 设置相应版本
cache:
apt: true
directories:
- node\_modules \# 设置缓存,传说会在构建的时候快一些
before\_install:
- npm install hexo-cli -g
install:
- npm install \# 安装hexo及插件
script:
- hexo clean \# 清除
- hexo g \# 生成
after\_script:
- git clone ${GH\_REF} pub\_web \# 将发布服务的仓库clone下来,
- cp -rf public/\* pub\_web/ \# 将源博客仓库目录下的public文件夹下的文件复制到发布服务的仓库中
- cd pub\_web \# 进入到git仓库
- git config user.name "username"
- git config user.email "username@mail.com"
- git add .
- git commit -am "Travis CI Auto Builder :$(date '+%Y-%m-%d %H:%M:%S' -d '+8 hour')" \# 零时区,+8小时
- git push origin master
branches:
only:
- master #只监测master分支
env:
global:
- GH\_REF: https://username:${BLOG\_TOKEN}@github.com/username/username.github.io #设置GH\_REF
注意更改 username, BLOG_TOKEN: 就是在 travis-ci 仓库中配置的环境变量 push 到远程仓库后 Travis 就会开始工作,之后每次发布文章只需要 push 一下就行
参考文章
评论
登录后参与技术讨论,分享你的经验与见解。
登录 / 注册暂无评论