Differences
This shows you the differences between the selected revisions of the page.
| 2010-03-23 | 2010-03-28 | ||
| no summary (kdpickett) | unreasonable detailed desc on configuring gvim as external editor, also bringing back info on the other editors (martin) | ||
| Line 15: | Line 15: | ||
| For basic editing WinSCP offers a simple [[ui_editor|integrated text editor]]. For advanced editing you will probably want to [[ui_pref_editor|configure your favourite editor]]. | For basic editing WinSCP offers a simple [[ui_editor|integrated text editor]]. For advanced editing you will probably want to [[ui_pref_editor|configure your favourite editor]]. | ||
| - | ==== [[mdi]] Problems with Some External Editors ==== | + | ==== Opening More Files in a Single Editor Instance ==== |
| Some external editors can open multiple files in one process. Usually such editors have some kind of tabbed interface, but it is also the case of new versions of Microsoft Word (2000 and later). | Some external editors can open multiple files in one process. Usually such editors have some kind of tabbed interface, but it is also the case of new versions of Microsoft Word (2000 and later). | ||
| Line 22: | Line 22: | ||
| To allow using this kind of editor, WinSCP does not treat the file as closed when the editor launched to open it is closed. | To allow using this kind of editor, WinSCP does not treat the file as closed when the editor launched to open it is closed. | ||
| - | If you choose to edit the same file again during the same session, WinSCP will download it to the same temporary directory as before, allowing the external editor to reload the file content in case it still ·has it opened (assuming the editor can detect the change). | + | If you choose to edit the same file again during the same session, WinSCP will download it to the same temporary directory as before, allowing the external editor to reload the file content in case it still has it opened (assuming the editor can detect the change). |
| One drawback of this approach is that all of the files ever edited by the current instance of WinSCP are kept in a [[temp_folder|temporary directory]] (until WinSCP is closed). WinSCP watches for changes to them all. | One drawback of this approach is that all of the files ever edited by the current instance of WinSCP are kept in a [[temp_folder|temporary directory]] (until WinSCP is closed). WinSCP watches for changes to them all. | ||
| - | If you want to avoid that, you need to make sure that your editor opens each file in a separate window (process). Some editors do that by default while some offer a configuration option for that. If either is the case, then configure your editor as an external editor for WinSCP and enable preference option //[[ui_editor_preferences#external|External editor opens each file in separate window (process)]]//. WinSCP will then treat the file as closed when the editor launched to open it is closed. | + | If you want to avoid that, you need to make sure that your editor opens each file in a separate window (process). Some editors do that by default while some offer a configuration option for that (see below). If either is the case, then configure your editor as an external editor for WinSCP and enable preference option //[[ui_editor_preferences#external|External editor opens each file in separate window (process)]]//. WinSCP will then treat the file as closed when the editor launched to open it is closed. Note that this setting only affects the "edit" operation. So you may want to make sure that editing is the [[ui_pref_panels#double-click|default operation for double-click]]. |
| - | * Note that this setting only affects the "edit" operation. So you may want to make sure that editing is the [[ui_pref_panels#double-click|default operation for double-click]]. | + | |
| - | * For configuring Vim, you would not choose to option preference above for opening each file in a separate process. See [[task_edit#configuring_vim_as_an_external_editor|Configuring Vim as an External Editor]] for more information. | + | |
| - | + | ||
| - | ===== Configuring Vim as an External Editor ===== | + | |
| - | + | ||
| - | Vim can be easily configured for use with WinSCP. To configure Vim as an external editor in WinSCP, do the following: | + | |
| - | - From the menu of WinSCP, select //Options > Preferences// | + | |
| - | - Select //Editors// from the left pane of the //Preferences// window. | + | |
| - | - From //Editor Preference//, select //Add ...// | + | |
| - | - From the //Add Editor// window, click on the //External editor// radio button. | + | |
| - | - Click the //Browse// button and navigate to the path where Vim is installed. For example, the default installation for a Windows installation of Vim is ''"C:\Program Files\Vim\vim72\'' (Assuming Vim 7.2 is your version). You could also apply these steps to the portable version of Vim as well. | + | |
| - | - Select //gvim.exe// as the editor. **(Note: This selects the GUI version of Vim.)** | + | |
| - | You will notice the the box will return something that looks similar to the following:\\ **''"C:\Program Files\Vim\vim72\gvim.exe"'' !.!**\\ | + | |
| - | Make sure to leave the **!.!** as it is at the end of the string.\\ | + | |
| - | For simple use of Vim, choosing any of the //External editor options// below the //Editor// selection are optional depending on your needs. However, as you will see in the next section, this is not the case for using Vim with multiple tabs. To complete the external editor selection, click the OK button at each dialog to finish the setup. | + | |
| - | Whenever you right-click on a file and select **Edit**, the file will be loaded into Vim for editing. | + | |
| - | + | ||
| - | ==== Configuring WinSCP for Vim Multi-Tab Use ==== | + | |
| - | + | ||
| - | Vim supports multiple tabs as of version 7. Invoking a multiple tab session requires an additional command line argument to be passed to Vim. Step 6 above documents what is returned when the Vim editor executable (//gvim.exe//) is selected. The string **''"C:\Program Files\Vim\vim72\gvim.exe"'' !.!** | + | |
| - | is indicated in the box for //External editor//. In order to enable multiple tab support, you must pass the //--remote-tab-silent// argument to the command line just before **!.!**. To make this change, place your cursor in the drop-down box after the ''"'' and before the **!.!**.\\ | + | |
| - | Just type in //--remote-tab-silent//. Make sure there is a space between that and **!.!**.\\ | + | |
| - | + | ||
| - | The full command line string should look accordingly:\\ | + | |
| - | ''"C:\Program Files\Vim\vim72\gvim.exe" --remote-tab-silent'' !.! | + | |
| - | \\ | + | |
| - | In the section below titled //External editor options (affects editing remote files only)//, make sure the box titled //External Editor opens each file in separate window (process)// is **Un-Checked**. You want each file to open in Vim in the same process since the tabs are derived in the same Vim session. | + | |
| - | + | ||
| - | To edit files in Vim using multiple tabs, select either one or multiple files in the WinSCP file Explorer using your mouse and keyboard. Right click on one of the highlighted files and select **Edit**. Vim will load the selected files in separate tabs in one Vim edit session. Any time you want to edit an additional file in the same session, just right-click on it and select **Edit**. The file will be loaded into a new tab in the original Vim session.\\ | + | |
| + | Following list shows how you can select between opening files in a separate or the same window for some favourite editors: | ||
| + | * UltraEdit: //Advanced > Configuration > General > General Application Items > Allow multiple instances//; | ||
| + | * PSPad: //Settings > Program Settings > System Integration > Only One Program Instance//; | ||
| + | * Crimson Editor: //Tools > Preferences > General > Allow Multiple Instances//; | ||
| + | * TextPad: //Configure > Preferences > Allow Multiple Instances to Run//; | ||
| + | * Notepad++: Use command-line switch ''[[http://notepad-plus.sourceforge.net/uk/cmdLine-HOWTO.php|-multiInst]]''; | ||
| + | * gVim: Use command-line switch ''--remote-tab-silent''. | ||
| ===== [[binary]] Editing Binary Files ===== | ===== [[binary]] Editing Binary Files ===== | ||