TLDR - Leicht verständliche Handbuchseiten für Linux-Befehle
Eine der am häufigsten verwendeten und zuverlässigsten Methoden, um Hilfe unter Unix-ähnlichen Systemen zu erhalten, sind Handbuchseiten, die die Standarddokumentation für jedes Unix-ähnliche System darstellen und Online-Handbüchern für Programme, Funktionen, Bibliotheken, Systemaufrufe, formale Standards und Konventionen, Dateiformate und so weiter entsprechen.
Manpages leiden jedoch unter vielen Fehlern, einer davon ist, dass sie zu lang sind und manche Leute einfach nicht gerne zu viel Text auf dem Bildschirm lesen.
Die TLDR (steht für "Too Long; Didn't Read") ist ein von der Community betriebenes Projekt, das eine prägnante und vereinfachte Dokumentation für verschiedene Linux-Befehle bereitstellt.
TLDR zielt darauf ab, schnelle und praktische Beispiele für die Verwendung von Befehlen anzubieten, die es den Benutzern erleichtern, Befehle zu verstehen und zu verwenden, ohne sich in umfangreiche Handbücher oder langwierige Erklärungen vertiefen zu müssen.
Der Zugriff auf TLDR erfolgt in der Regel über die Befehlszeile mit dem Befehl "tldr", gefolgt vom Namen des Befehls, den Sie kennenlernen möchten.
$ tldr ls
TLDR ist ein Internet-Slang, was bedeutet, dass ein Beitrag, Artikel, Kommentar oder irgendetwas wie eine Handbuchseite zu lang war, und wer auch immer den Ausdruck verwendet hat, hat ihn aus diesem Grund nicht gelesen. Der Inhalt von TLDR-Seiten ist unter der freizügigen MIT-Lizenz frei verfügbar.
In diesem kurzen Artikel zeigen wir, wie Sie TLDR-Seiten unter Linux installieren und verwenden.
So installieren Sie TLDR-Seiten in Linux-Systemen
Um bequem auf TLDR-Seiten zugreifen zu können, müssen Sie einen der unterstützten Clients namens Node.js installieren, der der ursprüngliche Client für das tldr-pages-Projekt ist.
Um Node.js zu installieren, können Sie den Paketmanager verwenden, der für Ihre Distribution spezifisch ist.
$ sudo apt install nodejs npm [On Debian, Ubuntu and Mint]
sudo yum install nodejs npm [On RHEL/CentOS/Fedora and Rocky/AlmaLinux]
sudo emerge -a sys-apps/nodejs npm [On Gentoo Linux]
sudo apk add nodejs npm [On Alpine Linux]
sudo pacman -S nodejs npm [On Arch Linux]
sudo zypper install nodejs npm [On OpenSUSE]
Sobald Node.js und npm installiert sind, können Sie mit der Installation von TLDR fortfahren, indem Sie den Befehl npm wie gezeigt verwenden.
$ sudo npm install -g tldr
TLDR ist auch als Snap-Paket verfügbar, um es zu installieren und auszuführen.
$ sudo snap install tldr
Nach der Installation des TLDR-Clients können Sie die Handbuchseiten eines beliebigen Befehls anzeigen, z. B. des Befehls tar hier (Sie können hier jeden anderen Befehl verwenden):
$ tldr tar
Hier ist ein weiteres Beispiel für den Zugriff auf die zusammengefasste Manpage für den Befehl ls.
$ tldr ls
Um alle Befehle für die ausgewählte Plattform im Cache aufzulisten, verwenden Sie das Flag -l.
$ tldr -l
Um alle unterstützten Befehle im Cache aufzulisten, verwenden Sie das Flag -a.
$ tldr -a
Sie können den lokalen Cache aktualisieren oder löschen, indem Sie Folgendes ausführen.
$ tldr -u #update local cache
OR
tldr -c #clear local cache
Um Seiten mit Schlüsselwörtern zu durchsuchen, verwenden Sie z. B. die Optionen -s.
$ tldr -s "list of all files, sorted by modification date"
Um das Farbschema (simple, base16, ocean) zu ändern, verwenden Sie das Flag -t.
$ tldr -t ocean
Sie können auch einen zufälligen Befehl mit dem Flag -r anzeigen.
$ tldr -r
Sie können eine vollständige Liste der unterstützten Optionen anzeigen, indem Sie ausführen.
$ tldr -h
Eine Liste aller unterstützten und dedizierten Client-Anwendungen für verschiedene Plattformen finden Sie auf der TLDR-Client-Wiki-Seite.
Das war's fürs Erste! Die TLDR-Seiten sind zusammengefasste praktische Beispiele für Befehle, die von der Community bereitgestellt werden. In diesem kurzen Artikel haben wir gezeigt, wie man TLDR-Seiten unter Linux installiert und verwendet.
Verwenden Sie das Feedback-Formular, um Ihre Gedanken zu TLDR mitzuteilen, oder teilen Sie uns ähnliche Programme mit.