Hexo入门

• Hexo环境搭建
  • 安装Node.js
  • 安装Git
• 安装 Hexo
• 创建博客
• 安装Butterfly主题
• 远程部署
  • Gitee Pages
  • Github Pages
  • 配置
  • 执行部署命令

Hexo官方中文说明文档

Hexo环境搭建#

Hexo所需要的的应用程序

1. Node.js

2. Git

安装Node.js#

• node.js 官方下载地址

查看node版本

node -v

查看npm版本

npm -v

两行命令验证是否安装成功

安装Git#

• git 官方下载地址

安装 Hexo#

• 使用npm安装 Hexo

npm install -g hexo-cli

安装以后，可以使用以下两种方式执行 Hexo：

1.npx hexo <command>

2. 将 hexo.cmd 所在的目录 node_global 添加到环境变量之中即可直接使用hexo <command>

• 查看 hexo 版本

hexo -v

创建博客#

• 新建一个文件夹blog并对其初始化（管理员身份）

cd blog
hexo init
npm install

生成以下文件和目录

• 启动本地博客服务

hexo s

• 输入http://localhost:4000默认地址本地访问

安装Butterfly主题#

Butterfly 主题是我当前使用的 Hexo 博客主题

Butterfly 文档

Butterfly github项目地址

• 安装

在 Hexo 根目录下

git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

• 应用主题

修改 Hexo 根目录下的_config.yml，把主题改为 butterfly

theme: butterfly

• 安装渲染器

npm install hexo-renderer-pug hexo-renderer-stylus --save

• 升级主题

升级方法：在主题目录下，运行git pull

• 配置建议

为了方便升级主题后带来的不便，建议更改一些配置

在 hexo 的根目录创建一个文件_config.butterfly.yml ，并把主题目录下的_config.yml內容复制到_config.butterfly.yml 。

Hexo 自动合并主题_config.yml和_config.butterfly.yml中的配置。如果存在同名配置，则将使用该配置。_config.butterfly.yml的配置具有高优先级。

远程部署#

建议选择 Github，部署到 Gitee 的时候遇到了一些布局上的小错误，但在 Github 上是没有的，虽然 Github 有时访问不了，但借助一些工具还是可以快速访问和远程部署的

• 安装部署插件

npm install hexo-deployer-git --save

Gitee Pages#

Gitee Pages 官方帮助详情说明

• 创建 Gitee 账号

• 新建仓库

  公开或者私有都可以

  • 一级域名

    仓库名如果设置成和个人空间地址一样，那么访问地址就是：<个人空间地址名>.gitee.io

  • 二级域名

    仓库名如果设置成别的，那么访问地址则是：<个人空间地址名>.gitee.io/仓库名

• 启动 Gitee Pages

  在该仓库页面中点击“服务”>Gitee Pages> 勾选“强制使用HTTPS” > 点击“启动”

  

Github Pages#

• 创建 Github 账号

• 新建仓库

  • 创建一个仓库，仓库设置为公开才能免费使用Github Pages服务

  • 仓库名必须设置为：<用户名>.github.io

  • 创建完成后，就可以通过<用户名>.github.io来访问站点

配置#

• 在 Hexo 根目录下的_config.yml添加配置

  可选择一个部署，也可支持双部署

deploy:
  type: git
  # Gitee Pages
  repo: https://gitee.com/<用户名>/<用户名>.git
  # Github Pages
  repo: https://github.com/<用户名>/<用户名>.github.io.git
  branch: master

• 如果是域名带子目录，还需要多添加一项配置

# URL
url: https://<用户名>.gitee.io/project
root: /project

执行部署命令#

在 Hexo 根目录下执行以下命令

hexo c
hexo g
hexo d

注意

• 对于 Gitee Pages ，由于不支持自动更新，每次执行命令部署后需要手动点击更新，等待更新完成后访问地址即可看到效果。

  

  如果看不到效果的话，暂停服务，然后再重新启动。

• 对于 GitHub Pages，它支持自动更新，无需额外操作，稍等片刻后访问即可。