Skip to content

inopinatus/sublime_url

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Sublime Text URL handler

A URL handler for Sublime Text 3 on Mac OSX.

Implements a Sublime Text variant of the TextMate URL scheme.

Made using JavaScript for Automation. Originally written for Mac OS Sierra 10.12.6, and still works with Big Sur (11.2) and Catalina (10.15) as of February 2021.

Installation

  • Download the current release: SublimeUrl-1.0.zip
  • Extract SublimeUrl.app and place in your user Applications directory.
  • Run once to register the handler.

Uninstallation

Just delete the app.

How to use

Have your debugging tool/exception handling produce URLs in the following format:
subl://open?url=file://{{file}}&line={{line}}&column={{column}}

Examples:

  • subl://open?url=file:///path/to/file.js&line=19&column=4
  • subl://open?url=file:///path/to/other.css&line=127

url is required and the file must exist or an error is given. SublimeUrl expects to find Sublime Text in /Applications/Sublime Text.app.

Sublime Text and Ruby on Rails errors

This add-on was developed specifically for use with the Better Errors gem although it should work with anything that follows the specified URL format. See the Better Errors Wiki for more information.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/inopinatus/sublime_url. The .scpt files can be edited with the standard Script Editor. Please ensure that the src/ directory contains the decompiled text of each script. Two utilities are provided for your convenience:

bin/install-git-hooks.sh

This will install a pre-commit git hook that checks src/ texts for binary consistency and for whitespace errors.

bin/decompile.sh

This will update the contents of src/ by decompiling the contents of the .scpt files.

History

Version 1.0

This project was written from scratch as a drop-in replacement for the Subl handler by Dave Houlbrooke which has since been retired.

License

This code is available as open source under the terms of the MIT License.