Como faço para abrir páginas de manual em um navegador da web?

39

Como faço para abrir páginas de manual (a partir do mancomando) em um navegador da Web para facilitar a navegação?

browser manpage kiri
fonte
linux.die.net/man - dessa forma, você tem quase tudo o que pode sonhar. Existem scripts para transformar manuais em HTML, mas, a menos que você os transforme todos, os links não funcionarão conforme o esperado. Também a legibilidade também é excepcional em um console. Talvez você quisesse uma melhor navegação?
Alexis Wilke
2
@ Kevin Eu prefiro usar um navegador web (eu estou mais familiarizado com ele) e eu achei que gmaniria ficar sem resposta depois de abrir uma página
kiri
Entendido. O gman pode usar um navegador, mas entendo o seu ponto. além disso, ele não possui capacidade de navegação. Acabei de postar isso quando você adicionou sua pergunta. ;-) você também pode dar uma olhada no pacote dwww.
Kevin Bowen
11
Esta pode não ser a sua solução, mas no knoqueror, você pode digitar man: <your command >> para acessar as páginas do manual em um navegador. Isso exigirá que você instale as bibliotecas do kde.
Crafter 4/10
Existe outra alternativa ao linux.die.net para ver as páginas de manual pré-processadas e embelezadas on-line: man7.org/linux/man-pages/index.html
Murphy

Respostas:

52

Usando o programa man

Olhando para a página do homem, 

man man

Existe a -Hopção ou equivalente --htmlque irá gerar o HTML para o manual e abri-los no navegador.

Essa opção fará com que o groff produza saída HTML e exibirá essa saída em um navegador da web. A escolha do navegador é determinada pelo argumento opcional do navegador, se houver, pela variável de ambiente $ BROWSER ou por um padrão em tempo de compilação, se não estiver definido (geralmente lynx). Esta opção implica -t e funcionará apenas com o GNU troff.

Então, para abrir qualquer página de manual no navegador, basta usar:

man -Hfirefox <command>

ou 

man --html=firefox <command>

Ambos são iguais.

Você pode usar firefox, google-chrome, chromium-browserou qualquer outro no lugar da firefoxpalavra.

Selecione um navegador padrão permanentemente

Antes de chamar o mancomando, use o seguinte comando:

export BROWSER=firefox

Dessa forma, você pode simplesmente usar man -Hou man --htmlsem especificar o navegador todas as vezes.

man -H ls

Você também pode adicionar o exportcomando anterior ao seu ~/.bashrcpara não precisar digitá-lo toda vez que abrir um novo terminal e tentar usarman -H

Solucionar problemas

Se você encontrou um erro ao dizer algo assim:

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

Você precisará instalar o groffpacote.

sudo apt-get install groff

Usando o Yelp

Se uma escolha de navegador não for relevante, você pode usar o yelpcomando que oferece navegação pelas páginas do manual

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

Usando o repositório de páginas de manual do Ubuntu

Você também pode visitar http://manpages.ubuntu.com/ e verificar quase todas as páginas de manual lá. Todas as versões das páginas de manual para todas as versões do Ubuntu estão disponíveis lá. Ele também possui uma funcionalidade de pesquisa.

Obviamente, a desvantagem de usar o site é que você não pode acessá-lo sem estar conectado à Internet.

Dan
fonte
Você pode usar o comando xdg-open que abriria os sistemas Defalt também
exussum
e você precisaria groff instalado
exussum
@ user1281385 Eu ia mencionar isso, mas ele tem alguns problemas. Por exemplo, meu padrão é Firefox. Se eu tentar usá-lo, e já tiver o Firefox aberto, ele me mostra o erro que diz 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.que mencionei a instalação #groff
305 de Dan
manpages.ubuntu.com parece útil!
Pisu 04/09/2013
+1 Obrigado! Eu havia escrito um roteiro inteiro para fazer isso há algum tempo. Isto é muito mais fácil!
Joe
13

manpode realmente fazer muito disso sozinho. Você só precisa instalar groffe, em seguida, você pode usar a Hbandeira.

sudo apt-get install groff
man -Hfirefox bash
Oli
fonte
6

man2html

Para pesquisar páginas de manual

Eu instalei o man2htmlpacote e naveguei http://localhost/cgi-bin/man/man2htmlpara ver as páginas do manual. Essas páginas podem ser visualizadas offline, vinculadas a outras páginas de manual e possuem uma função de pesquisa.
Fonte

Para abrir diretamente uma página (na linha de comando)

Eu criei esse script aqui (não é curto), ele apenas navega diretamente para a página da Web (de man2html) para uma determinada página de manual. Ele pode abrir várias páginas de manual especificadas como argumentos de linha de comando. Salve o script em algum lugar e dê a ele permissões de execução ( chmod +x script.sh). Execute-o como ~/script.sh(assumindo salvo no ~diretório) com páginas para abrir como argumentos. Para abrir algo como init(8), use ~/script "8 init".

dwww

Para pesquisar páginas de manual

Instale o dwwwpacote e navegue http://localhost/dwww/man/1para pesquisar nas páginas. Essas páginas podem ser visualizadas offline, vinculadas a outras páginas de manual e possuem uma função de pesquisa.

Para abrir diretamente uma página (na linha de comando)

Eu criei esse script aqui (não é curto), ele apenas navega diretamente para a página da Web (de dwww) para uma determinada página de manual. Ele pode abrir várias páginas de manual especificadas como argumentos de linha de comando. Salve o script em algum lugar e dê a ele permissões de execução ( chmod +x script.sh). Execute-o como ~/script.sh page(assumindo salvo no ~diretório) com páginas para abrir como argumentos. Para abrir algo como init(8), use ~/script init/8. Sem pcregrep, você precisa digitar o /8tempo todo; basta digitar o nome da página.

kiri
fonte