https://github.com/SublimeText/VintageEx

An implementation of Vim's command-line mode for Sublime Text 2
https://github.com/SublimeText/VintageEx

Last synced: 2 months ago
JSON representation

An implementation of Vim's command-line mode for Sublime Text 2

• Host: GitHub
• URL: https://github.com/SublimeText/VintageEx
• Owner: SublimeText
• License: mit
• Archived: true
• Created: 2011-11-01T07:52:27.000Z (about 13 years ago)
• Default Branch: master
• Last Pushed: 2015-03-26T19:45:21.000Z (almost 10 years ago)
• Last Synced: 2024-08-01T13:29:09.307Z (5 months ago)
• Language: Python
• Homepage:
• Size: 492 KB
• Stars: 381
• Watchers: 34
• Forks: 51
• Open Issues: 23
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG.txt
  • License: LICENSE.txt

Awesome Lists containing this project

• my-awesome-github-stars - SublimeText/VintageEx - An implementation of Vim's command-line mode for Sublime Text 2 (Python)

README

        
=========

VintageEx

=========

A rendition of Vim's command-line mode for Sublime Text 2.

License

=======

This whole package is distributed under the MIT license (see LICENSE.txt).

Compatibility

=============

VintageEx aims at full cross-platform compatibility. Howerver, I cannot test

under OS X, so patches and feedback are welcome.

Installation

============

Download the `latest version`_, put it under ``Installed Packages`` and restart

Sublime Text.

.. _latest version: https://bitbucket.org/guillermooo/vintageex/downloads/VintageEx.sublime-package

.. TOOD: add link to Vintage's help file

**VintageEx doesn't replace Vintage**: To use vi key bindings, you need to

enable the `Vintage`_ package (shipped with Sublime Text and *ignored* by default).

.. _Vintage: http://www.sublimetext.com/docs/2/vintage.html

VintageEx extends the vi-like functionality provided py Vintage by adding

a command-line mode that tries to remain close to Vim's.

Also, because VintageEx uses commands in the Vintage package, this package

must be under your ``Packages`` folder with that name. This is mostly important

to keep in mind if you contribute code to Vintage and have deleted the original

package.

Overview

========

To open the command line, press ``:``.

VintageEx offers tab completion of top-level commands, so you can type a letter

and press `Tab` to cycle through available commands.

To see the implemented commands, you can look through ``ex_commands.py``.

Configuration

=============

These settings should be stored in your personal preferences (*Packages/User/Preferences.sublime-settings*).

**vintageex_linux_shell** 

The name of the shell through which commands should be executed (``bash``, ``ksh``, etc.).

If empty, the ``$SHELL`` variable will be read when a shell is needed.

**vintageex_linux_terminal**

The name of the preferred terminal emulator (``gnome-terminal``, ``xterm``, etc.). If empty,

the variables ``$COLORTERM`` and ``$TERM`` will be read in turn when a terminal is needed.

Donations

=========

If you want to show your appreciation, you can tip me through Gittip: guillermooo_.

.. _guillermooo: http://www.gittip.com/guillermooo/