Skip to content

Commit

Permalink
basics: Toggleterm uses direction=tab to open in tab page
Browse files Browse the repository at this point in the history
AstroNvim key binding to open Toggleterm in a tab page no longer exists
(or has been overridden by Toggleterm btm)

Add how to open Toggleterm in a new tab page

Resolve #3
  • Loading branch information
practicalli-johnny committed Jun 16, 2024
1 parent df27237 commit 3911888
Showing 1 changed file with 9 additions and 8 deletions.
17 changes: 9 additions & 8 deletions docs/neovim-basics/terminal.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,16 @@

[akinsho/toggleterm.nvim](https://github.com/akinsho/toggleterm.nvim) plugin provides a terminal session within Neovim, using a float, split or tab.

=== "AstroNvim"

`SPC t` for the Terminal sub-menu
++spc++ ++"t"++ for the Terminal sub-menu

`SPC t f` opens a terminal in a floating window, useful for one-off commands
++spc++ ++"t"++ ++"f"++ opens a terminal in a floating window, useful for one-off commands or short sessions

`SPC t h` opens a terminal in a horizontal split, useful for a process that prints valuable feedback, e.g. a test runner in watch mode
++spc++ ++"t"++ ++"f"++ opens a terminal in a horizontal split, useful for a process that prints valuable feedback, e.g. a test runner in watch mode

`SPC t t` opens a terminal in a tab, useful for background processes that do not need attendtion

![Toggleterm.nvim float](https://github.com/practicalli/graphic-design/blob/live/editors/neovim/screenshots/neovim-terminal-float-directory-listing-light.png?raw=true#only-light){loading=lazy}
![Toggleterm.nvim float](https://github.com/practicalli/graphic-design/blob/live/editors/neovim/screenshots/neovim-terminal-float-directory-listing-dark.png?raw=true#only-dark){loading=lazy}
`:Toggleterm direction=tab` opens a terminal in a tab page, useful for long running processes

<!-- TODO: Add key binding for Terminal in a tab to lua/plugins/user-practicalli.lua -->

![Toggleterm.nvim float](https://github.com/practicalli/graphic-design/blob/live/editors/neovim/screenshots/neovim-terminal-float-directory-listing-light.png?raw=true#only-light){loading=lazy}
![Toggleterm.nvim float](https://github.com/practicalli/graphic-design/blob/live/editors/neovim/screenshots/neovim-terminal-float-directory-listing-dark.png?raw=true#only-dark){loading=lazy}

0 comments on commit 3911888

Please sign in to comment.