mirror of
				https://github.com/tmux-plugins/tpm.git
				synced 2025-11-04 00:16:05 +00:00 
			
		
		
		
	Move all the docs to docs/ dir
				
					
				
			This commit is contained in:
		@@ -2,6 +2,7 @@
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
### master
 | 
					### master
 | 
				
			||||||
- refactor `shared_set_tpm_path_constant` function
 | 
					- refactor `shared_set_tpm_path_constant` function
 | 
				
			||||||
 | 
					- move all instructions to `docs/` dir
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### v2.0.0, 2015-07-07
 | 
					### v2.0.0, 2015-07-07
 | 
				
			||||||
- enable overriding default key bindings
 | 
					- enable overriding default key bindings
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -73,8 +73,9 @@ More advanced features and instructions, regular users probably do not need
 | 
				
			|||||||
this:
 | 
					this:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- [How to create a plugin](docs/how_to_create_plugin.md). It's easy.
 | 
					- [How to create a plugin](docs/how_to_create_plugin.md). It's easy.
 | 
				
			||||||
- [Installing plugins via the command line](https://github.com/tmux-plugins/tpm/wiki/Installing-plugins-via-the-command-line-only)
 | 
					- [Installing plugins via the command line](docs/installing_plugins_via_cmd_line.md)
 | 
				
			||||||
- [Changing plugins install dir](https://github.com/tmux-plugins/tpm/wiki/Changing-plugins-install-dir)
 | 
					- [Changing plugins install dir](docs/changing_plugins_install_dir.md)
 | 
				
			||||||
 | 
					- [Automatic TPM installation](docs/automatic_tpm_installation.md)
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### Tests
 | 
					### Tests
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 
 | 
				
			|||||||
							
								
								
									
										12
									
								
								docs/automatic_tpm_installation.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										12
									
								
								docs/automatic_tpm_installation.md
									
									
									
									
									
										Normal file
									
								
							@@ -0,0 +1,12 @@
 | 
				
			|||||||
 | 
					# Automatic tpm installation
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					One of the first things we do on a new machine is cloning our dotfiles. Not everything comes with them though, so for example `tpm` most likely won't be installed.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					If you wanna install `tpm` automatically when tmux is started, put the following snippet in `.tmux.conf` before the final `run '~/.tmux/plugins/tpm/tpm'`:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					if "test ! -d ~/.tmux/plugins/tpm" \
 | 
				
			||||||
 | 
					   "run 'git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm'"
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					This useful tip was submitted by @acr4.
 | 
				
			||||||
							
								
								
									
										14
									
								
								docs/changing_plugins_install_dir.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										14
									
								
								docs/changing_plugins_install_dir.md
									
									
									
									
									
										Normal file
									
								
							@@ -0,0 +1,14 @@
 | 
				
			|||||||
 | 
					# Changing plugins install dir
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					By default, TPM installs plugins to `~/.tmux/plugins/`.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					You can change the install path by putting this in `.tmux.conf`:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					    set-environment -g TMUX_PLUGIN_MANAGER_PATH '/some/other/path/'
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					Tmux plugin manager initialization in `.tmux.conf` should also be updated:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					    # initializes TMUX plugin manager in a new path
 | 
				
			||||||
 | 
					    run /some/other/path/tpm/tpm
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					Please make sure that the `run` line is at the very bottom of `.tmux.conf`.
 | 
				
			||||||
							
								
								
									
										20
									
								
								docs/installing_plugins_via_cmd_line.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										20
									
								
								docs/installing_plugins_via_cmd_line.md
									
									
									
									
									
										Normal file
									
								
							@@ -0,0 +1,20 @@
 | 
				
			|||||||
 | 
					# Installing plugins via the command line only
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					### From inside tmux
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					When you have `tmux` running, plugins can be installed with the following command:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					    ~/.tmux/plugins/tpm/scripts/install_plugins.sh
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					This is the equivalent of pressing `prefix + I`.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					### From outside tmux
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					To install the plugins when `tmux` is not even started (for example in a provisioning script):
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					    # start tmux and create a session but don't attach to it
 | 
				
			||||||
 | 
					    tmux new-session -d
 | 
				
			||||||
 | 
					    # install the plugins
 | 
				
			||||||
 | 
					    tmux run "~/.tmux/plugins/tpm/scripts/install_plugins.sh"
 | 
				
			||||||
 | 
					    # killing the session is not required
 | 
				
			||||||
 | 
					    tmux kill-session
 | 
				
			||||||
		Reference in New Issue
	
	Block a user