mirror of
https://github.com/neovim/neovim.git
synced 2026-08-27 09:31:47 +00:00
d03b4cfb7a
Problem: There is no health check. Encrypted entries cannot be read at all, since Info-ZIP takes a password only from a terminal and `-P` would expose it in the process arguments. Solution: Add `:checkhealth nvim.zip`, reporting the backend and which implementation is handling archives. Prompt for the password on a pty, extracting to a file so the entry's bytes stay off the terminal. Report Info-ZIP's exit code rather than inferring a cause, so an archive using AES is not reported as a failed decryption.
54 lines
1.9 KiB
Plaintext
54 lines
1.9 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"; entries open as
|
|
read-only `zipfile://{archive}::{path}` buffers. Requires the `unzip`
|
|
executable.
|
|
|
|
Recognized extensions include zip, jar, apk, epub, Office and OpenDocument
|
|
formats, whl, xpi, pkpass, and cbz. Remote archives are fetched by |vim.net|.
|
|
|
|
Reading an entry from an encrypted archive prompts for its password.
|
|
|
|
*g:loaded_nvim_zip_plugin*
|
|
To disable the built-in zip browser, set this before startup: >lua
|
|
|
|
vim.g.loaded_nvim_zip_plugin = 1
|
|
<
|
|
MAPPINGS *zip-mappings*
|
|
|
|
The standard |dir-buffer-mappings|, plus:
|
|
|
|
• x extracts the entry under the cursor into the current directory, discarding
|
|
its path inside the archive. It never overwrites an existing file.
|
|
|
|
At the archive root, - opens the containing filesystem directory.
|
|
|
|
LIMITATIONS *zip-limitations*
|
|
|
|
Archive entries cannot be updated. 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.
|
|
|
|
Only the original zip encryption is supported, not AES.
|
|
|
|
==============================================================================
|
|
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
|