Какой самый простой способ конвертировать все 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
источник