tmux-plugins/tpm
1
0
Fork 0
mirror of https://github.com/tmux-plugins/tpm.git synced 2024-12-04 18:58:49 +00:00
Code Issues Projects Releases Wiki Activity

Update README.md (#66)

Browse Source 
- Changed PNG Badges to SVG
- Added Styling to Code Blocks
- Added <kbd> tags for Key Bindings
This commit is contained in:
Timothy Cyrus 2017-04-14 23:13:45 -04:00 committed by Graham McGregor
parent 0ea31ae2d6
commit c8ac32a085
1 changed files with 30 additions and 22 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

52
README.md
View File

@ -1,8 +1,8 @@
# Tmux Plugin Manager # Tmux Plugin Manager
[![Build Status](https://travis-ci.org/tmux-plugins/tpm.png?branch=master)](https://travis-ci.org/tmux-plugins/tpm) [![Build Status](https://travis-ci.org/tmux-plugins/tpm.svg?branch=master)](https://travis-ci.org/tmux-plugins/tpm)
Installs and loads TMUX plugins. Installs and loads `tmux` plugins.
Tested and working on Linux, OSX, and Cygwin. Tested and working on Linux, OSX, and Cygwin.
@ -12,54 +12,60 @@ Requirements: `tmux` version 1.9 (or higher), `git`, `bash`.
Clone TPM: Clone TPM:
$ git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm ```bash
$ git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm
```
Put this at the bottom of `.tmux.conf`: Put this at the bottom of `.tmux.conf`:
# List of plugins ```bash
set -g @plugin 'tmux-plugins/tpm' # List of plugins
set -g @plugin 'tmux-plugins/tmux-sensible' set -g @plugin 'tmux-plugins/tpm'
set -g @plugin 'tmux-plugins/tmux-sensible'
# Other examples: # Other examples:
# set -g @plugin 'github_username/plugin_name' # set -g @plugin 'github_username/plugin_name'
# set -g @plugin 'git@github.com/user/plugin' # set -g @plugin 'git@github.com/user/plugin'
# set -g @plugin 'git@bitbucket.com/user/plugin' # set -g @plugin 'git@bitbucket.com/user/plugin'
# Initialize TMUX plugin manager (keep this line at the very bottom of tmux.conf) # Initialize TMUX plugin manager (keep this line at the very bottom of tmux.conf)
run '~/.tmux/plugins/tpm/tpm' run '~/.tmux/plugins/tpm/tpm'
```
Reload TMUX environment so TPM is sourced: Reload TMUX environment so TPM is sourced:
# type this in terminal if tmux is already running ```bash
$ tmux source ~/.tmux.conf # type this in terminal if tmux is already running
$ tmux source ~/.tmux.conf
```
That's it! That's it!
### Installing plugins ### Installing plugins
1. Add new plugin to `~/.tmux.conf` with `set -g @plugin '...'` 1. Add new plugin to `~/.tmux.conf` with `set -g @plugin '...'`
2. Press `prefix + I` (capital I, as in **I**nstall) to fetch the plugin. 2. Press `prefix` + <kbd>I</kbd> (capital I, as in **I**nstall) to fetch the plugin.
You're good to go! The plugin was cloned to `~/.tmux/plugins/` dir and sourced. You're good to go! The plugin was cloned to `~/.tmux/plugins/` dir and sourced.
### Uninstalling plugins ### Uninstalling plugins
1. Remove (or comment out) plugin from the list. 1. Remove (or comment out) plugin from the list.
2. Press `prefix + alt + u` (lowercase u as in **u**ninstall) to remove the plugin. 2. Press `prefix` + <kbd>alt</kbd> + <kbd>u</kbd> (lowercase u as in **u**ninstall) to remove the plugin.
All the plugins are installed to `~/.tmux/plugins/` so alternatively you can All the plugins are installed to `~/.tmux/plugins/` so alternatively you can
find plugin directory there and remove it. find plugin directory there and remove it.
### Key bindings ### Key bindings
`prefix + I` `prefix` + <kbd>I</kbd>
- Installs new plugins from GitHub or any other git repository - Installs new plugins from GitHub or any other git repository
- Refreshes TMUX environment - Refreshes TMUX environment
`prefix + U` `prefix` + <kbd>U</kbd>
- updates plugin(s) - updates plugin(s)
`prefix + alt + u` `prefix` + <kbd>alt</kbd> + <kbd>u</kbd>
- remove/uninstall plugins not on the plugin list - remove/uninstall plugins not on the plugin list
### More plugins ### More plugins
@ -80,13 +86,15 @@ this:
### Tests ### Tests
Tests for this project run on [travis](https://travis-ci.org/tmux-plugins/tpm). Tests for this project run on [Travis CI](https://travis-ci.org/tmux-plugins/tpm).
When run locally, [vagrant](https://www.vagrantup.com/) is required. When run locally, [vagrant](https://www.vagrantup.com/) is required.
Run tests with: Run tests with:
# within project directory ```bash
$ ./run_tests # within project directory
$ ./run_tests
```
### Other goodies ### Other goodies