How-To :: gerador de PDF para manpages

Desde tempos imemoriais eu venho utilizando uma função em meu ~/.bashrc e agora no ~/.zshrc que gera arquivos em PDF a partir das tão salutares manpages, hoje resolvi expandi-la um pouco mais.

manpage do fodástico rsync e um bugzinho no tema GTK visto no terminal! rsrs

Requisitos.

1. ter os pacotes ghostscript, shared-mime-info e xdg-utils instalados;
2. criar em sua $HOME a pasta PDF; e
3. adicionar na configuração de seu shell preferido a função abaixo.

A função original (cujo autor desconheço), apresenta-se da seguinte forma:

manpdf() { man -t "$@" | ps2pdf - /tmp/manpdf_$1.pdf && xdg-open /tmp/manpdf_$1.pdf ;}

A versão expandida apresentar-se-a assim:

# Criar PDFs de ManPages (requer: ghostscript, shared-mime-info e xdg-utils).
manpdf() { man -t "$@" | ps2pdf - /tmp/manpdf_$1.pdf && cp /tmp/manpdf_$1.pdf $HOME/PDF/"$@".pdf && xdg-open $HOME/PDF/"$@".pdf ;}

Bom… dado o recado, salve o seu ~/.bashrc, ~/.zshrc ou o que seja, abra um novo terminal e digite:

$ mkdir $HOME/PDF
$ manpdf nome-do-programa

Como no exemplo:

$ manpdf rsync

executando e listando o diretório PDF…

As vantagens… além de automaticamente abrir o seu novo PDF, o mesmo estará salvo numa pasta pré-determinada, dando até para você criar um biblioteca de tanto o que existe de comando! 🙂

IntÈ!