Use Hexo to Build My Gitee Blog
之前有自己建站托管自己的博客系统, 后来因为流量实在太少, 服务器又要每个月出钱, 然后就把她关了, 然是拥有自己的网站的心一直没有退去啊, 然后之前有接触到别人用GitHub托管静态网页的玩法, 因此个人也想布一个, 个人比较喜欢支持国产, 所以我用的Gitee, 原理都是一样的.
Gitee托管的是静态网页, 对于一个博客系统, 我们不可能动手全部去写Html, 于是我们这个时候就借助了一个叫做Hexo的博客工具(注意是工具, 不是系统), 把我们的Markdown文件转换成Html, 然后借助主题按照一定的风格样式以及规则, 生成一整套的Html.
下面我就来介绍如何使用Hexo在Gitee上面搭建自己的博客.
Hexo的安装
安装环境
安装 Hexo 相当简单,只需要先安装下列应用程序即可:
- Node.js(Node.js 版本需不低于 8.6,建议使用 Node.js 10.0 及以上版本)
- Git
如果您的电脑中已经安装上述必备程序,那么恭喜您!接下来只需要使用 npm 即可完成 Hexo 的安装。
$ npm install -g hexo-cli
创建项目
$ hexo init <folder>
$ cd <folder>
$ npm install
本地运行
项目创建完之后, 系统会有一个默认的landscape的主题, 通过运行以下命令, 就可以在浏览器预览效果了.
$ hexo server
至此, 你的本地环境就准备好了, 只等你进行编译并且发布了.
创建Gitee项目
以我的Gitee举例https://gitee.com/jerryqi.
创建仓库
创建仓库的时候记得是空仓库, Readme和gitignore都可以不要, 有的话对于git新手会造成一点点的小麻烦.
博客地址
这里把后面的内容提到前面来说了, 一开始我创建了一个名为blog的项目, 最后博客的地址是https://jerryqi.gitee.io/blog, 而我不喜欢后面这个blog的后缀, 通过查看gitee的文档, 原来规则是, 要想没有后缀, 你的仓库名必须和你的用户名是一样的, 于是我把仓库名从blog改成了jerryqi, 于是最终我的博客地址就成了https://jerryqi.gitee.io
发布博客
上传内容
上传内容首先要通过配置把本地的博客系统和刚才建的git仓库打通, 找到——config.yml, 配置如下内容:
deploy:
type: git
repo: git@gitee.com:jerryqi/jerryqi.git
branch: master
配置完成后运行如下命令上传html到Gitee仓库:
hexo clean && hexo g && hexo d
其他的配置内容, 请参考文档自行配置.
发布内容
至此, 我们在我们刚才的创建的仓库已经可以看到我们上传的文件了.
在仓库页面选择Services, 然后选择Gitee Pages, 然后点击发布即可大功告成.
免费版本的限制
这里说明一下, Gitee Pages免费版本是有限制的, 目前据我所知有以下几点:
- 文件大小限制为300M.
- 不能绑定自定义的域名.
- 每次本地Deploy之后, 托管网页并不会自动更新, 而是要进入Gitee Pages进行手动的Update.