Como encurtar páginas Man em explicações legíveis no Linux e no macOS

O MacOS e o Linux possuem um comando útil, man, que exibe explicações manuais para os comandos do terminal. Como eles costumam ser demorados, por que não usar a ferramenta tldr para encurtá-los em partes legíveis?

O MacOS e o Linux possuem um comando útil, man, que exibe explicações manuais para os comandos do terminal.  Como eles costumam ser demorados, por que não usar a ferramenta tldr para encurtá-los em partes legíveis?
Propaganda

Quando tudo mais falhar, leia o manual. Linha de Comando Um Guia Rápido Para Começar a Usar a Linha de Comando do Linux Um Guia Rápido para Começar a Usar a Linha de Comando do Linux Você pode fazer muitas coisas incríveis com comandos no Linux e não é realmente difícil de aprender. Os usuários do Read More no Linux e no Mac sabem que podem digitar “man” seguido de um nome de comando para ver uma explicação longa e detalhada desse comando. Essas páginas man são úteis, mas detalhadas. Às vezes, tudo que você precisa é uma explicação breve e concisa de um comando para atualizar sua memória.

Aqui está uma maneira fácil de obter explicações concisas e práticas de comandos usados ​​na linha de comando. Top Websites e Livros para Transformá-lo em um Herói da Linha de Comandos Linux Top Sites e Livros para Transformá-lo em um Herói da Linha de Comando Linux A linha de comando do Linux é extremamente ferramenta poderosa - mas também pode ser intimidante. Use esses sites e livros para lidar com isso. Leia mais sobre Linux e Mac. É um aplicativo de linha de comando chamado “tldr”, após a abreviação de “muito longo; não leu ”. A abreviatura dr é usada para escrever ou solicitar uma versão abreviada do texto, que é exatamente o que o comando tldr faz.

Instalar o tldr no Ubuntu

O comando tldr no Ubuntu não está disponível em nenhum repositório, então há uma maneira indireta de instalá-lo. Mas não é difícil.

Primeiro, precisamos instalar o NodeJS e o Node Package Manager (npm). Pressione Ctrl + Alt + T para abrir o Terminal e digite o seguinte comando.

sudo apt install nodejs npm 

Em seguida, vamos usar o npm para instalar o tldr . Tipo:

 sudo npm install -g tldr 

Você deve poder usar o tldr agora, mas poderá ver um erro dizendo "Nenhum arquivo ou diretório" ao tentar.

encurtar man pages com o comando tldr linux mac

Você pode corrigir esse erro criando um symlink O que é um link simbólico e quais são seus usos? [MakeUseOf explica] O que é um link simbólico e quais são seus usos [MakeUseOf explica] Leia mais. Digite o seguinte comando.

 sudo ln -s /usr/bin/nodejs /usr/bin/node 

Instalar o tldr no macOS

No macOS, vamos usar Homebrew Instalar o software Mac do terminal com o Homebrew Instalar o software Mac do terminal com o Homebrew Instalar (quase) qualquer aplicativo gratuito do Mac digitando quatro palavras e pressionando "Enter". Leia mais, o gerenciador de pacotes para macOS, para instalar o tldr. Homebrew permite que você instale qualquer utilitário de linha de comando com apenas alguns toques no teclado. Adicionando Cask ao Homebrew permite que você instale também aplicativos de desktop, como o Firefox e o GIMP. A atualização de utilitários de linha de comando e aplicativos de desktop é fácil com o Homebrew e o Cask.

Homebrew não é instalado por padrão. Vá para o site da Homebrew e copie o comando de instalação de lá. Nós não incluímos aqui caso isso mude.

Para instalar o Homebrew, abra o Terminal na pasta Utilitários da pasta Aplicativos . Clique com o botão direito no prompt da linha de comando e selecione Paste para inserir o comando de instalação do Homebrew que você copiou. Pressione Enter e siga as instruções conforme elas são apresentadas.

Uma vez instalado o Homebrew, digite o seguinte comando para instalar o comando tldr .

 brew install tldr 

Agora, você pode usar o comando tldr para obter explicações concisas e curtas para comandos.

Use o tldr para descobrir rapidamente como usar um comando

Usaremos o comando ls para ilustrar a diferença entre usar man e tldr. As capturas de tela são do Linux, mas funcionam da mesma maneira no macOS.

Digite o seguinte comando no prompt.

 man ls 

Você verá a explicação detalhada e prolixa do comando ls que continua para as páginas. Use as teclas de seta e as teclas Page Up e Page Down para navegar pela man page do comando ls.

encurtar man pages com o comando tldr linux mac

Agora, digite o seguinte comando.

 tldr ls 

Você verá uma descrição muito mais curta dos usos mais comuns do comando ls. Observe que você não precisa rolar pelos resultados, pelo menos muito. Tornamos a janela do nosso Terminal um pouco mais alta para mostrar todos os resultados de uma só vez.

encurtar man pages com o comando tldr linux mac

Use a versão da Web do tldr

Se você não quiser instalar o tldr ou estiver com problemas para fazer isso, há uma ótima versão da Web do utilitário tldr em https://tldr.ostera.io/. Eles incluem uma breve explicação sobre como usar o site. Isso também é útil se você já estiver em um navegador e quiser procurar rapidamente um comando sem abrir uma janela do Terminal.

encurtar man pages com o comando tldr linux mac

Por exemplo, digite "ls" na caixa de pesquisa na parte superior da página. Os resultados são exibidos imediatamente. Você pode achar isso ainda mais fácil de ler do que os resultados do comando tldr na linha de comando.

encurtar man pages com o comando tldr linux mac

Eles até fornecem uma página Editar esta página no Github, na parte inferior da página, para cada comando, caso você veja algum erro.

Você também pode criar ou editar comandos no site das Páginas TLDR.

encurtar man pages com o comando tldr linux mac

Precisa de uma cópia offline? Faça o download de uma versão em PDF das páginas do tldr, para uso posterior. Você pode até instalar um aplicativo tldr no seu dispositivo Android ou iOS.

man Páginas ainda são úteis

O comando tldr é útil para aprender o básico sobre um comando. Mas existem parâmetros de comando deixados de fora que você pode achar úteis. Portanto, se você não vir o que procura na página tldr de um comando, verifique a página do manual, se o comando tiver um.

Por exemplo, a página tldr do comando ls deixa de fora os seguintes parâmetros úteis. Parâmetros diferenciam maiúsculas de minúsculas.

  • -R: lista subdiretórios de forma recursiva.
  • -X: classifica alfabeticamente pelas extensões de arquivo.
  • -d: Lista apenas os diretórios, não seus conteúdos.

Outro exemplo é o comando rm, que remove arquivos e diretórios. Com um determinado parâmetro, ele pode ser usado para limpar todo o conteúdo de um diretório especificado. Tenha cuidado com este comando, pois você pode acabar excluindo arquivos críticos do sistema se usado incorretamente.

  • -I: avisar uma vez antes de remover mais de três arquivos ou ao remover arquivos recursivamente. Esse parâmetro é menos intrusivo que -i, enquanto ainda protege você contra a remoção acidental de arquivos que não deseja remover.
  • -d: remove diretórios vazios.

Enquanto a página tldr para o comando rm lista o parâmetro -r para remover recursivamente um diretório e todos os seus subdiretórios, ele não explica que rm não remove diretórios não vazios por padrão. Você deve usar -r ou -R para remover recursivamente diretórios não vazios.

Economize tempo com o comando tldr

O comando tldr vai direto ao ponto com explicações curtas e exemplos práticos de comandos do shell bash. Você pode até encontrar explicações concisas para alguns comandos internos que não estão mais disponíveis como entradas man, como o comando cd .

Você pode descobrir todos os comandos internos disponíveis no bash shell digitando o seguinte comando na linha de comando.

 man bash-builtins 

Você também pode querer experimentar o shell Fish 7 razões pelas quais você deve instalar o Fish Shell 7 razões pelas quais você deve instalar o Fish Shell Não gosta de como funciona o seu terminal Linux? Por que não instalar um novo shell? Uma delas é o peixe, que introduz características que deveriam ter se tornado comuns, mas não o fizeram. Vamos dar uma olhada. Leia mais, que possui recursos adicionais como sugestões automáticas, cores VGA e uma linguagem de script inspirada em linguagens de programação modernas, como Python e Ruby.

Você acha as explicações mais fáceis de entender? Ou você prefere as explicações completas e detalhadas nas man pages? Compartilhe seus pensamentos e experiências conosco nos comentários abaixo.

In this article