zhengyi
fb218ac50b
Build Plugin JAR File / build (push) Failing after 27s
Details
Build Plugin JAR File / github-release (push) Has been skipped
Details
|
||
---|---|---|
.gitea/workflows | ||
.github/workflows | ||
console | ||
gradle/wrapper | ||
src/main | ||
.editorconfig | ||
.gitignore | ||
LICENSE | ||
OWNERS | ||
README.md | ||
build.gradle | ||
gradle.properties | ||
gradlew | ||
gradlew.bat | ||
settings.gradle |
README.md
halo-plugin-vditor
This Version 🏷️v1.2.0
⚠️ 破坏性: 设置中有关渲染器的设置项会恢复到默认值,您需要重新进行设置
- 🚸 将设置拆分为编辑器和渲染两个部分
- ✨ 为编辑器添加多国语言支持
- ✨ 添加启用编辑器代码块的选项
- ✨ 添加跟随Joe 3.0主题切换暗色模式的选项
- 🐛 修复单页未对内容进行渲染的问题
- 🐛 修复所见即所得模式下部分内容被小工具栏遮挡的问题 issue by musnows
本插件将Vditor整合进Halo,支持所见即所得编辑模式。 Support English (*Only Editor)!
编辑器支持数学公式、脑图、图表、流程图、甘特图、时序图、五线谱、graphviz 渲染、plantumlUML图
如果您在使用本插件的过程中发现了BUG或新的建议,欢迎您在 Github ISSUE 中提出
Vditor 是一款浏览器端的 Markdown 编辑器,支持所见即所得、即时渲染(类似 Typora)和分屏预览模式。它使用 TypeScript 实现,支持原生 JavaScript 以及 Vue、React、Angular 和 Svelte 等框架。
✨特性
- 集成强大的Markdown编辑器Vditor进Halo中
- 提供所见即所得(wysiwyg)、即时渲染(ir)、分屏渲染(sv)三种渲染模式
- 支持大纲、数学公式、脑图、图表、流程图、甘特图、时序图、五线谱、多媒体、语音阅读、标题锚点、代码高亮及复制、graphviz 渲染、plantumlUML图
- 支持字符计数
- 支持在前台注入渲染脚本(需在设置中开启)
- 更多强大的语法功能请 ->到这<- 查看 (部分功能仍未支持)
💻使用方式
- 下载,目前提供以下下载方式:
- GitHub Releases:访问 Releases 下载 Assets 中的 JAR 文件。
- Halo 应用市场:https://www.halo.run/store/apps/app-uBcYw
- 安装,插件安装和更新方式可参考:https://docs.halo.run/user-guide/plugins。
- 安装完成之后,进入文章新建页面即可在右上角编辑器切换按钮中看到 Vditor 编辑器。
🤖兼容性
下面是当前已知的兼容性问题
- 在同时使用ToolBench插件时,数学公式、脑图、图表、流程图、甘特图、时序图、五线谱无法正常渲染。
会尝试修复
- Vditor渲染器不会根据主题暗色模式进行改变,当前仅支持跟随系统暗色模式
📒TODO
如果可以支持的功能将会加入到这个TODO列表中,列表中没有的功能也未必是不能支持的,可能只是开发者没有想到
- 能够在Halo中运行Vditor编辑器
- 支持数学公式、脑图、图表、流程图、甘特图、时序图、五线谱、graphviz 渲染、plantumlUML图
- 添加编辑器默认展示模式设置
- 优化代码命名
- 添加打字机模式
- 支持附件选取插入
- 支持暗色主题渲染
🧪
支持多媒体渲染💻
拆分配置为编辑器配置与渲染配置两部分💻
添加多国语言支持手搓翻译函数实现
💻
支持代码高亮及复制💻
跟随主题的暗色模式(joe主题)- 将Vditor前台渲染资源全量引入本地
- 添加配置是否使用CDN加载前台资源
🐛
内置渲染器与ToolBench不兼容📄
自定义暗色模式触发方式📄
支持AI编写与修改
注释
🧪
当前已在某个版本进行实验性发布📄
一个想法,如果你有什么比较好的建议可以在ISSUE中提出💻
计划在下个版本推出🐛
这是一个BUG,但是比较难处理
🙏 鸣谢
特别感谢Vditor,本插件大部分内容均为此编辑器提供
- Vditor 一款浏览器端的 Markdown 编辑器,支持所见即所得、即时渲染(类似 Typora)和分屏预览模式。
- Lute:🎼 一款结构化的 Markdown 引擎,支持 Go 和 JavaScript
- highlight.js:JavaScript syntax highlighter
- mermaid:Generation of diagram and flowchart from text in a similar manner as Markdown
- incubator-echarts:A powerful, interactive charting and visualization library for browser
- abcjs:JavaScript library for rendering standard music notation in a browser
🏗开发日志
- Halo插件开发-Vditor Markdown(一)准备工作
- Halo插件开发-Vditor Markdown(二)编辑器
- Halo插件开发-Vditor Markdown(三)插件设置
- Halo插件开发-Vditor Markdown(四)前台渲染注入
努力赶稿中...
- Halo插件开发-Vditor Markdown(五)使用Halo附件管理器插入图片
努力开发中...
🧑💻开发环境
插件开发的详细文档请查阅:https://docs.halo.run/developer-guide/plugin/hello-world
git clone git@github.com:justice2001/vditor-mde.git
# 或者当你 fork 之后
git clone git@github.com:{your_github_id}/vditor-mde.git
cd path/to/plugin-starter
# macOS / Linux
./gradlew pnpmInstall
# Windows
./gradlew.bat pnpmInstall
# macOS / Linux
./gradlew build
# Windows
./gradlew.bat build
修改 Halo 配置文件:
halo:
plugin:
runtime-mode: development
fixedPluginPath:
- "/path/to/plugin-starter"
🧑💼发布
您可以在 Gitea ISSUE 看到该项目的进展