Hexo部署使用

前言

使用Hexo，首先需要node和git环境，其次要有gitee或github账号以及git pages创建。有这些前置条件才能进行使用。

环境搭建

安装node

# 安装过程省略，验证环境
node -v
npm -v

# 查看npm的配置
npm config list
# 默认源
npm config set registry https://registry.npmjs.org
# 临时改变镜像源
npm --registry=https://registry.npm.taobao.org
# 永久设置为淘宝镜像源
npm config set registry https://registry.npm.taobao.org
# 另一种方式，编辑 ~/.npmrc 加入下面内容
registry = https://registry.npm.taobao.org

安装git

# 安装过程省略，验证环境
git
git --version

本地安装hexo静态博客框架

框架安装

# hexo框架的安装
npm install -g hexo-cli
# 等上一个命令完成后，在输入下面的命令
hexo init <新建文件夹的名称>  #初始化文件夹
cd <新建文件夹的名称>
npm install  # 安装博客所需要的依赖文件

初步使用

hexo g # 生成网站静态文件到默认设置的 public 文件夹。
hexo s # 启动本地服务器，用于预览主题。默认地址： http://localhost:4000/

启动后能看到页面则说明搭建成功，后面可以进行一些自定义优化。

发布到Gitee Pages

首先需要安装发布的插件，在站点目录下执行下面的命令，也就是创建的博客目录下：
```
npm install hexo-deployer-git --save
```
紧接着，将本地目录与 GitHub 关联起来，输入下面的命令行：
```
ssh-keygen -t rsa -C "你的邮箱地址"
```
然后一直回车，然后在 C:/Users/[username] 目录下找到名为.ssh 的文件夹，文件夹内会有两个文件，一个 id_rsa.pub 一个 id_rsa，用文本编辑器打开 id_rsa.pub，复制里面的的内容。然后打开 Gitee，点击右上角的头像 Settings 选择 SSH and GPG keys。

点击 New SSH key 将之前复制的内容粘帖到 Key 的框中。上面的 Title 可以随意，点击 Add SSH key 完成添加。

然后回到 Git 的命令行界面，测试一下是否与 GitHub 连接成功。输入下面的命令行：
```
ssh -T git@github.com
```
点击回车，然后会出现一个询问内容，输入 yes，回车，会出现一段内容，Hi ! You've successfully authenticated, but GitHub doesnot provide shell access.。说明连接成功。此处这个 `` 应该是你 Github 的用户名。

进入博客站点目录，用文本编辑器打开_config.yml，这个_config.yml 是博客的配置文件，在以后的博客修改，如个性化修改，博客 SEO 优化等都会使用到，修改如下图的几个地方：

title: 你的博客名
subtitle: 博客的副标题，有些主题支持
description: 博客描述
keywords: 博客关键词
author: 作者，在文章中显示
language: 博客语言语种   
timezone: 时区

滑到文件最底部，有一个 deploy，在 deploy 下面添加一个 repo 项，一个 branch 项。填入如下代码，并如下图所示：

type: git
repo: git@github.com:Github用户名/github用户名.github.io.git  
# 也可使用https地址，如：https://github.com/Github用户名/Github用户名.github.io.git            
branch: master

最后就是生成页面，并发布至 Gitee Pages，执行如下命令：
```
# Hexo会根据配置文件渲染出一套静态页面
hexo g
# 将上一步渲染出的一系列文件上传至至Gitee Pages
hexo d
# 也可以直接输入此命令，直接完成渲染和上传
hexo g -d
```
上传完成后，在浏览器中打开 https://<用户名>.gitee.io，查看上传的网页。如果页面变成了之前本地调试时的样子，说明上传以及完成了。没变的话查看一下上传时命令行窗口的信息有没有错误信息，没有的话清除一下浏览器缓存试试。