Hexo + Github Pages部署个人网站

1. 前言

Hexo是一个快速、简洁且高效的博客框架，支持部署到Github Pages上，实现零成本建站。

2. 准备工作

Node.js：提供npm包管理器套件。
Git：分布式控制版本系统，支持将档案发布到Github Pages

你需要去官网下载这两个作为前置准备。

3. Hexo部署

命令行输入以下命令以安装Hexo：

npm install hexo-cli -g

安装后可以输入hexo -v查看版本确认是否安装成功，类似以下返回即可。

下一步进行初始化，可以创建文件夹以存放Hexo文件再在文件夹中初始化，也可以直接通过命令初始化。

hexo init [文件夹名称]

这一步有时候报错，通常是网络问题，尝试多次或科学上网即可。

安装npm套件和git套件。

npm install
npm install hexo-developer-git --save

完成这些操作后你会得到这样的文件夹结构：

├── .deploy_git
├── .github
├── node_modules
├── public
├── scaffolds
├── source
├── themes
├── .gitignore
├── _config.landscape.yml
├── _config.yml
├── db.json
├── package.json
└── package-lock.json

3.1 简单介绍

简单讲讲常用的一些文件和文件夹作用，具体可以查阅官方文档。

_config.yml:存放有关网站标题、语言等配置项。
source:存放网站文章，其他如关于页面。
themes:存放网站主题，官网中可以找喜欢的主题下载使用。

3.2 常用指令

hexo cl   //清除缓存文件和已生成的静态文件
hexo g    //生成静态文件
hexo d    //部署到github仓库，一般上传流程就是把这三个命令轮流执行一遍
hexo s    //启动本地服务器，通过预设地址http://localhost:4000/在本地预览你的网站

4. 部署到Github

首先需要创建一个仓库，仓库名为你的用户名.github.io，创建好后打开_config.yml文件，找到deploy部分，修改代码为：

deploy:
  type: git
  repo: git@github.com:你的用户名/你的用户名.github.io.git
  branch: master

之后你需要生成SSH密钥添加到github。

ssh-keygen -t ed25519 -C "github注册邮箱"
//或者
ssh-keygen -t rsa -b 4096 -C "github注册邮箱"

执行命令后会提示输入保存密钥的文件之类的，一路回车即可。之后将密钥添加到SSH代理。

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519   //id_ed25519是你密钥文件的名字

来到设置页面找到SSH and GPG keys，在右侧添加你的密钥。你也可以来到仓库页面的设置中添加密钥。

完成后执行命令：

hexo cl
hexo g
hexo d

之后就可以通过https://你的用户名.github.io/访问你的网站。

5. 使用自己的域名

来到仓库设置中，选择Pages，右侧找到Custom domain，添加你解析过的域名。

有个公益组织会免费提供欧盟的子域名.eu.org，如果你目前无力负担域名花费，你可以在这里申请。

6. 参考资料

▲

▼