HexoBlogClient使用指南

HexoBlogClient基于HexoClient二次开发,是一个开源项目Github地址,本文将从Hexo博客的创建,客户端的使用,以及线上自动发布等各个方面讲解使用。

前提

本客户端的使用需要配置hexo博客,创建hexo博客的方式有多种。本文将介绍gitlab来配置hexo博客

  • 使用hexo官方的hexo-cli脚手架创建。
  • 使用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
    image.png
  • 滑到底部选择Pages/Hexo—>Use template,然后正常创建项目即可
  • 打开刚创建的项目,选择左侧菜单的CI/CD,然后执行Run Pipeline,静静等待执行完成,如下
    image.png
  • 执行完成后,打开左侧菜单的Setting—>Pages,即可看到你的gitlab pages地址。打开网页地址就是你的hexo博客
    image.png
  • 配置自定义域名,看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成功的。
    左侧有重新加载图标,可以点击重新加载

更新日志


 上一篇
Unable to preventDefault inside passive event listener Unable to preventDefault inside passive event listener
在做禁止浏览器或微信下拉出现网页来源的这个功能时用到了下面的代码 document.body.addEventListener('touchmove', e => e.preventDefault()) 在控制台看到了下面的报错
2018年10月22日
下一篇 
winscp普通用户上传文件没有权限解决 winscp普通用户上传文件没有权限解决
winscp可以利用sftp协议对linux服务器就行连接,如果是利用普通用户进行登陆的话,上传文件的过程中会出现一些permission denied的提示,并且错误的返回码是3,下面说明下解决方法。 查看sftp应用程序的路径
2018年10月20日
  目录