HexoBlogClient基于HexoClient二次开发,是一个开源项目Github地址,本文将从Hexo博客的创建,客户端的使用,以及线上自动发布等各个方面讲解使用。
前提
本客户端的使用需要配置hexo博客
,创建hexo博客的方式有多种。本文将介绍gitlab来配置hexo博客
以前如何部署hexo
- 需要两个项目,一个存放hexo源码
项目1
,一个是编译后静态网页的项目2
- 每次在
项目1
写完文章都需要hexo deploy
部署到项目2
- 切换电脑都需要配置一样的环境,不然无法部署
原理概述
Gitlab是一个Git仓库,可以创建私人项目,也可以从各种模板中创建自己需要的项目。Gitlab提供了gitlab-ci实现自动化部署,通过持续集成CI/CD的方式,让编译自动化。
GitLab配置流程
第一步:配置ssh key公钥
- 打开本地的git bash,使用如下命令生成ssh公钥和私钥
ssh-keygen -t rsa -C 'xxx@xxx.com' 然后一路回车(-C 参数是你的邮箱地址)
- 打开.ssh目录下的公钥文件,复制内容
cd ~/.ssh
cat id_rsa.pub
- 打开gitlab,找到
Profile Settings
–>SSH Keys
—>Add SSH Key
, 粘贴到相应位置即可 - 验证是否ok
ssh -T git@gitlab.com
第二步:创建hexo博客项目
New project
—>Create from template
- 滑到底部选择
Pages/Hexo
—>Use template
,然后正常创建项目即可 - 打开刚创建的项目,选择左侧菜单的
CI/CD
,然后执行Run Pipeline
,静静等待执行完成,如下
- 执行完成后,打开左侧菜单的
Setting
—>Pages
,即可看到你的gitlab pages地址。打开网页地址就是你的hexo博客
- 配置自定义域名,看gitlab教程自己配置。
第三步:克隆项目到本地
- 使用ssh克隆项目到本地
git clone git@gitlab.com:xxx/xxx.git
- 进入该项目,安装依赖
npm install // yarn
第四步:使用HexoBlogClient
- 软件启动后选择上一步hexo博客的目录,等待读取Hexo目录中的文章。
- 支持新建、修改文章,新建修改文章之后点确认图标能够hexo博客提交到gitlab,gitalb会自动执行构建。
- 支持七牛图片上传,可自行注册配置七牛,配置好后将七牛的ak、sk、bucket、域名配置到HexoClient中
常见问题
-
点击这里提交问题:https://github.com/Xonlystar/hexo-blog-client/issues/new
-
Hexo中有文章,但是打开之后却显示空白
HexoBlogClient数据加载是完全依赖于Hexo的,所以在打开之前要确保你的Hexo是install成功的。
左侧有重新加载图标,可以点击重新加载