visualizzazione della documentazione informativa con vim


11

Sto cercando di utilizzare il componente aggiuntivo ManPageView per visualizzare la documentazione informativa all'interno vim.

Sebbene trovo ManPageView molto utile per la visualizzazione di manpage, la sua funzionalità di lettura delle informazioni non sembra funzionare affatto. Ma poi non leggo quasi mai la documentazione informativa, soprattutto perché non sembra che valga la pena dedicare del tempo all'apprendimento infodell'interfaccia. Quindi potrei sbagliarmi.

Comunque: :Man info.imi dà l' esecuzione come suggerito dalla documentazione di ManPageView

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>

Vedo qualche successo se elimino le seguenti righe, che iniziano alla riga 345 nel file 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

L'eliminazione di queste righe consentirà :Man info.idi funzionare, ma non riesco ancora a seguire i collegamenti nella pagina visualizzata.

Funziona chiamando infodalla riga di comando e catturando l'output, quindi forse è solo che infola CLI è cambiata? In particolare, $ info info Advancedverrà visualizzato l'argomento "Avanzate" nel nodo "Informazioni". Ho cercato nel codice sorgente dell'addon per un po ', ma non ho trovato alcun modo ovvio per indirizzarlo a passare il nodo come argomento aggiuntivo invece di fare ciò che dovrebbe essere supposto, che è avvolgere il nome del nodo in tra parentesi e prefisso all'argomento, passando la combinazione come argomento a riga di comando singolo a info.

Non ho mai provato a utilizzare questo componente aggiuntivo per visualizzare la documentazione informativa prima. Sto eseguendo un Ubuntu 10.10 aggiornato, usando il pacchetto vim-gnome.

Ho presentato una parvenza di una segnalazione di bug in quella che sembra essere la posizione consigliata

Altri hanno avuto successo usando questo componente aggiuntivo per visualizzare la documentazione informativa? Mi sento come se fossi perso nelle nebbie che avvolgono eternamente i confini esterni dell'Oscurità.

nota : durante la composizione di questo messaggio, ho scoperto il componente aggiuntivo delle informazioni , che sembra funzionare in modo accettabile, almeno a prima vista.


1
"Ho presentato una parvenza di segnalazione di bug in quella che sembra essere la posizione consigliata" - no. Il posto giusto per compilare la segnalazione di bug è direttamente all'autore. Se l'autore utilizza un tracker per i suoi plugin, potrebbe essere una soluzione migliore (dipende da ciascun manutentore dello script)
Luc Hermitte,

1
@LucHermitte Hmm .. Immagino che qualcuno dovrebbe aggiornare vim.org, allora. Il banner nella parte superiore di ogni pagina del componente aggiuntivo fornisce un collegamento alla sua pagina wiki con l'etichetta "Commenti, bug, miglioramenti".
intuito il

Il plugin Vinfo è eccellente per questo. Dovresti accettare quella risposta.
vitirale,

Risposte:


3

Ho scoperto che il modo più semplice per visualizzare i documenti informativi in ​​vim è semplicemente aprirli. Sono solo testo gzip con alcuni codici binari aggiunti come markup. Ciò è particolarmente utile sapere nei casi in cui non è pratico installare un componente aggiuntivo.

La posizione dei documenti informativi è specifica della distro; sotto Ubuntu, e presumibilmente altri debian-like, lo sono /usr/share/info/*.info.gz. Sono compressi con gzip, ma vim gestirà la traduzione per te solo se li apri.

In realtà preferisco questo modo di visualizzarli all'utilizzo del infolettore, in quanto presenta i documenti come un lungo file che puoi cercare rapidamente o sfogliare. Avere un addon sarebbe comunque utile per facilitare i seguenti link e simili. In realtà non ho provato a utilizzare il componente infoaggiuntivo menzionato nell'aggiornamento; Da allora non ho più avuto bisogno di guardare un file informativo.


eccezionale. Non sopporto il visualizzatore di informazioni. Andare a fare uno script per automatizzare questo.
Thomas Dignan,


3

Usa questo plugin Vim:

Vinfo

Per leggere la documentazione informativa come i file della guida di Vim


Questo plugin è fantastico, grazie per averlo pubblicato.
vitirale,

1

Semplicemente invia l'output delle informazioni a Vim, ad es.,:

    info info Advanced | vim -R -

o

    info info Advanced | less

Puoi anche invocare Info usando --vi-keys, ma le presunte combinazioni di tasti "vi" sono davvero strane.

È inoltre possibile personalizzare i collegamenti dei tasti Info utilizzando lo infokeystrumento (consultare Personalizzazione dei collegamenti e delle variabili dei tasti ). È .infokeygià stato fornito un file sorgente di esempio vi (consultare il formato sorgente di infokey ).

Vale la pena imparare GNU Info ( info info-stnd) perché è lo strumento adeguato per visualizzare i file di informazioni. La documentazione completa per gli strumenti GNU si trova in file di informazioni, ad esempio confrontare la differenza di contenuto tra man tare info tar. Le informazioni possono anche fornire un accesso strutturato migliore alla documentazione, in particolare per documenti di grandi dimensioni.

Ma il vero modo di leggere i file di informazioni è con la modalità Info (tipo C-h i) di Emacs perché i collegamenti dei tasti Info sono praticamente gli stessi e ottieni inoltre tutti i vantaggi dell'editor Emacs (ad es. Segni, registri, divisione verticale delle finestre ecc.) . È utile familiarizzare con Emacs perché molti strumenti GNU usano i tasti di associazione in stile Emacs (es. Info, Bash, Screen ecc.). Prova il tutorial di Emacs.

Utilizzando il nostro sito, riconosci di aver letto e compreso le nostre Informativa sui cookie e Informativa sulla privacy.
Licensed under cc by-sa 3.0 with attribution required.