在 GitHub 上部署博客 | 个人博客
本文最后更新于:2020年12月13日
Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。
环境安装
- 安装 node.js
- 安装 Hexo
npm install -g hexo
创建静态博客
mkdir your_blog
cd your_blog
hexo init
hexo s # 本地预览
Github 设置
创建仓库
在github上创建一个 repo
注意:
- repo 名字一定要设置为 username.github.io
- repo 不要选私有,否则会 404
配置 SSH key
本机生成 SSH key
ssh-keygen
获取 SSH key
cat ~/.ssh/id_rsa.pub
复制 key,进入 GitHub SSH keys 配置页面,选择 “New SSH key”,粘贴并添加。
发布博客
配置
# Site
title: name's blog
author: name
language: zh-CN (or en)
timezone: Asia/Shanghai
# URL
url: https://username.github.io // 或者写自己的域名
# Deployment
deploy:
type: git
repo: https://github.com/username/username.github.io
部署
# your_blog
npm install --save hexo-generator-index
npm install --save hexo-deployer-git
hexo g
hexo d # 第一次可能需要输入一次 GitHub 账号密码
新建博客
- 在
your_blog/source/_posts
下新建 Markdown 文件 - 完成编辑后,重复以下指令:
# your_blog hexo g hexo d
相关配置
修改文章链接
Hexo 默认的文章链接形式为 https://username.github.io/year/month/day/title
,这种多级 URL 形式对于搜索引擎而言并不友好,可以在博客配置文件中将 permalink
修改成 :year-:month-:day-:title/
,这样文章链接就变成了 username.github.io/year-month-day-title
。
也可以使用 hexo-abbrlink
插件为每篇文章生成较短的链接,如 https://username.github.io/a38bdc21.html
。
npm install --save hexo-abbrlink
需要在博客配置文件配置:
# permalink: :title/
permalink: :abbrlink.html
abbrlink:
alg: crc32 # 算法:crc16(default) and crc32
rep: hex # 进制:dec(default) and hex
评论系统采用 utterances ,加载有延迟,请稍等片刻。