|
1 |
| -Sublime-Column-Select |
| 1 | +Sublime Column Select |
2 | 2 | =====================
|
3 | 3 |
|
4 |
| -Alternate behavior for Sublime keyboard column selection. |
| 4 | +This plugin provides an alternate behavior for Sublime keyboard column selection. I often found it challenging to select columns with lines that were shorter than the rest. |
| 5 | + |
| 6 | +Downloading |
| 7 | +----------- |
| 8 | +The best way to download and install Sublime Column Select is to use the Package Control plugin. If you do not already have it installed, it's really the best way to manage your packages. |
| 9 | + |
| 10 | +XXX TBD |
| 11 | + |
| 12 | +Configuring |
| 13 | +----------- |
| 14 | +No need to configure anything. By default it uses the default keystroke for column selection, plus a few extras. These keystrokes will select the same column in the next or previous line, page, or until the beginning/end of the document. |
| 15 | + |
| 16 | +Windows: |
| 17 | + |
| 18 | +- Ctrl-Alt-Up / Ctrl-Alt-Down: Up/down one line. |
| 19 | +- Ctrl-Alt-PageUp / Ctrl-Alt-PageDown: Up/down one page. |
| 20 | +- Ctrl-Alt-Home: Up until the beginning of the document. |
| 21 | +- Ctrl-Alt-End: Down until the end of the document. |
| 22 | + |
| 23 | +Linux: |
| 24 | + |
| 25 | +- Alt-Shift-Up / Ctrl-Alt-Down: Up/down one line. |
| 26 | +- Alt-Shift-PageUp / Ctrl-Alt-PageDown: Up/down one page. |
| 27 | +- Alt-Shift-Home: Up until the beginning of the document. |
| 28 | +- Alt-Shift-End: Down until the end of the document. |
| 29 | + |
| 30 | +OS X: |
| 31 | + |
| 32 | +- Ctrl-Shift-Up / Ctrl-Alt-Down: Up/down one line. |
| 33 | +- Ctrl-Shift-PageUp / Ctrl-Alt-PageDown: Up/down one page. |
| 34 | +- Ctrl-Shift-Home: Up until the beginning of the document. |
| 35 | +- Ctrl-Shift-End: Down until the end of the document. |
| 36 | + |
| 37 | +If you want to use a different keystroke, go to "Preferences" then "Key Bindings - User", and add an entry like this: |
| 38 | + |
| 39 | + { "keys": ["ctrl+alt+up"], "command": "column_select", "args": {"by": "lines", "forward": false}}, |
| 40 | + { "keys": ["ctrl+alt+down"], "command": "column_select", "args": {"by": "lines", "forward": true}}, |
| 41 | + { "keys": ["ctrl+alt+pageup"], "command": "column_select", "args": {"by": "pages", "forward": false}}, |
| 42 | + { "keys": ["ctrl+alt+pagedown"], "command": "column_select", "args": {"by": "pages", "forward": true}}, |
| 43 | + { "keys": ["ctrl+alt+home"], "command": "column_select", "args": {"by": "all", "forward": false}}, |
| 44 | + { "keys": ["ctrl+alt+end"], "command": "column_select", "args": {"by": "all", "forward": true}}, |
| 45 | + |
| 46 | +Do not include the trailing comma if it is the last entry. |
| 47 | + |
| 48 | +Using |
| 49 | +----- |
| 50 | +You should be able to place the character on any position on the line, and then use the keystrokes to add additional carets (cursors) to the next/previous lines. It will skip over lines that are too short. |
| 51 | + |
| 52 | +It will behave differently if the cursor is at the end of the line. In this case, it will select the end of every line. |
| 53 | + |
| 54 | +Contact |
| 55 | +------- |
| 56 | +If you find a bug, or have suggestions, head over to the github page: |
| 57 | +https://github.com/ehuss/Sublime-Column-Select |
0 commit comments