Sublime-better-coffeescript, more suited for Caper-activities, Caper and other Coffeescript development. /_/
- Latest Change Log
- FAQ
- Installation
- Updating
- Commands/Shortcuts
- Snippets
- Building
- Settings
- Special Thanks
This package is for Sublime Text 3. Other text editors, such as VIM, would be supported in another updated.
CoffeeScript plug-in was originally created by @Xavura. Sublime Better Coffeescript is forked from @aponxi
The original coffeescript plugin has been used by @DeveloperAlan and many other Blake Content devs to help with easier Coffeescript development. This repo has been forked so that these developers could have better development and commenting snippets to assist with caper-activities and caper development.
- Please use blake-education/issues page to make requests or report bugs.
- Please make pull requests to the respective branch (
master
branch is for Sublime Text 3,st2
branch is for Sublime Text 2.)
Don't. This repo has not been published to Package Control (as of writing), and probably would never be because it's not meant for public use. Instead, use the Source Control method. (may release to bx sometime in the future)
Sublime stores packages in the following locations:
Nix: ~/.config/sublime-text-3/packages
Mac: ~/Library/Application\ Support/Sublime\ Text\ 3/Packages
Win: %APPDATA%\Sublime Text 3\Packages
Open a Terminal/Console and run the following commands, replacing PACKAGE_PATH
with the path corresponding to your OS above.
cd PACKAGE_PATH
git clone https://github.com/aponxi/sublime-better-coffeescript.git "Better CoffeeScript"
If you use Github for Mac/Windows which store repositories in a specific location, or if you just don't want a repository in your packages directory, then instead you can use a link.
If you don't yet have the repository, then grab it via your GUI program or via the command line:
cd WHEREVER_YOU_WANT
git clone https://github.com/aponxi/sublime-better-coffeescript.git
Once that is done, we will create the link:
cd PACKAGE_PATH
mklink /D "Better CoffeeScript" ABSOLUTE_PATH_TO_REPOSITORY
cd PACKAGE_PATH
ln -s ABSOLUTE_PATH_TO_REPOSITORY "Better CoffeeScript"
When Package Control tries to update your packages, if you have a repository in your packages directory then it will try to pull down and merge any changes. If you don't want this to happen and would rather handle everything yourself, then you can add the following to your settings (Preferences » Package Settings » Package Control » Settings - User):
"auto_upgrade_ignore": ["Better CoffeeScript"]
If you are using Package Control, updating will be automatic and you don't have to worry about it.
If using Source Control:
cd "PACKAGE_PATH/Better CoffeeScript"
git fetch origin
git merge origin/master
You can access the commands either using the command palette (ctrl+shift+P
or cmd+shift+P
) or via shortcuts.
alt+shift+t - Run a Cake task
alt+shift+r - Run some CoffeeScript (prints output to a panel on the bottom)
alt+shift+s - Run a syntax check
alt+shift+c - Compile a file
alt+shift+d - Display compiled JavaScript
alt+shift+l - Display lexer tokens
alt+shift+n - Display parser nodes
alt+shift+w - Toggle watch mode
alt+shift+p - Toggle output panel
Context menu has Compile Output
that compiles the current CoffeeScript and outputs the javascript code that is run, in a panel.
Note: Some of the commands use the Status Bar for output, so you'll probably want to enable it (View » Show Status Bar).
- Use
TAB
to run a snippet after typing the trigger. - Use
TAB
andshift+TAB
to cycle forward/backward through fields. - Use
ESC
to exit snippet mode.
Comprehension
Array: forin
Object: forof
Range: fori (inclusive)
Range: forx (exclusive)
Statements
If: if
Else: el
If Else: ifel
Else If: elif
Switch: swi
Ternary: ter
Try Catch: try
Unless: unl
Classes
Class - cla
Class extends SuperClass - clx
Other
Function: -
Function: = (bound)
Interpolation: #
When using the build system, it is assumed that your
.sublime-project
file lives in your project's base directory (due to limitations with the build system).
Hitting F7
(Tools » Build) will run the Cake task 'sbuild'.
If you're not quite sure what the point of this is then read on.
Let's say before distributing your project that you would like to combine all of your .js
files into one and then minify them them using UglifyJS or something.
That's what this is for! You would create a Cakefile
and inside it you would write a task:
task 'sbuild', 'Prepare project for distribution.', ->
# ...
Go to Preferences > Package Settings > Better CoffeeScript > Settings - User
to change settings.
{
/*
The directories you would like to include in $PATH environment variable.
Use this if your node installation is at a separate location and getting errors such as `cannot find node executable`
example:
"envPATH": "/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
*/
"envPATH": "/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
/*
The directory containing your coffee binary. Usually
/usr/local/bin.
*/
"binDir": "/usr/local/bin"
/*
Compile without the top-level function wrapper (coffee -b).
*/
, "noWrapper": true
/*
Enable or disable refresh the compiled Output on Save.
Only available for watch mode.
*/
, "watchOnSave": true
/*
Enable refreshing compiled JS when CoffeeScript is modified.
Put false to disable
Put a number of seconds to delay the refresh
*/
, "watchOnModified": 0.5
/*
Enable Compiling on save. It will compile into the same folder.
*/
, "compileOnSave": true
/*
## Enable outputting the results of the compiled coffeescript in a panel
*/
, "showOutputOnSave": false
/*
## Enable compiling to a specific directory.
#### Description
if it is a string like 'some/directory' then `-o some/directory` will be added to `coffee` compiler.
if it is false or not string then it will compile your `script.coffee` to the directory it is in.
#### Example:
Directory is relative to the file you are editing if specified such as
compileDir": "out"
Directory is absolute if specified such as
compileDir": "/home/logan/Desktop/out"
*/
, "compileDir": false
/*
## Enable compiling to a specific relative directories.
#### Example:
Set absolute path for compile dir:
"compileDir": "/home/user/projects/js"
And specified folders
"relativeDir": "/home/user/projects/coffee"
"compilePaths":
{
"/home/user/projects/coffee": "/home/user/projects/first/js",
"/home/user/projects/second/coffee": "../js",
}
So
"/home/user/projects/coffee/app.coffee" will compile to "/home/user/projects/first/js/app.js"
"/home/user/projects/coffee/models/prod.coffee" will compile to "/home/user/projects/first/js/models/prod.js"
"/home/user/projects/coffee/second/coffee/app2.coffee" will compile to "/home/user/projects/second/js/app2.js"
"/home/user/projects/main.coffee" will compile to "/home/user/projects/js/main.js"
*/
, "compilePaths": false
}
Go to Project > Edit Project
to change project settings.
{
"folders":
[
...
],
"settings":
{
"CoffeeScript":
{
"noWrapper": true,
"compileOnSave": true,
"compileDir": "out"
}
}
}
Most of the linux terminal commands written here can be run via cygwin - aka Linux Terminal in Windows.
-
Most of the problems are related to configurations. Remember to configure
binDir
after you install! -
Do I have coffee-script installed?
Try finding coffee-script in your global npm list with npm ls -g | grep coffee
which will output something like:
npm ls -g | grep coffee
# will output:
#├── coffee-script@1.6.3
#├─┬ coffeelint@0.5.6
#│ ├── coffee-script@1.6.3
#├── UNMET DEPENDENCY generator-coffee *
#│ │ ├── coffee-script@1.3.3
- Where can I find out the path to coffee binary?
In Linux which
command will tell you where a command originates from. In terminal type:
which coffee
# /usr/bin/coffee
This path will go into the binDir
setting.
- I'm getting the error message
'coffee' is not recognized as an internal or external command,
when saving.
The coffee-script binary probably is not installed. Either install coffee-script or set checkSyntaxOnSave
and compileOnSave
to false
in Preferences > Package Settings > Better CoffeeScript > Settings - User
.
- merged st3 with master branch
- now the sublime text 2 support is in st2 branch
- fixed the @ highlight in language definitions
- fixed an error you would get when it was looking for project settings when it wasn't a project we were editing
Thanks to everyone who has contributed to the original sublime-better-coffeescript project. You guys rock!
-
agibsonsw for his help in writing WatchMode
-
Xavura for writing the base of this plugin and contributing 56 commits / 1,951 ++ / 406 --
-
@lavrton for helping with moderation as well as ontributing 39 commits / 5,009 ++ / 857 --
-
@markalfred for contributing 6 commits / 90 ++ / 48 --
-
@exromany for contributing 5 commits / 71 ++ / 31 --
-
@DaQuirm for contributing 3 commits / 42 ++ / 23 --
-
@ehuss for contributing 2 commits / 2 ++ / 2 --
-
@donovanhide for contributing 2 commits / 16 ++ / 16 --
-
@SunLn for contributing 2 commits / 5 ++ / 5 --
-
@mekf for contributing 2 commits / 15 ++ / 2 --
-
@pyrotechnick for contributing 2 commits / 4 ++ / 3 --
-
@samtsai for contributing 2 commits / 6 ++ / 6 --
-
@szhu for contributing 2 commits / 18 ++ / 15 --
-
@johnogle222 for contributing 1 commit / 7 ++ / 0 --
-
@arjansingh for contributing 1 commit / 8 ++ / 4 --
-
@stared for contributing 1 commit / 1 ++ / 1 --
-
@tomByrer for contributing 1 commit / 1 ++ / 13 --
-
@ppvg for contributing 1 commit / 20 ++ / 27 --
-
@TurtlePie for contributing 1 commit / 1 ++ / 1 --
-
@FichteFoll for contributing 1 commit / 8 ++ / 5 --
-
@daytonn for contributing 1 commit / 1 ++ / 1 --
-
@mfkp for contributing 1 commit / 1 ++ / 1 --
-
@btmills for contributing 1 commit / 3 ++ / 1 --
-
@Whoaa512 for contributing 1 commit / 2 ++ / 2 --
-
@alexdowad for contributing 1 commit / 8 ++ / 2 --
-
@Cryrivers for contributing 1 commit / 1 ++ / 1 --
-
@wbond for contributing 1 commit / 4 ++ / 4 --
-
@nouveller for contributing 1 commit / 0 ++ / 1 --
-
@larvata for contributing 1 commit / 11 ++ / 11 --
-
@ashtuchkin for contributing 1 commit / 36 ++ / 7 --
-
@philippotto for contributing 1 commit / 28 ++ / 1 --
-
@mattschofield for contributing 1 commit / 19 ++ / 0 --
-
@Mitranim for contributing 1 commit / 1 ++ / 1 --
-
@osuushi for contributing 1 commit / 10 ++ / 2 --
-
@radcool for contributing 1 commit / 2 ++ / 2 --
-
@FredyC for contributing 1 commit / 1 ++ / 1 --