Typora插件自定义快捷键配置指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_07099/article/details/148787628

Typora插件自定义快捷键配置指南

typora_plugin Typora plugin. feature enhancement tool | Typora 插件，功能增强工具项目地址: https://gitcode.com/gh_mirrors/ty/typora_plugin

在Typora插件项目中，自定义快捷键功能为用户提供了强大的文本处理能力。本文将详细介绍如何通过修改配置文件来实现自定义快捷键功能，让用户能够快速为选中文本应用特定样式或执行自定义操作。

配置文件位置

自定义快捷键的核心配置文件位于插件目录下的plugin/global/settings/hotkey.user.toml文件中。这个文件专门用于用户自定义的快捷键设置，与系统默认的hotkey.default.toml文件分开管理，避免用户修改被系统更新覆盖。

配置语法解析

配置文件采用TOML格式，每个快捷键配置都是一个独立的配置块，包含以下几个关键参数：

desc：快捷键的功能描述，会显示在快捷键帮助中
enable：是否启用该快捷键，设置为true表示启用
hotkey：定义具体的快捷键组合，如"ctrl+alt+j"
evil：包含实际执行的JavaScript代码

实际配置示例

以下是一个完整的为选中文本添加引号的快捷键配置示例：

[wrapQuotationMarks]
desc = "包裹引号"
enable = true
hotkey = "ctrl+alt+j"
evil = """
() => {
    const {node, bookmark, range} = this.utils.getRangy();
    const ele = File.editor.findElemById(node.cid);
    const rangyText = ele.rawText().substring(bookmark.start, bookmark.end);
    if (rangyText !== "") {
        const insertText = "“" + rangyText + "”";
        File.editor.UserOp.pasteHandler(File.editor, insertText, true, true, true);
        File.editor.undo.addSnap(node.cid, File.editor.undo.UndoManager.SnapFlag.REPLACE);
        setTimeout(() => {
            const {range, bookmark} = this.utils.getRangy();
            bookmark.start -= insertText.length - 1;
            bookmark.end -= 1
            range.moveToBookmark(bookmark);
            range.select();
        });
    }
}
"""