JERRY-Hexo-GitHub

《JERRY Hexo & GitHub 静态网站搭建说明》

一、前言

1.1 什么是 Hexo？

一个基于

Node.js

• 超快速度
• 支持 Markdown
• 一键部署
• 插件和可扩展性
• 免费开源

1.2 什么是 GitHub？

一个面向开源及私有软件项目的托管平台，因为只支持

Git

• 全球最活跃开源社区
• 开源社交平台
• 企业项目管理平台

1.3 什么是静态网站？

通俗的讲静态网站指：只有

前端

后端

适用于博客、固定页面展示等网站。

1.4 Hexo 与 GitHub 搭配建站的优缺点

（1）优点

• 简单稳定
• 开源免费
• 社区活跃利于交流

（2）缺点：

• 国内访问速度慢
• 不支持动态网站搭建

二、安装 Git

2.1 什么是 Git？

Git

使用 GitHub 必须有 Git。

2.2 Git 的下载安装与配置

（1）下载安装

Git官网

选择对应系统版本下载，安装默认下一步即可。

（2）配置

打开终端键入以下命令：

$ git --version

# 查看 git 版本号
# 若成功识别即为 git 安装成功

$ git config --global user.name "xxx"
$ git config --global user.email xxx@xxx.com

# 配置个人的用户名称和电子邮件地址

$ git config --list

# ...
# user.name=xxx
# user.email=xxx@xxx.com

# 检查已有的配置信息
# 若配置信息中出现正确用户名及邮箱即为配置成功

三、安装 Node.js

3.1 什么是 Node.js？

一个基于

Chrome V8

JavaScript

PHP

Python

Perl

Ruby

脚本语言

3.2 Node.js 的下载安装与配置

Node.js官网

选择对应系统的长期支持版下载，安装默认下一步即可。

安装完成，打开终端键入以下命令：

$ node -v

# 查看 Node.js 版本

$ npm -v

# 查看 npm 包管理器版本

若以上两个命令都成功识别，那么 Node.js 便安装成功。

$ npm install -g cnpm --registry=https://registry.npm.taobao.org

# 利用 npm 下载国内淘宝镜像 cnpm

$ cnpm -v

# 查看 cnpm 版本
# 若以上命令成功识别，那么 cnpm 便安装成功

什么是 npm 和 cnpm ?

• npm

  (node package manager)：Node.js 的包管理器，用于 node 插件管理（包括安装、卸载、管理依赖等）。

• cnpm

  ：因为 npm 安装插件是从国外服务器下载，受网络的影响比较大，可能会出现异常，所以乐于分享的淘宝团队解决了这事。来自官网：“这是一个完整 npmjs.org 镜像，你可以用此代替官方版本(只读)，同步频率目前为 10分钟 一次以保证尽量与官方服务同步”。

四、安装 Hexo

4.1 Hexo 的下载安装与配置

下载安装：

可以参考Hexo官网

打开终端键入以下命令：

$ cnpm install hexo-cli -g

# 等待一会，安装完毕

$ hexo -v

# 查看 hexo 版本
# 若以上命令成功识别，那么 hexo 便安装成功

五、搭建静态网站

5.1 新建一个网站

$ hexo init [folder]

# 如果没有设置 folder，Hexo 默认在当前的文件夹建立网站

5.2 生成静态文件

$ hexo generate

# 该命令可以简写为 $ hexo g

5.3 启动服务器

$ hexo server

# 该命令可以简写为 $ hexo s
# 默认情况下，访问端口为：http://localhost:4000/
# 在浏览器中访问 http://localhost:4000/ 即可打开本地搭建好的网站

5.4 新建一篇文章

$ hexo new <title>

# 如果标题包含空格的话，请使用引号括起来 $ hexo new "first blog"
# 生成的 Markdown 文章放在 source 内的 _posts 下

六、利用 GitHub 部署网站

6.1 注册用户

GitHub官网

点击右上角注册即可。

6.2 创建同名仓库

• 点击右上的

  +

  ，选择

  New repository

  新建一个仓库

• 仓库名称设为

  用户名.github.io

• 仓库类型为

  Public

  公共类型

• 复制仓库

  HTTPS

  URL

6.3 更改 Hexo 配置文件

修改根目录

_config.yml

deploy

# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
type: 'git'
repo: https://github.com/用户名/用户名.github.io.git	# HTTPS URL
branch: master

6.4 安装 hexo - git 部署工具

在 Hexo 博客根目录下，打开终端键入：

$ cnpm install hexo-deployer-git --save

# 安装 hexo-deployer-git 工具

6.5 远程部署到 GitHub Pages 服务器

$ hexo deploy

# 该命令可以简写为 $ hexo d

部署成功后即使用

https://用户名.github.io/

七、结束语

7.1 美化 Hexo 网站

Hexo 支持主题自定义，并且有一个活跃的 主题社区。

切换主题方法：下载主题到

themes

_config.yml

theme

修改配置主题请查阅相应主题的文档。

目前比较热门的几个主题：

• NexT GitHub
• Butterfly GitHub
• Yilia GitHub
• Matery GitHub

7.2 使用 Hexo 插件

Hexo 是一个支持插件的可扩展框架，具体插件类型及安装方法请前往 Hexo 官网查看 或在搜索引擎求助。

7.3 帮助文档

Hexo 提供了全面的 Hexo 使用文档（中英文版）及 API 文档，在使用及开发优化 Hexo 的过程中，建议以官方文档为基准。