Man vs TLDR: Vantagens do comando TLDR e dicas práticas de uso

Para esclarecer, este artigo aborda os comandos mane tldrdentro do ambiente Linux. Embora as páginas de manual sejam completas, elas podem parecer sobrecarregadas para novatos. Como alternativa, o comando tldr oferece resumos concisos e fáceis de seguir dos comandos Linux.

Este guia explorará o que tldré, como utilizá-lo e por que ele pode ser uma opção mais amigável ao usuário em comparação ao mancomando clássico.

Compreendendo o comando Man

O mancomando, abreviação de manual, serve como método padrão para acessar a documentação de comando em sistemas do tipo Unix. Executar manseguido por um nome de comando recupera a página do manual associada a esse comando, fornecendo insights detalhados sobre suas funções, opções e exemplos.

Por exemplo, digitar o comando a seguir fornece uma visão geral abrangente do lscomando:

Esta ação abre uma longa página de manual exibindo todas as opções disponíveis, organizadas em várias seções, como NOME , SINOPSE , DESCRIÇÃO , OPÇÕES e EXEMPLOS . Embora essa estrutura ajude na navegação, o conteúdo extenso pode ser assustador.

Embora o mancomando forneça informações valiosas para usuários experientes, ele pode ser complicado para iniciantes e até mesmo alguns usuários intermediários devido ao volume de informações apresentadas.

O que exatamente é Tldr?

tldr, que significa “muito longo; não li”, é um coloquialismo da internet usado para resumir textos longos. Diferentemente das páginas de manual tradicionais, as páginas tldr enfatizam as opções mais práticas, complementadas por exemplos diretos e reais.

Por exemplo, ao executar tldrfollowed by lsno seu terminal, o comando tldr apresenta um breve resumo do lscomando, incluindo suas opções mais frequentemente usadas:

Conforme ilustrado, as páginas tldr são concisas e focadas, tornando mais simples para novos usuários compreender e usar os comandos de forma eficaz.

Introdução ao Tldr

Para acessar facilmente as páginas tldr, você precisa instalar um cliente compatível. O cliente primário para tldr é o Node.js, que é o cliente original para a iniciativa tldr. Para opções adicionais de cliente em várias plataformas, consulte a página wiki de clientes TLDR .

O Node.js pode ser instalado por meio do gerenciador de pacotes adequado à sua distribuição Linux. Por exemplo, em sistemas baseados em Debian, como Linux Mint ou Ubuntu, use o seguinte comando:

Depois que o Node.js e seu gerenciador de pacotes npm estiverem instalados, você pode configurar globalmente o cliente tldr usando este comando:

Se você preferir um pacote Snap, você pode instalar o tldr executando:

Após a instalação, o cliente tldr permite que você visualize páginas de manual de linha de comando simplificadas e fáceis de entender. Por exemplo, para acessar uma breve visão geral do tarcomando, basta digitar:

Você também pode pesquisar comandos usando a --searchopção com palavras-chave:

Além disso, listar todos os comandos disponíveis pode ser feito com a -lopção:

Simplesmente entrando tldrno seu terminal, você pode explorar todas as opções disponíveis para o comando tldr:

Se uma opção baseada na web for mais adequada para você, o site oficial do tldr fornece conteúdo similar formatado para navegação. Ele inclui recursos como uma barra de pesquisa com sugestões automáticas, bem como rótulos indicando se os comandos são específicos para Linux ou macOS.

Além disso, cada página de ajuda tem um link para sua fonte no GitHub, onde você pode propor modificações ou melhorias usando as ferramentas integradas do GitHub — não é necessário ter muito conhecimento do Git.

As vantagens do Tldr sobre o homem

As páginas Tldr são criadas para leitura e compreensão diretas. Elas eliminam complexidades desnecessárias e focam somente nas informações essenciais necessárias para usar um comando de forma eficaz.

Em contraste com as páginas man, que frequentemente se aprofundam em cada opção e detalhe concebíveis, as páginas tldr destacam casos de uso práticos. Esses exemplos práticos demonstram como implementar comandos em contextos do mundo real, facilitando a compreensão dos conceitos apresentados.

O Tldr também é independente de plataforma, compatível com Windows, macOS e Linux, o que aumenta sua utilidade em diversos ambientes.

Conclusão

Seja você um novato ansioso para começar ou um especialista buscando uma rápida recapitulação, o tldr é um recurso valioso para adicionar ao seu kit de ferramentas.

No entanto, tenha em mente que o comando tldr não deve substituir completamente as páginas de manual. Para um entendimento abrangente e técnico, as páginas de manual tradicionais continuam a servir como materiais de referência vitais.

Crédito da imagem: Unsplash . Todas as modificações e capturas de tela por Haroon Javed.