tldr

¿Qué son las páginas tldr?

El proyecto tldr-pages es una colección de páginas de ayuda mantenidas por la comunidad para herramientas de línea de comandos, que pretende ser un complemento más simple y accesible a las páginas de manual tradicionales.

Quizás seas nuevo en el mundo de la línea de comandos. ¿Quizás esté un poco oxidado o no siempre pueda recordar los argumentos de comandos como lsof o tar ?

Ciertamente no ayuda que, en el pasado, la primera opción explicada en man tar fuera:

$ man tar
...
-b blocksize
   Specify the block size, in 512-byte records, for tape drive I/O.
   As a rule, this argument is only needed when reading from or writing to tape drives,
   and usually not even then as the default block size of 20 records (10240 bytes) is very common.
...

Hay espacio para páginas de ayuda más sencillas y centradas en ejemplos prácticos. ¿Qué tal:

Este repositorio es solo eso: una colección cada vez mayor de ejemplos para las herramientas de línea de comandos más comunes de UNIX, Linux, macOS, FreeBSD, NetBSD, OpenBSD, SunOS, Android y Windows.

¿Cómo lo uso?

Consejo

Para navegar sin instalar un cliente en su computadora, consulte el cliente web en https://tldr.inbrowser.app (con soporte sin conexión mediante PWA).

Una forma popular y conveniente de acceder a estas páginas en su computadora es instalar el cliente oficial Node.js:

npm install -g tldr

Alternativamente, también puedes usar el cliente oficial de Python, que se puede instalar mediante pip3 (u otros administradores de paquetes):

pip3 install tldr

Los usuarios de Linux y Mac también pueden instalar el cliente Rust oficial usando Homebrew (u otros administradores de paquetes en otros sistemas operativos):

brew install tlrc

Luego tendrá acceso directo a ayuda simplificada y fácil de leer para comandos, como tar , a la que se puede acceder escribiendo tldr tar en lugar del estándar man tar .

Si no desea instalar ningún software, consulte la versión PDF.

Nota

Los archivos PDF para traducciones están disponibles para la mayoría de los idiomas. Puede encontrarlos en los activos de la versión más reciente.

También hay otros clientes proporcionados por la comunidad, tanto para la línea de comandos como para otras plataformas. Para obtener una lista completa de clientes, diríjase a nuestra Wiki.

¿Cómo contribuyo a tldr-pages?

¡Todas las contribuciones son bienvenidas!

Algunas formas de contribuir incluyen:

• Agregar su comando favorito que no está cubierto.
• Agregar ejemplos o mejorar el contenido de una página existente.
• Agregar páginas solicitadas de nuestros problemas con la etiqueta Se busca ayuda.
• Traducir páginas a diferentes idiomas.

Todas las páginas tldr están escritas en Markdown para que puedan editarse con bastante facilidad y los cambios se puedan enviar en solicitudes de extracción aquí usando Git en la línea de comandos o usando la interfaz web de GitHub.

Nos esforzamos por mantener una comunidad acogedora y colaborativa. Si es la primera vez que contribuyes, echa un vistazo a las pautas de contribución y ¡adelante!

Si desea contribuir con las traducciones, puede visitar https://lukwebsforge.github.io/tldri18n/ para ver el progreso general de todas las traducciones y qué traducciones faltan o están desactualizadas.

¡También puedes unirte a nosotros en la sala de chat de Matrix!

Proyectos similares

• Las páginas de interfaz de línea de comandos le permiten escribir páginas de ayuda estandarizadas para CLI, directorios y configuraciones.

• Cheat te permite crear y ver hojas de trucos interactivas en la línea de comandos. Fue diseñado para ayudar a recordar a los administradores de sistemas Unix las opciones de los comandos que utilizan con frecuencia, pero no con la suficiente frecuencia como para recordarlos.

• Cheat.sh Agrega hojas de trucos de múltiples fuentes (incluidas páginas tldr) en una interfaz unificada.

• Las hojas de trucos de devhints Rico no se centran solo en la línea de comandos e incluyen una gran cantidad de otras hojas de trucos relacionadas con la programación.

• por ejemplo, proporciona ejemplos detallados con explicaciones en la línea de comandos. Los ejemplos provienen del repositorio, pero eg admite la visualización de ejemplos y comandos personalizados junto con los valores predeterminados.

• kb es un administrador de base de conocimientos de línea de comandos minimalista. kb se puede utilizar para organizar sus notas y hojas de trucos de una manera minimalista y limpia. También admite archivos que no son de texto.

• navi es una herramienta de hoja de referencia interactiva que le permite navegar a través de ejemplos específicos o completar comandos sobre la marcha.

• bropages (en desuso) son un complemento altamente legible de las páginas de manual. Muestra ejemplos concisos y de casos comunes de comandos de Unix. Los ejemplos los envía la base de usuarios y se pueden votar a favor o en contra; las mejores entradas son las que la gente ve primero cuando busca un comando.

¿Qué significa "tldr"?

TL;DR significa "Demasiado largo; No lo leí". Se originó como jerga de Internet, donde se utiliza para indicar que un texto largo (o partes de él) se ha omitido por ser demasiado largo. Lea más en el artículo de How-To Geek.