Skip to content

Commit

Permalink
Updated docs to contain all README info
Browse files Browse the repository at this point in the history
  • Loading branch information
G. Roggemans committed Feb 21, 2016
1 parent f2cbf05 commit 76b1be3
Show file tree
Hide file tree
Showing 7 changed files with 123 additions and 5 deletions.
12 changes: 10 additions & 2 deletions docs/about.md
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
16 changes: 13 additions & 3 deletions docs/index.md
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
14 changes: 14 additions & 0 deletions docs/install.md
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
1 change: 1 addition & 0 deletions docs/plugins.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
TODO
12 changes: 12 additions & 0 deletions docs/tpm.md
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'
```

68 changes: 68 additions & 0 deletions docs/usage.md
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
5 changes: 5 additions & 0 deletions mkdocs.yml
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

0 comments on commit 76b1be3

Please sign in to comment.