准备工作
Git
Node.js
Github
Git 和 Node.js 是安装 Hexo 的必备程序。请下载安装包后自行安装。使用 Github Pages 功能,完成静态网站发布。
笔者的软件环境:
操作系统:Windows 10 专业版 version 17134.590
Git:version 2.20.1.windows.1
Node.js:version 10.15.1
创建 Repo
Repo 的名称,按照 username.github.io 进行命名。把 username 换成你的 GitHub 账号的 username。
安装 Hexo
$ npm install -g hexo-cli
$ hexo -v #检验是否安装成功
在命令提示符,直接运行指令,即可进入安装流程。此处安装的,是 Hexo 运行环境。
建站
$ hexo init <folder> #须在空目录下执行
$ cd <folder>
$ npm install
执行后,生成如下目录:
其中,_config.yml 是配置文件。在部署时需要修改部分参数。
部署
$ npm install hexo-deployer-git –save
先安装 hexo-deployer-git,之后修改目录下的配置文件 deployment 模块。
deploy:
type: git
repo: https://github.com/JiLuanxi/jiluanxi.github.io.git
branch:
message:
参数说明:
repo:直接复制 Repo 的 URL 即可
branch:默认 push 到哪个分支。如果为空,则默认 push 到 master 分支
message:默认提交信息。如果为空,则默认为 Site updated: {{now(‘YYYY-MM-DD HH:mm:ss’) }}
$ hexo deploy
运行后,即可将网站部署到服务器上。
在浏览器中输入 username.github.io 就可以正常访问了。
如果需要自定义域名,需要:
在域名服务提供商处,做好域名解析。
在 master 分支下,CNAME 文件(无后缀),内容直接写注册的域名即可。
几点建议
配置文件 _config.yml 千万不要使用记事本打开。记事本不会保存为 UTF- 8 的编码。如果你的博客名称是中文,会在网站上显示成乱码。建议使用 Atom 或者 Sublime Text 打开。
本文仅简单介绍安装、部署流程,不涉及配置文件、主题修改、Markdown 语法等内容。
参考文档
Hexo 官方文档
Github Pages