FilePathConvert : Convert filespec between absolute, relative, and URL formats.
| script karma |
Rating 0/0,
Downloaded by 1603 |
Comments, bugs, improvements
|
Vim wiki
|
| created by |
| Ingo Karkat |
| |
| script type |
| utility |
| |
| description |
DESCRIPTION
This plugin converts a file path and name that is inserted into the buffer
between absolute and relative paths. This is especially useful after pasting
in or completing (i_CTRL-X_CTRL-F) filespecs.
RELATED WORKS
- html_FileCompletion.vim (vimscript #4070) is insert mode completion of
URL-escaped file links relative to a document root and base URL.
USAGE
<Leader>sf Convert the file whose name is under or after the
cursor to a more local one:
URL -> [ UNC -> ] absolute -> relative (-> absolute)
{Visual}<Leader>sf Convert the selected file name.
<Leader>sF Convert the file whose name is under or after the
cursor to a more global one:
relative -> absolute -> [ UNC -> ] URL (-> UNC / abs)
{Visual}<Leader>sF Convert the selected file name.
A relative file path (../foo) is converted to an
absolute one (/home/user/dir/foo).
An absolute file path (/home/user/dir/foo) is
converted to a relative one (../foo).
On Windows, an absolute filespec starts with a drive
letter (C:\foo).
A URL starts with a protocol like file://; the actual
protocol is ignored here. Or it is a Windows file
share in UNC notation (\\host\share\foo).
Unless a mapping of URL prefix to mount point exists
(see g:FilePathConvert_UrlMappings), this can only
be mapped to a generic share in UNC notation.
EXAMPLE
Here's a simple illustration:
:cd C:\Windows\Temp
:edit test.txt
The text
C:\Windows\System32\drivers\etc\hosts
is turned into:
..\System32\drivers\etc\hosts
and
Cookies\index.dat
is turned into:
C:\Windows\Temp\Cookies\index.dat |
| |
| install details |
INSTALLATION
This script is packaged as a vimball. If you have the "gunzip" decompressor
in your PATH, simply edit the *.vmb.gz package in Vim; otherwise, decompress
the archive first, e.g. using WinZip. Inside Vim, install by sourcing the
vimball or via the :UseVimball command.
vim FilePathConvert*.vmb.gz
:so %
To uninstall, use the :RmVimball command.
DEPENDENCIES
- Requires Vim 7.0 or higher.
- Requires the ingo-library.vim plugin (vimscript #4433), version 1.019 or
higher.
- Requires the TextTransform plugin (vimscript #4005), version 1.22 or higher.
CONFIGURATION
For a permanent configuration, put the following commands into your vimrc:
To be able to convert custom URLs, non-file:// protocols, and UNC paths to a
local file system path, you need to specify the mapping of the base URL to
mount point(s; you can configure a list of filespecs to cater for symbolic
links etc.):
let g:FilePathConvert_UrlMappings = {
\ '//win/share': 'D:/data',
\ 'file://///lin/www/htdocs': '/var/srv/htdocs',
\ 'http://lin/': '/var/srv/htdocs',
\ 'file://///srv/user': ['/var/srv/user', '/home/user']
\}
As the filespecs are system-specific, you probably want to define them for the
current host; the hostname() function can help to write a conditional in
case you're using a .vimrc shared across multiple systems.
You can override the global mapping with a buffer-local one, too.
If you just want to add a single mapping for the current buffer, you can do
that by defining both b:baseurl and b:basedir variables.
If you want to use different mappings, map your keys to the
<Plug>TextTFilePathConvert#... mapping targets _before_ sourcing the script
(e.g. in your vimrc):
nmap <Leader>sf <Plug>TextTFilePathConvert#FilePathConvertLine
xmap <Leader>sf <Plug>TextTFilePathConvert#FilePathConvertVisual |
| |
script versions (upload new version)
Click on the package to download.
ip used for rating: 142.132.191.50
|
