How to Install and Configure Hexo for a Static Blog on GitHub

理想主义的功能不是卖钱，是它在实用主义无力的时候延伸了它的无言 ——严明

1. 安装 Hexo

什么是 Hexo？

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

安装前提

安装 Hexo 之前，需要系统中已有 Node.js 和 Git 环境。推荐使用 nvm 安装 Node.js。

使用 curl 安装 nvm：

curl https://raw.github.com/creationix/nvm/master/install.sh | sh

使用 wget 安装 nvm：

wget -qO- https://raw.github.com/creationix/nvm/master/install.sh | sh

安装完成后，重启终端并执行以下命令安装 Node.js：

nvm install stable

安装并启动 Hexo

全局安装 Hexo CLI： npm install -g hexo-cli 如果没有 npm，可通过 yum 安装。

检查 Hexo 版本：

hexo -v

初始化博客目录： hexo init blog 进入目录并安装依赖：

cd blog

npm install

生成静态文件并启动本地服务器：

hexo g

hexo server

默认在 4000 端口，可通过 -p <port> 修改。

在浏览器访问 http://localhost:4000/ 即可查看。

2. 在 GitHub 上的配置

添加公钥到 GitHub

生成 SSH 密钥：

ssh-keygen -t rsa -C "[email protected]"

登录 GitHub，进入 Settings → SSH and GPG keys → New SSH key，粘贴公钥。

创建 GitHub 仓库

在 GitHub 个人页面点击 “Your repositories” → “New” 创建仓库，仓库名使用用户名。

修改配置文件

编辑博客根目录下的 _config.yml ，将 repository 地址改为新建的仓库 URL。

执行部署命令：

hexo generate

hexo deploy

若出现 ERROR Deployer not found: git ，安装 Git 部署插件：

npm install --save hexo-deployer-git

完成安装查看博客

访问 https://wahaha5354.github.io/ 即可看到已发布的博客。

3. Hexo 博客配置

修改博客默认主题

从 Hexo 主题库 选择喜欢的主题，例如 next，克隆到本地：

git clone https://github.com/theme-next/hexo-theme-nextthemes/next

编辑 _config.yml 将 theme: landscape 改为 theme: next 。

重新生成并部署：

hexo generate

hexo deploy

修改网站内容

编辑根目录下的 _config.yml ，修改以下字段： title: WangEr's Blog – 网站标题

subtitle: 生活不止眼前的苟且，还有远方的西洋参和鹿茸

– 副标题

description: 记录生活的点滴，Linux 运维学习笔记

– 网站描述（用于 SEO） author: wanger – 作者 language: zh-Hans – 语言 timezone: (默认使用电脑时区) – 时区

修改完成后执行：

hexo clean

hexo g

hexo d

新建博文

使用以下命令创建新帖子或页面： hexo new [layout] <title> layout 可选，默认 post ，可在 _config.yml 中的 default_layout 更改。

布局（layout）

存储路径

说明

post

source/_posts

默认，可直接发布

page

source

在 source 下新建文件夹

draft

source/_drafts

草稿文件，写博客的草稿

示例：创建测试页并编辑内容： hexo new test 编辑 source/_posts/test.md 后再次执行：

hexo clean

hexo g

hexo d

至此 Hexo 博客搭建完成，更多细节可参考官方文档 https://hexo.io/zh-cn/docs/ 。