图像预览插件 for Neovim：image_preview.nvim

图像预览插件 for Neovim：image_preview.nvim

image_preview.nvimImage Preview for Neovim 🖼项目地址:https://gitcode.com/gh_mirrors/im/image_preview.nvim

项目介绍

image_preview.nvim 是一个专为 Neovim 设计的图像预览插件，它目前支持在终端模拟器如 WezTerm 和 Kitty 中预览图像文件。该插件旨在提供一种简单的方式，在浏览文件树（如通过 nvim-tree 或 neo-tree）时，能够便捷地查看图像文件而无需离开编辑器。支持的图像格式包括 BMP, PNG, 和 JPG，未来计划扩大兼容性至更多终端和插件。

项目快速启动

安装

首先，确保你的 Neovim 已配置好 Plug 插件管理器。然后，在你的 .vimrc 或者 init.vim 文件中添加以下行来安装 image_preview.nvim：

call plug#begin('~/.config/nvim/plugs')
Plug 'adelarsq/image_preview.nvim', { 'event': 'VeryLazy' }
call plug#end()

" 配置插件，懒加载
autocmd FileType bufexplorer NeoTreeFile buffer
augroup END
lua <<EOF
require("image_preview").setup({})
EOF

保存并关闭文件后，运行 :PlugInstall 来安装插件。

使用

安装完成后，将光标移动到你想预览的图像文件上，并按下 <leader>p 键（默认映射），即可在一个新分屏中打开图像预览。按 <Enter> 键可关闭预览。

对于 neo-tree 用户，需要额外的配置以激活命令：

require("neo-tree").setup({
  filesystem = {
    window = {
      mappings = { ["<leader>p"] = "image_preview" },
    },
    commands = {
      image_preview = function(state)
        local node = state.tree:get_node()
        if node.type == "file" then
          require("image_preview").PreviewImage(node.path)
        end
      end,
    },
  },
})

应用案例和最佳实践

• 结合 NeoTree 或 Nvim-Tree: 在使用文件树插件浏览目录时，可以即时预览选中的图片，无需切换窗口或退出编辑器。
• WezTerm 和 Kitty 用户: 特别适合这些终端用户，可以无缝预览图像，提升日常开发或查阅效率。
• 自定义快捷键: 根据个人习惯调整触发预览的快捷键，例如使用 <leader>i> 或其他你喜欢的组合。

典型生态项目集成

• NeoTree: 作为文件浏览器与 image_preview.nvim 结合，实现图像文件的即点即看。
• Nvim-Treesitter: 虽然不直接集成，但可以增强 Neovim 的语法解析能力，使得在项目结构中寻找图像资源更加高效。
• Telescope: 利用 Telescope 查找文件的同时，也可以结合此插件进行快速预览。

使用 image_preview.nvim，你可以大大提升在 Neovim 环境下处理图像文件的便利性和效率。随着社区的支持和开发，它的兼容性和功能将会得到持续扩展，为你的编程工作流增添便利。

image_preview.nvimImage Preview for Neovim 🖼项目地址:https://gitcode.com/gh_mirrors/im/image_preview.nvim