Hexo文章转换器II

a view of a beach and a body of water

Hexo系列文章:

  1. 从0到1部署博客系统到GitHub Page(0成本)
  2. hexo如何修改主题?
  3. hexo-Acrylic主题集成twikoo评论
  4. 如何将JavaFX的java项目打包成exe格式

背景

该工具可以帮助你在使用Hexo写博客的时候,将文章直接转换成为Hexo可识别并可展示在页面;

每次在写博客的时候,都需要手动在文章的开头添加Front-Matter的信息:

image-20230619104358612

感觉不太方便,所以想通过界面化的方式,将过程进行简化(要不,每次都手动在文章的开头写上—xxx—,太麻烦)。

基于此,本文通过界面化的方式,将文章进行格式化,通过代码的方式自动在文章开头插入markdown可识别的字符串。


⭐⭐⭐⭐V1.0.0更新日志

第一版的Hexo文章转换器使用起来不太方便,所以在第一版的基础上进行了更新,主要是将标签和分类的信息保存到sqlite数据库中,不再用户每次都手动输入了。(初版的思路是,标题、 创建时间、位置等一些信息可以从后台直接获取,比如标题可以通过读取文章的第一行获取,然后将标题生成到原文中就行,不知道为什么打包成exe格式之前,标题都能从文章中提取出来,但是在exe中如果获取出来的标题永远都是乱码,各种尝试都无用,无奈,手动输入标题吧)

⭐⭐⭐⭐⭐V1.1.0更新日志

V1.1.0版本在界面上进行了一系列的改动,优化了用户体验,主要体现在:

  1. 显示内容正常无遮挡。上一版本由于页面布局的问题,cover一般都会很长,导致遮挡后面部分label。
  2. 新增一键重置功能,考虑到有可能一次性转换多个文章,如果不重置的话,无法重新上传文件并转换,只能关掉应用程序重新打开,才能进行转换新的文章。
  3. 新增标签管理和分栏管理Tab页。在最顶端新增两个Tab页,分别用来对标签和分栏的新增和删除功能。
  4. 优化了大部分的代码,包括但不限于接口实现jdbc操作数据库功能,提高易用性和扩展性、新增表结构、合适的地方处理异常等等。

示例

image-20230628164814150

使用该工具可以避免手动输入这些信息,而是通过界面化的方式进行配置:

image-20230628164828060

但是,建议在使用之前进行两项的配置

image-20230628164907063

工作目录:主要是基于这个目录,执行一系列指令:hexo clean、hexo g和hexo d等指令。

上传文件目录:在Hexo转换器Tab中,需要上传文件之后才能点转换,这里的位置就是点击后重定向的位置,换句话说,就是你平常文章经常放的位置,通常是_posts。

image-20230628165125467

关于Hexo转换器界面,主要就是讲解这个页面是干什么用的,解决了什么问题。

技术说明

Java17(开发语言)、Java FX(Java界面工具,类似于java8的swing,现已不支持java8)、SceneBuilder(拖拽式界面工具)、exe4j(jar转exe工具)。

踩坑无数,尤其是将java转为exe的过程中,踩了一晚上吧。

如何使用

下载地址:

HexoHelper下载地址

下载好之后,解压缩,解压缩之后,需要注意的是,db文件夹要和hexoHelper.exe是同级目录,db文件夹中是sqlite的数据库,运行的时候需要找到db的数据库才行。最终文件的位置关系:

image-20230628165640833

开始运行,会出现[示例]中的界面。

功能说明

现在的界面主要分三个主Tab:

Hexo转换器

该界面主要分三个部分:

从上到下依次是Front-Matter清单,在这里可以看到你填写的一些文章信息,这也是最终会填写到你文章里面的内容;

输入区:在这里你需要输入一些文章信息,这个和Front-Matter清单联动,修改了什么会体现在清单上。

最下面是功能区域:

【上传文件】:点击上传文件按钮之后,选中待转换的markdown文件(没有front-matter信息的markdown文件)

【转换格式】:对已上传的文件进行格式转换,在文章头添加已经输入的front-matter信息。

【部署】:执行hexo clean、hexo g、hexo d一系列指令。

【一键部署】:对已上传的文件进行格式转换并执行hexo clean、hexo g、hexo d指令部署到对应平台上。

设置

主要设置一些提升用户体验的必要信息。

工作目录:主要是基于这个目录,执行一系列指令:hexo clean、hexo g和hexo d等指令。

上传文件目录:在Hexo转换器Tab中,需要上传文件之后才能点转换,这里的位置就是点击后重定向的位置,换句话说,就是你平常文章经常放的位置,通常是_posts。

关于Hexo转换器

主要介绍了该工具解决了什么问题,如何使用及关于作者等信息。

使用流程说明

image-20230619105823619

待优化问题

  1. 用户使用优化。
  2. 标签和分类的操作业务流程有问题。无法删除标签和分类。考虑在设置中体现。
  3. 显示优化,如果cover或者其他字段太长的话,会影响到字体显示。