TLDR: páginas de manual fáciles de entender para todos los usuarios de Linux


Una de las formas más utilizadas y fiables de obtener ayuda en sistemas similares a Unix es a través de las páginas de manual. Las páginas de manual son la documentación estándar para todos los sistemas similares a Unix y corresponden a manuales en línea para programas, funciones, bibliotecas, llamadas al sistema, estándares y convenciones formales, formatos de archivo, etc. Sin embargo, las páginas de manual sufren muchas fallas, una de las cuales es que son demasiado largas y a algunas personas simplemente no les gusta leer demasiado texto en la pantalla.

Las páginas TLDR (siglas de "Too Long; Didn’t Read") son ejemplos prácticos resumidos de uso de comandos en diferentes sistemas operativos, incluido Linux. Simplifican las páginas de manual ofreciendo ejemplos prácticos.

TLDR es una jerga de Internet, lo que significa que una publicación, artículo, comentario o cualquier cosa, como una página de manual, era demasiado larga, y quienquiera que haya usado la frase no la leyó por ese motivo. El contenido de las páginas TLDR está disponible abiertamente bajo la licencia MIT permisiva.

En este breve artículo, mostraremos cómo instalar y usar páginas TLDR en Linux.

  1. Instale la última versión de Nodejs y NPM en sistemas Linux

Antes de la instalación, puede probar la demostración en vivo de TLDR.

Cómo instalar páginas TLDR en sistemas Linux

Para acceder cómodamente a las páginas TLDR, debe instalar uno de los clientes compatibles llamado Node.js, que es el cliente original del proyecto tldr-pages. Podemos instalarlo desde NPM ejecutando.

$ sudo npm install -g tldr

TLDR también está disponible como paquete Snap, para instalarlo, ejecutar.

$ sudo snap install tldr

Después de instalar el cliente TLDR, puede ver las páginas de manual de cualquier comando, por ejemplo, el comando tar aquí (puede usar cualquier otro comando aquí):

$ tldr tar

Aquí hay otro ejemplo de cómo acceder a la página de manual resumida para el comando ls.

$ tldr ls

Para enumerar todos los comandos para la plataforma elegida en la caché, use el indicador -l .

$ tldr -l 

Para enumerar todos los comandos admitidos en la caché, use la marca -a .

$ tldr -a

Puede actualizar o borrar la caché local ejecutando.

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

Para buscar páginas usando palabras clave, use las opciones -s , por ejemplo.

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

Para cambiar el tema de color (simple, base16, océano), use la bandera -t .

$ tldr -t ocean

También puede mostrar un comando aleatorio, con el indicador -r .

$ tldr -r   

Puede ver una lista completa de opciones compatibles ejecutando.

$ tldr -h

Nota: Puede encontrar una lista de todas las aplicaciones de cliente dedicadas y compatibles para diferentes plataformas, en la página wiki de clientes de TLDR.

Página de inicio del proyecto TLDR: https://tldr.sh/

¡Eso es todo por ahora! Las páginas de TLDR son ejemplos prácticos resumidos de comandos proporcionados por la comunidad. En este breve artículo, mostramos cómo instalar y usar páginas TLDR en Linux. Utilice el formulario de comentarios para compartir sus pensamientos sobre TLDR o comparta con nosotros cualquier programa similar que exista.