summaryrefslogtreecommitdiff
path: root/vsc-extension-quickstart.md
diff options
context:
space:
mode:
authorBen Beltran <ben@nsovocal.com>2019-02-05 22:35:04 +0100
committerBen Beltran <ben@nsovocal.com>2019-02-05 22:35:04 +0100
commit55ab0586626b0a833e7b3801164699e4b3a640c2 (patch)
tree7ebd3f76327b8d9f5e4840592ce3f37e9fe63827 /vsc-extension-quickstart.md
parent4549164147a331c583651f87d3d0490eb0a0397f (diff)
parentb1cf6d7ccd532b35c845ba93170996f700ce59a7 (diff)
Merge branch 'release/1.0.0'1.0.0
Diffstat (limited to 'vsc-extension-quickstart.md')
-rw-r--r--vsc-extension-quickstart.md29
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.