MKB-Syntax-Highlighting

Sublime Text ¾ 中带自动完成和提示的宏/键绑定模语法高亮

语法高亮和自动完成支持来自 https://spthiel.github.io/Modules/ 的模块

还包含 Federal 制作的自动缩进器

访问 Package Control

加入 我的 discord 获取支持/建议/错误。

简介

此软件包旨在帮助简化宏键绑定模的编码。为了帮助您，我创建了自动完成来建议可能的行为和变量，并且如果您将鼠标悬停在关键字上，您可以看到来自 MKB 文档 的命令描述和示例。（感谢 Gorlem！）此外，它还包含 Federal 制作的缩进器，具有花哨的缩进功能！在创建您的代码后，您还可以使用代码检查器来查找可能的错误，例如丢失的大括号。要个性化此软件包，请转到 Sublime Text ¾ 顶部菜单的上下文菜单或 编辑 > MKB 菜单，并修改 软件包设置。

软件包中文件的简要描述包括

File                          | Description
MKB.py                        | Is a Python plugin file, which controls all the popups, autocompletes, indenting, and linter.
MKBdocs.css                   | CSS for dark mode on wiki
MKBdocs.json                  | Gorlem's wiki API used for popup hints.
Main.sublime-menu             | JSON file for the menu at the top.
MKB.sublime-syntax            | Is a YAML file, with many regexes and assigning scopes to the text to make them colorful.
Context.sublime-menu          | JSON file for the menu when you right click the screen.
MKB.sublime-settings          | JSON file for the settings to customize the package.
Default.sublime-keymap        | Auto %% when typing one %. 
MKB.sublime-completions       | Is a JSON file, containing specific "triggers", which will activate the auto complete.
MKB.sublime-color-scheme      | Is a json file for the custom colors of the syntax highlighter.
Miscellaneous.tmPreferences   | Helps with toggling comments.
template.sublime-color-scheme | Template to make your own color scheme (You can send it to me too)

使用 Package Control 安装

1) 如果您还没有安装，请安装 Package Control。

2) 在命令面板中打开 Package Control: Install Package，搜索 MKB。安装它，您可能需要重新启动 sublime。

3) 将语言从 纯文本 更改为 MKB 作为您的语言。您可以在底部的右角菜单中选择它。有时您需要显示状态栏 (视图/显示状态栏)。另一种方法是在屏幕上单击鼠标右键，然后单击 MKB > MKB 语言

4) 您还可以单击 MKB > 软件包设置，并个性化软件包，例如颜色方案、缩进和其他设置

5) 开心！如果有什么问题，请在 #•help 上提问

手动安装

用法

• 打开一个 .txt 文件（可以配置），如果第一行是 $${，则它会自动更改为 MKB 语法。但如果它不起作用，则可以在底部的右角更改 纯文本 为 MKB 语法。之后，颜色应自动出现，并带有自动完成功能。
• 要自动完成一个语句，自动完成菜单应自动出现。按上箭头键或下箭头键进行浏览，按回车键完成。然后，按 Tab 键跳转到下一个参数。
• 或者按 CMD/CTRL + 空格键查看可能的自动完成列表。
• 您还可以按 CTRL + SHIFT + 空格键打开内建的wiki。
• 要缩进代码，您可以调整设置（保存时缩进，或在缩进之前提示）。或者，如果您想手动缩进，则右键单击屏幕并按 MKB 缩进。
• 默认情况下，当您悬停在关键字上时，您将看到一个弹出窗口显示信息。要手动显示提示，可以在右键单击时按 MKB 提示。查看示例，或单击“打开 Wiki”以在浏览器中打开 wiki 页面（可以指定）。
• 在任意位置右键单击以执行某些操作，或在顶级主菜单中选择 编辑 > MKB。
• 您还可以在 MKB > 软件包设置 中更改颜色方案，以及其他酷炫设置。
• 如果您想创建自己的颜色方案，请按照 MKB > 颜色方案 中的步骤进行操作。

它是如何工作的？

• 新的 Sublime 语法将识别 Macro/Keybind Mod 的操作、变量、参数、迭代器以及更多关键字（也包括来自 https://spthiel.github.io/Modules 的模块以及一些其他模块），使用正则表达式语句为脚本的不同部分分配作用域。然后，将作用域分配给颜色方案文件中的颜色，然后您即可获得自定义语法高亮！默认作用域是 source.mkb。
• 自动完成文件将帮助您自动完成语句，并在按 Tab 键时显示语句的基本帮助信息。这使用了 Sublime Text 的功能片段。
• 弹出窗口使用 Sublime 的 API 和 gorlem 的 API 来查找弹出窗口的信息。
• 缩进器读取每一行，并将制表符放在每一行的前面。花式缩进在缩进行之间添加一个延迟，让它看起来像波浪。
• 检查器读取每一行，检查是否有偶数个 %% () "" []
• 变量插入器查找脚本中的所有变量

设置

额外

MKBdocs.css：是一个CSS文件，用于使https://mkb.ddoerr.com/docs/actions拥有深色模式。您可以使用一个名为 stylus 的chrome扩展来更改CSS。

• Chrome扩展
• Safari修改元素
• Firefox样式编辑器

其他

如有任何问题，请告诉我或报告至GitHub。我的Discord是TKM#6228。如有建议，也请告诉我！加入https://discord.gg/m9yfJtb获取支持/建议/问题。

语法高亮和自动完成的示例：

致谢

• Federal for the Indenter
• Gorlem for the wiki
• Sublime Text Community for help (https://discord.gg/TZ5WN8t)

有用链接

• https://packagecontrol.sublime.net.cn/installation
• https://github.com/SublimeText/PackageDev/blob/master/README.md
• https://text.sublime.net.cn/docs/3/syntax.html
• https://text.sublime.net.cn/docs/3/color_schemes.html
• https://text-docs.sublime.net.cn/guide/extensibility/completions.html#completed-completions
• https://text-docs.sublime.net.cn/guide/extensibility/plugins/
• https://text.sublime.net.cn/docs/3/api_reference.html
• https://www.youtube.com/channel/UCJAB_XF3kAMqwF85y0hxcXQ
• https://beta.mkb.gorlem.ml/api/docs
• https://mkb.ddoerr.com/docs/actions