Configuration

Just copy your favorite .vimrc to the Data\settings directory and rename it to vimrc.

By default, the program expects one of these directory structures:

-\ <--- Directory with GVimPortable.exe
  +\App\
    +\vim\
      +\vim71\
  +\Data\
    +\settings\

or

-\ <--- Directory with GVimPortable.exe
  +\GVimPortable\
    +\App\
      +\vim\
        +\vim71\
    +\Data\
      +\settings\

or

-\ <--- Directory with GVimPortable.exe
  +\PortableApps\
    +\GVimPortable\
      +\App\
        +\vim\
          +\vim71\
      +\Data\
        +\settings\

or

-\ <--- Directory with GVimPortable.exe (PortableApps, for instance)
  +\Apps\
    +\GVimPortable\
      +\vim\
        +\vim71\
  +\Data\
    +\GVimPortable\
      +\settings\

It can be used in other directory configurations by including the GVimPortable.ini file in the same directory as GVimPortable.exe and configuring it as details in the INI file section below. The INI file may also be placed in a subdirectory of the directory containing GVimPortable.exe called GVimPortable or 2 directories deep in PortableApps\GVimPortable or Data\GVimPortable. All paths in the INI should remain relative to the EXE and not the INI.

The GVim Portable Launcher will look for an ini file called GVimPortable.ini within its directory. If you are happy with the default options, it is not necessary, though. The INI file is formatted as follows:

[GVimPortable]
GVimDirectory=App\vim\vim71
SettingsDirectory=Data\settings
SettingsFile=vimrc
GVimExecutable=gvim.exe
AdditionalParameters=
DisableSplashScreen=false

# The above options are explained in the included readme.txt
# This INI file is an example only and is not used unless it is placed as
# described in the included readme.txt

The GVimDirectory and SettingsFile entries should be set to the relative path to the directories containing gvim.exe, etc. from the current directory. All must be a subdirectory (or multiple subdirectories) of the directory containing GVimPortable.exe. The default entries for these are described in the installation section above.

The AdditionalParameters entry allows you to pass additional commandline parameter entries to gvim.exe. Whatever you enter here will be appended to the call to gvim.exe.

The GVimExecutable entry allows you to set the Portable GVim Launcher to use an alternate EXE call to launch GVim. This is helpful if you are using a machine that is set to deny gvim.exe from running. You'll need to rename the gvim.exe file and then enter the name you gave it on the gvimexecutable= line of the INI.

The DisableSplashScreen entry allows you to run the GVim Portable Launcher without the splash screen showing up. The default is false.