Dust Plugin for Intellij

Provides syntax highlighting for the Dust templating language.

How to use

Plugin is available through the Jetbrains plugin repository

Install From Repository (recommended)

1. Find and right click to install the plugin - File > Settings > Plugins > Browse repositories
2. Associate plugin with your dust file extension - File > Settings > File Types
3. Customize appearance - File > Settings > Editor > Colors & Fonts > Dust

Manual Install

1. Download the plugin
2. Go to File > Settings > Plugins > Install plugin from disk

Developer Notes

1. Open the project with Intellij. The project is already setup to be an Intellij Plugin Module and should have the build settings configured. The only build dependency is the IDEA SDK. However, you may need to configure the SDK verison and location specific to your system. Recommend developing on Mac or Linux with Intellij 12.

2. Install the JFlex and Grammar-Kit plugins

3. Disable the external compiler via Settings > Compiler > Use external build option.

4. You will need the Grammar-Kit to generate the parser source files from Dust.bnf and JFlex to generate the DustLexer from Dust.flex. Since the generated sources are not checked into version control, you need to remember to generate the lexer/parser before compiling. Latest version of JFlex may generate a LexerAdapter which is not used and should be manually deleted.

5. (Optional) Install PSI Viewer plugin which lets you see the parse tree graphically.

Release Notes

Version 0.3.8

• Allow hyphen inside of identifiers

Version 0.3.7

• Use system dependent file separator when resolving partial declarations
• Fixed parsing errors with single period path expressions
• Allow multiple colon tags

Version 0.3.6

• Allow path expression inside subscript
• Fix bugs in subscript tokenizer rule

Version 0.3.5

• Allow self-closing section tags in grammar

Version 0.3.4

• Fixed bug with parsing numeric key tag

Version 0.3.3

• Fixed bug with using current context and numbers as attribute values

Version 0.3.2

• Fixed bug in comment parsing

Version 0.3.1

• Fixed compatibility issues with Intellij 11 and set it as the minimum supported version
• Fixed bugs in left curly brace and identifier token patterns in lexer

Version 0.3

• Added closing tag auto-completion
• Added goto declaration shortcut "Ctrl+b" on dust partial tag references
• Fix parsing error on self closing block tags
• Fix brace matcher bug when key tags are used in attribute strings
• Remove redundant HTML pattern rules in Dust lexer

Version 0.2

• Added Dust brace match highlighting
• Added "Ctrl+/" shortcut for Dust comments
• Fix syntax highlighting for subscript operator in tags (e.g. {#section[0]}...{/section[0]})
• Added TODO highlighting in comments

Version 0.1.2

• Fixes syntax highlighting when javascript is present in the template

Version 0.1.1

• Provides syntax highlighting for dust templates
• Enabled for all Jetbrains IDEs