-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Updated docs to contain all README info
- Loading branch information
G. Roggemans
committed
Feb 21, 2016
1 parent
f2cbf05
commit 76b1be3
Showing
7 changed files
with
123 additions
and
5 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,8 +1,16 @@ | ||
# About | ||
### Credits | ||
This project wasn't possible without the great work of [Z. Kelling][zkelling] | ||
on [Ellipsis][ellipsis], and [B. Sutic][bsutic] on [TPM][tpm]. | ||
|
||
### Author | ||
[G. Roggemans][groggemans] | ||
|
||
### License | ||
Ellipsis-TPM is open-source software licensed under the [MIT license][mit-license]. | ||
|
||
|
||
[zkelling]: https://github.com/zeekay | ||
[ellipsis]: https://github.com/ellipsis/ellipsis | ||
[bsutic]: https://github.com/bruno- | ||
[tpm]: https://github.com/tmux-plugins/tpm | ||
[groggemans]: https://github.com/groggemans | ||
[mit-license]: http://opensource.org/licenses/MIT |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,5 +1,15 @@ | ||
# Ellipsis-TPM | ||
Ellipsis-TPM is an [Ellipsis][ellipsis] extension to manage Tmux plugins. It | ||
can be used as replacement for [TPM][tpm]. | ||
|
||
This is the official Ellipsis-TPM documentation. | ||
### Features | ||
- Easy plugin management. | ||
- Easy plugin loading. | ||
- Compatible with [existing plugins][tmux-plugins] written for [TPM][tpm]! | ||
- No Tmux version restrictions! | ||
- Can be used without Tmux running. | ||
- Supports custom config file locations. | ||
- Supports branch based installs | ||
|
||
The docs are currently under development. | ||
[ellipsis]: https://github.com/ellipsis/ellipsis | ||
[tpm]: https://github.com/tmux-plugins/tpm | ||
[tmux-plugins]: https://github.com/tmux-plugins |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,14 @@ | ||
**Requirements:** [Ellipsis][ellipsis] | ||
|
||
```bash | ||
# With ellipsis installed | ||
$ ellipsis install ellipsis-tpm | ||
|
||
# Without ellipsis installed | ||
$ curl -Ls ellipsis.sh | PACKAGES='ellipsis-tpm' sh | ||
``` | ||
|
||
The `.ellipsis/bin` folder should be added to your path. If it isn't you will | ||
need to symlink `.ellipsis/bin/ellipsis-tpm` to a folder that is in your path. | ||
|
||
[ellipsis]: https://github.com/ellipsis/ellipsis |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
TODO |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,12 @@ | ||
Make sure your using the `@plugin` notation, switch the initialization line in | ||
your tmux.conf and your good to go! | ||
|
||
``` | ||
# Remove this | ||
set -g @plugin 'tmux-plugins/tpm' | ||
run '~/.tmux/plugins/tpm/tpm' | ||
# Add this | ||
run 'ellipsis-tpm run' | ||
``` | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,68 @@ | ||
Add your plugins in your `.tmux.conf` file. | ||
|
||
``` | ||
# List of plugins | ||
set -g @plugin 'tmux-plugins/tmux-resurrect' | ||
set -g @plugin 'tmux-plugins/tmux-yank' | ||
# Other examples | ||
# set -g @plugin 'github_username/plugin_name' | ||
# set -g @plugin 'github_username/plugin_name@branch_name' | ||
# set -g @plugin 'http://github.com/user/plugin' | ||
# set -g @plugin 'https://github.com/user/plugin' | ||
# set -g @plugin 'git://github.com/user/plugin' | ||
# set -g @plugin 'ssh://git@github.com/user/plugin' | ||
# set -g @plugin 'https://gitlab.com/user/plugin' | ||
# Initialize the manager (loads all plugins) | ||
run 'ellipsis-tpm run' | ||
``` | ||
|
||
After you modified your config file you can either source it again or run | ||
`ellipsis-tpm run` manually. | ||
|
||
#### Installing plugins | ||
- Add the plugins to your config file with `set -g @plugin '...'` | ||
- Press `prefix + I` to install newly added plugins or run `ellipsis-tpm | ||
install` in your terminal | ||
|
||
Only testing a plugin? Run `ellipsis-tpm install <plugin_url>` to quickly install | ||
it! | ||
|
||
#### Uninstalling plugins | ||
- Remove from your config file or comment out. | ||
- Press `prefix + alt + u` or run `ellipsis-tpm clean` in your terminal | ||
|
||
Remove a specific plugin? Run `ellipsis-tpm uninstall <plugin_name>`. | ||
|
||
#### Updating plugins | ||
- Press `prefix + U` or run `ellipsis-tpm update` in your terminal. | ||
|
||
Update a specific plugin? Just run `ellipsis-tpm update <plugin_name>` | ||
|
||
#### Customization | ||
|
||
There are several options wich can either be set in the tmux config file or | ||
with an environment variable. When both are set the environment variable will | ||
be used. | ||
|
||
env var | tmux var | Default | Description | ||
-----------------|--------------------|-------------------------------|------------ | ||
`TPM_CONF` | / | `/etc/tmux.conf:~/.tmux.conf` | Tmux configuration files ( `:` separated) | ||
`TPM_PLUGIN_PATH`| `@tpm_plugin_path` | `~/.tmux/plugins` | Location where plugins are installed | ||
`TPM_INSTALL_KEY`| `@tpm_install_key` | `I` | Key to install plugins | ||
`TPM_UPDATE_KEY` | `@tpm_update_key` | `U` | Key to update plugins | ||
`TPM_CLEAN_KEY` | `@tpm_clean_key` | `M-u` | Key to clean plugins | ||
|
||
The original [TPM][tpm] variables are also supported: | ||
|
||
tmux var | Description | ||
---------------------------|------------ | ||
`TMUX_PLUGIN_MANAGER_PATH` | Location where plugins are installed | ||
`@tpm-install` | Install key | ||
`@tpm-update` | Update key | ||
`@tpm-clean` | Cleanup key | ||
|
||
|
||
[tpm]: https://github.com/tmux-plugins/tpm |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,4 +1,9 @@ | ||
site_name: Ellipsis-TPM | ||
pages: | ||
- Home: index.md | ||
- Install: install.md | ||
- Switching from TPM: tpm.md | ||
- Usage: usage.md | ||
- Writing plugins: plugins.md | ||
- About: about.md | ||
theme: readthedocs |