FRFAM.COM >> Famille >> Technologie &Innovation >> Informatique

Comment raccourcir les pages de manuel en explications lisibles sous Linux et macOS

Quand tout le reste échoue, lisez le manuel. Les utilisateurs de la ligne de commande sur Linux et Mac savent qu'ils peuvent taper "man" suivi d'un nom de commande pour voir une longue explication détaillée de cette commande. Ces pages de manuel sont utiles mais détaillées. Parfois, tout ce dont vous avez besoin est une explication courte et concise d'une commande pour vous rafraîchir la mémoire.

Voici un moyen simple d'obtenir des explications concises et pratiques sur les commandes utilisées sur la ligne de commande sous Linux et Mac. Il s'agit d'une application en ligne de commande appelée "tldr", après l'abréviation de "trop ​​long ; n'a pas lu". Le tl;dr l'abréviation est utilisée pour écrire ou demander une version abrégée du texte, ce qui est exactement ce que le tldr la commande le fait.

Installer tldr sur Ubuntu

Le tldr La commande sur Ubuntu n'est disponible dans aucun référentiel, il existe donc un moyen détourné de l'installer. Mais ce n'est pas difficile.

Tout d'abord, nous devons installer NodeJS et le Node Package Manager (npm). Appuyez sur Ctrl + Alt + T pour ouvrir le Terminal et tapez la commande suivante.

sudo apt install nodejs npm 

Ensuite, nous allons utiliser npm pour installer tldr . Saisissez :

sudo npm install -g tldr 

Vous devriez pouvoir utiliser tldr maintenant, mais vous pouvez voir une erreur indiquant "Aucun fichier ou répertoire de ce type" lorsque vous essayez.

Comment raccourcir les pages de manuel en explications lisibles sous Linux et macOS

Vous pouvez corriger cette erreur en créant un lien symbolique. Tapez la commande suivante.

sudo ln -s /usr/bin/nodejs /usr/bin/node 

Installer tldr sur macOS

Sur macOS, nous utiliserons Homebrew, le gestionnaire de packages pour macOS, pour installer tldr. Homebrew vous permet d'installer n'importe quel utilitaire de ligne de commande en quelques frappes. L'ajout de Cask à Homebrew vous permet également d'installer des applications de bureau, telles que Firefox et GIMP. La mise à jour des utilitaires de ligne de commande et des applications de bureau est facile avec Homebrew et Cask.

Homebrew n'est pas installé par défaut. Rendez-vous sur le site Web Homebrew et copiez la commande d'installation à partir de là. Nous ne l'avons pas inclus ici au cas où il changerait.

Pour installer Homebrew, ouvrez le Terminal depuis les utilitaires dossier dans les Applications dossier. Faites un clic droit à l'invite de la ligne de commande et sélectionnez Coller pour entrer la commande d'installation Homebrew que vous avez copiée. Appuyez sur Entrée et suivez les instructions telles qu'elles sont présentées.

Une fois Homebrew installé, tapez la commande suivante pour installer le tldr commande.

brew install tldr 

Maintenant, vous pouvez utiliser la commande tldr pour obtenir des explications courtes et concises sur les commandes.

Utilisez tldr pour découvrir rapidement comment utiliser une commande

Nous utiliserons la commande ls pour illustrer la différence entre l'utilisation de man et tldr. Les captures d'écran proviennent de Linux, mais cela fonctionne de la même manière sur macOS.

Tapez la commande suivante à l'invite.

man ls 

Vous verrez l'explication longue et détaillée de la commande ls qui s'applique aux pages. Utilisez les touches fléchées et les touches Page Up et Page Down pour parcourir la page de manuel de la commande ls.

Comment raccourcir les pages de manuel en explications lisibles sous Linux et macOS

Maintenant, tapez la commande suivante.

tldr ls 

Vous verrez une description beaucoup plus courte des utilisations les plus courantes de la commande ls. Notez que vous n'avez pas besoin de faire défiler les résultats, du moins beaucoup. Nous avons agrandi légèrement la fenêtre de notre terminal pour afficher tous les résultats en même temps.

Comment raccourcir les pages de manuel en explications lisibles sous Linux et macOS

Utiliser la version Web de tldr

Si vous ne voulez pas installer tldr, ou si vous rencontrez des difficultés pour le faire, il existe une excellente version Web de tldr utilitaire sur https://tldr.ostera.io/. Ils comprennent une brève explication sur la façon d'utiliser le site. C'est également pratique si vous êtes déjà dans un navigateur et que vous souhaitez rechercher rapidement une commande sans ouvrir de fenêtre de terminal.

Comment raccourcir les pages de manuel en explications lisibles sous Linux et macOS

Par exemple, tapez "ls" dans la zone de recherche en haut de la page. Les résultats s'affichent immédiatement. Vous trouverez peut-être cela encore plus facile à lire que les résultats de la commande tldr sur la ligne de commande.

Comment raccourcir les pages de manuel en explications lisibles sous Linux et macOS

Ils fournissent même un Modifier cette page sur Github lien en bas de la page pour chaque commande au cas où vous verriez des erreurs.

Vous pouvez également créer ou modifier des commandes sur le site Web TLDR Pages.

Comment raccourcir les pages de manuel en explications lisibles sous Linux et macOS

Besoin d'une copie hors ligne ? Téléchargez une version PDF des pages tldr, pour une utilisation ultérieure. Vous pouvez même installer un tldr app sur votre appareil Android [No Longer Available] ou iOS.

Les pages de manuel sont toujours utiles

Le tldr command est pratique pour apprendre les bases d'une commande. Mais il y a des paramètres de commande qui pourraient vous être utiles. Donc, si vous ne voyez pas ce que vous cherchez sur le tldr page pour une commande, vérifiez le man page, si la commande en a une.

Par exemple, le tldr page pour le ls La commande omet les paramètres utiles suivants. Les paramètres sont sensibles à la casse.

  • -R : Liste les sous-répertoires de manière récursive.
  • -X : Trier par ordre alphabétique des extensions de fichiers.
  • -d : Indiquez uniquement les répertoires, pas leur contenu.

Un autre exemple est le rm commande, qui supprime les fichiers et les répertoires. Avec un certain paramètre, il peut être utilisé pour effacer tout le contenu d'un répertoire spécifié. Soyez prudent avec cette commande car vous pouvez finir par supprimer des fichiers système critiques si elle n'est pas utilisée correctement.

  • -je : Demander une fois avant de supprimer plus de trois fichiers ou lors de la suppression récursive de fichiers. Ce paramètre est moins intrusif que -i , tout en vous protégeant contre la suppression accidentelle de fichiers que vous ne souhaitez pas supprimer.
  • -d : Supprimez les répertoires vides.

Alors que le tldr page pour le rm la commande liste le -r paramètre de suppression récursive d'un répertoire et de tous ses sous-répertoires, il n'explique pas que rm ne supprime pas les répertoires non vides par défaut. Vous devez utiliser -r ou -R pour supprimer récursivement les répertoires non vides.

Gagnez du temps avec la commande tldr

Le tldr La commande va droit au but avec de courtes explications et des exemples pratiques de commandes shell bash. Vous pouvez même trouver des explications concises pour certaines commandes intégrées qui ne sont plus disponibles en tant que man entrées, comme le cd commande.

Vous pouvez découvrir toutes les commandes intégrées disponibles dans le shell bash en tapant la commande suivante sur la ligne de commande.

man bash-builtins 

Vous pouvez également essayer le shell Fish, qui possède des fonctionnalités supplémentaires telles que les suggestions automatiques, les couleurs VGA et un langage de script inspiré des langages de programmation modernes tels que Python et Ruby.

Trouvez-vous les explications dans tldr plus faciles à comprendre ? Ou préférez-vous les explications complètes et détaillées sur les pages de manuel ? Partagez vos pensées et vos expériences avec nous dans les commentaires ci-dessous.


[]