просмотр информационной документации с vim

11

Я пытаюсь использовать дополнение ManPageView для просмотра информационной документации vim.

Хотя я считаю, что ManPageView очень полезен для просмотра man-страниц, его функция чтения информации, похоже, не работает вообще. Но потом я почти никогда не читаю информационную документацию, в основном потому, что не стоит тратить время на изучение infoинтерфейса. Так что я могу делать это неправильно.

В любом случае: запуск :Man info.iв соответствии с рекомендациями документации 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>

Я вижу некоторый успех, если я удаляю следующие строки, которые начинаются со строки 345 в файле 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

Удаление этих строк позволит :Man info.iработать, но я все еще не могу перейти по ссылкам на отображаемой странице.

Он работает, вызывая infoкомандную строку и захватывая выходные данные, так что, возможно, просто infoизменился CLI? В частности, $ info info Advancedподнимет тему «Дополнительно» в узле «информация». Некоторое время я копался в исходном коде аддона, но не нашел никакого очевидного способа направить его для передачи узла в качестве дополнительного аргумента вместо того, чтобы делать то, что, как кажется, должно делать, то есть заключать имя узла в Скобки и префикс в тему, передавая комбинацию в качестве одного аргумента командной строки info.

Я не пытался использовать это дополнение для просмотра информационной документации раньше. Я использую обновленную версию Ubuntu 10.10 с использованием пакета vim-gnome.

Я подал некоторое подобие сообщения об ошибке в том месте, которое кажется рекомендуемым

У других были успехи при использовании этого дополнения для просмотра информационной документации? Я чувствую, как будто я потерялся в тумане, который вечно окутывает внешние пределы Мрака.

примечание : во время написания этого сообщения я обнаружил информационный аддон, который, кажется, работает приемлемо, по крайней мере, на первый взгляд.

созерцаемое
источник
1
«Я подал некоторое подобие сообщения об ошибке в том месте, которое кажется рекомендуемым» - нет. Правильное место для заполнения отчета об ошибке - непосредственно автору. Если автор использует трекер для своих плагинов, это может быть лучшим решением (это зависит от каждого сопровождающего скрипта)
Люк Эрмитт
1
@LucHermitte Хмм .. Полагаю, тогда кто-то должен обновить vim.org. Баннер в верхней части каждой страницы дополнения содержит ссылку на ее вики-страницу с надписью «Комментарии, ошибки, улучшения».
интуитивно
Плагин Vinfo отлично подходит для этого. Вы должны принять этот ответ.
vitiral

Ответы:

3

Я обнаружил, что самый простой способ просмотреть информационные документы в vim - это просто открыть их. Это просто сжатый текст с некоторыми двоичными кодами, добавленными в качестве разметки. Это особенно полезно знать в тех случаях, когда установка аддона нецелесообразна.

Расположение информационных документов зависит от дистрибутива; под Ubuntu и, по-видимому, другими любителями дебианов, они находятся в /usr/share/info/*.info.gz. Они распакованы, но vim обработает перевод для вас, если вы просто откроете их.

Я на самом деле предпочитаю такой способ просмотра info, а не использовать ридер, так как он представляет документы в виде одного длинного файла, который вы можете быстро найти или пролистать. Наличие аддона все равно будет полезно для облегчения следующих ссылок и тому подобное. Я на самом деле не пытался использовать infoаддон, упомянутый в обновлении; С тех пор мне не нужно было просматривать информационный файл.

созерцаемое
источник
здорово. Я терпеть не могу просмотра информации. Собираюсь сделать скрипт для автоматизации этого.
Томас Диньян,
3

Используйте этот плагин Vim:

Vinfo

Чтобы прочитать документацию Info, например, файлы помощи Vim

alx741
источник
Этот плагин потрясающий, спасибо за публикацию.
vitiral
1

Просто передайте вывод информации в vim, например:

    info info Advanced | vim -R -

или же

    info info Advanced | less

Вы также можете вызвать Info, используя --vi-keys, но предполагаемые привязки клавиш "vi" действительно странные.

Вы также можете настроить привязки клавиш Info с помощью этого infokeyинструмента (см. « Настройка привязок клавиш и переменных» ). Образец .infokeyисходного файла vi уже предоставлен (см. Формат источника infokey ).

Стоит изучить GNU Info ( info info-stnd), потому что это подходящий инструмент для просмотра информационных файлов. Полная документация для инструментов GNU находится в информационных файлах, например, сравните разницу в содержании между man tarи info tar. Информация также может обеспечить более структурированный доступ к документации, особенно для больших документов.

Но реальный способ чтения информационных файлов - это информационный режим (тип C-h i) Emacs, поскольку привязки информационных клавиш практически одинаковы, и вы дополнительно получаете все преимущества редактора Emacs (например, метки, регистры, разбиение вертикальных окон и т. Д.) , Полезно ознакомиться с Emacs, потому что многие инструменты GNU используют привязки клавиш в стиле Emacs (например, Info, Bash, Screen и т. Д.). Попробуйте учебник по Emacs.

mvanle
источник