ekwjca
Last Updated: February 25, 2016
·
27.44K
· heartcode
Author

My essential guide to installing Sublime Text 3 Beta

Recently I had to set up 2 of my machines for development with a completely fresh OS X install and I happily took that opportunity to install the new beta version of my favourite code editor, Sublime Text 3.

As getting ST3 up and running is a bit more complex than installing version 2, I decided to write a quick guide, which contains all the necessary steps, so I can save myself from chasing up numerous websites, blogs and git repos for the beta install notes.

This is a guide I wrote for myself, but in hope of helping others I am sharing it here :)

<br>

Step 1 - Install Sublime Text 3

That's super easy, go to http://www.sublimetext.com/3, download and install the latest version of the app.

<br>

Step 2 - Setting up Sublime for the command line

I like to set Sublime as the default code editor in my shell, so that I can use it straight from Terminal.

Create a symbolic link to the app using Terminal:

$ sudo ln -s "/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl" /usr/bin

Set Sublime as the default editor in .profile:

export EDITOR="subl -w"
export BUNDLE_EDITOR="subl"

<br>

Step 3 - Adding Package Control

I've found that managing packages is best with Package Control. It's a bit more extra effort to make it work with Sublime 3, as it's not yet compatible with the newest version out of the box. You will need to get the latest source using Git and clone it into Sublime's Packages folder, and finally checkout the python3 branch, which will then work beautifully after restarting Sublime:

$ cd ~/Library/Application\ Support/Sublime\ Text\ 3/Packages/ 
$ git clone https://github.com/wbond/sublime_package_control.git "Package Control"
$ cd "Package Control"
$ git checkout python3

To bring Package Control up, press CMD + SHIFT + P.

<br>

Step 4 - Installing packages

In the next few steps I'll talk about installing my favourite packages - which is not much as I am pretty minimalistic with the amount of packages I am using. For a more comprehensive list of ST3 compatible packages visit this page.

<br>

Sidebar Enhancements

Update: I again had to install ST3 and when I installed Sidebar Enhancements via Package Control it worked out of the box, so the below workaround won't be necessary anymore. I'll leave it to stay on the safe side though.

I love the extra functionality of the sidebar contextual menus, which comes with SidebarEnhancements. This is one of the packages, that won't work properly with ST3, but with some Gitting we can make it work:

$ cd Library/Application\ Support/Sublime\ Text\ 3/Packages/
$ git clone -b st3 git://github.com/titoBouzout/SideBarEnhancements.git "SideBarEnhancements"
$ git checkout st3

<br>

Tomorrow Color Schemes

I've found Tomorrow Night to be my favourite color scheme for editing code for Sublime (I also use it in Terminal). It can be installed through Package Control, search for Tomorrow Color Schemes.

After installation the theme should be added to Sublime, and should be accessible through:

Sublime Text / Preferences… / Color Scheme / Tomorrow Color Schemes

<br>

Modific

Whenever working on a Git repository I like to use some sort of 'gutter' tool, which shows me the changes right next to my code in Sublime for every deletion/addition or modification for each of the open files. To install it type Modific in Package Control.

<br>

Levels

Levels turns Douglas Crockford's idea on scope context colouring into a very powerful tool for Sublime making it a lot easier to follow up on scopes in complex JavaScript code structures. To install the package type Levels in Package Control.

<br>
Of course as soon Sublime 3 becomes final all packages should be much simpler to install (and this guide eventually will become obsolete), but for the time being I hope this little note helps others to get around the installation process.

Enjoy!

Say Thanks
Respond

9 Responses
Add your response

8413
E136d3f26316df92d5f4efe1656ebc48

Nice little run through. Ta just what i needed!

over 1 year ago ·
8425
Author

I am glad you found it useful Mr Mitchell :)

over 1 year ago ·
10107

Cannot believe I'm sat at work and wanted a list of SET_SETTING'S for ST3 - who's name pops up on the first page of google? :p

over 1 year ago ·
10113
Author

:)

over 1 year ago ·
10323

This setup is just for Mac, I see. Any site like this for Windows setup? I appreciate this page regardless.

over 1 year ago ·
10328
Author

@brad_mem: I haven't used Windows for development for years, so I would not try to write about it as it's not really my territory. However after some quick searching on Google I've found this: http://adamjohnsondesign.com/blog/install-package-control-sublime-text-3-windows/ It looks great and it could be a great starting point for writing a ST3 installation guide for Windows users - if you're up for it :)

over 1 year ago ·
10339
Author

@brad_mem, here is another useful resource for you to set up the Sublime command line tool on Windows: https://coderwall.com/p/bn2inq?&p=1&q=

over 1 year ago ·
11793
0fb95fa9d80847bf6b6817211967ce45

In step 2, you create a symbolic link like so:

$ sudo ln -s "/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl" /usr/bin

but if I were to use a package manager (Homebrew, etc.) would it be better to use:

$ sudo ln -s "/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl" /usr/local/bin

Also, if I already made the symbolic link from the tutorial could I correct this and use the link described right above here by using:

sudo ln -fs /Applications/Sublime\ Text.app/Contents/SharedSupport/bin/subl /usr/local/bin

Awesome tutorial!

over 1 year ago ·
11815
Author

Hi @brday!

Thank you very much for the great feedback!

As far as I am concerned it doesn't matter how you install Sublime from the point of creating and using the symlink - it should just work.

I haven't got much experience with symlinks, but I believe you're right about overriding the symlink.

Thanks,
Rob

over 1 year ago ·