TLDR - Páginas de manual fáceis de entender para comandos do Linux

Uma das maneiras mais comumente usadas e confiáveis de obter ajuda em sistemas do tipo Unix é através das páginas de manual, que são a documentação padrão para todos os sistemas do tipo Unix e correspondem a manuais on-line para programas, funções , bibliotecas, chamadas de sistema, padrões formais e convenções, formatos de arquivo e assim por diante.

No entanto, as páginas de manual sofrem de muitas falhas, uma das quais é que são muito longas e algumas pessoas simplesmente não gostam de ler muito texto na tela.

O TLDR (significa “Too Long; Didn’t Read“) é um projeto conduzido pela comunidade que fornece documentação concisa e simplificada para vários comandos do Linux.

O TLDR tem como objetivo oferecer exemplos rápidos e práticos de uso de comandos, tornando mais fácil para os usuários entender e utilizar comandos sem ter que se aprofundar em manuais extensos ou explicações extensas.

TLDR normalmente é acessado por meio da linha de comando usando o comando “tldr”, seguido pelo nome do comando que você deseja aprender.

tldr ls

TLDR é uma gíria da internet, significando que uma postagem, artigo, comentário ou qualquer coisa como uma página de manual era muito longa e quem usou a frase não a leu por esse motivo. O conteúdo das páginas TLDR está disponível abertamente sob a licença permissiva do MIT.

Neste breve artigo, mostraremos como instalar e usar páginas TLDR no Linux.

Como instalar páginas TLDR em sistemas Linux

Para acessar convenientemente as páginas TLDR, você precisa instalar um dos clientes suportados chamado Node.js, que é o cliente original do projeto tldr-pages.

Para instalar o Node.js, você pode usar o gerenciador de pacotes específico para sua distribuição.

sudo apt install nodejs npm         [On Debian, Ubuntu and Mint]
sudo yum install nodejs npm         [On RHEL/CentOS/Fedora and Rocky/AlmaLinux]
sudo emerge -a sys-apps/nodejs npm  [On Gentoo Linux]
sudo apk add nodejs npm             [On Alpine Linux]
sudo pacman -S nodejs npm           [On Arch Linux]
sudo zypper install nodejs npm      [On OpenSUSE]    

Depois que Node.js e npm estiverem instalados, você poderá prosseguir com a instalação do TLDR usando o comando npm conforme mostrado .

sudo npm install -g tldr

TLDR também está disponível como um pacote Snap, para instalação e execução.

sudo snap install tldr

Depois de instalar o cliente TLDR, você pode visualizar as páginas man de qualquer comando, por exemplo, o comando tar aqui (você pode usar qualquer outro comando aqui):

tldr tar

Aqui está outro exemplo de acesso à página de manual resumida do comando ls.

tldr ls

Para listar todos os comandos da plataforma escolhida no cache, use a flag -l.

tldr -l 

Para listar todos os comandos suportados no cache, use o sinalizador -a.

tldr -a

Você pode atualizar ou limpar o cache local executando.

tldr -u	#update local cache 
OR
tldr -c 	#clear local cache 

Para pesquisar páginas usando palavras-chave, use as opções -s, por exemplo.

tldr -s  "list of all files, sorted by modification date"

Para alterar o tema de cores (simples, base16, oceano), use o sinalizador -t.

tldr -t ocean

Você também pode mostrar um comando aleatório, com o sinalizador -r.

tldr -r   

Você pode ver uma lista completa de opções suportadas executando.

tldr -h

Você pode encontrar uma lista de todos os aplicativos clientes dedicados e suportados para diferentes plataformas na página wiki dos clientes TLDR.

É tudo por agora! As páginas TLDR são exemplos práticos resumidos de comandos fornecidos pela comunidade. Neste breve artigo, mostramos como instalar e usar páginas TLDR no Linux.

Use o formulário de feedback para compartilhar suas idéias sobre o TLDR ou compartilhe conosco quaisquer programas semelhantes disponíveis.