VS Code pln-syntax extension

VS Code extensions for syntax highlighting PLN configuration files.

Usage

Binds to *.pln files.

Development

References

• Syntax highlight guide
• Text mate language grammars
• man pln(5)
• PLN source code

Build

What's in the folder

• This folder contains all of the files necessary for the extension.
• syntaxes/pf.tmLanguage.yaml - this is the Text mate grammar file that is used for tokenization.
• language-configuration.json - this is the language configuration, defining the tokens that are used for comments and brackets.

Get up and running straight away

• npm install
• Make sure the language configuration settings in language-configuration.json are accurate.
• Press F5 to open a new window with the extension loaded and a couple of test files opened.
• Verify that syntax highlighting works and that the language configuration settings are working.

Make changes

• You can relaunch the extension from the debug toolbar after making changes to the files listed above.
• You can also reload (Ctrl+R or Cmd+R on Mac) the VS Code window with the extension to load your changes.

Install your extension

• To start using the extension with VS Code, copy it into the <user home>/.vscode/extensions folder and restart VS Code.

Publish

• Change version

just version [major|minor|patch]
# or
npm version [major|minor|patch] --no-git-tag-version

• Update CHANGELOG.md
• Push changes upstream
• Create a tag

just tag
# or
git tag -a $(cat package.json | jq '.version' | cut -d '"' -f 2)
git push --tags

• Package the extension

just package
# or
npx @vscode/vsce package

• Publish the extension
  • VS Marketplace: Publishing Extension
  • Open VSX: Publishing Extensions

just publish-vsmarket
just publish-ovsx
# or
npx @vscode/vsce publish --packagePath <file>
npx ovsx publish --packagePath <file>