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!

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!