inkdrop-command-palette/README.md

54 lines
1.9 KiB
Markdown
Raw Normal View History

2022-08-24 09:05:59 +00:00
# inkdrop command palette
2022-08-24 09:09:10 +00:00
2022-08-24 09:05:59 +00:00
A VSCode-like command palette for Inkdrop.
![Inkdrop_logbdEi1qT](https://user-images.githubusercontent.com/53419401/186372300-eadccb9e-5acb-4771-ac1c-1d46728ce75a.gif)
## Features
2022-08-24 09:09:10 +00:00
2022-08-24 09:05:59 +00:00
- Access and Invoke almost any command in Inkdrop.
- Filter commands by `.` for Formatting Commands and by `>` for application commands.
- Know which keyboard shortcuts are associated per command[^1].
- Search every command[^2] in Inkdrop.
- Extensible and easily configurable for plugin developers.
## Install
2022-08-24 09:09:10 +00:00
2022-08-24 09:05:59 +00:00
```css
ipm install command-palette
```
## Keybindings
2022-08-24 09:09:10 +00:00
| Command | Explanation | Keybind |
| --------------------- | ------------------------------- | ------- |
| commandpalette:toggle | Shows/Hides the Command Palette | Ctrl+K |
2022-08-24 09:05:59 +00:00
#### add it to your keymap.cson
2022-08-24 09:09:10 +00:00
2022-08-24 09:05:59 +00:00
```js
2022-08-24 09:09:10 +00:00
'body':
2022-08-24 09:05:59 +00:00
'ctrl-k': 'commandpalette:toggle'
```
2022-08-24 09:09:10 +00:00
## Changelog
2022-08-24 09:05:59 +00:00
#### 1.0.0 - 08/24/2022
2022-08-24 09:09:10 +00:00
2022-08-24 09:05:59 +00:00
- Initial release, yay!
2022-08-24 09:09:10 +00:00
## Ideas
2022-08-24 09:05:59 +00:00
- [ ] configurable settings? I don't know what to put here though...
2022-08-24 09:09:10 +00:00
## Todo
2022-08-24 09:05:59 +00:00
- [ ] ability to use commands that require an argument, **requires a bit of reverse engineering**
- [ ] finalize decision on whether i should isolate commands such as `focus on ****` because we'd be already focusing on it or have another command invokable related to it that works targeted by the selector[^3].
- [ ] code documentation/prettify to make it less stressful on the eyes.
- [ ] find a way to make commands that rely on native stuff target the proper selector, as of now i could only rule this as a javascript DOM limitation (still researching on it though!)
[^1]: Current version is limited to only default keybindings, planned support for user defined `keymaps.cson` is in the works.
[^2]: Provided that the plugin developer provides support for their command via `lib/commands/plugins.js`
[^3]: For now, if you search for a command like that, it won't show anything but it's always visible on the full list, oh and you can't invoke it either.