]> git.r.bdr.sh - rbdr/r.bdr.sh/blame - oleoboard.gmi
Add font-size
[rbdr/r.bdr.sh] / oleoboard.gmi
CommitLineData
0e67cd77
RBR
1--- title: /oleoboard.html
2--- description: oleoboard (.nvim) is a plugin to use directories as a kanban-like board.
3
4## oleoboard.nvim
5
6A tool to use directories as a kanban-like board.
7
8When summoned it will load the directories in the current directory as columns so you can easily move files around.
9
10It depends on oil[1] to provide the file management functionality.
11
12=> https://github.com/stevearc/oil.nvim [1] oil.nvim
13
14=> https://git.r.bdr.sh/rbdr/oleoboard.nvim view source @ git.r.bdr.sh
15=> https://git.sr.ht/~rbdr/oleoboard.nvim source mirror @ sourcehut
16
17## Installation
18
19### lazy.nvim
20
21```lua
22require('lazy').setup({
23 {
24 'https://git.sr.ht/~rbdr/oleoboard.nvim',
25 dependencies = {
26 'stevearc/oil.nvim'
27 }
28 }
29})
30```
31
32By default, oleoboard adds keybinds that might not suit your style or conflict with other plugins. You can disable them with the `default_keybinds` option.
33
34```lua
35require('lazy').setup({
36 {
37 'https://git.sr.ht/~rbdr/oleoboard.nvim',
38 dependencies = {
39 'stevearc/oil.nvim'
40 },
41 opts = {
42 default_keybinds = false
43 }
44})
45```
46
47## Keybinds
48
49Unless disabled, these are the key bindings provided:
50
51- `<leader>bb`, `:OleoBoardToggle`, Opens and Closes the kanban board
52- `<leader>bl`, `:OleoBoardMoveEntryRight`, Moves the current entry to the right
53- `<leader>bL`, `:OleoBoardMoveColumnRight`, Moves the current column to the right
54- `<leader>bh`, `:OleoBoardMoveEntryLeft`, Moves the current entry to the left
55- `<leader>bH`, `:OleoBoardMoveColumnLeft`, Moves the current column to the left
56
57## An Example
58
59As I work in blog entries I have four directories: ideas, writing, published, and cancelled. By opening them with oleoboard I can see them as a kanban board and easily move them around (eg. when I start writing an idea, or when I publish an article)