TLDR, pages de manuel résumées par des exemples dans Ubuntu

À propos de TLDR

Dans le prochain article, nous allons jeter un œil aux pages TLDR. Ces acronymes signifient 'Trop long; N'a pas lu', proviennent d'Internet, où ils sont utilisés pour indiquer qu'un texte long, ou une partie de celui-ci, a été omis parce qu'il est trop long. L'application proposera sur les pages présentées des exemples pratiques de commandes fournies par la communauté. En général, ils ont simplifié la pages de manuel offrant de tels exemples, sur différents systèmes d'exploitation, y compris Gnu / Linux.

Comme le savent tous les utilisateurs de Gnu / Linux, l'un des moyens les plus utilisés et les plus fiables obtenir de l'aide sur les systèmes de type Unix est de recourir aux pages de manuel Les pages de manuel sont la documentation standard de chaque système de type Unix et correspondent aux manuels en ligne des programmes, fonctions, bibliothèques, appels système, normes et conventions formelles, formats de fichiers, etc.

L'un des problèmes que de nombreux utilisateurs rencontrent avec les pages de manuel est que beaucoup d'entre elles sont trop longues. Certains utilisateurs n'aiment tout simplement pas lire trop de texte à l'écran pour trouver la solution à un problème spécifique.

Comme j'ai déjà écrit des lignes ci-dessus, TLDR est un acronyme utilisé sur Internet pour dire qu'une publication, un article, un commentaire ou une page de manuel est trop long et quiconque l'a utilisé ne l'a pas lu pour cette raison. Grâce à cette application, nous retrouverons chacun des Commandes résumées par des exemples. Le contenu proposé par ces pages est ouvertement disponible sous la licence MIT.

Ensuite, nous allons voir comment nous pouvons installer et utiliser les pages TLDR dans Ubuntu. Mais avant de vous lancer dans l'installation, vous pouvez essayez une démo de ces pages. Vous pouvez également consulter le Version PDF, pour voir si c'est ce que vous recherchez.

Comment installer les pages TLDR dans Ubuntu

Pour installer ces pages, nous pourrons utiliser NodeJS et NPM ou son correspondant pack de pression.

Installer à l'aide de NodeJS et NPM

Pour cette installation, nous aurons besoin de Nodejs et NPM disponibles dans notre système d'exploitation.

Pour accéder facilement aux pages TLDR, vous devez installer l'un des clients pris en charge, qui est le client d'origine du projet tldr-pages. Nous pouvons l'installer depuis NPM en l'exécutant dans un terminal (Ctrl + Alt + T):

Installer les pages TLDR avec NPM

sudo npm install -g tldr

Installer à l'aide du package snap

TLDR est également disponible sous forme de package Snap. Pour l'installer dans un terminal (Ctrl + Alt + T) vous devrez exécuter la commande suivante:

Installez TLDR à l'aide du package snap

sudo snap install tldr

Utiliser TLDR

Après avoir installé le client TLDR, vous pouvez maintenant voir les pages de manuel de toute commande résumées par des exemples. Par exemple, la commande pwd, comme indiqué dans la capture d'écran suivante. Vous pouvez utiliser n'importe quelle autre commande:

Commande TLDR pwd

tldr pwd

Un autre exemple de page de manuel récapitulatif pour la commande ls, ce sera le suivant:

Commande TLDR ls

tldr ls

Mettre à jour ou effacer le cache local

Pour mettre à jour le cache local, il vous suffit d'utiliser la commande accompagnée du option -u:

Option TLDR -u

tldr -u

Si vous souhaitez vider le cache local, vous devez utiliser le option -c:

tldr -c

Afficher toutes les commandes

Pour lister toutes les commandes du cache de la plateforme choisie, utilisez simplement le option -l:

Commandes d'affichage TLDR avec l'option -l

tldr -l

Si nous voulons voir toutes les commandes admises dans le cache, nous devrons ajouter le option -a:

tldr -a

Pages de recherche

Pour rechercher des pages à l'aide de mots-clés, vous devez utiliser le option -s suivi des mots, en anglais, qui nous intéressent:

Option TLDR -s chaîne de recherche

tldr -s 'list of all files'

Voir une commande aléatoire

Une commande aléatoire peut également être affichée avec le option -r:

Option -r de commande aléatoire TLDR

tldr -r

Options prises en charge

Nous pourrons en voir un liste complète des options prises en charge fonctionnement:

Aide TLDR

tldr -h

Vous pouvez trouver une liste de toutes les applications clientes prises en charge et dédié à différentes plateformes, dans le Page Wiki Clients TLDR. Pour obtenir plus d'informations sur TLDR, vous pouvez consulter le site web du projet. Si vous êtes intéressé, vous pouvez en savoir plus sur ces types de pages dans le Article Wikipédia.


Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont marqués avec *

*

*

  1. Responsable des données: Miguel Ángel Gatón
  2. Finalité des données: Contrôle du SPAM, gestion des commentaires.
  3. Légitimation: votre consentement
  4. Communication des données: Les données ne seront pas communiquées à des tiers sauf obligation légale.
  5. Stockage des données: base de données hébergée par Occentus Networks (EU)
  6. Droits: à tout moment, vous pouvez limiter, récupérer et supprimer vos informations.