在 GitHub 上部署博客 | 个人博客

本文最后更新于：2020年12月13日

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。

环境安装

  1. 安装 node.js
  2. 安装 Hexo
    npm install -g hexo

创建静态博客

mkdir your_blog
cd your_blog
hexo init
hexo s # 本地预览

Github 设置

创建仓库

在github上创建一个 repo
注意：

  1. repo 名字一定要设置为 username.github.io
  2. 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 账号密码

新建博客

  1. 在 your_blog/source/_posts 下新建 Markdown 文件
  2. 完成编辑后，重复以下指令：
    # 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