mirror of
https://github.com/neovim/neovim.git
synced 2026-08-01 13:19:20 +00:00
e29af9c32f
Problem: The bundled `zip` plugin is implemented in Vimscript, making it harder to maintain and build on with Nvim's Lua runtime infrastructure. Solution: Add an opt-out `zip.lua` browser backed by `nvim.dir`, and disable the legacy Vimscript implementation by moving it to `pack/dist/opt/zip/`. Load it with `:packadd zip`.
56 lines
2.0 KiB
Plaintext
56 lines
2.0 KiB
Plaintext
*zip.txt* Nvim
|
|
|
|
|
|
NVIM REFERENCE MANUAL
|
|
|
|
|
|
Builtin plugin: zip *zip*
|
|
|
|
Nvim opens a read-only listing when |:edit| is used with a zip archive. The
|
|
listing is a |dir| buffer with 'filetype' set to "zip". It requires the
|
|
`unzip` executable. The module implementing it is private and is not
|
|
a supported Lua API.
|
|
|
|
*g:loaded_nvim_zip_plugin*
|
|
To disable the built-in zip browser, set this before startup: >lua
|
|
|
|
vim.g.loaded_nvim_zip_plugin = 1
|
|
<
|
|
ARCHIVE LISTINGS *zip-listing*
|
|
|
|
Editing a zip-like file opens a read-only listing. Directory entries can be
|
|
opened to browse that level of the archive. File entries open as read-only
|
|
`zipfile://{archive}::{path}` buffers.
|
|
|
|
Mappings are the standard |dir-buffer-mappings|. At the archive root, - opens
|
|
the containing filesystem directory.
|
|
|
|
Recognized extensions include zip, jar, apk, epub, Office and OpenDocument
|
|
formats, whl, xpi, pkpass, and cbz.
|
|
|
|
INTEGRATIONS *zip-integrations*
|
|
|
|
Remote zip URLs are downloaded by |vim.net| and opened in the browser.
|
|
|
|
|g:ftplugin_java_source_path| opens the selected entry with |gf|.
|
|
|
|
LIMITATIONS *zip-limitations*
|
|
|
|
Archive entries cannot be updated or extracted. Remote archives are not
|
|
refetched on reload, and there is no PowerShell fallback, no custom backend
|
|
command, and no support for the legacy `g:zip_*` variables. Use |old-zip|
|
|
when those features are required.
|
|
|
|
==============================================================================
|
|
Legacy plugin: zip *old-zip*
|
|
|
|
The legacy Vimscript zip plugin browses, updates, and extracts archive
|
|
entries. It is not loaded by default; use `:packadd` to activate it: >lua
|
|
|
|
vim.cmd.packadd('old-zip')
|
|
<
|
|
This can be done at any time. Its manual is then available as
|
|
`:help pi_zip.txt`.
|
|
|
|
vim:tw=78:ts=8:noet:ft=help
|