https://github.com/szw/vim-maximizer

Maximizes and restores the current window in Vim.
https://github.com/szw/vim-maximizer

Last synced: 3 months ago
JSON representation

Maximizes and restores the current window in Vim.

• Host: GitHub
• URL: https://github.com/szw/vim-maximizer
• Owner: szw
• Created: 2012-11-21T21:25:50.000Z (about 12 years ago)
• Default Branch: master
• Last Pushed: 2022-03-10T13:04:03.000Z (almost 3 years ago)
• Last Synced: 2024-08-01T16:56:10.287Z (6 months ago)
• Language: VimL
• Homepage: http://www.vim.org/scripts/script.php?script_id=4376
• Size: 163 KB
• Stars: 472
• Watchers: 8
• Forks: 18
• Open Issues: 7
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• my-awesome - szw/vim-maximizer - 03 star:0.5k fork:0.0k Maximizes and restores the current window in Vim. (VimL)

README

        
vim-maximizer

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

Maximizes and restores the current window in Vim.

Installation

------------

Place in *~/.vim/plugin/maximizer.vim* or in case of Pathogen:

    cd ~/.vim/bundle

    git clone https://github.com/szw/vim-maximizer.git

Please, don't forget to star the repository if you like (and use) the plugin. This will let me know

how many users it has and then how to proceed with further development :).

About

-----

Maximizer lets you maximize split windows and restore them automatically. It is very useful if you

like to have many split windows per tab. And also, if the text you are working with does not

[_...subscribe to the ridiculous Church of 80-character

Lines..._](http://37signals.com/svn/posts/3250-clarity-over-brevity-in-variable-and-method-names).

It means, while working with Ruby on Rails code. ;) Or just with lengthy HTML files.

Usage

-----

Maximizer has only one command:

    :MaximizerToggle

Also the plugin can define some default mappings if the user wants to.  By default it maps to ``

in normal, insert, and visual modes.  See [Configuration](#configuration) to get some examples.

When the current window is not in maximized state, Vim-Maximizer saves dimensions and positions of

all windows in the current tab, and then it performs maximization of the active window. The second

time the command is invoked, Maximizer restores all windows to the previously saved positions.

The toggle command can be invoked with a bang (!):

    :MaximizerToggle!

The bang version forces the restoration of previously saved state (if any). It can be used in case

you did some changes in the maximized state layout and the current window is not maximized anymore.

Despite that, the bang version force restoration anyway. Notice, the bang version can be set as the

default one in your mappings.



Configuration

-------------


Maximizer is extremely handy with command mappings. By default it uses `` like here:

    nnoremap  :MaximizerToggle

    vnoremap  :MaximizerTogglegv

    inoremap  :MaximizerToggle

With these mappings you can hit `` any time, not only in normal mode. Other handy situations may

include typing some text while you don't fit the current split window or selecting some long lines

in the visual mode. Just try it yourself.

Maximizer respects minimal allowed window size, both vertically and horizontally. By default the

minimal window height and width are set to 1.  You can change those values by tweaking

`'winminheight'` (`'wmh'`) and `'winminwidth'` (`'wmw'`) settings in your .vimrc.

Here are some plugin options:

* `maximizer_set_default_mapping`

    Whether Maximizer should set default mappings or not:

        let g:maximizer_set_default_mapping = 1

* `maximizer_set_mapping_with_bang`

    Whether Maximizer should set default mappings with banged version or not:

        let g:maximizer_set_mapping_with_bang = 0

* `maximizer_default_mapping_key`

    The default mappings key:

        let g:maximizer_default_mapping_key = ''

Author and License

------------------

Maximizer was written by Szymon Wrozynski and

[Contributors](https://github.com/szw/vim-maximizer/commits/master). It is licensed under the same

terms as Vim itself.

Copyright © 2012-2013 Szymon Wrozynski. See `:help license`