online_man - Páginas de manual online no terminal
Dica publicada em Shell Script / Miscelânea
online_man - Páginas de manual online no terminal
Tive essa ideia após ler a dica "Limpeza Extra no Slackware" do amigo Mauricio Ferrari, na qual ele sugere a remoção do diretório das páginas de manual do sistema como recurso de limpeza extra de disco.
Nesta dica mostro uma alternativa a quem optou por remover as páginas de manual (man pages) do disco, mas vez ou outra terá a necessidade de consultá-las. Podemos fazer isso criando um "comando" (neste caso uma função shell script) que baixará a página de manual desejada on-the-fly da internet.
Como pre-requisitos precisaremos do pandoc e do lynx:
sudo apt install pandoc lynx
Abra o teu arquivo de início de seção e adicione o seguinte conteúdo:
vim ~/.bash_profile
No meu caso adicionei apenas para meu usuário em ~/.bash_profile, mas você pode usar qualquer uma das alternativas a seguir, dependendo de sua preferência, distribuição etc: ~/.profile, ~/.bash_profile, ~/.bashrc, /etc/profile, /etc/bash.bashrc...
Agora basta reiniciar a seção de usuário ou recarregar o ~/.bash_profile:
source ~/.bash_profile
E consultar a página de manual desejada. Exemplo, man page do awk:
online_man awk Fica como dever de casa usar o "online_man" para consultar o pandoc e lynx para entender o que a função em shell script criada faz.
Nesta dica mostro uma alternativa a quem optou por remover as páginas de manual (man pages) do disco, mas vez ou outra terá a necessidade de consultá-las. Podemos fazer isso criando um "comando" (neste caso uma função shell script) que baixará a página de manual desejada on-the-fly da internet.
Como pre-requisitos precisaremos do pandoc e do lynx:
sudo apt install pandoc lynx
Abra o teu arquivo de início de seção e adicione o seguinte conteúdo:
vim ~/.bash_profile
online_man() {
pandoc -f html https://man.cx/$1 | lynx -stdin
}
pandoc -f html https://man.cx/$1 | lynx -stdin
}
No meu caso adicionei apenas para meu usuário em ~/.bash_profile, mas você pode usar qualquer uma das alternativas a seguir, dependendo de sua preferência, distribuição etc: ~/.profile, ~/.bash_profile, ~/.bashrc, /etc/profile, /etc/bash.bashrc...
Agora basta reiniciar a seção de usuário ou recarregar o ~/.bash_profile:
source ~/.bash_profile
E consultar a página de manual desejada. Exemplo, man page do awk:
online_man awk Fica como dever de casa usar o "online_man" para consultar o pandoc e lynx para entender o que a função em shell script criada faz.