Sublime插件开发指引【教程导向】

2024-03-23 04:58
文章标签 教程 开发 插件 sublime 导向 指引

本文主要是介绍Sublime插件开发指引【教程导向】，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

因为工作的原因，会接触到公司自己开发的自动化语言，但是这个语言从开发到现在，一直没有一个匹配的IDE（其实是有一个网页版的IDE，但是不好用没人用），而一直使用Notepad++，他们习惯了，但是我作为公司新人有点忍不了界面丑陋，没有高亮，不能快速折叠函数等等功能缺陷，所以自己看了看Sublime的插件指引，自己做了一个IDE适配自动化语言，特记录如何开发sublime插件。

文章介绍的并不全面，主要还是“领进门”，重在制作的方法。（因为自己也没有很懂😛）

插件支持的功能

  1. 自定义语言
  2. 主题（就是配色啥的）（该文章不介绍）
  3. 添加菜单
  4. 命令
  5. 自定义快捷键

命令/快捷键/菜单

这几个功能其实是相辅相成，共同使用的。

逻辑是：键盘按下一个组合件，触发命令，执行操作；或者在菜单中添加一个选项，点击这个选项来触发命令，执行操作。

我们先来一个简单的示例说明怎么做

示例1：添加一个上下文菜单，取名为“print hi”，当点击这个菜单时，在当前文件的起始位置打印hi

点击Tools -> Developer -> New Plugin
插入命令
会新建一个python文件，并显示一个Demo

import sublime
import sublime_pluginclass ExampleCommand(sublime_plugin.TextCommand):def run(self, edit):self.view.insert(edit, 0, "Hello, World!")

可以看到这里有一个名为ExampleCommand类，重载了里面的run方法，方法中这个语句的含义是在文本的最开头位置插入"Hello World"文本，其中Command前面的Example就是命令的名称。

Command前面第一个大驼峰单词就是命令。比如PrintHiCommand这个类名，print就是命令的名称。命令这个概念我们后面就慢慢清楚了。

我们修改命令名为“printhi”，修改文本为"hi"。程序长这个样子：

import sublime
import sublime_pluginclass PrintHiCommand(sublime_plugin.TextCommand):def run(self, edit):self.view.insert(edit, 0, "hi")

ctrl+s保存一下，弹出保存对话框的路径自动就是插件所存在的地方，默认是**\Pakages\Users，所有的插件包都存放在Pakages文件夹下，你可以叫任意的名字。这里我们自己建立一个名为TestPackage的插件文件夹放置我们所有的插件文件。
路径

所有的插件包都存放在Pakages文件夹下
安装板sublime存放路径：
C:\Users[用户名]\AppData\Roaming\Sublime Text\Packages
绿色版sublime存放路径：
[sublime根目录]\Data\Packages\

这样我们第一个命令就做好了。

接下来，在这个文件夹下新建一个文件，取名为Context.sublime-menu，以json格式，写入以下内容

Context.sublime-menu。后缀表示该文件是定义菜单文件，Context文件名表示这个菜单将插入到上下文档中。

[{"caption": "hi","command": "print","id": "hi"}
]

caption表示菜单中的名称
command表示当选项被点击后，所触发的命令
id表示这个菜单项的唯一标识

保存文件，不用退出sublime，立刻可以看到效果。点击鼠标右键，看到最下面出现了名为hi的选项，点击可以看到文件的最前面输入了hi。
恭喜你，第一个插件已经完成了。

我用官方回答你的废话

开发插件怎么可能少了官方文档。
官方文档
上面就是sublime的文档地址。如果地址变动，也可以直接打开sublime官网官网地址，点击右上角Support，可以看到Documentation一栏，下面有很多指引，如直接打开documentation，或是官方论坛（不用翻墙可以访问），油管频道等。
我们重点介绍以下几个部分
在这里插入图片描述
有了前面的例子，相信大家已经知道如何编写插件，更多的功能自己看文档解决，毕竟我也没有精力写的很全。后文只会对文档中比较绕的名词和概念，以及我踩的坑做一说明。
那些英语不好的，右转各种翻译插件，谢谢。

菜单 Menu

  1. 只有caption和command是必要的，其他可写可不写。

  2. 其中mnemonic助记符，我也没有搞得很明白，如果有谁知道这个选项是干嘛的，烦请评论告诉大家，我会给你一个nubiplus。
    文档中只说了是一个按下一个按键可以激活进入入口，并且要和caption对应，也就是对应caption的第一个字母。我猜想是按下键盘的alt键，再组合按下这个助记符，可以激活指定的命令，就像直接鼠标点按菜单一样。

  3. Side Bar Mount Point.sublime-menu
    由于默认sublime隐藏侧边栏，我也是才知道这家伙还有个侧边栏。在View -> Side Bar -> Show Side Bar就可以显示侧边栏。
    上面的文件用于添加侧边栏顶部右键菜单。

    Tips
    在这里插入图片描述

  4. 可以带参

API

API Reference
python的文件名没有那么讲究，叫啥都行。

从前面的示例可以看到，我们自定义的类继承了sublime_plugin.TextCommand类。从官方的文档中也可以看到这个类的说明，我们重写了run()函数，当命令执行时，这个函数将会被调用，并执行里面的语句。

如果我们直接在函数中print()，打印的信息将会出现在哪里呢？
会在sublime的控制台当中。这一点非常重要，我们DEBUG经常会用到。使用快捷键ctrl+`，可以打开sublime的命令行。
此时，执行一下命令，可以看到输出。

import sublime
import sublime_pluginclass ExampleCommand(sublime_plugin.TextCommand):def run(self, edit):print("Hello World!")

在这里插入图片描述
下面会对部分类做一个简要说明：

  • sublime.View
    表示所打开文件的类。如在sublime中打开test.txt，那么view就代表这个test.txt对象。
    比如，关闭这个标签（其实也就是关闭这个文件）

    import sublime
import sublime_pluginclass ExampleCommand(sublime_plugin.TextCommand):def run(self, edit):self.view.close()

    从上面这个例子可以知道，sublime.View是sublime_plugin.TextCommand类的父类。
    view类还有很多函数，如sel()可以返回一段选中的范围、line()可以根据一个范围或点返回所在行，大家可以自己摸索。

  • sublime.Region
    表示一个范围。
    非常简单容易理解。注意，该类是可以直接根据头尾构造的。

  • sublime.Selection
    表示选中的对象。
    如果使用add()函数，将多个region添加进Selection对象中，就是多选。

自定义语言

我把这个放在了后面，主要是因为自定义语言这个功能应用场景应该比较少。
使用.sublime-syntax作为后缀名，对文件名没有要求，但是推荐以自定义的语言名作为名称。
该文件使用yaml语法，推荐先去熟悉一下什么是yaml语法。yaml语法
参考syntax官方说明文档
我们后文都以c语言做范例，先编写一个简单的Demo：

%YAML 1.2
---
name: C
file_extensions: [c, h]
scope: source.ccontexts:main:- match: \b(if|else|for|while)\bscope: keyword.control.c

name：语言名
file_extensions：所定义语言的拓展名
scope：应用范围（这个概念后面讲）
main：主上下文分支
match：匹配文本

原理

自定义语言最终的目的是解析语法，也就是让sublime根据文本特征，知道这段文字所表达的含义。
文本特征比如，c语言使用函数时，一定是函数名+括号的形式，根据这个特点，sublime就知道这里应该是一个函数，应该使用怎样的颜色高亮，除此之外，还可以知道这个函数的定义在哪。
我们在sublime-syntax文件中做的，就是定义文本特征，让sublime知道哪里是什么意思。
定义特征，使用的方法就是正则表达式，所以必须对正则非常熟悉。正则表达式

了解了上面的原理，我们需要对match和scope两个重要的概念做一个诠释。

  • match
    match是一个正则表达式，用于从文本开头到文本结束顺序的匹配文本规则。比如我们需要寻找括号前的英文识别为函数名，那么就需要编写正则
    - match: '\w(?=\()'
    match的单引号可以去掉，但是不能是双引号
    # 也可以这样
- match: \w(?=\()
  • scope
    当match匹配到了文本，scope就向sublime标识，这段文本是什么含义。
    - match: '\w(?=\()'scope: variable.function
    上面就表示所匹配到的文本，含义是函数变量。

有了上面基础还不够，还需要解决一个问题。类似函数体、函数当中的参数这样有“包裹结构”的，或者说层级结构的，如何表达。
比如，有下面一个例子。

int funcDemo(int a, int b)
{if (a == b){return a * 2;} else {return a + b;}
}

这里函数声明funcDemo，后面跟着形参，那么两个形参就是一个层级；再往后，是一对{}包裹的函数体，大括号中的所有内容都是属于funcDemo的函数体，那么函数体又是一个层级，依次向下推。。。
我们前面介绍过了，match是从前到后的匹配文本。那么文本就可以看作栈，当遇到funcDemo(第一个左括号时，可以看作是将后文的所有内容“进栈”，直到遇到了)右括号才将后文所有内容出栈，这样int a, int b就可以有办法表示为函数参数。函数体也同理；if、while等这样的语句也同理。
sublime中使用push和pop来进栈和出栈。

# 简单的函数定义规则
main:
- match: '(?<=\w+) *\('scope: punctuation.section.group.begin.cpush: function_paramterfunction_paramter:
- scope: meta.group.c- match: \b(int|float|double|char)\bscope: storage.type.c- match: \)scope: punctuation.section.group.end.cpop: true

从上面的示例可以看出，push可以将文本入栈到指定的yaml对象中解析，入栈的这一部分内容，会完全按照新的规则解析，直到遇到了pop，如果pop为true，则出栈到外面一层。
如果存在多层嵌套，就需要一层一层push再一层一层pop，直到根。这也符合c语言以及大多数语言的规定。
还有一个小细节非常值得注意，在function_paramter对象中，在第一个位置有十分孤单的scope并没有任何match与之对应scope: meta.group.c，其实这就是function_paramter的scope，表示这个对象的含义，一般以meta打头。

那么我们就明白了，最开始的示例中，最开头的scope，scope: source.c其实就是表示这个语言的根scope。

让我们开始吧！

懂得了上面的原理，做起来就非常轻松了。
官方文档中列举有几乎所有支持的scope定义scope naming文档

tips:
对于我们的自定义语言，最快速有效的开发方式就是对照别的语言来开发。使用快捷键ctrl+shift+alt+p快速查看文本定义。
比如对照着js语言，我们不知道function关键字会给一个怎样的scope，我们可以将光标移动到function上面，使用快捷键查看。
在这里插入图片描述
结合前文讲到的，scope是会根据不断的push、pop形成一个类似树状的结构，上面列出的就是按照从根到叶子的所有scope

除了刚刚介绍的push、pop以外，还有set可以直接把后文推到某个层级当中。
大致就是这样了，后面有哪里想起来需要添加的再添加进去。

这篇关于Sublime插件开发指引【教程导向】的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/837198。

相关文章

Spring Security 从入门到进阶系列教程

Spring Security 从入门到进阶系列教程

Spring Security 入门系列 《保护 Web 应用的安全》 《Spring-Security-入门（一）：登录与退出》 《Spring-Security-入门（二）：基于数据库验证》 《Spring-Security-入门（三）：密码加密》 《Spring-Security-入门（四）：自定义-Filter》 《Spring-Security-入门（五）：在 Sprin
阅读更多...
这15个Vue指令，让你的项目开发爽到爆

这15个Vue指令，让你的项目开发爽到爆

1. V-Hotkey 仓库地址: github.com/Dafrok/v-ho… Demo: 戳这里 https://dafrok.github.io/v-hotkey 安装: npm install --save v-hotkey 这个指令可以给组件绑定一个或多个快捷键。你想要通过按下 Escape 键后隐藏某个组件，按住 Control 和回车键再显示它吗？小菜一碟： <template
阅读更多...
Hadoop企业开发案例调优场景

Hadoop企业开发案例调优场景

需求 （1）需求：从1G数据中，统计每个单词出现次数。服务器3台，每台配置4G内存，4核CPU，4线程。 （2）需求分析： 1G / 128m = 8个MapTask；1个ReduceTask；1个mrAppMaster 平均每个节点运行10个 / 3台 ≈ 3个任务（4    3    3） HDFS参数调优 （1）修改：hadoop-env.sh export HDFS_NAMENOD
阅读更多...
Makefile简明使用教程

Makefile简明使用教程

文章目录 规则makefile文件的基本语法：加在命令前的特殊符号：.PHONY伪目标: Makefilev1 直观写法v2 加上中间过程v3 伪目标v4 变量 make 选项-f-n-C Make 是一种流行的构建工具，常用于将源代码转换成可执行文件或者其他形式的输出文件(如库文件、文档等)。Make 可以自动化地执行编译、链接等一系列操作。 规则 makefile文件
阅读更多...
嵌入式QT开发：构建高效智能的嵌入式系统

嵌入式QT开发：构建高效智能的嵌入式系统

摘要： 本文深入探讨了嵌入式 QT 相关的各个方面。从 QT 框架的基础架构和核心概念出发，详细阐述了其在嵌入式环境中的优势与特点。文中分析了嵌入式 QT 的开发环境搭建过程，包括交叉编译工具链的配置等关键步骤。进一步探讨了嵌入式 QT 的界面设计与开发，涵盖了从基本控件的使用到复杂界面布局的构建。同时也深入研究了信号与槽机制在嵌入式系统中的应用，以及嵌入式 QT 与硬件设备的交互，包括输入输出设
阅读更多...
OpenHarmony鸿蒙开发（ Beta5.0）无感配网详解

OpenHarmony鸿蒙开发（ Beta5.0）无感配网详解

1、简介 无感配网是指在设备联网过程中无需输入热点相关账号信息，即可快速实现设备配网，是一种兼顾高效性、可靠性和安全性的配网方式。 2、配网原理 2.1 通信原理 手机和智能设备之间的信息传递，利用特有的NAN协议实现。利用手机和智能设备之间的WiFi 感知订阅、发布能力，实现了数字管家应用和设备之间的发现。在完成设备间的认证和响应后，即可发送相关配网数据。同时还支持与常规Sof
阅读更多...
活用c4d官方开发文档查询代码

活用c4d官方开发文档查询代码

当你问AI助手比如豆包，如何用python禁止掉xpresso标签时候，它会提示到 这时候要用到两个东西。https://developers.maxon.net/论坛搜索和开发文档 比如这里我就在官方找到正确的id描述 然后我就把参数标签换过来
阅读更多...
Linux_kernel驱动开发11

Linux_kernel驱动开发11

一、改回nfs方式挂载根文件系统         在产品将要上线之前，需要制作不同类型格式的根文件系统         在产品研发阶段，我们还是需要使用nfs的方式挂载根文件系统         优点：可以直接在上位机中修改文件系统内容，延长EMMC的寿命         【1】重启上位机nfs服务         sudo service nfs-kernel-server resta
阅读更多...
【区块链 + 人才服务】区块链集成开发平台 | FISCO BCOS应用案例

【区块链 + 人才服务】区块链集成开发平台 | FISCO BCOS应用案例

随着区块链技术的快速发展，越来越多的企业开始将其应用于实际业务中。然而，区块链技术的专业性使得其集成开发成为一项挑战。针对此，广东中创智慧科技有限公司基于国产开源联盟链 FISCO BCOS 推出了区块链集成开发平台。该平台基于区块链技术，提供一套全面的区块链开发工具和开发环境，支持开发者快速开发和部署区块链应用。此外，该平台还可以提供一套全面的区块链开发教程和文档，帮助开发者快速上手区块链开发。
阅读更多...
SWAP作物生长模型安装教程、数据制备、敏感性分析、气候变化影响、R模型敏感性分析与贝叶斯优化、Fortran源代码分析、气候数据降尺度与变化影响分析

SWAP作物生长模型安装教程、数据制备、敏感性分析、气候变化影响、R模型敏感性分析与贝叶斯优化、Fortran源代码分析、气候数据降尺度与变化影响分析

查看原文>>>全流程SWAP农业模型数据制备、敏感性分析及气候变化影响实践技术应用 SWAP模型是由荷兰瓦赫宁根大学开发的先进农作物模型，它综合考虑了土壤-水分-大气以及植被间的相互作用；是一种描述作物生长过程的一种机理性作物生长模型。它不但运用Richard方程，使其能够精确的模拟土壤中水分的运动，而且耦合了WOFOST作物模型使作物的生长描述更为科学。 本文让更多的科研人员和农业工作者
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2