tldr converte man Pages em explicações concisas e simples em inglês

Os usuários de linha de comando sabem ler o manual: digite “man” seguido do nome de um comando – você verá uma explicação detalhada. Esses manuais são úteis, mas detalhados, usando centenas de palavras para explicar todos os detalhes de um comando.

Isso é bom quando você quer saber tudo , mas na maioria das vezes está procurando um uso específico. O projeto tldr fornece explicações concisas em vez disso e permite que você procure qualquer aplicativo digitando “tldr” seguido do nome do comando. É perfeito para quando você precisa de uma atualização rápida e é compatível com os sistemas Linux e Mac.

Usando tldr para pesquisar rapidamente o que um comando faz

Digamos que você tenha esquecido os pontos mais delicados de usar cd, o comando para alterar pastas. Você pode digitar man cd, mas os resultados não serão diretos.

Se você tiver o tldr instalado, digite tldr cd. Você verá apenas os pontos mais pertinentes.

É fácil imaginar isso sendo útil. Você se esqueceu de como atualizar pacotes no Ubuntu? Basta digitar tldr apt-get.

Ou talvez você não se lembre de como desmontar unidades usando o diskutil no macOS:

Você entendeu: é uma maneira rápida de pesquisar o que quase qualquer comando faz. Não consigo encontrar muitos comandos comuns que não sejam suportados, mas se você fizer isso, confira a página de contribuições para aprender como enviar seus próprios resumos.

Instalando tldr no macOS e Ubuntu

Instalar o tldr no macOS é fácil usando o Homebrew, o gerenciador de pacotes do macOS . Instale o Homebrew, use o comando brew install tldre pronto. Você pode começar a usar o tldr imediatamente!

Recomendado:  Como permitir que os aplicativos se comuniquem através do firewall do seu Mac

Tive um pouco mais de problemas no Ubuntu porque, no momento em que este livro foi escrito, tldr não é oferecido em nenhum repositório. Mas não é difícil fazer isso funcionar com um pouco de trabalho.

Primeiro, instale o NodeJS e o Node Package Manager (nps):

sudo apt install nodejs npm

Em seguida, use o npm para instalar o tldr:

sudo npm install -g tldr

Agora você deve conseguir usar o tldr, mas tive problemas no Ubuntu 16.04: vi um erro sobre não haver “tal arquivo ou diretório” como nó. A solução foi criar um link simbólico:

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

Faça isso e o tldr deve estar instalado e funcionando no Ubuntu. Como sempre, essas etapas podem variar dependendo de qual distribuição Linux você está usando.

… Ou apenas use a versão da web

Usar tldr a partir do prompt de comando faz sentido, porque é o lugar onde você digita seus comandos. Mas não é necessário: há uma ótima versão da web em tldr.ostera.io , e vale a pena marcá-la se você não conseguir instalar as versões acima.

Existe até um link de edição, caso você veja um erro. Aproveitar!