/brackets-ruler

An extension for Brackets that adds an adjustable column ruler to the editor.

Primary LanguageJavaScript

Ruler for Brackets

An extension for Brackets that adds an adjustable column ruler to the editor.

How to Install

  1. Select File > Extension Manager...
  2. Search for this extension.
  3. Click on the Install button.

How to Use Extension

Toggle the Column Ruler with View > Column Ruler.

Toggle the Column Guide with View > Column Guide.

Click on a column on the ruler to set the guide at that column.

Click on the same column repeatedly to toggle the guide on and off.

Click and drag on the ruler to the set the guide to a new column.

Right click on the ruler to get a context menu where you can toggle the guide or the ruler.

Extension Preferences

brackets-ruler.rulerEnabled (boolean)
If the value of this preference is true, the column ruler will be visible. If the value is false, the column ruler will be hidden.

brackets-ruler.guideEnabled (boolean)
If the value of this preference is true, the column guide will be visible. If the value is false, the column guide will be hidden.

brackets-ruler.guidePosition (number)
The position of the column guide as defined by a column number that is zero or greater. Values that exceed the length of the column ruler are rounded to the highest number on the ruler.

brackets-ruler.guideColor (string)
The color of the column guide. Can be any valid CSS Color value.

brackets-ruler.guideLineStyle (string)
The line style of the column guide. Values can be one of the following: "solid", "dotted", or "dashed".

For more information on setting preferences see: How to Use Brackets - Preferences

Custom Key Bindings

If you would like to add a customized keyboard shortcut to toggle the column ruler, set your shortcut key to the following command id: lkcampbell.toggleColumnRuler.

If you would like to add a customized keyboard shortcut to toggle the column guide, set your shortcut key to the following command id: lkcampbell.toggleColumnGuide.

For example, if you want the shortcut Ctrl-Shift-R to toggle the column ruler and you want the shortcut Ctrl-Shift-G to toggle the column guide, type the following entries into the overrides section of your keyboardmap.json file:

"Ctrl-Shift-R": "lkcampbell.toggleColumnRuler",
"Ctrl-Shift-G": "lkcampbell.toggleColumnGuide"

For more information on setting Custom Key Bindings see User Key Bindings.

Unit Testing

This extension comes with a Jasmine test suite that can be run from within a development build of Brackets:

  1. Select Debug > Run Tests.
  2. Click on the Extensions tab.
  3. Click on the Column Ruler link.

Known Issues

Working with other extensions: Any extensions that change the font family of the editor (i.e. Themes, Fonts) from the default Brackets font of Source Code Pro will make this extension act incorrectly, especially if the font is not monospace. There is no good way to listen for font family change events right now in Brackets or in CodeMirror, so I have to address these issues directly with the other extension developers on a case-by-case basis.

Ruler disappears in Split View mode: For now, the Column Ruler extension only works when there is a single view in the editor. Displaying multiple rulers in multiple views will be part of future functionality.

License

MIT-licensed -- see main.js for details.