ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

Syntax​Definition​Helper

by matthew-dumas ST2

This is a plugin/module for Sublime Text 2 to aid in the creation of language syntax definitions.

Details

  • 2014.01.09.00.03.02
  • github.​com
  • github.​com
  • 6 years ago
  • 3 hours ago
  • 6 years ago

Installs

  • Total 367
  • Win 223
  • OS X 87
  • Linux 57
Sep 17 Sep 16 Sep 15 Sep 14 Sep 13 Sep 12 Sep 11 Sep 10 Sep 9 Sep 8 Sep 7 Sep 6 Sep 5 Sep 4 Sep 3 Sep 2 Sep 1 Aug 31 Aug 30 Aug 29 Aug 28 Aug 27 Aug 26 Aug 25 Aug 24 Aug 23 Aug 22 Aug 21 Aug 20 Aug 19 Aug 18 Aug 17 Aug 16 Aug 15 Aug 14 Aug 13 Aug 12 Aug 11 Aug 10 Aug 9 Aug 8 Aug 7 Aug 6 Aug 5 Aug 4
Windows 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
OS X 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
Linux 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0

Readme

Source
raw.​githubusercontent.​com

Syntax Definition Helper

This plug-in contains two tools to aid in the creation of basic syntax definition files.

The Problem

Working with P-List and JSON files can be annoying when attempting to deal with syntax definitions. Furthermore, not looking directly at a file of the syntax definition type you're creating can cause you to miss tokens. Even further than that, people don't seem to understand regular expressions well enough to make basic regular expressions.

For these reasons, and extreme laziness on my part, I made these tools. The Syntax Definition Helper creates a new syntax definition based on user input while the user is staring at a file that contains no syntax highlighting. It creates very basic regular expressions based off of the selected text, and allows the user to choose a scope and a comment, as well as edit the regular expression for that token.

The syntax definition edit helper opens up the current syntax defintion, and allows the user to add basic patterns to the definition in exactly the same way as the Syntax Definition Helper.

Getting Started

Once installed:

Press ALT-CTRL-6 to start the Syntax Definition Helper Wizard Press ALT-CTRL-7 to start the Syntax Definition Edit Helper Wizard

Alternatively, you can define a new key binding for this command.

How to Use

Create A Syntax Definition

  1. Open a file that doesn't contain a syntax definition
  2. Press ALT-CTRL-6
  3. Type "yes" and hit enter
  4. Type the file extensions this will apply to (Ex: .asm .txt .x86) and hit enter
  5. Give the language a name and hit enter.
  6. Press Enter or enter your own UUID
  7. Name the language root scope. This should be something followed by the file extension. (Ex: For XML I would enter Text.XML)
  8. Select a group of tokens (for example, command tokens -- if end last next continue for while loop do) then click into the dialog entry box and hit enter
  9. Edit the regex and hit enter.
  10. Add a comment to the group, describing it (ex: Control Tokens), and hit enter.
  11. Choose a named scope from the default color scheme list (ex: comment.py), and change the final extension to the extension you used for the root scope. (xml ex: comment.xml)
  12. Repeat 8-11 until you run out of groups or tokens to colorize.
  13. Enter "no" at the token prompt and hit enter.
  14. Wait for Sublime Text 2 to save and reload syntax definitions.
  15. Set the syntax to your new syntax defintion and observer the colors.

Edit A Syntax Definition

  1. Verify that the syntax in the file you're planning on editing is set to the correct syntax.
  2. Press ALT-CTRL-7
  3. Press Enter
  4. Perform the steps 8-15 from the above set of instructions.

Clicking into the text edit area in the dialog and pressing escape will cancel the entire process at any time. If you change your mind, and decide to not make the changes, then do this.