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
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...
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È!

How-To :: gerador de PDF para manpages

Deixe um comentário

Preencha os seus dados abaixo ou clique em um ícone para log in:

Logotipo do WordPress.com

Você está comentando utilizando sua conta WordPress.com. Sair /  Alterar )

Imagem do Twitter

Você está comentando utilizando sua conta Twitter. Sair /  Alterar )

Foto do Facebook

Você está comentando utilizando sua conta Facebook. Sair /  Alterar )

Conectando a %s