关于如何使用GitHub Pages和Hexo搭建个人博客并进行写作（使用Keep主题）。

GitHub Pages & Hexo 搭建博客

Hexo 安装与配置

Hexo 安装与配置 | Easy Hexo 👨‍💻

确认本地已经安装 Git 和 Node.js

安装hexo: npm install -g hexo-cli

Tips：如果是mac需要使用sudo，一直卡顿可以尝试设置镜像，或者安装cnpm
1
2
3
4
5
6
sudo npm install -g hexo-cli
// 设置镜像
npm config set registry=https://registry.npmmirror.com
// 安装cnpm
sudo npm install -g cnpm
sudo cnpm install -g hexo-cli // 使用cnpm重新安装

在本地创建一个文件夹，然后往这个文件夹中安装Hexo
配置 Hexo，其配置文件为_config.yml：配置 Hexo | Easy Hexo 👨‍💻

1
2
3

npm install -g hexo-cli # 安装Hexo
mkdir mkdir <your_blog_name>  # 建立你的网站根目录，名字可以自己修改
hexo init <your_blog_name> # 往这个文件夹中安装Hexo

使用GitHub Pages部署到GitHub

部署 Hexo | Easy Hexo 👨‍💻

Step 1: 创建一个仓库：<username>.github.io

Step 2: 在（<username>.github.io）安装部署插件

1 2	npm install hexo-deployer-git --save npm install hexo-server --save

Step 3: 部署到 GitHub

1	hexo clean && hexo d -g

GitHub保存博客项目的源代码

# 本地博客项目根目录下运行
git init
git checkout -b hexo # 切换分支
git add .
git commit -m "init"
git remote add origin git@github.com:isJinHu/isjinhu.github.io.git # 添加远程仓库
git remote -v
git push origin hexo:hexo # push到远程仓库的hexo分支

Keep主题安装与配置

home_article | Keep 主题使用手册 && XPoet's Blog

Step 1: 安装Keep主题

1 2	cd <your_blog_name> npm install hexo-theme-keep

Step 2: 使用Keep主题：在 Hexo 配置文件 _config.yml 中将 theme 设置为 keep。

1	theme: keep

Step 3：配置Keep主题：在文件夹下创建一个 _config.keep.yml文件，参照文档进行配置：base_info | Keep 主题使用指南

其他：

可能用到的命令：

npm install hexo-theme-keep # 安装 keep 主题
npm install hexo-filter-mathjax # 安装显示数学公式的插件
npm install hexo-generator-searchdb # 安装站内搜索插件
npm install hexo-wordcount # 安装统计字数插件
hexo new page about # hexo创建页面命令，使用该命令创建about页面。

数学公式 | Keep 主题使用指南：建议开启。
配置时的图标文件可以放在 source/images文件夹中。
Gitalk设置：comment | Keep 主题使用指南

默认博客模板

在 scaffolds/post.md中可以设置默认模板，比如默认打开公式渲染等。

title: {{ title }}
date: {{ date }}
mathjax: true
tags:

图片插入：结合Typora

Step 1：修改 _config.yml文件

post_asset_folder: true # 将这个配置项改为true，这样hexo new “postname"时会创建一个同名文件夹
marked:
  prependRoot: true
  postAsset: true

Step 2：安装插件

1 2	npm install hexo-asset-img --save npm install hexo-renderer-marked --save

Step 3: 设置Typora插入图片时路径：${filename}

Hexo deploy失败？

执行Hexo d报错Spawn failed，以及OpenSSL SSL_read: Connection was reset, errno 10054_copying files from extend dirs…warning: in the w_Candle_light的博客-CSDN博客

1	hexo config deploy.repository git@github.com:isjinhu/isjinhu.github.io.git

其他链接

Hexo 如何隐藏文章 - yangstar - 博客园