Sublime Text

Sublime Text is a sophisticated text editor for code, markup and prose . You'll love the slick user interface, extraordinary features and amazing performance. First of all Sublime Text is multi-platform, so available for OS X, Windows and Linux.

Keyboard shortcuts

One very important shortcut for OSX is the one is the ⌘ + ⇧ + . which shows the normal hidden files in a directory (i.e. .bashrc) .

The keyboard shortcuts for OSX are base on the Websites:

• Docs Sublime Text Info, Keyboard Shortcuts for OSX.

Editing Keypress Command ⌘ + X Cut line ⌘ + ↩ Insert line after ⌘ + ⇧ + ↩ Insert line before ⌘ + ⌃ + ↑ Move line / selection up ⌘ + ⌃ + ↓ Move line/selection down ⌘ + D Select word - Repeat to select next occurrence ⌘ + L Select line - Repeat to select next lines ⌃ + ⌘ + G Select all occurrence of the line above ⌃ + ⇧ + ↑ Extra cursor on the line above ⌃ + ⇧ + ↓ Extra cursor on the line below ⌃ + M Jump to closing parentheses Repeat to jump to opening parentheses ⌃ + ⇧ + M Select all contents of the current parentheses ⌃ + A ⌘ + Left Move to beginning of line ⌃ + E ⌘ + Right Move to end of line ⌘ + K, ⌘ + K Delete from cursor to end of line ⌘ + K + ⌫ Delete from cursor to start of line ⌘ + ] Indent current (selected) line(s) ⌘ + [ Un-Indent current (selected) line(s) ⌘ + ⇧ + D Duplicate line(s) ⌘ + J Join line below to the end of the current line ⌘ + / Comment/un-comment current line ⌘ + ⌥ + / Block comment current selection ⌘ + Y Redo, or repeat last keyboard shortcut command ⌘ + ⇧ + V Paste and indent correctly ⌃ + Space Select next auto-complete suggestion ⌃ + U Soft undo; jumps to your last change before undoing change when repeated ⌃ + ⇧ + Up Column selection up ⌃ + ⇧ + Down Column selection down ⌃ + ⇧ + W Wrap Selection in html tag ⌃ + ⇧ + K Delete current line of cursor

Navigation / Goto anywhere Keypress Command ⌃ + G Goto line in current file, overlay (:) ⌘ + P ⌘ + T Quick-open files by name ⌘ + ⇧ + R Goto symbol / function / method, overlay (@) F12 Goto definition ⌃ + - Jump back, go to previous location ⌃ + ⇧ + - Jump forward, go to next location.   General Keypress Command ⌘ + ⇧ + P Command Palette ⌃ + ` Python Console ⌃ + ⌘ + F Toggle fullscreen mode ⌃ + ⇧ + ⌘ + F Toggle distraction free mode ⌘ + K, ⌘ + B Toggle side bar ⌃ + ⇧ + P Show scope in status bar   Tabs Keypress Command ⌘ + ⇧ + T Open last closed tab ⌘ + [NUM] Jump to tab in current group where num is 1-9 ⌘ + 0 Jump to 10th tab in current group ⌘ + ⇧ + [ Cycle left through tabs ⌘ + ⇧ + ] Cycle right through tabs ^ + Tab Cycle up through recent tabs ^ + ⇧ + Tab Cycle down through recent tabs   Files Keypress Command ⌘ + ⇧ + . Shows all files in directory

Split Window Keypress Command ⌘ + ⌥ + 1 Revert view to single column ⌘ + ⌥ + 2 Split view into two columns ⌘ + ⌥ + 3 Split view into three columns ⌘ + ⌥ + 4 Split view into four columns ⌘ + ⌥ + 5 Set view to grid (4 groups) ⌃ + [NUM] Jump to group where num is 1-4 ⌃ + ⇧ + [NUM] Move file to specified group where num is 1-4   Bookmarks Keypress Command ⌘ + F2 Toggle bookmark F2 Next bookmark ⇧ + F2 Previous bookmark ⇧ + ⌘ + F2 Clear bookmarks   Text manipulation Keypress Command ⌘ + K, ⌘ + U Transform to Uppercase ⌘ + K, ⌘ + L Transform to Lowercase ⌘ + ⌃ + up Clip text upwards, exchange 2-lines ⌘ + ⌃ + down Clip text downwards, exchange 2-lines   Find / Replace Keypress Command ⌘ + F Find in file ⌘ + ⌥ + F Replace in file ⌘ + ⇧ + F Find in files

Descriptions

Command Palette The Command Palette holds infrequently used functionality, like sorting, changing the syntax and changing the indentation settings. With just a few keystrokes, you can search for what you want, without ever having to navigate through the menus or remember obscure key bindings. Show the Command Palette with ⌘⇧P. Examples: Snippet to insert a code snippet. Rename to rename a file Package Control to see or insert Packages.	Goto Anything Use Goto Anything to open files with only a few keystrokes, and instantly jump to symbols, lines or words. Triggered with ⌘P, it is possible to: Type part of a file name to open it. Type @ to jump to symbols, Type # to search within the file, Type : to go to a line number. These shortcuts can be combined, so tp@rf may take you to a function read_file within a file text_parser.py. Similarly, tp:100 would take you to line 100 of the same file.	Split Editing Get the most out of your wide screen monitor with split editing support. Edit files side by side, or edit two locations in the one file. You can edit with as many rows and columns as you wish. Take advantage of multiple monitors by editing with multiple windows, and using multiple splits in each window. Take a look at the View→ Layout menu for split editing options. To open multiple views into the one file, use the File→New View into File menu item.
Multiple Selections Make ten changes at the same time, not one change ten times. Multiple selections allow you to interactively change many lines at once, rename variables with ease, and manipulate files faster than ever. Try pressing ⇧⌘L to split the selection into lines ⌘D to select the next occurrence of the selected word. To make multiple selections with the mouse, take a look at the Column Selection documentation.	Distraction Free Mode When you need to focus, Distraction Free Mode is there to help you out. Distraction Free Mode is full screen, chrome free editing, with nothing but your text in the center of the screen. You can incrementally show elements of the UI, such as tabs and the find panel, as you need them. You can enter Distraction Free Mode using the View→Enter Distraction Free Mode menu.	Instant Project Switch Projects in Sublime Text capture the full contents of the workspace, including modified and unsaved files. You can switch between projects in a manner similar to Goto Anything, and the switch is instant, with no save prompts - all your modifications will be restored next time the project is opened.
Goto Definitions Using information from syntax definitions, Sublime Text automatically generates a project-wide index of every class, method and function. This index powers Goto Definition, which is exposed in three different ways: A popup is displayed when hovering over a symbol Pressing F12 when the caret is on a symbol The Goto Symbol in Project functionality Symbol indexing can be customized on a per-syntax basis via configuration files, allowing users to tailor the feature to their needs.

Git Integration

Sublime Text's Git integration includes the following components:

• Side Bar
• Status Bar
• Diff Markers
• Sublime Merge Integration
• Settings

For the full description go to: https://www.sublimetext.com/docs/3/git_integration.html

Side Bar

Files and folders displayed in the side bar will include a status badge along the right-hand edge, when modified. This includes files and folder in the Folders section of the side bar, along with files in the Open Files section. Ignored files and folders are de-emphasized in the side bar by reducing the opacity of the name.

When the mouse pauses over a status badge, a tool tip will be displayed indicating the status of the file, or in the case of a folder, the status of the contained files and folders.

Status Badge Key

The following table indicates the meaning of each badge. Please note that the color of the badges will be slightly different as they adapt to the closest hue in the active color scheme.

• ⚪ Untracked, white circle
• 🔵 Modified, blue circle
• 🔴 Missing, red circle
• ➼ Staged Addition, Green heavy wedge tailed rightwards arrow.
• ➼ Staged Modification
• ➼ Staged Deletion
• Unmerged, symbol not yet found.

Packages

Gitsavvy

GitSavvy provides integration between Sublime Text 3 and Git.

If you're a new user and you find yourself asking, "Can GitSavvy do X?", there are two places to look.

1. Open your command palette and type `GitSavvy: help`. This will take you to the offline wiki-style documentation.
2. You can also check for configurability options by opening `Preferences > Package Settings > GitSavvy > Settings - Default` in the ST3 menu.
   Any optional or configurable behavior will be documented here, along with the default values.

If you need help along the way, there's usually someone around in our Gitter channel: https://gitter.im/divmain/GitSavvy

Finally, if at any time you encounter a bug, or if you wish that GitSavvy included some missing functionality, please open an issue: https://github.com/divmain/GitSavvy/issues

On youtube: https://www.youtube.com/watch?v=HLU_D8ZiqRs
Documentation: https://raw.githubusercontent.com/divmain/GitSavvy/master/docs/README.md

Hunspell

The spellings-package is based on Hunspell .

Adding Language

To add a new language to sublime text 3

• Download the language file from the appropriate OpenOffice extension .
• Rename the "some.oxt" file to "some.zip"
• Unzip the file
• Look for two files:
  • "lang.aff"
  • "lang.dic
• For example es_ES.aff and es_ES.dic
• Open the "lang.aff" to check the encoding used. Such the line: SET ISO-8859-1
• Convert that file to UTF-8 from the used encoding
• Convert "lang.dic" to UTF-8 from the used encoding.
• Change SET ISO-8859-1 to SET UTF-8
• In ST3, click on Preferences -> Browse Packages
• Create a new folder, for example Language - Spanish
• Move lang.dic and lang.aff to that folder
• Activate the dictionary in ST3 (View -> Dictionary -> Language - Spanish -> es_ES)
• Press F6 to enable spell check

adapted from the github repo for SublimeText/Dictionaries

Sublime Preferences

File Indexing

Some of the core features in Sublime Text 3 are Goto Definition and Goto Symbol in Project . Both of these work by indexing the files in the current project to determine where each symbol is defined.
To see when files are being indexed, you can enter sublime.log_indexing(True) in Sublime Text's console. This will trigger Sublime Text to start logging relevant information whenever it indexes files.

In the latest version 4107 this in the background working mechanism has been extended causing the complete editor to become terrible slow.
So what to do?

• First of all, disable file indexing:
  • index_files: false.
• File indexing works by applying syntax highlighting rules to each file, and then extracting everything that looks like a symbol.
  The syntax highlighting rules are regex based, and some combinations of rules and files can cause the parsing to take a long time.
  See the log-file what's going on, and then consider adding the files to the index_exclude_patterns setting.
• Various events can cause the index itself to become corrupted, and when this happens, Sublime Text will do the indexing work, but be unable to write the results to disk, so it'll start again in the near future.
  The next build of Sublime Text will handle this situation more gracefully, but in the mean time you can check this for yourself: if the index is corrupted, there will be a log message in the console (accessible from the View/Show Console menu), which indicates which directory needs to be deleted to reset the index.

See also

• Git, Version Control System.