Abrindo a ajuda do Vim em uma janela dividida vertical

Existe uma maneira de obter ajuda do Vim para abrir em um painel dividido vertical em vez de um horizontal?

:vertical( vert) funciona:

:vert help

Você também pode controlar se a janela se divide à esquerda / superior ou à direita / inferior com topleft( to) e botright( bo) . Por exemplo, para abrir a ajuda na janela direita de uma divisão vertical:

:vert bo help

Como alternativa às respostas de Haroogan e Sean, você pode usar o FileTypeevento para o comando automático da seguinte maneira:

autocmd FileType help wincmd L

Embora isso mude a posição de qualquer janela de ajuda, bem como mova a janela depois de colocá-la manualmente se o arquivo que você está vendo mudar. Mas acredito que esse seja um problema de qualquer solução.

Não há necessidade de remapear nenhum comando ou introduzir apelidos estranhos como :Help. Aqui está a solução. Crie ~/.vim/after/ftplugin/help.vimonde você pode substituir quaisquer configurações do Vim especialmente para helpe adicionar a seguinte linha lá:

autocmd BufWinEnter <buffer> wincmd L

Este gancho irá garantir que qualquer helparquivo seja aberto na divisão vertical. Além disso, não tem um efeito colateral descrito na resposta de Sean. Pessoalmente, esta é a solução perfeita para mim até agora.

Espero que isto ajude. Boa sorte.

Este comando deve fazer isso:

:vert help

Coloque isso em seu .vimrc:

command -nargs=* -complete=help Help vertical belowright help <args>

Agora você pode abrir uma ajuda vertical com o :Helpcomando (observe que a primeira letra está em maiúscula)

Para fazer com que os arquivos de ajuda sempre abram em uma divisão vertical à direita, coloque isso em seu vimrc:

augroup helpfiles
  au!
  au BufRead,BufEnter */doc/* wincmd L
augroup END

Isso terá o efeito colateral de ter qualquer coisa com "doc" em seu caminho aberto em uma divisão vertical, mas isso pode não ser um problema para você. Não é para mim. Se você preferir que ele abra em uma divisão vertical à esquerda, ou qualquer outra coisa, você pode mudar wincmd L. Você pode aprender mais sobre isso com:he wincmd

Coloque o seguinte em seu ~/.vim/ftplugin/help.vim

wincmd L

Não pode ser mais simples do que isso :)

Isso move a janela de ajuda uma vez . Portanto, você pode movê-lo livremente após a criação da janela.

if has('autocmd')
  function! ILikeHelpToTheRight()
    if !exists('w:help_is_moved') || w:help_is_moved != "right"
      wincmd L
      let w:help_is_moved = "right"
    endif
  endfunction

  augroup HelpPages
    autocmd FileType help nested call ILikeHelpToTheRight()
  augroup END
endif

A função ILikeHelpToTheRight()só será executada wincmd Luma vez por janela (é o quew: serve prefixo).

Ele é então chamado sempre que um arquivo de "ajuda" é aberto. Isso não tem os efeitos colaterais da solução da EdJoJob.

Abra dinamicamente as janelas de ajuda na parte superior se houver mais de uma janela na guia atual, ou à direita, se houver apenas uma janela:

if winnr('$') > 2
    wincmd K
else
    wincmd L
endif

Você precisará colocá-lo ftplugin/help.vimou usá-lo com um autocmd, por exemplo:

augroup my_filetype_settings
autocmd!
autocmd FileType help if winnr('$') > 2 | wincmd K | else | wincmd L | endif
augroup END

Isso foi feito para aumentar a resposta de @ m42, mas ainda não tenho 50 representantes aqui no SO adequados para adicionar aos comentários.

Adicionar nnoremap <C-H> :vert bo helpa .vimrc

Agora, pressionar Ctrl-H no modo Normal irá pular para o modo Command, prefixado para abrir a ajuda em uma janela dividida verticalmente à direita. Incluir um espaço à direita apóshelp· <- no final da linha de configuração para melhores resultados.

Este mapeamento permite que você ainda use :help\ :hpara abrir uma janela dividida horizontalmente ou percorrer seu histórico de comandos de ajuda anterior sem a expansão automática do prompt.