参考文献:
hexo中文文档
http://opiece.me/2015/04/09/hexo-guide/
http://blog.csdn.net/jzooo/article/details/46781805
http://blog.csdn.net/xuezhisdc/article/details/53130328
博主环境:Windows8.1
1. 前置条件—— 安装Git、Node.js
参考 hexo中文文档 概述篇,没什么要补充的。
2. 安装Hexo
第一步:
前置条件满足后,即Git、Node.js安装完成后,即可使用npm 安装 Hexo。
(npm是Git下的命令。若出现命令无法执行,检查下环境变量PATH。)
$ npm install -g hexo-cli
安装完成后的界面如下图:
第二步:设置初始环境
安装 Hexo 完成后,请执行下列命令,Hexo 将会在指定文件夹中新建所需要的文件。这个指定的文件夹就是以后的工作目录。我将它放在了G:\Hexo 路径下。
$ hexo init <folder>
$ hexo init G:\Hexo #我将它放在了G:\Hexo 路径下。
安装完成后的界面如下图:
第三步:安装依赖
切换到安装的指定文件夹中,安装依赖文件,命令如下:
$ cd <folder>
$ npm install
#这里建议在安装一些组件,防止后续的一些问题的出现
npm install hexo-server --save
npm install hexo-admin --save
npm install hexo-generator-archive --save
npm install hexo-generator-feed --save
npm install hexo-generator-search --save
npm install hexo-generator-tag --save
npm install hexo-deployer-git --save
npm install hexo-generator-sitemap --save
$ npm install
这个命令应该是用来安装一些Node.js 模块。我命令执行的结果如下:
看警告提示,大意是“跳过可选依赖:…………”,命令应该是已经执行成功了,这个WARN 警告可以忽视。
此时已经安装完成了。完成后的指定文件夹下的目录内容如下:
用dir
命令查看
文件目录说明
参见 Hexo中文文档 建站
_config.yml
网站的配置信息,可以配置大部分的参数
package.json
应用程序的信息。EJS, Stylus 和 Markdown renderer 已默认安装,您可以自由移除。
package.json
{
"name": "hexo-site",
"version": "0.0.0",
"private": true,
"hexo": {
"version": ""
},
"dependencies": {
"hexo": "^3.0.0",
"hexo-generator-archive": "^0.1.0",
"hexo-generator-category": "^0.1.0",
"hexo-generator-index": "^0.1.0",
"hexo-generator-tag": "^0.1.0",
"hexo-renderer-ejs": "^0.1.0",
"hexo-renderer-stylus": "^0.2.0",
"hexo-renderer-marked": "^0.2.4",
"hexo-server": "^0.1.2"
}
}
scaffolds
模版 文件夹。当您新建文章时,Hexo 会根据 scaffold 来建立文件。
Hexo的模板是指在新建的markdown文件中默认填充的内容。例如,如果您修改scaffold/post.md中的Front-matter内容,那么每次新建一篇文章时都会包含这个修改。
source
资源文件夹是存放用户资源的地方。除 _posts 文件夹之外,开头命名为 _ (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹,而其他文件会被拷贝过去。
themes
主题 文件夹。Hexo 会根据主题来生成静态页面。
本地预览Hexo博客
第一次使用hexo,在本地创建服务器使用。
hexo generate # 生成静态页面
hexo s # 开启本地服务器
打开浏览器,输入URL:localhost:4000(或127.0.0.1:4000),即可在本地预览,如下:
按【CTRL + C】 后,即可停止本地服务器:
将hexo博客部署到github上
Github 准备
首先你要先有一个Github 账号,可以直接去注册一个账号。
注册完成之后,登录,创建一个新的存储仓库:new repositories
点击新建仓库之后,界面如下:
注意:箭头所指部分填写仓库名,仓库名格式应该为:用户名.github.io
将hexo部署到Github上
修改配置文件blog/_config.yml,修改deploy项的内容(在文件末尾)。修改方式有两种。
第一种:
利用SSH链接协议,如下所示:
# Deployment 注释
## Docs: https://hexo.io/docs/deployment.html
deploy:
type: git
repo: git@github.com:XavierRoot/XavierRoot.github.io.git
branch: master
第二种:
利用http协议,如下所示:
# Deployment 注释
## Docs: https://hexo.io/docs/deployment.html
deploy:
type: git
repo: https://github.com/XavierRoot/XavierRoot.github.io.git
branch: master
注意:type: git中的冒号后面是有空格的。
输入下面的命令将hexo博客部署到github中:
hexo clean # 清空静态页面
hexo generate # 生成静态页面
hexo deploy # 上传到仓库
打开网页,输入URL:http://Github用户名.github.io,即可打开博客。
还有一种部署到Github上的方法,参见:最简单的Hexo搭建博客教程
大致说下基本思路:就是下载一个Github客户端,然后Clone下来你刚创建的仓库。再将hexo中的public文件夹下的所有东西全部粘贴到你刚刚Clone下来的仓库中,通过Github客户端提交上去,完成部署。
感兴趣的朋友可以自行尝试。
到这里,基本的安装就结束了,但是hexo还有很多的功能尚未接触,也将在接下来使用过程中,一点点的去学习,与大家共同进步。