[{"result":{"data":[{"id":"3b641485-b9ca-4bdb-9de1-8451ddc0b20a","title":"chore!: Bram Moolenaar creator of Vim has passed away","text":"chore!: Bram Moolenaar creator of Vim has passed away\n\nRIP, great man.\n\nhttps://groups.google.com/g/vim_announce/c/tWahca9zkt4","type":"breaking-change","createdAt":"2023-08-07T02:23:53.512Z","breakingChange":{"id":24,"postId":"3b641485-b9ca-4bdb-9de1-8451ddc0b20a","pluginId":98,"externalUrl":"https://github.com/kevinhwang91/rnvimr/commit/5f0483d1c107ab1fe7e0af08cdf7900aa0dcb40e","sha":"5f0483d1c107ab1fe7e0af08cdf7900aa0dcb40e","plugin":{"id":98,"owner":"kevinhwang91","name":"rnvimr","type":"github","source":"awesome-neovim","category":"file-explorer","link":"https://github.com/kevinhwang91/rnvimr","shortDescription":"Make Ranger running in a floating window to communicate with Neovim via RPC","createdAt":"2023-03-22T19:35:21.574Z","readme":"# Rnvimr\n\nRnvimr is a NeoVim plugin that allows you to use Ranger in a floating window.\n\nDifferent than other Ranger vim-plugins, Rnvimr gives you full control over Ranger.\nIt uses [RPC](https://neovim.io/doc/user/api.html#RPC) to communicate with Ranger.\n\n

\n \n

\n\n**This plugin does not support Vim.**\n\n## Table of contents\n\n* [Requirements](#requirements)\n* [Features](#features)\n* [Installation](#installation)\n * [Dependence](#dependence)\n * [Plugin](#plugin)\n * [CheckHealth (optional)](#checkhealth-(optional))\n* [Usage](#usage)\n * [Demonstration](#demonstration)\n * [Example configuration](#example-configuration)\n * [Minimal configuration](#minimal-configuration)\n * [Advanced configuration](#advanced-configuration)\n* [FAQ](#faq)\n* [License](#license)\n\n## Requirements\n\n1. [Ranger](https://github.com/ranger/ranger) (v1.9.3 or laster)\n2. [Pynvim](https://github.com/neovim/pynvim)\n3. [Neovim](https://github.com/neovim/neovim) 0.5 or later\n4. Python3.6\n5. [Ueberzug](https://github.com/seebye/ueberzug) (optional, v18.1.6 or laster) /\n[Ueberzugpp](https://github.com/jstkdng/ueberzugpp) (optional, v2.3.0 or laster)\n\n## Features\n\n- Replace the built-in Netrw as a default file explorer\n- Calibrated preview images for ueberzug\n- Attach file automatically when toggling Ranger\n- Adjust floating window size automatically after resizing NeoVim\n- Adjust view automatically to adapt the size of floating window\n- Fully customizable layouts for floating window\n- Better experience for Pager view in Ranger\n- Wipe out the buffers corresponding to the files deleted by Ranger automatically\n- Enhanced border in Ranger\n- Synchronize the current working directory of Neovim and Ranger\n- Hide the files included in gitignore\n- Save Buffer information when the src files are moved from Ranger\n\n## Installation\n\n### Dependence\n\nExample for [yay](https://github.com/Jguer/yay) in ArchLinux and\n[pip](https://pip.pypa.io/en/stable/) in other \\*unix distributions:\n\n```sh\n# ArchLinux install all requirements is extremely convenient\nyay -S ranger python-pynvim ueberzug\n# ~ `ueberzug` can be replaced with `ueberzugpp` ~\n\n# pip\n\n# macOS users please install ranger by `pip3 ranger-fm` instead of `brew install ranger`\n# There're some issues about installation, such as https://github.com/ranger/ranger/issues/1214\n# Please refer to the issues of ranger for more details\npip3 install ranger-fm pynvim\n\n# Ueberzug/Ueberzugpp is not supported in macOS because it depends on X11\npip3 install ueberzug\n```\n\n> Ueberzug is optional\n\n### Plugin\n\nInstall Rnvimr with your favorite plugin manager! Example for [Vim-plug](https://github.com/junegunn/vim-plug):\n\n```vim\nPlug 'kevinhwang91/rnvimr'\n```\n\n### CheckHealth (optional)\n\nRun `nvim +'checkhealth rnvimr'` in shell. If everything is OK, it will output like these:\n\n```log\nhealth#rnvimr#check\n========================================================================\n## OS\n - OK: Name: Linux\n\n## Ranger\n - OK: Version: ranger-master\n\n## Python\n - OK: Version: 3.8.3 (default, May 17 2020, 18:15:42) [GCC 10.1.0]\n\n## Pynvim\n - OK: Version: 0.4.1\n\n## Ueberzug (optional)\n - OK: Ueberzug is ready\n\n## RPC\n - OK: RPC echo: Neovim send \"Give me five!\" and receive \"Give me five!\"\n```\n\n## Usage\n\nUsing `:RnvimrToggle` to create a Ranger process, and if one exists,\n`:RnvimrToggle` simply shows or hides the floating window.\n\nUsing `:RnvimrResize` to cycle the preset layouts.\n\nPressing `Enter` to open a file in Ranger.\n\nRnvimr also supports `ctrl-t`/`ctrl-x`/`ctrl-v` key bindings that allow you to\nopen up a file in a new tab, a new horizontal split, or in a new vertical split.\n\nPressing `q` in Ranger simply hides the floating window.\nRanger will attach the file of the current buffer in the next toggle event.\n\nPressing `yw` in Ranger will emit Ranger's cwd to Neovim's, `gw` will jump to Neovim's cwd.\n\n### Demonstration\n\n

Hide the files included in gitignore

\n \n

Save buffers information (undo) when the src files are moved from Ranger

\n \n

\n\n### Example configuration\n\n#### Minimal configuration\n\n```vim\nPlug 'kevinhwang91/rnvimr'\n\ntnoremap

:RnvimrResize\nnnoremap

:RnvimrToggle\ntnoremap

:RnvimrToggle\n```\n\n#### Advanced configuration\n\n```vim\nPlug 'kevinhwang91/rnvimr'\n\n\" Make Ranger replace Netrw and be the file explorer\nlet g:rnvimr_enable_ex = 1\n\n\" Make Ranger to be hidden after picking a file\nlet g:rnvimr_enable_picker = 1\n\n\" Replace `$EDITOR` candidate with this command to open the selected file\nlet g:rnvimr_edit_cmd = 'drop'\n\n\" Disable a border for floating window\nlet g:rnvimr_draw_border = 0\n\n\" Hide the files included in gitignore\nlet g:rnvimr_hide_gitignore = 1\n\n\" Change the border's color\nlet g:rnvimr_border_attr = {'fg': 14, 'bg': -1}\n\n\" Make Neovim wipe the buffers corresponding to the files deleted by Ranger\nlet g:rnvimr_enable_bw = 1\n\n\" Add a shadow window, value is equal to 100 will disable shadow\nlet g:rnvimr_shadow_winblend = 70\n\n\" Draw border with both\nlet g:rnvimr_ranger_cmd = ['ranger', '--cmd=set draw_borders both']\n\n\" Link CursorLine into RnvimrNormal highlight in the Floating window\nhighlight link RnvimrNormal CursorLine\n\nnnoremap

:RnvimrToggle\ntnoremap

:RnvimrToggle\n\n\" Resize floating window by all preset layouts\ntnoremap

:RnvimrResize\n\n\" Resize floating window by special preset layouts\ntnoremap

:RnvimrResize 1,8,9,11,5\n\n\" Resize floating window by single preset layout\ntnoremap

:RnvimrResize 6\n\n\" Map Rnvimr action\nlet g:rnvimr_action = {\n \\ '': 'NvimEdit tabedit',\n \\ '': 'NvimEdit split',\n \\ '': 'NvimEdit vsplit',\n \\ 'gw': 'JumpNvimCwd',\n \\ 'yw': 'EmitRangerCwd'\n \\ }\n\n\" Add views for Ranger to adapt the size of floating window\nlet g:rnvimr_ranger_views = [\n \\ {'minwidth': 90, 'ratio': []},\n \\ {'minwidth': 50, 'maxwidth': 89, 'ratio': [1,1]},\n \\ {'maxwidth': 49, 'ratio': [1]}\n \\ ]\n\n\" Customize the initial layout\nlet g:rnvimr_layout = {\n \\ 'relative': 'editor',\n \\ 'width': float2nr(round(0.7 * &columns)),\n \\ 'height': float2nr(round(0.7 * &lines)),\n \\ 'col': float2nr(round(0.15 * &columns)),\n \\ 'row': float2nr(round(0.15 * &lines)),\n \\ 'style': 'minimal'\n \\ }\n\n\" Customize multiple preset layouts\n\" '{}' represents the initial layout\nlet g:rnvimr_presets = [\n \\ {'width': 0.600, 'height': 0.600},\n \\ {},\n \\ {'width': 0.800, 'height': 0.800},\n \\ {'width': 0.950, 'height': 0.950},\n \\ {'width': 0.500, 'height': 0.500, 'col': 0, 'row': 0},\n \\ {'width': 0.500, 'height': 0.500, 'col': 0, 'row': 0.5},\n \\ {'width': 0.500, 'height': 0.500, 'col': 0.5, 'row': 0},\n \\ {'width': 0.500, 'height': 0.500, 'col': 0.5, 'row': 0.5},\n \\ {'width': 0.500, 'height': 1.000, 'col': 0, 'row': 0},\n \\ {'width': 0.500, 'height': 1.000, 'col': 0.5, 'row': 0},\n \\ {'width': 1.000, 'height': 0.500, 'col': 0, 'row': 0},\n \\ {'width': 1.000, 'height': 0.500, 'col': 0, 'row': 0.5}\n \\ ]\n\n\" Fullscreen for initial layout\n\" let g:rnvimr_layout = {\n\" \\ 'relative': 'editor',\n\" \\ 'width': &columns,\n\" \\ 'height': &lines - 2,\n\" \\ 'col': 0,\n\" \\ 'row': 0,\n\" \\ 'style': 'minimal'\n\" \\ }\n\"\n\" Only use initial preset layout\n\" let g:rnvimr_presets = [{}]\n\n```\n\nFor more information, please refer to [:help rnvimr](./doc/rnvimr.txt),\nbecause I don't want to maintain two documents with the same contents :).\n\n## FAQ\n\nQ: Couldn't open some special types of files by using `Enter` or `l` in Ranger.\n\nA: Please follow the below steps to solve this issue:\n\n1. The behavior of opening the file in Ranger depends on `rifle.conf`.\n Press `r` to make sure that the `${VISUAL:-$EDITOR} -- \"$@\"` is the best candidate in Ranger.\n2. If the case 1 is false, change the code in `rifle.conf` like that:\n\n\n\n```diff\n-!mime ^text, label editor, ext xml|json|csv|tex|py|pl|rb|js|sh|php = ${VISUAL:-$EDITOR} -- \"$@\"\n+!mime ^text, label editor, ext xml|json|csv|tex|py|pl|rb|js|sh|php|your_file_type = ${VISUAL:-$EDITOR} -- \"$@\"\n```\n\n\n\nQ: CheckHealth says RPC timeout.\n\nA: Install [Dependence](#Dependence) first,\nrun ex command`:echo $NVIM_LISTEN_ADDRESS` to\nconfirm that the message output is in a format like this `/tmp/nvimIYj484/0` or a tcp format\n`address:port`, Rnvimr needs this environment variable.\n\nQ: How can I go back to the previous directory in Ranger after attaching a new file?\n\nA: Press `H` in Ranger, mean go back to the last history directory.\n\nQ: How can I use Ranger default configuration (vanilla)?\n\nA: Write `let g:rnvimr_vanilla = 1` to your vim configuration.\n\nQ: `let g:rnvimr_enable_ex = 1` can't work as expected.\n\nA: Turn off the option of other plugins (like `let g:NERDTreeHijackNetrw = 0` which is used in\nNERDTree) or uninstall the conflicting plugins.\n\nQ: In MacOS, I must press `` twice to split window vertically.\n\nA: Please refer to [#71](https://github.com/kevinhwang91/rnvimr/issues/71) and use `rnvimr_action`\nvariable to remap `` as a workaround for the issue.\n\n## License\n\nThe project is licensed under a BSD-3-clause license. See [LICENSE](./LICENSE) file for details.\n","dotfyleShieldAddedAt":null,"stars":737,"lastSyncedAt":"2023-12-03T02:20:46.078Z","addedLastWeek":0}}}]}}]