visualización de documentación de información con vim

11

Estoy tratando de usar el complemento ManPageView para ver la documentación de información dentro vim.

Aunque encuentro que ManPageView es muy útil para, bueno, ver páginas de manual, su funcionalidad de lectura de información no parece funcionar en absoluto. Pero casi nunca leo documentación de información, principalmente porque no parece que valga la pena tomarse el tiempo para aprender la infointerfaz. Entonces puedo estar haciéndolo mal.

De todos modos: ejecutar :Man info.icomo sugiere la documentación de ManPageView me da

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>

Veo algo de éxito si elimino las siguientes líneas, que comienzan en la línea 345 del archivo 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

Eliminar esas líneas permitirá :Man info.ique funcione, pero aún no puedo seguir los enlaces en la página mostrada.

Funciona llamando infoa la línea de comando y capturando la salida, así que tal vez es solo que infola CLI ha cambiado. Específicamente, $ info info Advancedaparecerá el tema "Avanzado" dentro del nodo "información". Rebusqué en el código fuente del complemento por un tiempo, pero no encontré ninguna forma obvia de dirigirlo para que pasara el nodo como un argumento adicional en lugar de hacer lo que parece que se supone que debe hacer, que es envolver el nombre del nodo entre paréntesis y el prefijo al tema, pasando la combinación como un único argumento de línea de comandos a info.

No he intentado usar este complemento para ver la documentación de información antes. Estoy ejecutando un ubuntu 10.10 actualizado, usando el paquete vim-gnome.

He presentado una apariencia de un informe de error en lo que parece ser la ubicación recomendada

¿Han tenido éxito otros al usar este complemento para ver la documentación de información? Siento que estoy perdido en las brumas que envuelven eternamente los confines de la Oscuridad.

nota : Mientras redactaba este mensaje, descubrí el complemento de información , que parece funcionar de manera aceptable, al menos a primera vista.

intuido
fuente
1
"He presentado una apariencia de informe de error en lo que parece ser la ubicación recomendada" - no. El lugar correcto para completar el informe de errores es directamente al autor. Si el autor usa un rastreador para sus complementos, puede ser una mejor solución (depende de cada responsable del script)
Luc Hermitte
1
@LucHermitte Hmm .. Supongo que alguien debería actualizar vim.org, entonces. El banner en la parte superior de cada página de complementos ofrece un enlace a su página wiki con la etiqueta "Comentarios, errores, mejoras".
intuido el
El complemento Vinfo es excelente para esto. Deberías aceptar esa respuesta.
vitiral

Respuestas:

3

Descubrí que la forma más fácil de ver documentos de información en vim es simplemente abrirlos. Son solo texto comprimido con algunos códigos binarios agregados como marcado. Esto es especialmente útil para saber en los casos en que no es práctico instalar un complemento.

La ubicación de los documentos de información es específica de la distribución; bajo ubuntu, y presumiblemente otros me gusta de debian, están en /usr/share/info/*.info.gz. Están comprimidos, pero vim se encargará de la traducción por usted si solo los abre.

De hecho, prefiero esta forma de verlos a usar el infolector, ya que presenta los documentos como un archivo largo en el que puede buscar o navegar rápidamente. Tener un complemento aún sería útil para facilitar los siguientes enlaces y demás. De hecho, no he intentado usar el infocomplemento mencionado en la actualización; No he tenido que mirar un archivo de información desde entonces.

intuido
fuente
increíble. No soporto el visor de información. Voy a hacer un script para automatizar esto.
Thomas Dignan el
3

Use este complemento Vim:

Vinfo

Para leer la documentación de información como los archivos de ayuda de Vim

alx741
fuente
Este complemento es increíble, gracias por publicarlo.
vitiral
1

Simplemente canalice la salida de información a vim, por ejemplo:

    info info Advanced | vim -R -

o

    info info Advanced | less

También puede invocar información usando --vi-keys, pero las supuestas combinaciones de teclas "vi" son realmente extrañas.

También puede personalizar las asociaciones de teclas de información con la infokeyherramienta (consulte Personalizar asociaciones de teclas y variables ). .infokeyYa se proporciona un archivo fuente vi de muestra (consulte el formato fuente infokey ).

Vale la pena aprender GNU Info ( info info-stnd) porque es la herramienta adecuada para ver archivos de información. La documentación completa de las herramientas GNU se encuentra en archivos de información, por ejemplo, compara la diferencia de contenido entre man tary info tar. La información también puede proporcionar un mejor acceso estructurado a la documentación, particularmente para documentos grandes.

Pero la forma real de leer archivos de información es con el modo de información de Emacs (tipo C-h i) porque las combinaciones de teclas de información son prácticamente las mismas, y además obtiene todas las ventajas del editor de Emacs (por ejemplo, marcas, registros, división de ventanas verticales, etc.) . Es útil familiarizarse con Emacs porque muchas herramientas GNU usan enlaces de teclas de estilo Emacs (por ejemplo, Información, Bash, Pantalla, etc.). Prueba el tutorial de Emacs.

mvanle
fuente