HEXO,是一款基于Node.js的轻量的静态博客框架,利用它可以在github上快速构建个人的静态博客。下面就将我自己的构建博客的过程分享给大家。
1 安装环境
1.1 安装node.js
由于HEXO是基于node.js的静态框架,我们首先要安装node环境。在node.js官网进行下载安装.
1.2 安装git及申请github账号
关于git的安装以及github账号的创建,可自行百度或者在官网的指引下操作,此处省略。
1.3安装HEXO
接下来利用npm安装HEXO
1 | $ npm install -g hexo |
1.4 建立本地博客目录
安装好HEXO后,建立一个文件夹。
1 | $ hexo init <fileName> |
生成的目录结构,及各目录文件作用:
scaffolds 脚手架,也就是一个工具模板
scripts 写文件的js,扩展hexo的功能
source 存放博客正文内容
source/_drafts 草稿箱
source/_posts 文件箱
themes 存放皮肤的目录
themes/landscape 默认的皮肤
_config.yml 全局的配置文件
db.json 静态常量
然后进入到该文件夹中,执行下面操作:
1 | $ npm install |
生成静态页面(hexo\public\目录):执行下面命令后,会在本地生成一个public目录。该目录下生成的文件,即为之后上传到github上并用于发布的静态文件。
1 | $ hexo generate |
本地发布:执行下面命令后,会在启动本地服务,访问localhost:4000,即可看到博客的页面。
1 | $ hexo server |
2 配置Github
如何将静态博客利用github进行部署呢?下面来看下操作步骤。
2.1 在Github上建立个人Repository
建立reponsity过程可参考Github Pages.
2.2 配置_config.yml文件
在_config.yml文件末尾,配置如下内容。其中,reposity对应的url为上一步在Github上建立的reposity地址。
deploy:
type: git
repository: https://github.com/username/reposityname.github.io.git
branch: master
配置完成后,执行如下命令:
1 | $ hexo deploy |
因为我建立的reposity名字为cqu2008,所以我就直接在浏览器中访问 http://jiaochunxiao.github.io/
3 建站过程中的一些问题
3.1 本地发布失败
本地发布,执行 hexo server 失败。解决方案: 执行如下命令。
1 | $ npm install hexo-server --save |
执行完此命令后,再执行
1 | $ hexo server |
即可看到博客的效果。
3.2 Github部署失败
执行下面命令:
1 | $ hexo deploy |
会出现: Deployer not found: git
此时执行如下命令:
1 | $ npm install hexo-deployer-git --save |
此时再去执行,hexo deploy ,就可以成功部署了。
3.3 部署步骤
配置后_config.yml后,通用的三条部署命令(好比是大象装冰箱,一共分三步):
1 | $ hexo clean |
3.4 常用命令
1 | hexo new "postName" #新建文章 |