.\" -*- coding: UTF-8 -*- .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH LESSPIPE.SH 1 "April 2026" lesspipe.sh "Dienstprogramme für Benutzer" .SH BEZEICHNUNG lesspipe.sh \- ein Filter für Less .SH ÜBERSICHT \fBlesspipe.sh\fP [\fIDATEI[en]\fP] … .SH BESCHREIBUNG .PP Der Zweck von \fBlesspipe.sh\fP ist die Verbesserung der Ausgabe von \fBless\fP. Die Wahl der anzuwendenden Regeln zur Beeinflussung der Ausgabe basieren auf dem Inhalt der Datei. Die Dateiendung wird lediglich als letzter Anhaltspunkt berücksichtigt. \fBlesspipe.sh\fP wird üblicherweise als Eingabefilter für \fBless\fP aufgerufen. .PP Mit Hilfe dieses Filters zeigt \fBless\fP den unkomprimierten Inhalt komprimierter Dateien an (\fIgzip\fP, \fIbzip2\fP, \fIcompress\fP, \fIzstd\fP, \fIlz4\fP, \fIlzip\fP, \fIxz\fP, \fIlzma\fP, \fIzlib\fP oder \fIbrotli\fP). Bei Dateien, die Archive und Verzeichnisse enthalten (zum Beispiel die Formate \fItar\fP, \fIar\fP, \fIzip\fP, \fI7\-zip\fP, \fIrar\fP, \fIjar\fP, \fIcpio\fP, \fIrpm\fP, \fIdeb\fP, \fIms\-cabinet\fP, \fIiso\fP, \fIdmg\fP, \fIappimage\fP und \fIsnap\fP), wird ein Inhaltsverzeichnis angezeigt. Viele andere Dateien werden für die Anzeige neu formatiert. Diese umfassen \fIpdf\fP, \fIdvi\fP, \fImarkdown\fP, die Formate der Bürosuiten \fIMS Office\fP und \fIOpenoffice\fP, \fINetCDF\fP, \fImatlab\fP, \fIdevice tree blob\fP, \fIhtml\fP, \fIxml\fP und \fIMedienformate\fP (Bild, Audio und Video). Dafür sind zusätzlich installierte Hilfsanwendungen erforderlich. .PP Der Filter kann auch rekursiv bis zu einer Tiefe von 6 Verzeichnisebenen agieren und Dateien in Archiven unmittelbar entpacken und anzeigen. Hierbei zählt ein Kompressionsalgorithmus als separate Ebene. .PP Falls das Dienstprogramm \fBfile\fP(1) Text mit einer Kodierung berichtet, die sich von der im Terminal verwendeten Kodierung unterscheidet, dann wird dieser Text mittels \fBiconv\fP(1) in die Standardkodierung umgewandelt. Dies setzt voraus, dass \fBfile\fP(1) die Dateikodierung korrekt ermitteln kann, was aber in einigen Situationen nicht gelingt. Sie können die Umwandlung unterdrücken, indem Sie einen Doppelpunkt an den Dateinamen anhängen. .PP Wenn Sie die Programme \fBgit\fP(1), \fBvim\fP(1) oder \fBmutt\fP(1) verwenden, können Sie \fBlesspipe.sh\fP zum Lesen von Nicht\-Textdateien aktivieren. Dies ist im Wiki auf \fIhttps://github.com/wofr06/lesspipe/wiki\fP beschrieben. .SH FILTERAKTIVIERUNG Der Filter wird von \fBless\fP(1) aufgerufen, sofern die Umgebungsvariable \fBLESSOPEN\fP korrekt gesetzt ist. Für die Ksh\-artige Shells (\fBbash\fP(1), \fBzsh\fP(1)) sollte der Befehl .RS \fILESSOPEN="|lesspipe.sh %s"; export LESSOPEN\fP .RE den Filter für \fBless\fP(1). Verwenden Sie den vollständigen Pfad, falls sich \fBlesspipe.sh\fP nicht im Suchpfad befindet. Wenn Sie \fBlesspipe.sh\fP ohne Argumente aufrufen, wird der Befehl zum Setzen der Variable \fBLESSOPEN\fP angezeigt. Damit können Sie \fBLESSOPEN\fP sogar direkt setzen: .EX .RS \fIeval `lesspipe.sh`\fP (bash) oder \fIlesspipe.sh|source /dev/stdin\fP (zsh) .RE .EE Die obigen Befehle funktionieren nur in der beschriebenen Art und Weise, falls der Dateiname \fBlesspipe.sh\fP lautet. Falls er unter einem anderen Namen installiert ist, dann wird der Aufruf ohne Argument als Filter mit gesetztem \fBLESSQUIET\fP funktionieren und die Eingabe wird von STDIN erwartet. .PP Mit der wie vorstehend beschrieben gesetzten Umgebungsvariable zeigt \fBless\fP(1) dann für zahlreiche Dateiformate Informationen in Textform an. .PP Der Filter wird normalerweise nicht aufgerufen, wenn die Eingabe aus einer Pipe an \fBless\fP(1) übergeben wird, wie in .RS \fIcat eine_Datei | less\fP .RE Wie in der Handbuchseite zu \fBless\fP(1) beschrieben, können Sie die Filterung in einer Pipe dennoch aktivieren, wenn Sie der Variable \fBLESSOPEN\fP die Zeichen \fI|\-\fP voranstellen. .PP Falls Befehle innerhalb von \fBlesspipe.sh\fP fehlschlagen, werden in einigen Fällen Fehlermeldungen angezeigt. Dies wird als fehlerhaftes Verhalten betrachtet und sollte berichtet werden. .PP Um informative Meldungen in der ersten Zeile der Filterausgabe zu unterdrücken, kann die Umgebungsvariable \fBLESSQUIET\fP auf einen nicht leeren Wert gesetzt werden. .PP Um den Filter temporär auszuschalten, können Sie einen Doppelpunkt an den Dateinamen anhängen. Falls der Dateiname selbst einen Doppelpunkt enthält, sollten Sie stattdessen ein Gleichheitszeichen verwenden. .SH "HTML\-, XML\- und Perl\-POD\-Dateien" Dateien im Format \fIhtml\fP und \fIperl pod\fP werden immer dargestellt. Manchmal sollen stattdessen allerdings die ursprünglichen Inhalte der Datei dargestellt werden. Wie bereits erwwähnt, kann dies durch Anhängen eines Doppelpunktes an den Dateinamen erreicht werden. Falls der korrekte Dateityp (\fIhtml\fP, \fIpod\fP) folgt, kann die Ausgabe farbig dargestellt weden (siehe auch den nachfolgenden Abschnitt). .PP .RS Beispiel: \fBless\fP \fIindex.html:html\fP .RE .PP Falls das Programm \fBxmq\fP installiert ist, dann wird \fIxml\fP anders dargestellt, so dass die XML\-Struktur besser erkennbar ist. Eine ähnliche Darstellung für \fIhtml\fP\-Inhalte mittels \fIxmq\fP wird durch Anhängen eines Doppelpunktes an den Dateinamen erreicht. Um die ursprünglichen HTML\-Dateiinhalte zu erhalten, werden in diesem Fall zwei Doppelpunkte benötigt. .SH "FARBIGE AUSGABE" Der Filter ist in der Lage, Syntaxhervorhebung für eine breite Auswahl an Dateitypen zu verwenden. Falls installiert, wird \fInvimpager\fP für die farbige Darstellung der Ausgabe verwendet. Falls nicht, werden stattdessen \fIpygmentize\fP, \fIsource\-highlight\fP, \fIvimcolor\fP und \fIcode2color\fP versucht. Für \fIbat\fP/\fIbatcat\fP wird das Thema auf \fIansi\fP und der Stil auf \fIplain\fP gesetzt, welches der ungefilterten Ausgabe von \fBless\fP näher kommt. Diese Einstellungen können in \fI~/.config/bat/config\fP oder den Umgebungsvariablen \fBBAT_STYLE\fP und \fBBAT_THEME\fP geändert werden. .PP Der Inhalt der Protokolldateien kann eingefärbt werden, falls das Programm \fBtspin\fP(1) installiert ist und der Zeichenkette »:log« angehängt wird oder die Dateierweiterung »log« lautet. .PP Aus diesen Einfärbungsprogrammen können Sie eines als Standard für die farbige Darstellung festlegen, indem Sie die Umgebungsvariable \fBLESSCOLORIZER\fP auf dessen Namen setzen. Für \fBpygmentize\fP(1) und \fIbat\fP/\fIbatcat\fP sind folgende Einstellungen erlaubt: .EX .RS \fILESSCOLORIZER='pygmentize \-O style=foo' # \-P auch erlaubt\fP \fILESSCOLORIZER='bat \-\-style=foo \-\-theme=bar' # Vorgabe: theme=ansi, style=plain\fP .RE .EE Syntaxhervorhebung wird aktiviert, wenn die Umgebungsvariable \fBLESS\fP existiert und die Option \fB\-R\fP enthält oder \fBless\fP(1) mit dieser Option aufgerufen wird. Das stellt sicher, dass Escape\-Sequenzen in Farben umgewandelt werden und die Anzeige nicht entstellen. Die Verwendung der Option \fB\-r\fP wird nicht empfohlen, da lange Zeilen in der Ausgabe das Bildschirmlayout verfälschen könnten. .PP Die Syntaxhervorhebung kann durch Anhängen eines Doppelpunktes an den Dateinamen deaktiviert werden, falls die Ausgabe farbig war. Sollte für die Syntaxhervorhebung die falsche Sprache gewählt worden sein, kann eine andere durch Anhängen eines Doppelpunktes und der entsprechenden Endung an den Dateinamen erzwungen werden. Die Liste der Endungen und unterstützten Sprachen kann mittels folgenden Einfärbe\-Befehlen angezeigt werden: .EX .RS \fIbat \-\-list\-languages\fP \fIbatcat \-\-list\-languages\fP \fIpygmentize \-L lexers\fP \fIsource\-highlight \-\-lang\-list\fP \fIcode2color \-h\fP \fIvimcolor \-L (both for vimcolor and nvimpager)\fP .RE .EE .PP In einer Pipe kann diese Methode nicht verwendet werden. Ein möglicher Ausweg ist das Hinzufügen eines letzten Arguments, das von \fBlesspipe.sh\fP ausgewertet wird. Ein einzelner Doppelpunkt (Deaktivierung der Filterung) oder \fI:Erweiterung\fP (Erzwingung einer bestimmten Sprache) ist beispielsweise möglich mit .RS \fIBefehl, der C\-Code erzeugt | less \- :c\fP .RE .PP Wenn die Bedingungen für Syntax\-Hervorhebung erfüllt sind, werden Auflistungen von Verzeichnis\- und Tar\-Inhalten ebenfalls farbig dargestellt. .PP Da \fBless\fP(1) in anderen Programmen (z.B. \fBman\fP(1), \fBgit\fP(1) und \fBperldoc\fP(1)) als Standardbrowser verwendet wird, kann \fBlesspipe.sh\fP beteiligt sein und die Ausgabe dieser Programme verändern. .SH "ÜBERWACHEN ANWACHSENDER DATEIEN" Die Fähigkeit, größer werdene Dateien zu beobachten (normalerweise für Protokolldateien wie Syslog erwünscht) (mittels des Befehls \fBF\fP innerhalb von \fBless\fP(1) oder dem Aufruf von \fBless\fP(1) mit der Option \fB+F\fP) könnte verloren gehen, falls \fBlesspipe.sh\fP die Eingabe in einer temporären Datei für die weitere Bearbeitung speichert. Dies kann korrigiert werden, in dem ein Doppelpunkt als letztes Argument für \fBless\fP wie beispielsweise folgt angegeben wird: .RS \fBless\fP\fI /var/log/syslog\fP: .RE Oder falls LESSOPEN mit |\- beginnt und \fBless\fP(1) in einer Pipe aufgerufen wird. .RS \fBcat\fP\fI /var/log/syslog | less +F \- :\fP .RE .SH "FORTGESCHRITTENE VERWENDUNG" Diese Version von \fBlesspipe.sh\fP ermöglicht Ihnen die Anzeige individueller Dateien, die in einem Dateiarchiv enthalten sind, welches selbst sogar in einem anderen Archiv enthalten sein kann. .PP Die Notation für die Betrachtung von Dateien in Archiven, die mehrere Dateien enthalten, ist wie folgt: .RS \fBless\fP \fIArchivdatei\fP:\fIenthaltene_Datei\fP .RE oder auch .RS \fBless\fP \fIÜbergeordnetes_Archiv\fP:\fIArchivdatei\fP:\fIenthaltene_Datei\fP .RE Um die letzte Datei in der Kette in einem Rohformat anzuzeigen, muss an den Dateinamen ein Doppelpunkt (\fI:\fP) angehängt werden. Falls diese bereits einen Doppelpunkt enthält, muss ein Gleichheitszeichen (\fI=\fP) als alternatives Trennzeichen verwendet werden. .PP Diese Methode zum Entpacken und Anzeigen von Dateien funktioniert wiederum nicht, wenn \fBless\fP in einer Ausgabe\-Pipe aufgerufen wird und die Umgebungsvariable \fBLESSOPEN\fP mit den Zeichen \fB|\-\fP beginnt. Wie auch für die Syntaxhervorhebung, ist die Lösung die Verwendung eines zweiten Arguments, das mit einem Doppelpunkt beginnt. Dann würde der vorige Befehl folgendermaßen lauten: .RS \fBcat \fP\fIÜbergeordnetes_Archiv\fP\fB | less \- :\fP\fIArchiv\fP\fB:\fP\fIenthaltene_Datei\fP .RE .PP .SH "VERVOLLSTÄNDIGUNGSMECHANISMUS FÜR ARCHIVINHALTE" Mit der bereitgestellten Datei \fIlesscomplete\fP (für \fBzsh\fP(1) und \fBbash\fP(1)), \fI_less\fP (für \fBzsh\fP) und \fIless\fP (für \fBbash\fP), die während der Installation erstellt werden, ist eine Tab\-Vervollständigung für Dateien in Archiven möglich. Wenn Sie nach dem Namen einer Archivdatei einen Doppelpunkt (:) oder ein Gleichheitszeichen (=) eingeben und dann die Tabulatortaste drücken, wird die Vervollständigung ausgelöst. Dies funktioniert auch in verketteten Archiven. Die für den Vervollständigungsalgorithmus benötigten Dateien werden in Verzeichnissen installiert, die den Auswahlen während der Installation (Konfigurationsskript) entsprechen. Die Dateien \fIlesscomplete\fP muss sich in einem der in \fB$PATH\fP aufgelisteten Verzeichnisse und die Funktion \fI_less\fP für \fBzsh\fP(1) in einem in \fB$fpath\fP aufgelisteten Verzeichnis befinden. Die Datei \fIless\fP mit Vervollständigungsanweisungen für \fBbash\fP(1) muss innerhalb eines Bash\-Initialisierungsskripts eingelesen werden, zum Beispiel in \fI~/.bashrc\fP. Neue Verzeichnisse wie \fI~/scripts\fP und \fI~/.fpath\fP (für \fBzsh\fP(1)) können mit folgenden Befehlen hinzugefügt werden: .RS \fBPATH\fP=\fI~/scripts:$PATH\fP # (lesspipe.sh, less) und \fBfpath\fP=\fI(~/.fpath $fpath)\fP # (_less, nur zsh) .RE .PP In \fBzsh\fP(1) muss \fIcompinit\fP aufgerufen werden und die Option »menucomplete« muss gesetzt werden, falls das noch nicht bereits passiert ist. Dies kann mit folgenden Befehlen erreicht werden: .EX .RS \fIautoload compinit\fP \fIcompinit \-Uz\fP \fIsetopt menucomplete\fP .RE .EE .PP Für \fBbash\fP muss \fIbash\-completion\fP (normalerweise ein Paket mit diesen Namen) installiert werden. .SH "BENUTZERDEFINIERTE FILTERUNG" Das Filtern mit \fBlesspipe.sh\fP kann durch ein benutzerdefiniertes Programm ersetzt oder erweitert werden. Ein solches Programm muss entweder \&\fB.lessfilter\fP heißen (und sich im Home\-Verzeichnis des Benutzers befinden) oder \fBlessfilter\fP heißen (und sich in einem in \fB$PATH\fP erwähnten Verzeichnis befinden). Es muss ausführbar sein und muss sich mit einem Exit\-Code 0 beenden, falls das Filtern innerhalb des Skriptes erfolgte. Andernfalls bedeutet ein von Null verschiedener Exit\-Code, dass das Filtern bei \fBlesspipe.sh\fP verbleibt. .PP Dieser Mechanismus kann dazu verwendet werden, dass Filtern für neue Formate hinzuzufügen oder z.B. das Filtern für bestimmte Dateitypen zu unterbinden. Beispielsweise könnte eine \fI.lessfilter\fP folgendermaßen aussehen: .EX \fI#!/usr/bin/env bash\fP \fIcase $1 in\fP \fI*.md|*.MD|*.mkd|*.markdown|*.rst)\fP \fI# falls das Python\-Modul rich.markdown nicht gefunden wird, dann\fP \fI# ist der Exit\-Code nicht Null und lesspipe.sh wird abgebrochen\fP \fIpython3 \-m rich.markdown \-c $1 ;;\fP \fI*.html|*.htm)\fP \fI# rufen Sie Ihren Lieblings\-HTML\-Verschöner auf, »cat \-b« ist nur ein langweiliges Beispiel\fP \fIcat \-b $1 ;;\fP \fI*)\fP \fIexit 1;;\fP \fIesac\fP .EE .SH AUTOR Wolfgang Friebel .SH "FEHLER MELDEN" Melden Sie Fehler an . .SH COPYRIGHT Copyright \(co 2005\-2026 Wolfgang Friebel .br Dies ist freie Software, in den Quellen finden Sie die Bedingungen zur Weitergabe. Es gibt KEINE Garantie, auch nicht für die MARKTREIFE oder die TAUGLICHKEIT FÜR EINEN BESTIMMTEN ZWECK. .SH "SIEHE AUCH" \fBless\fP(1) .PP Eine Beschreibung von \fBlesspipe.sh\fP finden Sie auch in der Datei README, die im Quellcode\-Paket enthalten ist. .PP .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Mario Blättermann und Helge Kreutzmann erstellt. .PP Diese Übersetzung ist Freie Dokumentation; lesen Sie die .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen. .PP Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die .MT debian-l10n-german@lists.debian.org Mailingliste der Übersetzer .ME .