Simplificando o manual do terminal no Ubuntu 26.04
Dica publicada em Linux / Comandos
Simplificando o manual do terminal no Ubuntu 26.04
Introdução
Quem nunca precisou descompactar um arquivo.tar.gz ou lembrar de uma flag específica do find e acabou se perdendo nas centenas de linhas geradas pelo comando man?
Embora as man pages sejam bem completas, no dia a dia geralmente precisamos apenas da sintaxe mais comum de um comando.
É exatamente para resolver este problema de produtividade que existe o
tldr (sigla da expressão em inglês "Too Long; Didn't Read" - Muito longo; não li). Ele é um projeto comunitário que resume as páginas de manual em exemplos práticos, focados em cenários reais. Em vez de ler um documento técnico complexo, você recebe as 5 ou 6 formas mais utilizadas daquela ferramenta.No Ubuntu 26.04, esta ferramenta é o pacote
tealdeer. Um cliente para o tldr escrito na linguagem Rust, o que garante uma execução instantânea e um consumo mínimo de recursos.1. Instalação do Tealdeer no Ubuntu 26.04
A instalação é feita diretamente pelos repositórios oficiais do Ubuntu. Abra o seu terminal e utilize o APT para instalar o pacotetealdeer:sudo apt update
sudo apt install tealdeer
2. Atualizando o Cache Local
A arquitetura do tldr é desenhada para ser rápida e funcionar offline. Ele faz isso armazenando arquivos de texto (em formato Markdown) localmente no seu computador. Portanto, logo após a instalação, o primeiro passo obrigatório é baixar esse banco de dados para a sua máquina.Execute o comando de sincronização:
tldr --update
Obs.: é uma boa prática executar este comando periodicamente para garantir que você tenha as documentações e exemplos mais recentes baixados no seu sistema.
3. Como utilizar o TLDR na prática
O uso é extremamente intuitivo. Basta invocar o comandotldr seguido da ferramenta que você deseja consultar.Por exemplo, se você esqueceu como extrair um arquivo compactado com o utilitário
tar, basta executar:tldr tar
O terminal retornará uma saída colorida e bem formatada, explicando como criar um arquivo, como extrair, e quais flags usar (
-czf, -xzf, etc.). As variáveis que você precisa substituir (como caminhos de diretórios ou nomes de arquivos) ficam em destaque.Teste também com ferramentas que possuem muitas opções, como:
tldr ffmpegtldr dockertldr ip
4. Listando os comandos catalogados
Se você estiver curioso para saber o escopo da documentação armazenada no seu computador ou quiser descobrir comandos novos, o clientetealdeer possui um parâmetro nativo para listar todo o seu banco de dados.Para visualizar todos os comandos disponíveis no cache, utilize:
tldr --list
Isso retornará uma lista completa de todos os utilitários que possuem páginas de resumo no seu sistema.