33 lines
1.9 KiB
Markdown
33 lines
1.9 KiB
Markdown
# Dever Language for VS Code
|
|
|
|
支持 `.dever` 语法高亮、括号配对、自动闭合、缩进和 `#` 快捷键注释。
|
|
Markdown 中的 `dever` 和 `typescript dever` 代码块也会高亮，正文仍按 Markdown 显示。无需先安装 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 说明和业务约束仍用 `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
|
|
```
|
|
|
|
测试使用 VS Code 实际的 TextMate/Oniguruma 语法引擎，检查反引号和波浪号代码块、关闭边界、注释、字符串、整数除法、声明与 CMS 双实现。缺少真实 Markdown 语法文件时会报错，不用仿造文件代替。
|