Textmate 2 Tips

Strip trailing whitespace on Save with …callbacks!

elia — Sat, 09 Feb 2013 06:34:42 -0500

Open the bundle editor (⌃⌥⌘B) and open “Text” → “Menu Actions” → “Converting / Stripping” → “Remove Trailing Spaces in Document / Selection”.

Then in the drawer put callback.document.export in Semantic Class and Document / Replace Document as Input / Output.

Hooray! From now on each time you’ll save a document all trailing space will be stripped!

Create a new file in a project folder

theinterned — Wed, 25 Jan 2012 11:14:35 -0500

One of the big changes in TM2 is that you can no longer create new files from the Project Drawer’s right click menu. This was a handy feature that I honestly miss.

Fortunately, there is a work around though it’s somewhat less intuitive.

Create a new file/tab by hitting ⌥⌘N or choosing File > New Tab from the menu.
Select the folder that you want to save the file in from the File Browser/Project Drawer:

Here I have the stylesheets folder selected.
Save the new tab (“untitled” in the screenshot above) by hitting ⌘S or choosing File > Save from the menu.
The file dialog will come up with the folder you chose in step 2 selected.

The save dialog with your folder selected.
Give your new file a name and hit Enter or click Save and the file will be right where you want it!

There it is.

It’s worth pointing out that steps 1 and 2 can be done in any order.

Launch files from the File Browser with a single click

theinterned — Mon, 19 Dec 2011 10:41:00 -0500

Want to be able to open files in the File Browser with a single click like you used to in TextMate 1? Click the file’s icon! A lot of people are asking about this one.

8956 Released

k776 — Mon, 19 Dec 2011 07:43:51 -0500

Development continues. This release allows you to disable the functionality that hides the tab bar when only one file is open. Disabling that auto hide makes Textmate 2’s functionality like that of Textmate 1.

2011-12-18

Introduced callback.application.did-activate and callback.application.did-deactivate as two new semantic classes. A command with this class will be executed when the application gain/lose focus. The scope selector is matched against the “current scope” of the visible document (in each window). This allows creating a command with “Save” set to “Modified Documents” and thereby recreating TextMate 1.x’s ability to save modified documents on lost focus.
The approach in 2.0 also allows to run some code, for example reloading the currently open browsers, and it can be scoped e.g. to text.html to only have the “save on lost focus” enabled when editing HTML files - alternatively one can introduce a custom scope like attr.save-on-deactivate and set that for specific projects via a scopeAttributes setting in .tm_properties.
Tab bar can be made always visible: defaults write com.macromates.TextMate.preview disableTabBarCollapsing -bool YES.
Fix issue with indented soft wrap having the prefix string wider than the wrap column.
Fix issue with selection sent to commands needing entire document (e.g. ⌘R for Ruby, Python, etc.).
Fix issue with ⌃⇥ not always working to move focus to file browser.
Remove folding patterns from grammar template.

TextMate Blog » Multiple Carets

theinterned — Mon, 19 Dec 2011 07:40:00 -0500

TextMate Blog » Multiple Carets:

In this article will discuss:

Using multiple carets with the mouse

Changes to column selection

Using multiple carets with Find

Using multiple carets with Copy and Paste

⌘X in the File Browser

kevinfinlayson — Sun, 18 Dec 2011 12:10:06 -0500

Allan pointed out to us yesterday that In addition to ⌘C one can also use ⌘X and ⌘V to move/copy files around (⌘X doesn’t “cut” before ⌘V is used).

Language codes

kevinfinlayson — Sun, 18 Dec 2011 10:00:05 -0500

Language codes:

Thanks to llamageddon for this list of language codes used for spellingLanguage in tm_properties

Replicating Edit Each Line In Selection

eirkeirkeirk — Sat, 17 Dec 2011 23:00:06 -0500

Here’s a great tip from eirkeirkeirk :

I noticed the ⌘⌥A command was gone from TM2. But I figured out a way to replicate it.

- Select all the lines you want to edit

- Turn it into a column selection (tap ⌥)

- Then ⌘→ to move all the carets to the end of each line

This is actually better than the previous incarnation because:

- You can actually see the carets, where as before you were typing blindly

- Each caret acts smarter. So you can do things like ⌥← to move back one word in each line.

He’s also provided a quick video showing it in action: http://dl.dropbox.com/u/364257/editall.mov

An excellent example of a .tm_properties file

hmans — Sat, 17 Dec 2011 19:36:27 -0500

An excellent example of a .tm_properties file:

A big thanks to hmans for sharing his .tm_properties file. Particularly useful are his instructions on how to hide specific directories (in this case: log, vendor and tmp) from the “Find File” dialog, but not from the project browser.

8949 Released

kevinfinlayson — Sat, 17 Dec 2011 17:36:00 -0500

I was delighted to see a significant update to the alpha released earlier today, with some much anticipated features/settings added. The big items here are the ability to disable text aliasing, the ability to put the file-browser on the right side of the window, and the option for HTML output to have its own window. See below for the complete release notes:

2011–12–16

HTML output can open in its own window: defaults write com.macromates.TextMate.preview htmlOutputPlacement window.
Anti-alias can be disabled: defaults write com.macromates.TextMate.preview disableAntiAlias -bool YES.
File browser can be placed on the right side: defaults write com.macromates.TextMate.preview fileBrowserPlacement right.
With multiple carets, ⌘-clicking one of them removes it (i.e. it’s a toggle).
Carriage returns (<CR>) on the general clipboard are converted to regular newlines when pasting.
Rename help book to “TextMate 2” which fixes issues where Help → TextMate Help showed TextMate 1.5’s help book.
TextMate 1.x and 2.0 can now both run at the same time.
Setting TM_HG and TM_GIT in Preferences is no longer eclipsed by the default properties (which set them to point at /opt/local/bin).
Fix potential crash when deleting bundles on disk (rm -rf).

TextMate Blog » Git Style Configuration

kevinfinlayson — Fri, 16 Dec 2011 17:43:33 -0500

TextMate Blog » Git Style Configuration

File Browser keyboard shortcuts

kevinfinlayson — Fri, 16 Dec 2011 14:58:00 -0500

A big thanks to macromates for this list of key commands for use when the file browser is in focus:

⌘⇡   Go to Enclosing Folder
⌘⇣   Open
⌘⇠   Go Back
⌘⇢   Go Forward
↩    Rename
␣    QuickLook
⇧⌘N  New Folder
⌥⌘N  New Tab
⌘D   Duplicate
⌘⌫   Delete
⇧⌘C  Go to Computer
⇧⌘H  Go to Home
⇧⌘D  Go to Desktop
⇧⌘G  Go to Folder…
⇧⌘F  Search Selected Folder
⌘C   Copy Path
⌘O   Open
⌘[   Go Back
⌘]   Go Forward

As well as these mouse commands:

Single-click icon to open (or double click name).

Hold ⌥ when single-clicking a package (e.g. tmBundle) to descend into the package.

Hold ⌥ to “close other” if clicking a regular (text) file.

(Quicklook? Nice.)

SmartFolders

theinterned — Fri, 16 Dec 2011 10:37:00 -0500

You can access a “Smart Folder” from the top bar of the folder drawer by clicking on the purple folder with a gear on it. This folder gives you a view of ‘Uncommitted Changes’ and ‘Untracked Files’ in your project*.

You can select files you want to commit using the Git bundle’s “Commit…” command (makes it easier if assign a shortcut to this menu item — maybe ⌘⌥⌃C — though you can use this tip to find one that doesn’t conflict).

You can also access a diff viewer from here which opens within textmate itself. Not ideal compared to GitX or Github, but for small commits it’s nice to not have to switch away from Textmate.

*This requires that you are using a source control system such as Git, Subversion or Mercurial, and that you have configure the proper path in .tm_properties.

Search (and edit) bundle items by key equivalent

kevinfinlayson — Thu, 15 Dec 2011 14:08:22 -0500

Here’s a great tip from Allan:

⌃⌘T to bring up the ‘Select bundle item’ dialog. By default, you can search by bundle item title, but if you hit ⌘4, you can switch to key equivalent—meaning you can just type the shortcut to find its bundle item.

For instance, if you’d like to find the Comment Line/Selection bundle item, you can use: ⌃⌘T + ⌘4 + ⌘/.

To then edit the bundle item, hit ⌥↩. Allan says that ⌥↩ also works with ⌘T (Go To File).

Quickly show a menu of past search terms

theinterned — Thu, 15 Dec 2011 13:45:00 -0500

(From the built-in help)

Find History

Just like clipboard history: ⌃⌥⌘F.

(While we’re at it: ⌃⌥⌘V = brings up a menu of your past clipboard contents)

TextMate Blog » Locating Bundles

kevinfinlayson — Thu, 15 Dec 2011 11:46:07 -0500

TextMate Blog » Locating Bundles

Jump to specific lines/columns from ‘Go To File’ dialog

kevinfinlayson — Thu, 15 Dec 2011 10:30:00 -0500

In the ⌘+T (Go To File) dialog, you can append :line or :line:column when specifying a file to jump to. This is particularly useful for console errors that return line/column positions in long blocks of code.

Thanks to Joachim Mårtensson for this tip!

TextMate 2 .tm_properties — Gist

kevinfinlayson — Thu, 15 Dec 2011 09:51:11 -0500

TextMate 2 .tm_properties — Gist:

More documentation of .tm_properties, showing among other things the ability to set preferences based on file type.

List of settings

kevinfinlayson — Thu, 15 Dec 2011 09:47:00 -0500

A list of settings for your .tm_properties file, and some explanation, from a pastie posted by Allan Odgaard

# List of Settings

## I/O

* `binary` — If set for a file, file browser will open it with external program when double clicked. Mainly makes sense when targetting specific globs.
* `encoding` — Set to the file’s encoding. This will be used during save but is also fallback during load (when file is not UTF-8). Load encodinng heuristic is likely going to change.
* `fileType` — The file type given as scope, e.g. `text.plain`.
* `useBOM` — Used during save to add BOM (for those who insist on putting BOMs in their UTF-8 files).

## Display

* `theme` — UUID of theme, presently unused but will be back, and should allow name of theme as well (use _View → Themes_ to change theme — remember to install the Themes bundle).
* `fontName`, `fontSize` — Name and size of font, e.g. `Menlo` and `13`. Presently these two keys are required to override font, but there will be a font option in the _View_ menu, so this is only for special requirements.
* `showInvisibles` — Sets the initial value. Can also be changed via View menu.
* `softTabs`, `tabSize` — Presently can only be changed this way, but there should be some memory added to Avian.
* `spellChecking`, `spellingLanguage` — Enable/disable spelling and set language. The language is defined by Apple, I can extract a list (but depends on installed spell checkers).

## Projects

* `projectDirectory` — the project directory, generally set to `$CWD` in a `.tm_properties` file at the root of the project. This affects `TM_PROJECT_DIRECTORY` and default folder for ⇧⌘F.
* `windowTitle` — override the window title. The default is `$TM_DISPLAYNAME` but could e.g. be changed to `$TM_FIEPATH`. Should add a `$TM_SCM_BRANCH`.

## Other

* `scopeAttributes` — The value is added to the scope of the current file.

## File Filtering Keys

These are all globs and perhaps a bit arcane.

The file browser, if it has a file, checks that file against the first key with a value in this order: `excludeFilesInBrowser`, `excludeInBrowser`, `excludeFiles`, `exclude`. If neither match, it then does the same with include keys, and if one match, it is included.

The default include key is `*` (so no hidden files, although see the default `.tm_properties` which include `.htaccess` and `.tm_properties`). The default exclude key is the empty string (nothing matches).

* `exclude`
* `excludeFiles`
* `excludeDirectories`
* `excludeInBrowser`
* `excludeInFolderSearch`
* `excludeInFileChooser`
* `excludeFilesInBrowser`
* `excludeDirectoriesInBrowser`

* `include`
* `includeFiles`
* `includeDirectories`
* `includeInBrowser`
* `includeInFileChooser`
* `includeFilesInBrowser`
* `includeDirectoriesInBrowser`
* `includeFilesInFileChooser`

Git status in file browser

kevinfinlayson — Wed, 14 Dec 2011 20:34:00 -0500

If you’ve configured your .tm_properties file to point to your installation of git, the file browser will display source control status icons on your files.

You can see this on the index.php and header.php files in the repo above, both of which have not-yet-committed changes, and are displaying small blue circle icons.