Как мне открыть страницы руководства в веб-браузере?

39

Как сделать так, чтобы страницы man (из manкоманды) открывались в веб-браузере для упрощения навигации?

browser manpage харакири
источник
linux.die.net/man - так у вас есть все, о чем вы можете мечтать. Существуют сценарии для преобразования руководств в HTML, но если вы не преобразуете их все, ссылки не будут работать должным образом. Также удобство чтения в консоли тоже исключительное. Может ты имел ввиду лучшую навигацию?
Алексис Уилк
2
@kevin Я бы предпочел использовать веб-браузер (я более знаком с ним), и я обнаружил, что gmanон не отвечает после открытия страницы
kiri
понят. gman может использовать браузер, но я понимаю вашу точку зрения. Кроме того, он не имеет возможности навигации. Я только что опубликовал это, как вы добавили в свой вопрос. ;-) Вы также можете взглянуть на пакет dwww.
Кевин Боуэн
1
Возможно, это не ваше решение, но в knoqueror вы можете ввести man: <ваша команда >>, чтобы получить доступ к страницам руководства в браузере. Это потребует от вас установки KDE-библиотек.
ремесленник
Есть еще одна альтернатива linux.die.net для просмотра страниц руководства, предварительно обработанных и украшенных онлайн: man7.org/linux/man-pages/index.html
Murphy

Ответы:

52

Использование программы man

Глядя на страницу человека, 

man man

Существует -Hопция или ее эквивалент, --htmlкоторая сгенерирует HTML для руководства и откроет их в браузере.

Эта опция заставит groff производить вывод HTML и отобразит этот вывод в веб-браузере. Выбор браузера определяется необязательным аргументом браузера, если таковой имеется, переменной среды $ BROWSER или значением по умолчанию во время компиляции, если оно не установлено (обычно lynx). Эта опция подразумевает -t и будет работать только с GNU troff.

Поэтому, чтобы открыть любую справочную страницу в браузере, просто используйте:

man -Hfirefox <command>

или 

man --html=firefox <command>

Оба одинаковы.

Вы можете использовать firefox, google-chrome, chromium-browserили любое другое вместо firefoxслова.

Выберите браузер по умолчанию навсегда

Перед вызовом manкоманды используйте следующую команду:

export BROWSER=firefox

Таким образом, вы можете просто использовать man -Hили man --htmlбез указания браузера каждый раз.

man -H ls

Вы также можете добавить предыдущую exportкоманду, ~/.bashrcчтобы вам не приходилось вводить ее каждый раз, когда вы открываете новый терминал и пытаетесь использоватьman -H

Troubleshoot

Если вы получили ошибку, говоря что-то вроде этого:

man: command exited with status 3: /usr/bin/zsoelim | /usr/lib/man-db/manconv -f UTF-8:ISO-8859-1 -t UTF-8//IGNORE | preconv -e UTF-8 | tbl | groff -mandoc -Thtml

Вам нужно будет установить groffпакет.

sudo apt-get install groff

Используя Yelp

Если выбор браузера не подходит, вы можете использовать yelpкоманду, которая предлагает навигацию по страницам руководства

yelp man:<command>
# example: yelp man:ls

Использование Ubuntu Manpage Repository

Вы также можете посетить http://manpages.ubuntu.com/ и проверить там почти все справочные страницы. Все версии справочных страниц для всех версий Ubuntu доступны там. Он также имеет функцию поиска.

Конечно, недостатком использования сайта является то, что вы не можете получить к нему доступ без подключения к Интернету.

Дэн
источник
Вы можете использовать команду xdg-open, которая также откроет дефолт системы
exussum
и вам нужно будет установить groff
exussum
@ user1281385 Я собирался упомянуть об этом, но у него есть несколько проблем. Например, по умолчанию у меня Firefox. Если я пытаюсь использовать его, и у меня уже открыт Firefox, он показывает мне ошибку, которая говорит, что Firefox is already running, but is not responding. To open a new window, you must first close the existing Firefox process, or restart your system.я упоминал об установкеgroff
Dan
manpages.ubuntu.com кажется полезным!
Пису
+1 Спасибо! Я написал целый сценарий, чтобы сделать это некоторое время назад. Это намного проще!
Джо
13

manдействительно может многое из этого сделать самостоятельно. Вам просто нужно установить, groffа затем вы можете использовать Hфлаг.

sudo apt-get install groff
man -Hfirefox bash
Оли
источник
6

man2html

Для поиска страниц man

Я установил man2htmlпакет, а затем перешел http://localhost/cgi-bin/man/man2htmlк просмотру справочных страниц. Эти страницы можно просматривать в автономном режиме, ссылаться на другие справочные страницы и использовать функцию поиска.
Источник

Чтобы напрямую открыть страницу (из командной строки)

Я сделал этот скрипт здесь (он не короткий), он просто перемещается прямо на веб-страницу (с man2html) для определенной страницы man. Он может открывать несколько страниц man, указанных в качестве аргументов командной строки. Сохраните скрипт где-нибудь и дайте ему права на выполнение ( chmod +x script.sh). Запустите его как ~/script.sh(при условии сохранения в ~каталоге) со страницами, которые нужно открыть в качестве аргументов. Чтобы открыть что-то вроде init(8), используйте ~/script "8 init".

dwww

Для поиска страниц man

Установите dwwwпакет и перейдите http://localhost/dwww/man/1к поиску страниц. Эти страницы можно просматривать в автономном режиме, ссылаться на другие справочные страницы и использовать функцию поиска.

Чтобы напрямую открыть страницу (из командной строки)

Я сделал этот скрипт здесь (он не короткий), он просто перемещается прямо на веб-страницу (с dwww) для определенной страницы man. Он может открывать несколько страниц man, указанных в качестве аргументов командной строки. Сохраните скрипт где-нибудь и дайте ему права на выполнение ( chmod +x script.sh). Запустите его как ~/script.sh page(при условии сохранения в ~каталоге) со страницами, которые нужно открыть в качестве аргументов. Чтобы открыть что-то вроде init(8), используйте ~/script init/8. Без pcregrep, вам нужно вводить /8все время, с ним, просто введите имя страницы.

харакири
источник