exibindo documentação informativa com o vim

Question

Estou tentando usar o add-on ManPageView para visualizar a documentação informativa em vim .

Embora eu ache o ManPageView muito útil para, bem, visualizar manpages, sua funcionalidade de leitura de informações não parece funcionar. Mas quase nunca leio a documentação informativa, principalmente porque não parece valer a pena aprender a interface info . Então eu posso estar fazendo errado.

De qualquer forma: executar :Man info.i como sugerido pela documentação do ManPageView me dá

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>

Eu vejo algum sucesso se eu 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á que :Man info.i funcione, mas ainda não posso seguir os links na página exibida.

Ele funciona chamando info na linha de comando e capturando a saída, então talvez seja apenas a CLI do info que mudou? Especificamente, $ info info Advanced apresentará o tópico "Avançado" no nó "info". 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 ser suposto fazer, que é envolver o nome do nó em parênteses e prefixá-lo ao tópico, passando a combinação como um único argumento de linha de comando para info .

Eu não tentei usar este addon para visualizar a documentação de informações antes. Estou executando um ubuntu atualizado 10.10, usando o pacote vim-gnome.

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

Já outros conseguiram usar esse complemento para visualizar a documentação informativa? Eu sinto que estou perdido nas névoas que eternamente encobrem os limites da Obscuridade.

note : Ao compor esta mensagem, descobri as informações addon, que parece funcionar de forma aceitável, pelo menos à primeira vista.

    

Answer 1

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

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

Na verdade, eu prefiro essa maneira de visualizá-los usando o leitor info , que apresenta os documentos como um arquivo longo que você pode pesquisar ou percorrer rapidamente. Ter um addon ainda seria útil para facilitar os links a seguir e tal. Eu realmente não tentei usar o info addon mencionado na atualização; Eu não precisei olhar para um arquivo de informações desde então.

    

Answer 2

Use este plugin Vim:

Vinfo

Para ler a documentação de informações, como arquivos de ajuda do Vim

    

Answer 3

Apenas saída de informações de pipe para vim, por exemplo:

    info info Advanced | vim -R -

ou

    info info Advanced | less

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

Você também pode personalizar as associações de teclas de informações usando a ferramenta infokey (consulte Personalizando Ligações de Chaves e Variáveis ). Um exemplo de arquivo de código-fonte vi .infokey já foi fornecido (consulte infokey source format ).

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

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