Jak podążać za linkami na stronach podręcznika systemu Linux?

Czy istnieje sposób na skorzystanie z linków wymienionych na stronie podręcznika? Na przykład, oto strona podręcznika dla ps; jak uzyskać dostęp do linku oznaczonego na czerwono?

Strony podręcznika sięgają do Unix First Edition . Chociaż wynaleziono hipertekst , wciąż był w powijakach; Internet był oddalony o dwie dekady, a podręcznik był rzeczywiście drukowaną książką, często z jednym poleceniem na stronę, jeśli pasowały (dlatego nazywano je stronami).

Od tego czasu format strony podręcznika ewoluował nieco, ale większość stron nie jest tak naprawdę zaprojektowana pod kątem hipertekstu, a domyślny manprogram go nie obsługuje (jest to zwykła przeglądarka tekstu z hackami do obsługi podstawowego formatowania). Istnieją jednak strony człowiek oglądania programów, które odtworzyć niektóre hiperłączy, głównie linki do innych stron podręcznika, które są tradycyjnie napisany w formie man(1)gdzie manto nazwa strony człowieka i 1jest numer sekcji :

• tkman , przeglądarka stron man z GUI z hiperłączami
• Kobieta ( wiki , człowiek comparsion , dawniej ), przeglądarka strona podręcznika dla Emacsa, hiperłącza wspierające
• man2html , konwerter człowieka na HTML (plus przeglądarka internetowa do odczytu wyniku)

Możesz przeglądać strony podręcznika kilku systemów operacyjnych, przekonwertowane na HTML przez man2htmllub podobne narzędzia, w wielu witrynach online, na przykład:

• CentOS
• Debian
• FreeBSD (i kilka innych kolekcji)
• Mac OS X
• MINIX 3
• NetBSD
• OpenBSD
• Solaris 10 , Solaris 11 , inne wersje Solaris
• Ubuntu
• Unix 1. edycja , Unix 6. edycja , Unix 8. edycja

Jakiś czas po tym, jak strony podręcznika stały się ustalonym formatem dokumentacji dla Uniksa i jakiś czas przed wynalezieniem sieci, projekt GNU wprowadził format dokumentacji informacji , bardziej zaawansowany niż człowiek, przy jednoczesnym trzymaniu się prostych znaczników zaprojektowanych dla terminali tekstowych. Główną innowacją informacji w porównaniu do człowieka było posiadanie wielostronicowej dokumentacji z linkami do innych stron. Info jest nadal preferowanym formatem dokumentacji dla projektów GNU, chociaż większość stron Info jest generowanych ze źródła Texinfo (lub czasami innych formatów), które mogą również generować HTML. Gdy istnieje dokumentacja informacyjna programu, często jest to główna instrukcja, podczas gdy strony podręcznika zawierają tylko podstawowe informacje o argumentach wiersza poleceń.

Przede wszystkim nie jest to link. To tylko podkreślenie. Strony podręcznika to tylko dokumenty tekstowe z odrobiną prostego formatowania, które terminal może obsłużyć. Podkreślenie jest tylko atrakcją, nie ma w tym „linku”.

Normalne manpolecenie to tylko formatator tekstu. W rzeczywistości manpolecenie nawet nie wyświetla tekstu, manpo prostu formatuje informacje zapisane w pliku strony man ^[1] i wysyła sformatowane dane wyjściowe do innego programu (zwykle less), który wyświetla sformatowane dane wyjściowe na ekranie. Te programy wyświetlające nie mają pojęcia łączy.

Istnieją pewne specjalne czytniki dokumentacji, które mogą być w stanie spojrzeć na takie formatowanie i zgadywać, że takie wyróżnienie może wskazywać, że istnieje powiązana strona podręcznika man, którą można podciągnąć i utworzyć link, ale nie wiem które robią. Być może pinfo?

Jeśli chcesz formatować jak w Internecie za pomocą hiperłączy, możesz znaleźć prawie każdą stronę man UNIX online z dodanymi linkami. Spróbuj wpisać man [anything]google, a prawie na pewno dostaniesz jedną z pierwszych kilku trafień.

W przypadku twojego przykładu, wizualne podświetlenie jest wskazówką, że jest to kolejna nazwa programu, która ma własną stronę podręcznika, którą możesz łatwo wyciągnąć. Spróbować man 1 top. Liczba 1 wskazuje sekcję stron podręcznika, na które należy zajrzeć. Zobacz to pytanie, aby uzyskać wyjaśnienie części: Co oznaczają liczby na stronie podręcznika?

^[1] Jeśli otworzysz manplik strony w edytorze tekstu, zobaczysz surową manstronę, która nie jest sformatowana do łatwego czytania. Nieprzetworzona manstrona jest napisana w języku znaczników o nazwie troff. Więcej informacji na trofftemat pisania manstrony znajduje się na stronie: https://liw.fi/manpages/ .

To jest bardzo późna odpowiedź, ale użyj w3mman. w3mman to ręczny pager systemowy autorstwa w3m.

https://linux.die.net/man/1/w3mman

Możesz spróbować, instalując pakiet w3m. Wierzę, że ten pakiet jest zarejestrowany w repozytoriach oprogramowania większości głównych dystrybucji Linux / UNIX i Cygwin.

Pozwól, że spróbuję bardziej zinterpretować twoje pytanie w tym sensie, że staram się podążać za tobą. Prawdopodobnie chciałbyś mieć kombinację klawiszy na manstronie, która prowadzi bezpośrednio do podkreślonych poleceń, o których czytasz. Nie trzeba więc instalować czegoś innego, nie otwierać innej konsoli i zapomnieć na przykład o dokładnej składni.

Najprostszym rozwiązaniem jest wykrzyknik (jeśli używasz lessdo wyświetlania stron podręcznika) i chcesz przejść do podkreślonego top:

!man top

Lub

!man 1 top

Będziesz musiał zamknąć je wszystkie, naciskając qwiele razy. Zauważ też, że to nie zadziała, jeśli LESSSECURE=1zostanie ustawione jako zmienna środowiskowa, która uruchomi się lessw trybie bezpiecznym i nie pozwoli na użycie !. Powie ci coś w rodzaju „Polecenie niedostępne”.

Chociaż w3mman jest rozwiązaniem umożliwiającym śledzenie linków, nie używa całego ekranu (przynajmniej w Ubuntu 12.10)

Wolę używać:

$ sudo su -
# apt-get install w3m man2html
# exit
$ alias man=' hman -P w3m'

dodaj ostatnią komendę do ~ / .bash_aliases lub podobnego skryptu startowego, aby uzyskać ją w każdej sesji.

-P w3m dlatego pierwsza przeglądarka hman jest ryś lub sensible-browser ale wolę w3m

hman to narzędzie dołączone do html2man. Zobacz to

Jeśli wyjście z potwierdzeniem jest dla ciebie denerwujące, to dla mnie skorzystaj z tego

Specjalnie dla Ubuntu istnieje Yelp. Jest instalowany domyślnie i domyślnie jest w stanie wyświetlać strony podręcznika, chociaż wywołanie w tym celu nie jest tym samym, co manpolecenie; Alias ​​lub funkcja powłoki może działać wokół tego ostatniego punktu (zależy od powłoki).

yelp 'man:exit'

Domyślnie będzie to sekcja w sposób, którego nie znam. Przypomnienie: aby uzyskać listę rozdziałów na temat podręcznika, użyj whatis, jak w whatis exit.

Aby poprosić Yelp o wyświetlenie strony podręcznika z określonej sekcji, powiedzmy 2, wykonaj:

yelp 'man:exit(2)'

Problemy: yelp ma błędy i bądź przygotowany na otrzymanie wielu błędów wyjściowych podczas wywoływania go z wiersza poleceń. Tam również alias lub niestandardowa funkcja powłoki może pomóc w przekierowaniu wszystkich błędów/dev/null

Jak powiedzieli, nie został do tego zaprojektowany.

Możesz użyć, info mana następnie nacisnąć Enter, gdy znajdziesz się w sekcji ZOBACZ TAKŻE na swoim produkcie.

info - przeczytaj dokumenty informacyjne

Mam (kilka) włamań.

włamać się 1

Umieść to w swoim ~ / .bashrc lub ~ / .zshrc

function man(){
    for arg in "$@"; do
        vim -c 'execute "normal! :let no_man_maps = 1\<cr>:runtime ftplugin/man.vim\<cr>:Man '"${arg}"'\<cr>:wincmd o\<cr>"'
    done
}

Zrzut ekranu..

Asciinema ..

https://asciinema.org/a/130131

Teraz..

1. man vimna przykład podczas pisania otworzy się ta strona podręcznika w vim

   • jeśli man man vimna przykład wpiszesz , najpierw otworzy maninstrukcję, a po wyjściu z vima, otworzy viminstrukcję

2. kiedy naciśniesz K(to kapitał k), gdy znajdziesz się na innej stronie podręcznika u dołu ( sekcja ZOBACZ TAKŻE ), przejdziesz do tej instrukcji (niestety wewnątrz mniej pagera - let no_man_maps = 1dzieje się tak dlatego, że mamy ; jeśli nie masz zrób to, wtedy vim zmusi qdo bycia :qi nie będziesz w stanie łatwo zapisać makra, a vim może zachowywać się chwiejnie na inne sposoby).

   • wyjście z drugiej wprowadzonej instrukcji spowoduje powrót do poprzedniej instrukcji, którą przeglądałeś

3. dostajesz bardzo ładne podświetlanie składni, ponieważ załadowałeś ftplugin / man.vim, a ft jest (automatycznie) ustawiony na man.

4. możesz kopiować i wklejać, swobodnie nawigować w vimie, a nawet modyfikować bufor i :w ~/usefulfile. Możesz robić wszystko, co normalnie robisz w vimie, w tym makra nagrywania, szarpać do schowka za pomocą "+y(jeśli masz +clipboard) itp.

Uważam, że jest to o wiele ładniejsze niż mniej .

Jedynym drobnym problemem, który znalazłem (który nadal istnieje, jeśli używasz mniej jako pager) jest to, że chcesz mieć wiele instrukcji otwartych w jednej sesji vim. Naprawdę nie widzę sposobu, aby to zrobić.

Kilka uwag:

1. jeśli spróbujesz zapisać bufor, otrzymasz E382: Cannot write, 'buftype' option is set

   • Podoba mi się, że nie można zapisać, ponieważ zapobiega to przypadkowemu zapisaniu

2. nadal możesz zapisać jak :w /tmp/man.man

   • jeśli zapiszesz go z .manrozszerzeniem, otwarcie go ustawi mandla ciebie typ pliku
   • jeśli nie zapiszesz go z .manrozszerzeniem, możesz po prostu ustawić ft man, uruchamiając:set ft=man

3. jeśli na przykład potrzebujesz zrobić coś podczas otwierania stron podręcznika użytkownika autocmd VimEnter *.~ echom 'hooray, we are using vim for man pages!'.

4. W moim vimrc umieściłem następujące elementy, dzięki czemu mogę nacisnąć, Kaby spróbować otworzyć instrukcję, a następnie nacisnąć, Gaby wrócić do poprzedniej instrukcji:

augroup man
    autocmd!
    autocmd VimEnter *.~ nnoremap B :execute "normal! `Z"<cr>
    autocmd VimEnter *.~ nnoremap <buffer> K :execute "normal! mZyiw:Man \<lt>c-r>\"\<lt>cr>"<cr>
augroup END

włamać się 2

umieść to w swoim ~ / .bashrc lub ~ / .zshrc

function man(){
    declare -a args
    for arg in "$@"; do
        command man "$arg" > "/tmp/${arg}.man"
        args+=("/tmp/${arg}.man")
    done
    vim "${args[@]}"
}

Zrzut ekranu..

Asciinema ..

https://asciinema.org/a/9Q6Si90Pi46cDVUknxFxfIwsv

To rozwiązuje problem włamania 1 i mniejszej twarzy (teraz możesz przeglądać wiele instrukcji w jednym buforze), ale jest mniej elegancki.

Uwagi:

1. WAŻNE jeśli chcesz hack2 do pracy, wówczas należy umieścić :let no_man_maps = 1w twojej ~/.vimrc. Wynika to z tego, że vim będzie pozyskiwał źródła .../vim80/man.vimi qzostanie do nich przymusowo mapowany :q.

2. w grę wchodzi więcej sprzątania (teraz zapisujesz każdą instrukcję w /tmp/*.man )

3. możesz jednak teraz przeglądać wiele stron podręcznika w jednej sesji, jak wspomniano powyżej

4. jednak jeśli naciśniesz K, nadal otworzysz nową sesję vim

   • jeśli chcesz, możesz powiązać autocmd (używając autocmd takiego jak powyższy), aby zrobić coś takiego autocmd VimEnter man.~ nnoremap <buffer> K :execute "normal! Byt(:silent !man \<c-r>\" > /tmp/\<c-r>\".man\<cr>:edit /tmp/\<c-r>\".man\<cr>"lub coś szalonego takiego ( nieprzetestowane )

Byłem w stanie użyć tego --htmlargumentu man, aby otworzyć go w przeglądarce zdefiniowanej przez zmienną środowiskową $ BROWSER, więc:

BROWSER=google-chrome man ps --help

Używam Fedory. Nie jestem pewien, czy to działa w przypadku Twojej dystrybucji, przetestuj i zgłoś w komentarzach.