在 GitHub 上部署博客

Posted 2021-03-11 zhongtian

目录

• 环境安装
• 创建静态博客
• Github 设置
  • 创建仓库
  • 配置 SSH key
• 发布博客
  • 配置
  • 部署
• 新建博客

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

1. 本机生成 SSH key

ssh-keygen

1. 获取 SSH key

cat ~/.ssh/id_rsa.pub

1. 复制 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