przeglądanie dokumentacji informacyjnej za pomocą vima


11

Próbuję użyć dodatku ManPageView, aby wyświetlić dokumentację informacyjną vim.

Chociaż uważam, że ManPageView jest bardzo przydatny do przeglądania stron podręczników, jego funkcja czytania informacji w ogóle nie działa. Ale prawie nigdy nie czytałem dokumentacji informacyjnej, głównie dlatego, że nie warto poświęcać czasu na naukę infointerfejsu. Więc może robię to źle.

W każdym razie: działa :Man info.izgodnie z sugestią zawartą w dokumentacji 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>

Widzę pewien sukces, jeśli usunę następujące linie, które zaczynają się od linii 345 w pliku 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

Usunięcie tych wierszy pozwoli :Man info.ina pracę, ale nadal nie mogę podążać za linkami na wyświetlanej stronie.

Działa poprzez wywoływanie infowiersza poleceń i przechwytywanie danych wyjściowych, więc może po prostu infozmienił się CLI? W szczególności poruszony $ info info Advancedzostanie temat „Zaawansowane” w węźle „informacje”. Przez jakiś czas przekopałem się w kodzie źródłowym dodatku, ale nie znalazłem żadnego oczywistego sposobu, aby przekazać go jako dodatkowy argument zamiast robić to, co wydaje się być, co należy, czyli owinięcie nazwy węzła nawiasy i prefiks do tematu, przekazując kombinację jako pojedynczy argument wiersza poleceń do info.

Nie próbowałem wcześniej używać tego dodatku do przeglądania dokumentacji informacyjnej. Używam zaktualizowanego systemu Ubuntu 10.10, używając pakietu vim-gnome.

Złożyłem pozory raportu o błędzie w miejscu, które wydaje się być zalecaną lokalizacją

Czy inni odnieśli sukces przy użyciu tego dodatku do przeglądania dokumentacji informacyjnej? Czuję się, jakbym zagubił się we mgle, która wiecznie spowija zewnętrzne obszary Obscurity.

uwaga : podczas pisania tej wiadomości odkryłem dodatek informacyjny , który wydaje się działać akceptowalnie, przynajmniej na pierwszy rzut oka.


1
„Złożyłem pozory raportu o błędzie w miejscu, które wydaje się być zalecaną lokalizacją” - nie. Właściwe miejsce do wypełnienia raportu o błędzie jest bezpośrednio dla autora. Jeśli autor używa modułu śledzącego do swoich wtyczek, może to być lepsze rozwiązanie (zależy od każdego opiekuna skryptu)
Luc Hermitte

1
@LucHermitte Hmm .. Chyba ktoś powinien zaktualizować vim.org. Baner u góry każdej strony z dodatkami zawiera link do strony wiki z etykietą „Komentarze, błędy, ulepszenia”.
intuicyjnie

Wtyczka Vinfo jest do tego doskonała. Powinieneś zaakceptować tę odpowiedź.
vitiral

Odpowiedzi:


3

Odkryłem, że najłatwiejszym sposobem przeglądania dokumentów informacyjnych w vimie jest ich otwarcie. Są tylko spakowanym tekstem z kilkoma kodami binarnymi dodanymi jako znaczniki. Jest to szczególnie przydatne w przypadkach, gdy instalacja dodatku nie jest praktyczna.

Lokalizacja dokumentów informacyjnych jest specyficzna dla dystrybucji; pod Ubuntu i prawdopodobnie innymi podobnymi do Debiana, są na /usr/share/info/*.info.gz. Są zgzipowane, ale vim zajmie się tłumaczeniem, jeśli tylko je otworzysz.

Właściwie wolę ten sposób przeglądania niż używanie infoczytnika, ponieważ przedstawia on dokumenty jako jeden długi plik, który można szybko przeszukać lub przewinąć. Posiadanie dodatku nadal byłoby przydatne, aby ułatwić korzystanie z poniższych linków. Właściwie nie próbowałem używać infododatku wymienionego w aktualizacji; Od tego czasu nie musiałem patrzeć na plik informacyjny.


niesamowite. Nie mogę znieść przeglądarki informacji. Zamierzam stworzyć skrypt, aby to zautomatyzować.
Thomas Dignan,


3

Użyj tej wtyczki Vima:

Vinfo

Aby przeczytać dokumentację informacyjną, taką jak pliki pomocy Vima


Ta wtyczka jest niesamowita, dziękuję za jej opublikowanie.
vitiral

1

Wystarczy potokować wyjście Info do vima, np .:

    info info Advanced | vim -R -

lub

    info info Advanced | less

Możesz także wywołać Info za pomocą --vi-keys, ale domniemane powiązania klawiszy „vi” są naprawdę dziwne.

Możesz także dostosować powiązania klawiszy Info za pomocą tego infokeynarzędzia (patrz Dostosowywanie powiązań klawiszy i zmiennych ). Przykładowy .infokeyplik źródłowy vi jest już udostępniony (patrz format źródłowy infokey ).

Warto nauczyć się GNU Info ( info info-stnd), ponieważ jest to właściwe narzędzie do przeglądania plików informacyjnych. Pełna dokumentacja narzędzi GNU znajduje się w plikach informacyjnych, na przykład porównaj różnicę zawartości między man tari info tar. Informacje mogą również zapewniać bardziej uporządkowany dostęp do dokumentacji, szczególnie w przypadku dużych dokumentów.

Ale prawdziwym sposobem na odczytanie plików informacyjnych jest tryb Info (typ C-h i) Emacsa, ponieważ powiązania klawiszy Info są praktycznie takie same, a dodatkowo zyskujesz wszystkie zalety edytora Emacsa (np. Znaki, rejestry, podział okien w pionie itp.) . Przydatne jest zapoznanie się z Emacsem, ponieważ wiele narzędzi GNU używa powiązań klawiszy w stylu Emacsa (np. Info, Bash, Screen itp.). Wypróbuj samouczek Emacsa.

Korzystając z naszej strony potwierdzasz, że przeczytałeś(-aś) i rozumiesz nasze zasady używania plików cookie i zasady ochrony prywatności.
Licensed under cc by-sa 3.0 with attribution required.