33 lines
2.1 KiB
Markdown
33 lines
2.1 KiB
Markdown
# Dever Language for VS Code
|
|
|
|
支持 `.dever` 语法高亮、括号配对、自动闭合、缩进和 `#` 快捷键注释。
|
|
Markdown 正文保留原有编辑体验，`dever` 和 `typescript dever` 围栏共用 Dever 高亮规则；支持反引号、波浪号及更长的关闭围栏。无需先安装 Dever 编译器。
|
|
|
|
## 安装
|
|
|
|
从 [Gitea Releases](https://git.dever.cc/shemic/dever/releases) 下载 VSIX，在 VS Code 的扩展视图中选择“从 VSIX 安装”，或执行（将文件名替换为下载的版本）：
|
|
|
|
```sh
|
|
code --install-extension dever-language-0.1.0.vsix
|
|
```
|
|
|
|
`.dever.md` 继续使用 Markdown 语言模式，不要切换为普通 Dever。已有纯 TypeScript 围栏不会被接管。
|
|
插件随 VSIX 单独分发，不包含编译器、skills、依赖或构建缓存；`dever update` 不负责安装或更新编辑器插件。
|
|
|
|
这是纯语法插件，不提供补全、跳转、格式化或实时编译诊断。最终颜色由 VS Code 主题决定；Markdown 着色依赖 VS Code 的宿主语法，不等同于编译器的程序块抽取。语言合法性、Markdown 说明契约和业务约束仍由 `dever check` 判断。
|
|
插件暂未发布到插件市场，扩展标识为 `shemic.dever-language`。
|
|
|
|
## 开发与打包
|
|
|
|
维护者需要 Node.js 22 或更新版本。用户安装 VSIX 不需要 Node.js、npm 或 Rust。
|
|
在本目录运行 `npm ci --ignore-scripts` 准备锁定的开发依赖，再运行 `npm run package` 生成 VSIX。
|
|
插件没有运行时依赖或激活代码，不读取应用配置、环境变量，也不执行用户程序。
|
|
|
|
正式测试放在仓库根的 `test/editor-vscode/`。使用 VS Code 随附的 `extensions/markdown-basics/syntaxes/markdown.tmLanguage.json` 作为真实宿主语法：
|
|
|
|
```sh
|
|
npm test -- --markdown-grammar /absolute/path/to/markdown.tmLanguage.json
|
|
```
|
|
|
|
测试用实际 TextMate/Oniguruma 引擎校验作用域与嵌入语言标识，覆盖两种 Markdown 围栏、关闭边界、注释/字符串、整数除法、声明以及仓库维护中的 CMS 双实现。没有宿主 Markdown 语法时明确报错，不以仿造语法代替。
|