Podemos converter facilmente todas as páginas de manual do Linux para o formato HTML, texto ou PDF. Para exibir as páginas de documentação do manual online no terminal em Linux usamos o comando man. No entanto, algumas páginas de manual são longas e podem ser difíceis de pesquisar. Portanto, podemos convertê-los para o formato HTML e abri-los em um navegador.
Podemos usar man2html ou groff para isso.
- man2html: formata uma página do manual em html no Linux
- groff: O troff é um sistema de processamento de documentos desenvolvido pela AT&T para o sistema operacional Unix. No Linux, todas as novas páginas de manual devem ser marcadas usando o pacote ou comando groff.
Instalando man2html
Debian, Ubuntu e derivados:
sudo apt install man2html-baseCentOS/RHEL/Fedora e derivados
sudo dnf install man2html-coreou
sudo yum install man2html-coreConvertendo uma página de manual para HTML
Antes de tudo deverá saber o caminho do arquivo referente ao manual(man). Use o comando whereis para localizar o caminho da página de manual. Exemplo, whereis pwd
joao@lubuntu:~$ whereis pwd pwd: /usr/bin/pwd /usr/share/man/man1/pwd.1.gz
e agora usaremos > para redirecionar o resultado para o arquivo pwd.html
joao@lubuntu:~$ man2html /usr/share/man/man1/pwd.1.gz > pwd.html
Usando groff
Faça a instalação do programa groff:
sudo apt install groffEncontre o caminho do manual usando whereis conforme vimos acima
joao@lubuntu:~$ whereis pwd pwd: /usr/bin/pwd /usr/share/man/man1/pwd.1.gz
Agora faça a conversão assim:
joao@lubuntu:~$ zcat /usr/share/man/man1/pwd.1.gz | groff -mandoc -Thtml > pwd.html
O comando zcat permite que você leia arquivos de texto compactados gzip e envie essa saída para groff
Conclusão
Eu achei muito melhor o resultado obtido pelo comando groff. A página html exibiu o manual do comando pwd da mesma forma que vendo com o comando man. Ele preservou espaçamento, indentação.