You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+16-10Lines changed: 16 additions & 10 deletions
Original file line number
Diff line number
Diff line change
@@ -126,8 +126,9 @@ Preinstalled `grep` in FreeBSD doesn't support Perl regular expressions. Solutio
126
126
* The default powerline should already be visible now!
127
127
4. Continue to the [Configuration](#configuration) section below.
128
128
129
-
Note that tpm plugins should be at the bottom of you `tmux.conf`. This plugin will then override some tmux settings like `status-left`, `status-right` etc. If you had already set those in your tmux config, it is a good opportunity to remove or comment those out.
130
-
Take a look at [main.tmux](https://github.com/erikw/tmux-powerline/blob/main/main.tmux) for exactly which settings are overridden.
129
+
> [!NOTE]
130
+
> Note that tpm plugins should be at the bottom of you `tmux.conf`. This plugin will then override some tmux settings like `status-left`, `status-right` etc. If you had already set those in your tmux config, it is a good opportunity to remove or comment those out.
131
+
> Take a look at [main.tmux](https://github.com/erikw/tmux-powerline/blob/main/main.tmux) for exactly which settings are overridden.
Remember to update the configuration file to use the new theme by setting `TMUX_POWERLINE_THEME=my-theme`
163
+
> [!IMPORTANT]
164
+
> Remember to update the configuration file to use the new theme by setting `TMUX_POWERLINE_THEME=my-theme`
163
165
164
166
## Custom segments
165
167
In the same was as themes, you can create your own segments at `TMUX_POWERLINE_DIR_USER_SEGMENTS` which defaults to `~/.config/tmux-powerline/segments`.
@@ -208,27 +210,30 @@ Be sure to search in the [resolved issues](https://github.com/erikw/tmux-powerli
208
210
209
211
210
212
211
-
## Common problems
213
+
## Common Problems
212
214
### Nothing is displayed
213
215
You have edited `~/.tmux.conf` but no powerline is displayed. This might be because tmux is not aware of the changes so you have to restart your tmux session or reloaded that file by typing this on the command-line (or in tmux command mode with `prefix :`)
214
216
215
217
```shell
216
218
tmux source-file ~/.tmux.conf
217
219
```
220
+
218
221
### Multiple lines in bash or no powerline in Zsh using iTerm (macOS)
219
222
If your tmux looks like [this](https://github.com/erikw/tmux-powerline/issues/125) then you may have to in iTerm uncheck [Unicode East Asian Ambiguous characters are wide] in Preferences -> Settings -> Advanced.
220
223
224
+
221
225
# Hacking (Development)
222
226
This project can only gain positively from contributions. Fork today and make your own enhancements and segments to share back! If you'd like, add your name and email to AUTHORS before making a pull request so you can get some credit for your work :-)
223
227
224
228
## Codespaces Devcontainer
225
229
You can fork this project and then start coding right away with GitHub Codespaces as this project is set up to install all development dependencies and install tmux-powerline on the devcontainer. See [devcontainer.json](.devcontainer/devcontainer.json) and [devcontainer_postCreateCommand.sh](scripts/devcontainer_postCreateCommand.sh). After starting the devcontainer, just type `tmux` in the terminal and you should see a working tmux-powerline already to start playing with.
226
230
227
-
Note: if you have set up your own dotfiles to be installed with GitHub Codespaces, and there was some tmux config files installed from your dotfiles to the devcontainer, then you might have to run this script to wipe your config in favour of the setup provided by this repo's initialization:
228
-
229
-
```shell
230
-
./scripts/devcontainer_postCreateCommand.sh
231
-
```
231
+
> [!IMPORTANT]
232
+
> If you have set up your own dotfiles to be installed with GitHub Codespaces, and there was some tmux config files installed from your dotfiles to the devcontainer, then you might have to run this script to wipe your config in favour of the setup provided by this repo's initialization:
233
+
>
234
+
> ```shell
235
+
> ./scripts/devcontainer_postCreateCommand.sh
236
+
>```
232
237
233
238
## How to make a segment
234
239
If you want to (of course you do!) send a pull request fora cool segment you written make sure that it follows the style of existing segments, unless you have good reason for it. Each segment residesin the `segments/` directory with a descriptive and simple name.
@@ -240,7 +245,8 @@ Usage of helper function to organize the work of a segment is encourage and shou
240
245
explanation of the setting and its values. Study e.g. `segments/now_playing.sh` to see how it is done. A segment having settings should typically call a helper function `__process_settings` as the first statement in `run_segment` that sets default values
241
246
to the settings that has not been set by the user.
242
247
243
-
Also, don't use bash4 features as requiring bash4 complicates installation for macOS user quite a bit. Use tabs for indentation ([discussion](https://github.com/erikw/tmux-powerline/pull/92)),
248
+
> [!IMPORTANT]
249
+
> Also, don't use bash4 features as requiring bash4 complicates installation for macOS user quite a bit. Use tabs for indentation ([discussion](https://github.com/erikw/tmux-powerline/pull/92)),
244
250
245
251
# Releasing
246
252
Create a new version of this project by using [semver-cli](https://github.com/maykonlsf/semver-cli).
0 commit comments