季銮西的博客

准备工作

1. Git
2. Node.js
3. Github

Git 和 Node.js 是安装 Hexo的必备程序。请下载安装包后自行安装。使用 Github Pages 功能，完成静态网站发布。

笔者的软件环境：

1. 操作系统：Windows 10 专业版 version 17134.590
2. Git：version 2.20.1.windows.1
3. Node.js：version 10.15.1

创建Repo

1. Repo的名称，按照 username.github.io 进行命名。把 username 换成你的 GitHub 账号的 username 。

安装Hexo

1 2 3

$ npm install -g hexo-cli $ hexo -v

在命令提示符，直接运行指令，即可进入安装流程。此处安装的，是 Hexo 运行环境。

建站

1 2 3

$ hexo init <folder> #须在空目录下执行 $ cd <folder> $ npm install

执行后，生成如下目录：

其中，_config.yml 是配置文件。在部署时需要修改部分参数。

部署

1	$ npm install hexo-deployer-git --save

先安装 hexo-deployer-git，之后修改目录下的配置文件deployment模块。

1 2 3 4 5

deploy: type: git repo: https://github.com/JiLuanxi/jiluanxi.github.io.git branch: master message:

参数说明：

• repo：直接复制 Repo 的URL即可
• branch：默认 push 到哪个分支。如果为空，则默认 push 到 master 分支
• message：默认提交信息。如果为空，则默认为提交时间

1	$ hexo deploy

运行后，即可将网站部署到服务器上。

在浏览器中输入 username.github.io 就可以正常访问了。

如果需要自定义域名，需要：

1. 在域名服务提供商处，做好域名解析。
2. 在Repo的 master 分支下，创建 CNAME 文件，内容是自己注册的域名。CNAME文件，需要在 Hexo 目录下的 public 文件夹里创建。这样，才不会被每一次 deploy 覆盖掉。

注意点

1. 千万 不要使用记事本打开配置文件_config.yml。记事本 大专栏  季銮西的博客不会保存为UTF-8的编码。如果你的博客名称是中文，会在网站上显示成乱码。建议使用Atom或者Sublime Text 打开。
2. 在执行hexo deploy命令时，可能会遇到警告提示：

1 2	warning: LF will be replaced by CRLF in lib/pjax/jquery.pjax.min.js. The file will have its original line endings in your working directory

在文件入库前，js文件中的 LF 将会被 CRLF 替换，并提交到仓库。工作目录下的文件中，换行符依然时 LF。

这个提示是由于Windows和Unix的换行符差异，导致执行命令时需要进行换行符转换。这也是Git确保跨平台协作进行的操作。

我使用Atom进行文本编辑，版本是 v1.34.0 x64。在编辑器的右下角，可以进行LF和CRLF的切换。

部署到Coding

由于GitHub在国内的访问速度较慢，可以考虑使用Coding Pages进行静态页面托管。Coding Pages 是由国内的代码托管服务商Coding提供的。按照 Coding Pages 网页上的流程走，即可完成部署。其实，提交到GitHub的同时，也提交到Coding，也算是备份了。

如果要把Hexo提交到Coding上，需要修改Hexo的配置文件的url参数和deploy参数。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

# URL ## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/' url: https://jiluanxi.coding.me/ # 开启Pages服务后，由Coding自动生成 root: / # Deployment deploy: - type: git repo: https://github.com/JiLuanxi/jiluanxi.github.io.git branch: master message: - type: git repo: https://git.coding.net/jeluomsy/jiluanxi.coding.me.git # Coding提供的仓库url branch: master message:

最后，别忘了自定义域名的解析设置。此处需要注意，自定义域名要么解析到 username.github.io ，要么解析要 username.coding.me。

---

本文仅简单介绍安装、部署流程，不涉及配置文件、主题修改、Markdown语法等内容。

参考文档

1. Hexo官方文档
2. Github Pages