chore: Auto generate docs
parent
cad2c8fb4b
commit
efbd1398ee
|
|
@ -1,13 +1,13 @@
|
||||||
*genghis.txt* For NVIM v0.8.0 Last change: 2023 October 13
|
*genghis.txt* For NVIM v0.8.0 Last change: 2023 November 12
|
||||||
|
|
||||||
==============================================================================
|
==============================================================================
|
||||||
Table of Contents *genghis-table-of-contents*
|
Table of Contents *genghis-table-of-contents*
|
||||||
|
|
||||||
1. nvim-genghis |genghis-nvim-genghis-|
|
1. nvim-genghis |genghis-nvim-genghis-|
|
||||||
- How is this different from vim.eunuch?|genghis-nvim-genghis--how-is-this-different-from-vim.eunuch?|
|
|
||||||
- Installation and Setup |genghis-nvim-genghis--installation-and-setup|
|
- Installation and Setup |genghis-nvim-genghis--installation-and-setup|
|
||||||
- Available Commands |genghis-nvim-genghis--available-commands|
|
- Available Commands |genghis-nvim-genghis--available-commands|
|
||||||
- Autocompletion of directories|genghis-nvim-genghis--autocompletion-of-directories|
|
- Autocompletion of directories|genghis-nvim-genghis--autocompletion-of-directories|
|
||||||
|
- Howis this different from vim.eunuch?|genghis-nvim-genghis--howis-this-different-from-vim.eunuch?|
|
||||||
- Why that name |genghis-nvim-genghis--why-that-name|
|
- Why that name |genghis-nvim-genghis--why-that-name|
|
||||||
- About me |genghis-nvim-genghis--about-me|
|
- About me |genghis-nvim-genghis--about-me|
|
||||||
|
|
||||||
|
|
@ -16,28 +16,19 @@ Table of Contents *genghis-table-of-contents*
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Conveniencefile operations for neovim, written in lua.
|
Lightweightplugin providing file operations without a full-blown file tree.
|
||||||
|
|
||||||
- |genghis-how-is-this-different-from-`vim.eunuch`?|
|
|
||||||
- |genghis-installation-and-setup|
|
- |genghis-installation-and-setup|
|
||||||
- |genghis-available-commands|
|
- |genghis-available-commands|
|
||||||
- |genghis-file-operation-command|
|
- |genghis-file-operation-command|
|
||||||
- |genghis-file-utility-commands|
|
- |genghis-file-utility-commands|
|
||||||
- |genghis-disable-ex-commands|
|
- |genghis-disable-ex-commands|
|
||||||
- |genghis-autocompletion-of-directories|
|
- |genghis-autocompletion-of-directories|
|
||||||
|
- |genghis-how-is-this-different-from-`vim.eunuch`?|
|
||||||
- |genghis-why-that-name|
|
- |genghis-why-that-name|
|
||||||
- |genghis-about-me|
|
- |genghis-about-me|
|
||||||
|
|
||||||
|
|
||||||
HOW IS THIS DIFFERENT FROM VIM.EUNUCH?*genghis-nvim-genghis--how-is-this-different-from-vim.eunuch?*
|
|
||||||
|
|
||||||
- Various improvements like automatically keeping the extensions when no extension is given, or moving files to the trash instead of removing them.
|
|
||||||
- Uses only vim-commands or lua os-modules, so it has no dependencies and works cross-platform.
|
|
||||||
- Makes use of up-to-date nvim features like `vim.ui.input` or `vim.notify`. This means you can get nicer input fields with normal mode support via plugins like dressing.nvim <https://github.com/stevearc/dressing.nvim>, and confirmation notices with plugins like nvim-notify <https://github.com/rcarriga/nvim-notify>, if they are installed and setup.
|
|
||||||
- If used with dressing and cmp, |genghis-you-can-also-get-autocompletion-of-directories|.
|
|
||||||
- Written 100% in lua.
|
|
||||||
|
|
||||||
|
|
||||||
INSTALLATION AND SETUP *genghis-nvim-genghis--installation-and-setup*
|
INSTALLATION AND SETUP *genghis-nvim-genghis--installation-and-setup*
|
||||||
|
|
||||||
>lua
|
>lua
|
||||||
|
|
@ -61,7 +52,7 @@ create keybindings for the commands you want to use:
|
||||||
keymap("n", "<leader>mf", genghis.moveAndRenameFile)
|
keymap("n", "<leader>mf", genghis.moveAndRenameFile)
|
||||||
keymap("n", "<leader>nf", genghis.createNewFile)
|
keymap("n", "<leader>nf", genghis.createNewFile)
|
||||||
keymap("n", "<leader>yf", genghis.duplicateFile)
|
keymap("n", "<leader>yf", genghis.duplicateFile)
|
||||||
keymap("n", "<leader>df", function () genghis.trashFile{trashLocation = "your/path"} end) -- default: "$HOME/.Trash".
|
keymap("n", "<leader>df", function() genghis.trashFile { trashLocation = "your/path" } end) -- default: "$HOME/.Trash".
|
||||||
keymap("x", "<leader>x", genghis.moveSelectionToNewFile)
|
keymap("x", "<leader>x", genghis.moveSelectionToNewFile)
|
||||||
<
|
<
|
||||||
|
|
||||||
|
|
@ -73,9 +64,12 @@ FILE OPERATION COMMAND ~
|
||||||
|
|
||||||
- `.createNewFile` or `:New`Create a new file.
|
- `.createNewFile` or `:New`Create a new file.
|
||||||
- `.duplicateFile` or `:Duplicate`Duplicate the current file.
|
- `.duplicateFile` or `:Duplicate`Duplicate the current file.
|
||||||
- `.moveSelectionToNewFile` or `:NewFromSelection`Prompts for a new file name and moves the current selection to that new file. (Note that this is a Visual Line Mode command; the selection is moved linewise.)
|
- `.moveSelectionToNewFile` or `:NewFromSelection`Prompts for a new file name
|
||||||
|
and moves the current selection to that new file. (Note that this is a Visual
|
||||||
|
Line Mode command; the selection is moved linewise.)
|
||||||
- `.renameFile` or `:Rename`Rename the current file.
|
- `.renameFile` or `:Rename`Rename the current file.
|
||||||
- `.moveAndRenameFile` or `:Move`Move and Rename the current file. Works like the UNIX `mv` command. Best used with |genghis-autocompletion-of-directories|.
|
- `.moveAndRenameFile` or `:Move`Move and Rename the current file. Works like
|
||||||
|
the UNIX `mv` command. Best used with |genghis-autocompletion-of-directories|.
|
||||||
|
|
||||||
The following applies to all commands above: - If no extension has been
|
The following applies to all commands above: - If no extension has been
|
||||||
provided, uses the extension of the original file. - If the new file name
|
provided, uses the extension of the original file. - If the new file name
|
||||||
|
|
@ -85,20 +79,37 @@ only place in the current working directory, so `.moveAndRenameFile` is the
|
||||||
only command that can move to a parent directory. - All commands support
|
only command that can move to a parent directory. - All commands support
|
||||||
|genghis-autocompletion-of-existing-directories|.
|
|genghis-autocompletion-of-existing-directories|.
|
||||||
|
|
||||||
`renameFile` and `moveAndRenameFile` will notify any running LSP client about
|
`renameFile` and `moveAndRenameFile` notify any running LSP client about the
|
||||||
the renaming. LSP servers supporting the `workspace/willRenameFiles` method can
|
renaming. LSP servers supporting the `workspace/willRenameFiles` method can use
|
||||||
use this information to update various code parts, for example `use` or
|
this information to update various code parts, for example `use` or `import`
|
||||||
`import` statements.
|
statements.
|
||||||
|
|
||||||
|
|
||||||
FILE UTILITY COMMANDS ~
|
FILE UTILITY COMMANDS ~
|
||||||
|
|
||||||
- `.trashFile{trashLocation = "/your/path/"}` or `:Trash`Move the current file to the trash location. Defaults to the operating-system-specific trash directory. <https://github.com/chrisgrieser/nvim-genghis/blob/main/lua/genghis.lua#L164> Any existing file in the trash location with the same name is overwritten, making that file irretrievable. If bufdelete.nvim <https://github.com/famiu/bufdelete.nvim> is available, `require'bufdelete.nvim'.bufwipeout` would be used to keep window layout intact instead of `vim.cmd.bwipeout`.
|
- `.trashFile{trashLocation = "/your/path/"}` or `:Trash`Move the current file
|
||||||
- `.copyFilename` or `:CopyFilename`Copy the file name. When `clipboard="unnamed[plus]"` has been set, copies to the `+` register, otherwise to `"`.
|
to the trash location. Defaults to the operating-system-specific trash
|
||||||
- `.copyFilepath` or `:CopyFilepath`Copy the absolute file path. When `clipboard="unnamed[plus]"` has been set, copies to the `+` register, otherwise to `"`.
|
directory. <https://github.com/chrisgrieser/nvim-genghis/blob/main/lua/genghis.lua#L164>
|
||||||
- `.copyRelativePath` or `:CopyRelativePath`Copy the relative file path. When `clipboard="unnamed[plus]"` has been set, copies to the `+` register, otherwise to `"`.
|
Any existing file in the trash location with the same name is overwritten,
|
||||||
- `.copyDirectoryPath` or `:CopyDirectoryPath`Copy the absolute directory path. When `clipboard="unnamed[plus]"` has been set, copies to the `+` register, otherwise to `"`.
|
making that file irretrievable. If
|
||||||
- `.copyRelativeDirectoryPath` or `:CopyRelativeDirectoryPath`Copy the relative directory path. When `clipboard="unnamed[plus]"` has been set, copies to the `+` register, otherwise to `"`.
|
bufdelete.nvim <https://github.com/famiu/bufdelete.nvim> is available,
|
||||||
|
`require'bufdelete.nvim'.bufwipeout` would be used to keep window layout intact
|
||||||
|
instead of `vim.cmd.bwipeout`.
|
||||||
|
- `.copyFilename` or `:CopyFilename`Copy the file name. When
|
||||||
|
`clipboard="unnamed[plus]"` has been set, copies to the `+` register, otherwise
|
||||||
|
to `"`.
|
||||||
|
- `.copyFilepath` or `:CopyFilepath`Copy the absolute file path. When
|
||||||
|
`clipboard="unnamed[plus]"` has been set, copies to the `+` register, otherwise
|
||||||
|
to `"`.
|
||||||
|
- `.copyRelativePath` or `:CopyRelativePath`Copy the relative file path. When
|
||||||
|
`clipboard="unnamed[plus]"` has been set, copies to the `+` register, otherwise
|
||||||
|
to `"`.
|
||||||
|
- `.copyDirectoryPath` or `:CopyDirectoryPath`Copy the absolute directory
|
||||||
|
path. When `clipboard="unnamed[plus]"` has been set, copies to the `+` register,
|
||||||
|
otherwise to `"`.
|
||||||
|
- `.copyRelativeDirectoryPath` or `:CopyRelativeDirectoryPath`Copy the
|
||||||
|
relative directory path. When `clipboard="unnamed[plus]"` has been set, copies
|
||||||
|
to the `+` register, otherwise to `"`.
|
||||||
- `.chmodx` or `:Chmodx`Makes current file executable. Equivalent to `chmod +x`.
|
- `.chmodx` or `:Chmodx`Makes current file executable. Equivalent to `chmod +x`.
|
||||||
|
|
||||||
To always use system clipboard put this in your configuration file:
|
To always use system clipboard put this in your configuration file:
|
||||||
|
|
@ -132,7 +143,7 @@ Put this in your configuration file:
|
||||||
AUTOCOMPLETION OF DIRECTORIES*genghis-nvim-genghis--autocompletion-of-directories*
|
AUTOCOMPLETION OF DIRECTORIES*genghis-nvim-genghis--autocompletion-of-directories*
|
||||||
|
|
||||||
You can get autocompletion for directories by using `dressing.nvim`,
|
You can get autocompletion for directories by using `dressing.nvim`,
|
||||||
`nvim-cmp`, and vim’s omnifunc:
|
`nvim-cmp`, and vim’s `omnifunc`
|
||||||
|
|
||||||
>lua
|
>lua
|
||||||
-- packer
|
-- packer
|
||||||
|
|
@ -154,14 +165,30 @@ You can get autocompletion for directories by using `dressing.nvim`,
|
||||||
>lua
|
>lua
|
||||||
-- required setup for cmp, somewhere after your main cmp-config
|
-- required setup for cmp, somewhere after your main cmp-config
|
||||||
require("cmp").setup.filetype("DressingInput", {
|
require("cmp").setup.filetype("DressingInput", {
|
||||||
sources = cmp.config.sources { {name = "omni"} },
|
sources = cmp.config.sources { { name = "omni" } },
|
||||||
})
|
})
|
||||||
<
|
<
|
||||||
|
|
||||||
|
|
||||||
|
HOWIS THIS DIFFERENT FROM VIM.EUNUCH?*genghis-nvim-genghis--howis-this-different-from-vim.eunuch?*
|
||||||
|
|
||||||
|
- Various improvements like automatically keeping the extensions when no
|
||||||
|
extension is given, or moving files to the trash instead of removing them.
|
||||||
|
- Uses only vim-commands or lua `os` modules, so it has no dependencies and
|
||||||
|
works cross-platform.
|
||||||
|
- Makes use of up-to-date nvim features like `vim.ui.input` or `vim.notify`.
|
||||||
|
This means you can get nicer input fields with normal mode support via plugins
|
||||||
|
like dressing.nvim <https://github.com/stevearc/dressing.nvim>, and
|
||||||
|
confirmation notices with plugins like
|
||||||
|
nvim-notify <https://github.com/rcarriga/nvim-notify>, if they are installed
|
||||||
|
and setup.
|
||||||
|
- LSP support when renaming.
|
||||||
|
- Written 100% in lua.
|
||||||
|
|
||||||
|
|
||||||
WHY THAT NAME *genghis-nvim-genghis--why-that-name*
|
WHY THAT NAME *genghis-nvim-genghis--why-that-name*
|
||||||
|
|
||||||
A nod to vim.eunuch <https://github.com/tpope/vim-eunuch> - as opposed to
|
A nod to vim.eunuch <https://github.com/tpope/vim-eunuch>. As opposed to
|
||||||
childless eunuchs, it is said that Genghis Khan has fathered thousands of
|
childless eunuchs, it is said that Genghis Khan has fathered thousands of
|
||||||
children <https://allthatsinteresting.com/genghis-khan-children>.
|
children <https://allthatsinteresting.com/genghis-khan-children>.
|
||||||
|
|
||||||
|
|
@ -174,7 +201,7 @@ economy and how software ecosystems manage the tension between innovation and
|
||||||
compatibility. If you are interested in this subject, feel free to get in
|
compatibility. If you are interested in this subject, feel free to get in
|
||||||
touch.
|
touch.
|
||||||
|
|
||||||
**Blog** I also occassionally blog about vim: Nano Tips for Vim
|
**Blog** I also occasionally blog about vim: Nano Tips for Vim
|
||||||
<https://nanotipsforvim.prose.sh>
|
<https://nanotipsforvim.prose.sh>
|
||||||
|
|
||||||
**Profiles** - Discord <https://discordapp.com/users/462774483044794368/> -
|
**Profiles** - Discord <https://discordapp.com/users/462774483044794368/> -
|
||||||
|
|
@ -183,7 +210,7 @@ Academic Website <https://chris-grieser.de/> - GitHub
|
||||||
- ResearchGate <https://www.researchgate.net/profile/Christopher-Grieser> -
|
- ResearchGate <https://www.researchgate.net/profile/Christopher-Grieser> -
|
||||||
LinkedIn <https://www.linkedin.com/in/christopher-grieser-ba693b17a/>
|
LinkedIn <https://www.linkedin.com/in/christopher-grieser-ba693b17a/>
|
||||||
|
|
||||||
**Buy Me a Coffee**
|
|
||||||
|
|
||||||
Generated by panvimdoc <https://github.com/kdheepak/panvimdoc>
|
Generated by panvimdoc <https://github.com/kdheepak/panvimdoc>
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue