This project establishes the central development and maintenance of syntax definition files for the PowerShell language used by editors that leverage the XML version of the TextMate language grammar format.
Currently this syntax definition is used in the following editors and extensions:
- Visual Studio Code by Microsoft
- PowerShell Package for Sublime Text by Guillermo López-Anglada
- language-powershell for Atom by James Sconfitto
In the future we may find a more common syntax that allows us to generate syntax definitions for editors that don't leverage the TextMate format.
We are starting with the current state of the TextMate grammar that is being used in both VS Code and Sublime Text. There are a number of existing issues with the grammar that we need to track down and fix. Please see issue #1 for more details.
Ultimately we are looking at doing a total refactoring of the grammar file.
We would love to have community contributions to this project to make PowerShell syntax highlighting great in as many editors as we can. Please feel free to file issues or send pull requests if you'd like to contribute.
Build and test scripts are provided that requires node and tasks are included for Visual Studio Code.
To get started contributing:
- Install node (if not installed already)
- Clone this repository locally
- run
npm installto install the node dependencies
After you have made changes to PowerShellSyntax.YAML-tmLanguage, press Ctrl + Shift + b to start the build task. This will convert the file to plist, JSON and CSON as well as run the tests to make sure that nothing breaks.
The converted files are saved to the grammars folder.
If you want to preview the changes locally, and are running Windows (with PowerShell), you can use the included helper scripts useThisGrammar.ps1 and useOriginalGrammar.ps1 to change between the original and the grammar file from this repository.
Note that you need to run these scripts as Administrator, and you also need to reload Visual Studio Code to read the new grammar file.
The test script are using the file referenceFile.yaml to test the tokens and their assigned scopes.
If you make any changes to the grammar file, remember to also update the reference file and/or test.ps1 if needed; or the tests will fail.
This extension is licensed under the MIT License. Please see the third-party notices file for details on the original source of the TextMate definition that we use.