visualizando a documentação de informações com o vim


11

Estou tentando usar o complemento ManPageView para visualizar a documentação das informações vim.

Embora eu ache o ManPageView muito útil para, bem, exibir páginas de manual, sua funcionalidade de leitura de informações parece não funcionar. Mas quase nunca leio a documentação de informações, principalmente porque não parece valer o tempo necessário para aprender a infointerface. Então, eu posso estar fazendo errado.

De qualquer forma: executar :Man info.iconforme sugerido pela documentação do ManPageView me fornece

info: No menu item `(info)Top' in node `(dir)Top'.
info: No menu item `(info)Top' in node `(dir)Top'.
info: No menu item `(info)Top' in node `(dir)Top'.
***warning*** sorry, no manpage exists for <(info)Top>

Vejo algum sucesso se excluir as seguintes linhas, que começam na linha 345 do arquivo autoload/manpageview.vim:

" special exception for info {{{3
if a:viamap == 0 && ext == "i"
 let s:manpageview_pfx_i = "(".manpagetopic.")"
 let manpagetopic        = "Top"
" call Decho("top-level info: manpagetopic<".manpagetopic.">")
endif

A exclusão dessas linhas permitirá :Man info.ique funcione, mas ainda não consigo seguir os links na página exibida.

Funciona chamando infoa linha de comando e capturando a saída, então talvez seja apenas infoa CLI que mudou? Especificamente, $ info info Advancedexibirá o tópico "Avançado" no nó "informações". Eu procurei no código-fonte do addon por um tempo, mas não encontrei nenhuma maneira óbvia de direcioná-lo para passar o nó como um argumento extra, em vez de fazer o que parece que deveria fazer, que é envolver o nome do nó em parênteses e prefixe-o ao tópico, passando a combinação como um único argumento de linha de comando para info.

Eu não tentei usar este complemento para visualizar a documentação informativa antes. Estou executando um ubuntu 10.10 atualizado, usando o pacote vim-gnome.

Arquivei um relatório de bug no que parece ser o local recomendado

Outros tiveram sucesso usando este complemento para visualizar a documentação informativa? Sinto que estou perdido nas brumas que eternamente encobrem os confins da Obscuridade.

Nota : Ao escrever esta mensagem, descobri o complemento de informações , que parece funcionar de maneira aceitável, pelo menos à primeira vista.


1
"Eu arquivei alguma aparência de um relatório de bug no que parece ser o local recomendado" - não. O lugar certo para preencher o relatório de erro é diretamente ao autor. Se o autor usa um rastreador de seus plugins, pode ser uma solução melhor (depende de cada mantenedor roteiro)
Luc Hermitte

1
@ LucHermitte Hmm .. Acho que alguém deveria atualizar o vim.org, então. O banner na parte superior de cada página de addon fornece um link para sua página wiki com o rótulo "Comentários, bugs, melhorias".
intuited

O plugin Vinfo é excelente para isso. Você deve aceitar essa resposta.
Vitiral # 28/15

Respostas:


3

Descobri que a maneira mais fácil de visualizar documentos de informações no vim é apenas abri-los. Eles são apenas texto compactado em gzip com alguns códigos binários adicionados como marcação. Isso é especialmente útil em casos em que não é prático instalar um complemento.

A localização dos documentos informativos é específica da distribuição; no ubuntu e, presumivelmente, outros curtidas do debian, eles estão em /usr/share/info/*.info.gz. Eles são compactados em gzip, mas o vim manipulará a tradução para você se você apenas os abrir.

Na verdade, eu prefiro essa maneira de visualizá-las do que usar o infoleitor, pois apresenta os documentos como um arquivo longo que você pode pesquisar ou folhear rapidamente. Ter um addon ainda seria útil para facilitar os links a seguir. Na verdade, eu ainda não tentei usar o infocomplemento mencionado na atualização; Eu não preciso olhar para um arquivo de informações desde então.


impressionante. Não suporto o visualizador de informações. Vai fazer um script para automatizar isso.
Thomas Dignan


3

Use este plugin Vim:

Vinfo

Para ler a documentação do Info, como arquivos de ajuda do Vim


Este plugin é incrível, obrigado por publicá-lo.
Vitiral # 28/15

1

Apenas canalize a saída de informações para o vim, por exemplo:

    info info Advanced | vim -R -

ou

    info info Advanced | less

Você também pode chamar o Info usando --vi-keys, mas as supostas associações de teclas "vi" são realmente estranhas.

Você também pode personalizar as ligações de teclas Informações usando a infokeyferramenta (consulte Personalizando ligações de variáveis ​​e variáveis ). Um .infokeyarquivo de origem vi de amostra já foi fornecido (consulte o formato de fonte infokey ).

Vale a pena aprender o GNU Info ( info info-stnd) porque é a ferramenta adequada para visualizar arquivos de informações. A documentação completa das ferramentas GNU está em arquivos de informações, por exemplo, compare a diferença de conteúdo entre man tare info tar. As informações também podem fornecer um melhor acesso estruturado à documentação, especialmente para documentos grandes.

Mas a maneira real de ler arquivos info é com o modo Info (tipo C-h i) do Emacs, porque as combinações de teclas Info são praticamente as mesmas e você obtém todas as vantagens do editor Emacs (por exemplo, marcas, registros, divisão vertical de janelas etc.) . É útil familiarizar-se com o Emacs porque muitas ferramentas GNU usam teclas de atalho no estilo Emacs (por exemplo, Info, Bash, Screen etc). Experimente o tutorial do Emacs.

Ao utilizar nosso site, você reconhece que leu e compreendeu nossa Política de Cookies e nossa Política de Privacidade.
Licensed under cc by-sa 3.0 with attribution required.