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
  • 10 years ago
  • 19 minutes ago
  • 10 years ago

Installs

  • Total 368
  • Win 224
  • Mac 87
  • Linux 57
Mar 29 Mar 28 Mar 27 Mar 26 Mar 25 Mar 24 Mar 23 Mar 22 Mar 21 Mar 20 Mar 19 Mar 18 Mar 17 Mar 16 Mar 15 Mar 14 Mar 13 Mar 12 Mar 11 Mar 10 Mar 9 Mar 8 Mar 7 Mar 6 Mar 5 Mar 4 Mar 3 Mar 2 Mar 1 Feb 29 Feb 28 Feb 27 Feb 26 Feb 25 Feb 24 Feb 23 Feb 22 Feb 21 Feb 20 Feb 19 Feb 18 Feb 17 Feb 16 Feb 15 Feb 14
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
Mac 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.