Zip アーカイブエクスプローラー

*pi_zip.txt*    For Vim バージョン 8.1.  Last change: 2016 Sep 13

                                +====================+
                                | Zip File Interface |
                                +====================+

Author:  Charles E. Campbell  <NdrOchip@ScampbellPfamily.AbizM>
          (remove NOSPAM from Campbell's email first)

Copyright: Copyright (C) 2005-2015 Charles E Campbell
        The VIM LICENSE (see |copyright|) applies to the files in this
        package, including zipPlugin.vim, zip.vim, and pi_zip.vim.  except use
        "zip.vim" instead of "VIM".  Like anything else that's free, zip.vim
        and its associated files are provided *as is* and comes with no
        warranty of any kind, either expressed or implied.  No guarantees of
        merchantability.  No guarantees of suitability for any purpose.  By
        using this plugin, you agree that in no event will the copyright
        holder be liable for any damages resulting from the use of this
        software. Use at your own risk!

1. 目次

2. 使ひ方

*.zip ファイルを開くとファイルの一覽が表示されます。一覽の中のファイルを開きたい場合はファイル名の上にカーソルを移動して <return> キーを押してください。開いたファイルを編輯して保存することもできます。zip アーカイブに新しいファイルを追加することはまだできません。

x : カーソル上にある一覽のファイルが解凍されます

オプション

g:zip_nomax

この變數が存在し、その値が眞なら、ファイルを開いたときにウィンドウを最大化しません。

コマンドの實行に使用されるシェルはシステムによつて異なります。Zip は適切な方法でスペースなどの文字をクォートしようとしますが、それがうまく機能しない場合はこの變數を設定してください。

g:zip_shq

初期設定は、Unix ではシングルクォート (’)、Windows ではダブルクォート (") です。クォート自體をしたくない場合は <.vimrc> の中で g:zip_shq に空文字を設定してください (let g:zip_shq = "")。

"unzip" として使用するプログラムを指定します。これはブラウジングに使用されます。初期設定:

let g:zip_unzipcmd= "unzip"

"zip" として使用するプログラムを指定します。これは zip ファイルを保存する (更新する) ときに使用されます。初期設定:

let g:zip_zipcmd= "zip"

このオプションは zip アーカイブからファイルを解凍する爲のプログラム (とそれに必要なオプション) を指定します。初期設定:

let g:zip_extractcmd= g:zip_unzipcmd

ロードの無效化

もしなんらかの理由で vim で zip ファイルを開きたくない場合は、次の 2 つの變數を <.vimrc> で設定すると、zip プラグインのロードを無效化できます:

let g:loaded_zipPlugin= 1
let g:loaded_zip      = 1

3. zip 以外の擴張子

zip ファイルを zip 以外の擴張子 (.jar や .xpi など) で生成するアーカイバがあります。そのやうなファイルを扱ひたい場合は、<.vimrc> ファイルに次のやうな行を追加してください:

au BufReadCmd *.jar,*.xpi call zip#Browse(expand("<amatch>"))

この行に擴張子を追加していけば對應する擴張子を增やすことができます。

代はりに .vimrc で |g:zipPlugin_ext| を使つて變更する方法もあります。現時點 (11/30/15) 以下が含まれる:

let g:zipPlugin_ext= '*.zip,*.jar,*.xpi,*.ja,*.war,*.ear,*.celzip,
\ *.oxt,*.kmz,*.wsz,*.xap,*.docx,*.docm,*.dotx,*.dotm,*.potx,*.potm,
\ *.ppsx,*.ppsm,*.pptx,*.pptm,*.ppam,*.sldx,*.thmx,*.xlam,*.xlsx,*.xlsm,
\ *.xlsb,*.xltx,*.xltm,*.xlam,*.crtx,*.vdw,*.glox,*.gcsx,*.gqsx,*.epub'

4. 開發履歷

v28 Oct 08, 2014 * changed the sanity checks for executables to reflect
                   the command actually to be attempted in zip#Read()
                   and zip#Write()
                 * added the extraction of a file capability
    Nov 30, 2015 * added *.epub to the |g:zipPlugin_ext| list
    Sep 13, 2016 * added *.apk to the |g:zipPlugin_ext| list and
                   sorted the suffices.
v27 Jul 02, 2013 * sanity check: zipfile must have "PK" as its first
                   two bytes.
                 * modified to allow zipfile: entries in quickfix lists
v26 Nov 15, 2012 * (Jason Spiro) provided a lot of new extensions that
                   are synonyms for .zip
v25 Jun 27, 2011 * using keepj with unzip -Z
                   (consistent with the -p variant)
                 * (Ben Staniford) now uses
                     has("win32unix") && executable("cygpath")
                   before converting to cygwin-style paths
v24 Jun 21, 2010 * (Cédric Bosdonnat) unzip seems to need its filenames
                   fnameescape'd as well as shellquote'd
                 * (Motoya Kurotsu) inserted keepj before 0d to protect
                   jump list
v17 May 09, 2008 * arno caught a security bug
v15 Sep 07, 2007 * &shq now used if not the empty string for g:zip_shq
v14 May 07, 2007 * using b:zipfile instead of w:zipfile to avoid problem
                   when editing alternate file to bring up a zipfile
v10 May 02, 2006 * now using "redraw then echo" to show messages, instead
                   of "echo and prompt user"
                 * g:zip_shq provided to allow for quoting control for the
                   command being passed via :r! ... commands.
v8 Apr 10, 2006 * Bram Moolenaar reported that he received an error message
                  due to "Pattern not found: ^.*\%0c"; this was caused by
                  stridx finding a Name... at the beginning of the line;
                  zip.vim tried 4,$s/^.*\%0c//, but that doesn't work.
                  Fixed.
v7 Mar 22, 2006 * escaped some characters that can cause filename handling
                  problems.
v6 Dec 21, 2005 * writing to files not in directories caused problems -
                  fixed (pointed out by Christian Robinson)
v5 Nov 22, 2005 * report option workaround installed
v3 Oct 18, 2005 * <amatch> used instead of <afile> in autocmds
v2 Sep 16, 2005 * silenced some commands (avoiding hit-enter prompt)
                * began testing under Windows; works thus far
                * filetype detection fixed
   Nov 03, 2005 * handles writing zipfiles across a network using
                  netrw#NetWrite()
v1 Sep 15, 2005 * Initial release, had browsing, reading, and writing