Какой самый простой способ конвертировать все man-страницы в html?

1

Шестнадцать лет в 21-м веке я остаюсь сбитым с толку, что нам все еще нужно изо всех сил, если мы хотим видеть страницу человека

отображается пропорциональным шрифтом (т. е. не Courier или аналогичный)
со ссылками на другие ссылочные страницы

Существуют дразнящие веб-сайты с HTML-страницами, на которых есть ссылки, например этот , но я не нашел такого сайта со страницами, обновленными для текущей версии macOS. И, конечно, на веб-сайте не будут отображаться справочные страницы для программного обеспечения, установленного вами через Homebrew и т. Д.

Есть ли решение этой проблемы? Я посмотрел и посмотрел. это

function manp {
  man -t "$1" | open -f -a /Applications/Preview.app/
}

отображает страницу и показывает ее в режиме предварительного просмотра (после того, как интерпретатор PostScript преобразует ее в PDF), но вы не получаете живых ссылок.

Справочная страница для человека говорит:

HTML СТРАНИЦЫ

Man найдет HTML-страницы, если они находятся в каталогах, имя которых, как ожидается, будет ".html", поэтому допустимым именем для HTML-версии man-страницы ls (1) будет /usr/share/man/htmlman1/ls.1 .html.

Я мог бы написать скрипт, чтобы конвертировать все страницы руководства в моей системе в HTML, но держу пари, что кто-то уже сделал это. Бьюсь об заклад, они также решили проблему рендеринга ТАКЖЕ ТАКЖЕ как ссылки, чего явно не делает команда man.

terminal html

— daveyost
источник

2

устанавливать Bwana который позволяет вам просматривать man страницы в вашем любимом браузере.

Чтобы процитировать приведенную выше страницу «Просто введите« man: », а затем страницу руководства, которую вы ищете, в поле URL вашего браузера. Нажмите enter и позвольте Bwana сделать все остальное». Он имеет живые ссылки.

— Tony Williams
источник

К сожалению, Bwana явно не работает для macOS 10.12 и в настоящее время не поддерживается. Другая версия Бваны предлагает лучшее форматирование, но имеет те же проблемы.

— daveyost

Я использую его на MacOS 10.12, и он отлично работает. Бвана версия 2.7

— PeterVP

1

bcat позволяет тебе трубу stdout в ваш браузер по умолчанию. Альтернативой вашей функции предварительного просмотра будет:

bman () 
{ 
    : Display man page in default browser
    man $* | col -b | bcat
}

... или просто установить man пейджер:

export MANPAGER='col -b | bcat'
man grep

bcat работает с любой командой, которая пишет stdout:

pbpaste  | bcat
make test | bcat
tail -n 1000 -f /var/log/messages | bcat

...так далее.

Это рубиновый камень, поэтому его установка так же проста, как:

gem install bcat

Если преобразования «на лету» недостаточно, и вы хотите создать HTML сразу или заранее, этот пост на Unix.se имеет ряд предложений (к сожалению, один из моих любимых инструментов, могучий pandocне подойдет для этого ...)

— John N
источник