https://github.com/gawel/oh-my-vim

A python package to manage your vim themes/plugins
https://github.com/gawel/oh-my-vim

Last synced: 4 days ago
JSON representation

A python package to manage your vim themes/plugins

• Host: GitHub
• URL: https://github.com/gawel/oh-my-vim
• Owner: gawel
• License: mit
• Created: 2011-12-10T15:55:44.000Z (about 13 years ago)
• Default Branch: master
• Last Pushed: 2017-10-21T16:51:23.000Z (about 7 years ago)
• Last Synced: 2024-05-11T05:41:30.537Z (8 months ago)
• Language: Python
• Homepage:
• Size: 141 KB
• Stars: 151
• Watchers: 10
• Forks: 15
• Open Issues: 2
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
Oh My Vim!

===========

This package allow you to manage your vim plugins

It's heavily inspired from `oh-my-zsh

`_

Installation

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

You must have `python3.X `_ installed on your system.

It's recommended to install **oh-my-vim** as a non root user.

If you don't know python and virtualenv then just run the install script::

    $ curl https://raw.github.com/gawel/oh-my-vim/master/tools/install.sh | sh -

Or with wget::

    $ wget --no-check-certificate -O- https://raw.github.com/gawel/oh-my-vim/master/tools/install.sh | sh -

If you know virtualenv/pip then run this in a virtualenv::

    $ pip install oh-my-vim

    $ bin/oh-my-vim upgrade

Have a look at your ``~/.vimrc``::

    $ vim ~/.vimrc

And select your favorites profiles.

Commands

========

Browse all VimL projects available on github in your favorite browser::

    $ oh-my-vim search [-t] [term]

Installation. You can use a git url or a ``requires.txt`` file/url wich

contains git urls::

    $ oh-my-vim install [--full] [giturl|requires.txt]

The ``--full`` options allow to install some extra dependencies. For example

`syntastic `_ require `flake8

`_ and `jslint

`_. **oh-my-vim** will try to install them

for you.

Remove a bundle::

    $ oh-my-vim remove [bundle1|bundle2|...]

List installed packages::

    $ oh-my-vim list

List all packages listed in Oh My Vim's registry::

    $ oh-my-vim list -a

Generate a ``requires.txt`` file::

    $ oh-my-vim list -u > requires.txt

Upgrade bundles (and **oh-my-vim** python package)::

    $ oh-my-vim upgrade [--full] [bundle1|bundle2|...]

Useful links

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

- `Vim revisited `_

- `Vim for programmers `_

FAQ

===

**I'm a newbie. Can oh-my-vim turn me into a Vim guru ?**

No, but it can help you to setup a friendly environment.

After the installation step install some `useful

`_

plugins with the following::

    $ oh-my-vim install -d useful

Then have a look at the `defaults

`_ and

`map `_

profiles and enable them in your ``.vimrc``

You're now ready to go...!

**What if I already use pathogen ?**

Nothing. Just remove the ``pathogen`` stuff from your ``vimrc``

**Can I use oh-my-vim from Vim ?**

Yes, and you should. You'll get some completion. Just use ``:OhMyVim ``

**Can I install a bundle from a mercurial repository ?**

Yes. You just need to prefix your url with ``hg+``::

  $ oh-my-vim install hg+https://bitbucket.org/sjl/gundo.vim

**Good project but I'm missing a feature. Can you add it ?**

No. But you can. Fork the repository and submit a pull request.

**I have a cool plugin and I want to add it to oh-my-vim-registry**

Submit a pull request after adding it to the `registry

`_

**Does oh-my-vim work on windows ?**

No, it wont be so hard to port but I'm not supporting this OS

**This is a great project. Can I offer you a beer ?**

Sure.