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

37

Como posso fazer manpages (a partir do comando man ) abrir em um navegador da web para facilitar a navegação?

    
por kiri 30.08.2013 / 10:51

3 respostas

6

man2html

Para pesquisar páginas man

Instalei o pacote man2html e, em seguida, naveguei para http://localhost/cgi-bin/man/man2html para visualizar as páginas do manual. Essas páginas podem ser visualizadas offline, link para outras páginas do manual e apresentam uma função de pesquisa. Origem

Para abrir diretamente uma página (a partir da linha de comando)

Eu fiz este script aqui (não é curto), ele apenas navega diretamente para a página da Web (de man2html ) para uma certa manpage. Ele pode abrir várias páginas de manual especificadas como argumentos de linha de comando. Salve o script em algum lugar e conceda a ele permissões de execução ( chmod +x script.sh ). Execute-o como ~/script.sh (assumindo que foi 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 man

Instale o pacote dwww e navegue até http://localhost/dwww/man/1 para pesquisar as páginas. Estas páginas podem ser visualizadas offline, link para outras páginas do manual e apresentam uma função de pesquisa.

Para abrir diretamente uma página (a partir da linha de comando)

Eu fiz este script aqui (não é curto), ele apenas navega diretamente para a página da Web (de dwww ) para uma certa manpage. Ele pode abrir várias páginas de manual especificadas como argumentos de linha de comando. Salve o script em algum lugar e conceda a ele permissões de execução ( chmod +x script.sh ). Execute-o como ~/script.sh page (assumindo que foi 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 /8 o tempo todo, basta digitar o nome da página.

    
por kiri 30.08.2013 / 10:51
50

Usando o programa man

Olhando para a manpage do homem,

man man

Existe a opção -H , ou seu equivalente --html , que irá gerar o HTML para o manual e abri-lo no navegador.

  

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

Então, para abrir qualquer página do manual no navegador, use:

man -Hfirefox <command>

ou

man --html=firefox <command>

Ambos são iguais.

Você pode usar firefox , google-chrome , chromium-browser ou qualquer outro no lugar da palavra firefox .

Selecione um navegador padrão permanentemente

Antes de chamar o comando man , use o seguinte comando:

export BROWSER=firefox

Dessa forma, você pode usar apenas man -H ou man --html sem especificar o navegador a cada vez.

man -H ls

Você também pode adicionar o comando export anterior ao seu ~/.bashrc , para não precisar digitá-lo toda vez que abrir um novo terminal e tentar usar man -H

Solucionar problemas

Se você recebeu um erro dizendo 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 pacote groff .

sudo apt-get install groff

Usando o Yelp

Se a escolha do navegador não for relevante, você poderá usar o comando yelp , que oferece navegação pelas man pages

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

Usando o Repositório de Manuais do Ubuntu

Você também pode visitar o link e verificar quase todas as páginas do manual. Todas as versões das páginas man para todas as versões do Ubuntu estão disponíveis lá. Também possui uma funcionalidade de pesquisa.

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

    
por Dan 30.08.2013 / 11:22
13

man pode realmente fazer muito isso sozinho. Você só precisa instalar groff e, em seguida, pode usar o H flag.

sudo apt-get install groff
man -Hfirefox bash
    
por Oli 30.08.2013 / 11:24