saret/ChocolateyPackages
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
Files
5ed4214a22a1980eece9ea08cd808b033aabb56c
ChocolateyPackages/EthanBrown.SublimeText2.EditorPackages/tools/PackageCache/Clipboard Manager/README.md
Iristyle 5ed4214a22 feat(ST2.EditorPackages): bump up all packages 
- Refresh PackageCache with latest versions of everything
2013-09-16 22:29:05 -04:00

4.4 KiB
Raw Blame History

Clipboard Manager plugin for Sublime Text 2

A version of the Sublime Text 2 plugin at http://www.sublimetext.com/forum/viewtopic.php?f=5&t=2260&start=0 that makes for TextMate-like clipboard history.

Originally written by AJ Palkovic (ajpalkovic), modified by Martin Aspeli (optilude), and further modified and packaged for Package Control by Colin Thomas-Arnold (colinta)

My version of this plugin does not use clipboard_history as the prefix. See the full command-list below.

Installation

Sublime Text 2

  1. Using Package Control, install "Clipboard Manager"

Or:

  1. Open the Sublime Text 2 Packages folder

    • OS X: ~/Library/Application Support/Sublime Text 2/Packages/
    • Windows: %APPDATA%/Sublime Text 2/Packages/
    • Linux: ~/.Sublime Text 2/Packages/

  2. clone this repo

  3. Install keymaps for the commands (see Example.sublime-keymap for my preferred keys)

Sublime Text 3

  1. Open the Sublime Text 2 Packages folder

  2. clone this repo, but use the st3 branch

    git clone -b st3 git@github.com:colinta/SublimeClipboardManager

Commands

The basics

clipboard_manager_cut: Self Explanatory

clipboard_manager_copy: Self Explanatory

clipboard_manager_paste: Self Explanatory.

Options: indent (default: False): Determines whether to use the paste or paste_and_indent built-in command.

Navigating clipboard history

clipboard_manager_next_and_paste (super+alt+v)

Goes to the next entry in the history and pastes it. Options: indent (default: False)

clipboard_manager_previous_and_paste (super+shift+v)

Goes to the previous entry in the history and pastes it. Options: indent (default: False)

clipboard_manager_next (super+pageup aka super+fn+up)

Goes to the next entry in the history, but doesn't paste. (the content will appear as a status message)

clipboard_manager_previous (super+pagedown aka super+fn+down)

Goes to the previous entry in the history, but doesn't paste. (the content will appear as a status message)

clipboard_manager_choose_and_paste (super+ctrl+alt+v)

Shows the clipboard history in a "quick panel".

clipboard_manager_show (super+ctrl+shift+v, /)

Shows the clipboard history in an "output panel", and points to the current clipboard item. This was mostly useful for development, but you might find it beneficial as well.

Registers

Right now registers do not add/remove from the clipboard history. This may change!! I would appreciate feedback about this feature.

clipboard_manager_copy_to_register (there are a ton, e.g. super+ctrl+shift+c, 1, super+ctrl+shift+c, a)

Puts the selection into a register. The example keymap includes a register binding for every number and letter. Register keys should be single characters.

clipboard_manager_paste_from_register (super+ctrl+shift+v, 1, super+ctrl+shift+v, a)

Pastes the contents of a register. Again, there are lots of example key bindings.

clipboard_manager_show_registers (super+ctrl+shift+v, ?)

Shows the clipboard registers in an "output panel", similar to clipboard_manager_show.

Helpful Tips

There are two ways to find out what you've got hanging out in your clipboard history, you should use both. The clipboard_manager_choose_and_paste command is your goto. It uses the fuzzy finder input panel, so you can quickly find and paste the entry you want.

The other useful trick is to use clipboard_manager_show to show an output panel at the bottom of the screen. As you scroll through history using clipboard_manager_next and clipboard_manager_previous, it will update that panel, with an arrow pointing the current entry. Then you can clipboard_manager_next_and_paste, and it will get updated then, too. Keeps you sane if you're doing something crazy.

If you've got a repetive task to do, with lots of copy/pastes, use registers. They do not get affected by usual copy/pasting, so you can rest assured that your work flow will not get affected. The keyboard shortcuts are unfortunately quite verbose (super+ctrl+shift+c, letter/digit), but look at Example.sublime-keymap and you'll see that it is easy to assign a quicker shortcut for registers you like to use. Registers do not have to be one letter, any string can be used as the key.