使用Theia——添加语言支持

  • 时间:
  • 浏览:0

上一篇:使用Theia——创建插件

Theia——加在语言支持

Theia中TextMate的支持

  使用TextMate语法都都可不可不上能 为大每项源文件提供精准的着色修饰,人太好这如果在语法级别上(如此语言有这个的角度解析)。语义着色都都可不可不上能 由语言服务器提供。

  TextMate语法主要有有这个格式:.plist.tmLanguage.json,这有这个Theia都支持。

  更多有关TextMate语法的内容都都可不可不上能 查看

这里

  注意:特定语言的语法应该含晒 在该语言的专用扩展包中。@theia/textmate-grammars中只注册了当前如此任何特定扩展包的语言。

加在新语法

  要提供有这个新语法,通常的做法是在扩展包的根目录下创建1个 data目录,在其中保存不同的语法。

extension/
    data/
        grammars go here
    lib/
        ...
    src/
        ...
    package.json
    ...

  否则 ,在package.json文件中声明以下属性,另1个 新提供的语法都都可不可不上能 与源代码和编译的文件并肩发布。

"files": [
    "data",
    "lib",
    "src"
  ],

  在扩展包中,亲戚亲戚.我都都可不可不上能 通过LanguageGrammarDefinitionContribution的contribution point来提供这个结构。

@injectable()
export class YourContribution implements LanguageGrammarDefinitionContribution {

    readonly id = 'languageId';
    readonly scopeName = 'source.yourLanguage';

    registerTextmateLanguage(registry: TextmateRegisty) {
        registry.registerTextmateGrammarScope(this.scopeName, {
            async getGrammarDefinition() {
                return {
                    format: 'json',
                    content: require('../data/yourGrammar.tmLanguage.json'),
                }
            }
        });
        registry.mapLanguageIdToTextmateGrammar(this.id, this.scopeName);
    }
}

  可能使用.plist语法,则只能使用require来直接获取内容,可能Webpack将返回从服务器获取的文件的名称。这个清况 下,都都可不可不上能 使用下面的模式来获取文件的内容:

@injectable()
export class YourContribution implements LanguageGrammarDefinitionContribution {

    readonly id = 'languageId';
    readonly scopeName = 'source.yourLanguage';

    registerTextmateLanguage(registry: TextmateRegisty) {
        registry.registerTextmateGrammarScope(this.scopeName, {
            async getGrammarDefinition() {
                const response = await fetch(require('../data/yourGrammar.plist'));
                return {
                    format: 'plist',
                    content: await response.text(),
                }
            }
        });
        registry.mapLanguageIdToTextmateGrammar(this.id, this.scopeName);
    }
}

原文地址:https://theia-ide.org/docs/textmate