vim www

vim-www

Caixa de ferramentas para abrir e pesquisar URLs de vim

Instalação

Assim como qualquer outro plug -in do VIM. Use patógeno, neobundle ou vundle, ou apenas descompacte -o dentro do seu diretório $HOME/.vim .

Uso

O VIM-WWW permite o lançamento de um navegador da Web do VIM para abrir URLs arbitrários, favoritos definidos e resultados do mecanismo de pesquisa.

O navegador da web a ser usado é detectado automaticamente, mas pode ser definido manualmente através de g:www_launch_browser_command , opcionalmente usando {{URL}}} como espaço reservado para o URL real. Por exemplo:

 let g:www_launch_browser_command = "iceweasel {{URL}} &"

Da mesma forma, um navegador CLI alternativo pode ser definido através de g:www_launch_cli_browser_command . Para funcionar, o complemento Vim-Dispatch deve ser instalado. Seu objetivo é abrir uma Web, por exemplo, em um painel TMUX, ou em um terminal virtual se Neovim e Vim-Dispatch-Neovim estiverem sendo usados.

Favoritos e URLs arbitrários

:Wopen abre qualquer URL. Por exemplo:

 :Wopen http://vim.org

Mas digitar e lembrar URLs completos é irritante, para que os favoritos personalizados possam ser definidos no dicionário g:www_urls .

Então, tendo no vimrc ,

 let g:www_urls = {
   'vim' : 'http://www.vim.org',
   }

O comando a seguir faz o mesmo que o anterior:

 :Wopen vim

Além disso, no modo normal, <leader>wo lança o navegador usando WORD Under Cursor como URL. No modo visual, ele faz o mesmo, mas pegando a seleção atual de texto como URL.

:Wcopen Command e <leader>wco fazem o mesmo, mas usando o navegador da CLI.

Mecanismos de pesquisa

:Wsearch consulta um mecanismo de pesquisa e abre a página de resultados correspondentes:

Por exemplo:

 :Wsearch google how to learn vim

O comando anterior abre a página resultante da pesquisa de how to learn vim no Google.

Os mecanismos de pesquisa a seguir são fornecidos por padrão:

• Bitbucket
• Devdocs
• Duckduckgo
• Google
• Github
• Stackoverflow
• Wikipedia

Mais mecanismos de pesquisa podem ser adicionados através do dicionário g:www_engines . A consulta é anexada no final do determinado URL. Por exemplo:

 let g:www_engines = {
   'youtube' : 'https://www.youtube.com/results?search_query=',
   }

No modo normal, <leader>ws pesquisa WORD sob cursor, enquanto o mesmo mapeamento no modo visual pesquisa a seleção visual atual. Nos dois casos, o usuário é solicitado a escolher qual mecanismo de pesquisa deve ser usado. Se nenhum for fornecido, o DuckDuckGo será usado, mas esse comportamento pode ser alterado Configuração g:www_default_search_engine variável. Por exemplo:

 let g:www_default_search_engine = 'google'

:Wcsearch e os mapeamentos <leader>wcs fazem o mesmo, mas usando o navegador da CLI.

Mecanismos de pesquisa de atalho

Atalhos convenientes para mecanismos de pesquisa comumente usados ​​podem ser definidos no dicionário g:www_shortcut_engines . Tendo no vimrc :

 let g:www_engines = {
   'ruby' : 'http://ruby-doc.com/search.html?q=',
}

let g:www_shortcut_engines = {
   'ruby': ['Docruby', '<leader>dr', 'Doccliruby', '<leader>dcr']
}

Adiciona automaticamente :Docruby / :Doccliruby Comandos e <leader>dr / <leader>dcr que funcionam como :Wsearch / :Wcsearch e <leader>ws / <leader>wcs , mas usando Ruby imediatamente como mecanismo de pesquisa.

Lembre -se de que os comandos definidos pelo usuário devem começar com uma letra de maiúsculas.

É muito conveniente usar como uma maneira rápida de consultar a documentação da API.

Sessões

URLs e favoritos arbitrários podem ser agrupados em um nome no dicionário g:www_sessions e aberto imediatamente usando :Wsession .

Tendo no vimrc :

 let g:www_urls = {
   'vim' : 'http://www.vim.org',
   }

let g:www_sessions = {
   'dev' : ['vim', 'http://stackoverflow.com'],
   }

Correndo:

 :Wsession vim

abriria http://www.vim.org e http://stackoverflow.com imediatamente.

:Wcsession faz o mesmo, mas usando o navegador da CLI.

Configuração e referência

Tipo :help vim-www para obter uma referência e informações completas sobre a configuração.

Bugs

Abra um bug em https://github.com/waiting-for-dev/vim-www/issues

Contribuindo

1. Fork the Project (http://github.com/waiting-for-dev/vim-www/fork)
2. Crie sua filial de recursos ( git checkout -b my-new-feature )
3. Comprometa suas alterações ( git commit -am 'Add some feature' )
4. Empurre para o ramo ( git push origin my-new-feature )
5. Crie um novo pedido de tração

Versão

O VIM-WWW segue o sistema de versão semântica 2.0. A versão atual é 1.1.0.

Licença

A licença do MIT http://www.opensource.org/license/mit-license.php

Copyright (c) 2014 Marc Busqué Pérez

A permissão é concedida, gratuita, a qualquer pessoa que obtenha uma cópia deste software e arquivos de documentação associados (o "software"), para lidar com o software sem restrição, inclusive sem limitação os direitos de usar, copiar, modificar, mesclar, publicar, distribuir, mobilizar o software e/ou vender cópias do software e permitir que as pessoas a quem

O aviso de direitos autorais acima e este aviso de permissão devem ser incluídos em todas as cópias ou em partes substanciais do software.

O software é fornecido "como está", sem garantia de qualquer tipo, expresso ou implícito, incluindo, entre outros, as garantias de comercialização, aptidão para uma finalidade específica e não innoculação. Em nenhum caso os autores ou detentores de direitos autorais serão responsáveis ​​por qualquer reclamação, danos ou outro passivo, seja em uma ação de contrato, delito ou não, decorrente de, fora ou em conexão com o software ou o uso ou outras negociações no software.