This repository contains TmLanguage files for Common Lisp, which describes TextMate Grammars, can be used by VSCode, TextMate, Sublime Text, and Atom.
The TmLanguage files can tell the editors how to highlight code.
Run npm install
We have two syntax files in ./syntaxes, and we use ./syntaxes/scripts/build_grammar.mjs (npm run bg) to convert them into json format:
commonlisp.yamlis the main syntax of Common Lisp.cl_codeblock.yamlis the injection grammar for Markdown.
If you need to modify the syntax, here are some helpful materials:
Syntax Highlight Guide,
TextMate grammars,
making_language_grammar,
textmatebundle,
regex101,
Common Lisp HyperSpec.
Mastering the TextMate grammars is very difficult. If you are a beginner, you can try to start with a small work sample and then work on it incrementally.
The recommended workflow is:
git add- construct a regex and verify the regex in regex101
- add the regex to the syntax
- convert the syntax into
jsonand test the syntax in real world
If you would like to test the highlighting in a VS Code extension, replace the file commonlisp.tmLanguage.json in the extension with the one you rebuilt.
npm run bg # After you modified the grammar, you need to rebuild the grammar.
npm run testg # Then, test the grammar with the fixtures in `syntaxes/fixtures/baselines`.
npm run diff # Check if it is the test result you expected. Find the differences between the baselines and generated.
npm run accept # If the changes are what you expect, accept the new baselines.You may need to run
npx tsc -p syntaxes/scripts/tsconfig.jsonto generategen_record.mjsbeforenpm run testg.
Run npm run lint for linting.
Most errors and warnings can be fixed automatically by running npm run lint -- --fix.
Run npx unimported to check if there are any dangling files.
- GitHub Linguist
Note that althought this grammar is based on vscode-common-lisp. This grammar has no version/source control relationship with vscode-common-lisp, and this grammar is intentionally separated.
CL-ANSI Standard Draft, Common Lisp HyperSpec, vscode-scheme, Scheme.tmLanguage, Lisp.tmLanguage, regex101
The code segment in Syntax Highlighting is from SBCL Repository.