准备工作
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语法等内容。