diff options
| author | Ben Beltran <ben@nsovocal.com> | 2019-02-05 22:01:25 +0100 |
|---|---|---|
| committer | Ben Beltran <ben@nsovocal.com> | 2019-02-05 22:01:25 +0100 |
| commit | e6c2e653ab8ad7d115d29a407c99aaecb179adb1 (patch) | |
| tree | b9f0bb708df0482c6c665ea318205eb4cacf9ed5 /vsc-extension-quickstart.md | |
| parent | 4549164147a331c583651f87d3d0490eb0a0397f (diff) | |
Import from api-notation.tmLanguage
Diffstat (limited to 'vsc-extension-quickstart.md')
| -rw-r--r-- | vsc-extension-quickstart.md | 29 |
1 files changed, 29 insertions, 0 deletions
diff --git a/vsc-extension-quickstart.md b/vsc-extension-quickstart.md new file mode 100644 index 0000000..06a7355 --- /dev/null +++ b/vsc-extension-quickstart.md @@ -0,0 +1,29 @@ +# Welcome to your VS Code Extension + +## What's in the folder + +* This folder contains all of the files necessary for your extension. +* `package.json` - this is the manifest file in which you declare your language support and define the location of the grammar file that has been copied into your extension. +* `syntaxes/api-notation.tmLanguage` - 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 + +* Make sure the language configuration settings in `language-configuration.json` are accurate. +* Press `F5` to open a new window with your extension loaded. +* Create a new file with a file name suffix matching your language. +* 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 your extension to load your changes. + +## Add more language features + +* To add features such as intellisense, hovers and validators check out the VS Code extenders documentation at https://code.visualstudio.com/docs + +## Install your extension + +* To start using your extension with Visual Studio Code copy it into the `<user home>/.vscode/extensions` folder and restart Code. +* To share your extension with the world, read on https://code.visualstudio.com/docs about publishing an extension. |