LESSPIPE.SH(1) Dienstprogramme fur Benutzer LESSPIPE.SH(1) BEZEICHNUNG lesspipe.sh - ein Filter fur Less UBERSICHT lesspipe.sh [DATEI[en]] BESCHREIBUNG Der Zweck von lesspipe.sh ist die Verbesserung der Ausgabe von less. Die Wahl der anzuwendenden Regeln zur Beeinflussung der Ausgabe basieren auf dem Inhalt der Datei. Die Dateiendung wird lediglich als letzter Anhaltspunkt berucksichtigt. lesspipe.sh wird ublicherweise als Eingabefilter fur less aufgerufen. Mit Hilfe dieses Filters zeigt less den unkomprimierten Inhalt komprimierter Dateien an (gzip, bzip2, compress, zstd, lz4, lzip, xz, lzma oder brotli). Bei Dateien, die Archive und Verzeichnisse enthalten (zum Beispiel die Formate tar, ar, zip, i7-zip, rar, jar, rpm, deb, ms-cabinet und iso), wird ein Inhaltsverzeichnis angezeigt. Viele andere Dateien werden fur die Anzeige neu formatiert. Diese umfassen pdf, dvi, markdown, die Formate der Burosuiten MS Office und Openoffice, NetCDF, matlab, html und Medienformate (Bild, Audio und Video). Dafur sind zusatzlich installierte Hilfsanwendungen erforderlich. Der Filter kann auch rekursiv bis zu einer Tiefe von 6 Vezeichnisebenen agieren und Dateien in Archiven unmittelbar entpacken und anzeigen. Hierbei zahlt ein Kompressionsalgorithmus als separate Ebene. Falls das Dienstprogramm file(1) Text mit einer Kodierung berichtet, die sich von der im Terminal verwendeten Kodierung unterscheidet, dann wird dieser Text mittels iconv(1) in die Standardkodierung umgewandelt. Dies setzt voraus, dass file die Dateikodierung korrekt ermitteln kann, was aber in einigen Situationen nicht gelingt. Sie konnen die Umwandlung unterdrucken, indem Sie einen Doppelpunkt an den Dateinamen anhangen. Wenn Sie die Programme git(1), vim(1) oder mutt(1) verwenden, konnen Sie lesspipe.sh zum Lesen von Nicht-Textdateien aktivieren. Dies ist im Wiki auf https://github.com/wofr06/lesspipe/wiki beschrieben. FILTERAKTIVIERUNG Der Filter wird von less aufgerufen, sofern die Umgebungsvariable LESSOPEN korrekt gesetzt ist. Fur die Ksh-artige Shells (bash, zsh) sollte der Befehl LESSOPEN="|lesspipe.sh %s"; export LESSOPEN den Filter fur less. Verwenden Sie den vollstandigen Pfad, falls sich lesspipe.sh nicht im Suchpfad befindet. Wenn Sie lesspipe.sh ohne Argumente aufrufen, wird der Befehl zum Setzen der Variable LESSOPEN angezeigt. Damit konnen Sie LESSOPEN sogar direkt setzen: eval `lesspipe.sh` (bash) oder lesspipe.sh|source /dev/stdin (zsh) Mit der wie vorstehend beschrieben gesetzten Umgebungsvariable zeigt less dann fur zahlreiche Dateiformate Informationen in Textform an. Der Filter wird normalerweise nicht aufgerufen, wenn die Eingabe aus einer Pipe an less ubergeben wird, wie in cat eine_Datei | less Wie in der Handbuchseite zu less beschrieben, konnen Sie die Filterung in einer Pipe dennoch aktivieren, wenn Sie der Variable LESSOPEN die Zeichen |- voranstellen. Die Zeichen || am Anfang der Umgebungsvariable LESSOPEN fur den Umgang mit leeren Dateien und Befehlsfehlern sind in dieser Version von lesspipe.sh nur teilweise implementiert. Ublicherweise werden bei fehlgeschlagenen Befehlen innerhalb von lesspipe.sh Fehlermeldungen angezeigt. Die nunmehr veraltete Variable LESS_ADVANCED_PREPROCESSOR bestimmte fruher, ob html, xml und perl pod als Textformate aufgefasst werden sollten oder nicht. Jetzt werden diese Formate immer interpretiert, ausser wenn ein Doppelpunkt an den Dateinamen angehangt ist. Falls die Dateiendung den genauen Dateityp angibt (html, xml, pod), kann die Ausgabe farbig dargestellt werden (siehe nachfolgend). Beispiel: less index.html:html Um informative Meldungen in der ersten Zeile der Filterausgabe zu unterdrucken, kann die Umgebungsvariable LESSQUIET auf einen nicht leeren Wert gesetzt werden. Um den Filter temporar auszuschalten, konnen Sie einen Doppelpunkt an den Dateinamen anhangen. Falls der Dateiname selbst einen Doppelpunkt enthalt, sollten Sie stattdessen ein Gleichheitszeichen verwenden. FARBIGE AUSGABE Der Filter ist in der Lage, Syntaxhervorhebung fur eine breite Auswahl an Dateitypen zu verwenden. Falls installiert, wird bat/batcat fur die farbige Darstellung der Ausgabe verwendet. Falls nicht, werden stattdessen pygmentize, source-highlight, code2color und vimcolor versucht. Fur bat/batcat wird das Thema auf ansi und der Stil auf plain gesetzt, welches der ungefilterten Ausgabe von less naher kommt. Diese Einstellungen konnen in ~/.config/bat/config oder den Umgebungsvariablen BAT_STYLE und BAT_THEME geandert werden. Aus diesen Einfarbungsprogrammen konnen Sie eines als Standard fur die farbige Darstellung festlegen, indem Sie die Umgebungsvariable LESSCOLORIZER auf dessen Namen setzen. Fur pygmentize und bat/batcat sind folgende Einstellungen erlaubt: LESSCOLORIZER='pygmentize -O style=foo' LESSCOLORIZER='bat --style=foo --theme=bar' Syntaxhervorhebung wird aktiviert, wenn die Umgebungsvariable LESS existiert und die Option -R enthalt oder less mit dieser Option aufgerufen wird. Das stellt sicher, dass Escape-Sequenzen in Farben umgewandelt werden und die Anzeige nicht entstellen. Die Verwendung der Option -r wird nicht empfohlen, da lange Zeilen in der Ausgabe das Bildschirmlayout verfalschen konnten. Die Syntaxhervorhebung kann durch Anhangen eines Doppelpunktes an den Dateinamen deaktiviert werden, falls die Ausgabe farbig war. Sollte fur die Syntaxhervorhebung die falsche Sprache gewahlt worden sein, kann eine andere durch Anhangen eines Doppelpunktes und der entsprechenden Endung an den Dateinamen erzwungen werden. In einer Pipe kann diese Methode nicht verwendet werden. Ein moglicher Ausweg ist das Hinzufugen eines letzten Arguments, das von lesspipe.sh ausgewertet wird. Ein einzelner Doppelpunkt (Deaktivierung der Filterung) oder :Erweiterung (Erzwingung einer bestimmten Sprache) ist beispielsweise moglich mit Befehl, der C-Code erzeugt | less - :c Wenn die Bedingungen fur Syntax-Hervorhebung erfullt sind, werden Auflistungen von Verzeichnis- und Tarball-Inhalten ebenfalls farbig dargestellt. Wenn less in anderen Programmen als Standardbrowser verwendet wird, kann die Wahl der Art der Einfarbung die Ausgabe jener Programme beeinflussen. Fur man, git und perldoc nimmt lesspipe.sh keine Filterung vor. UBERWACHEN ANWACHSENDER DATEIEN Sobald lesspipe.sh ein Programm zur Umwandlung der Eingabe aufruft, geht die Fahigkeit zum Uberwachen anwachsender Dateien (mit dem F-Befehl innerhalb von less) verloren. Dies ist aber ublicherweise fur Protokolldateien wie /var/log/syslog erwunscht. Um lesspipe.sh temporar abzuschalten, konnen Sie einen Doppelpunkt als letztes Argument fur less hinzufugen, wie in less /var/log/syslog : oder less kann mit dem Argument +F aufgerufen werden, welches dem Drucken der Taste F im Seitenanzeigeprogramm entspricht: less +F /var/log/syslog Das Anhangen eines Doppelpunkts an den Dateinamen funktioniert nicht, weil dann der Filter angewiesen werden musste, zumindest diesen Doppelpunkt zu entfernen und cat(1) fur die Originaldatei zu verwenden. Andererseits konnen nicht anwachsende Protokolldateien mittels ccze(1) farbig dargestellt werden. Die Erkennung als Protokolldatei ist schwierig, falls sie nicht die Endung .log hat, aber Sie konnen das Anhangen von :.log an den Dateinamen erzwingen, wie beispielsweise in less /var/log/syslog:.log FORTGESCHRITTENE VERWENDUNG Diese Version von lesspipe.sh ermoglicht Ihnen die Anzeige individueller Dateien, die in einem Dateiarchiv enthalten sind, welches selbst sogar in einem anderen Archiv enthalten sein kann. Die Notation fur die Betrachtung von Dateien in Archiven, die mehrere Dateien enthalten, ist wie folgt: less Archivdatei:enthaltene_Datei oder auch less Ubergeordnetes_Archiv:Archivdatei:enthaltene_Datei Um die letzte Datei in der Kette in einem Rohformat anzuzeigen, muss an den Dateinamen ein Doppelpunkt (:) angehangt werden. Falls diese bereits einen Doppelpunkt enthalt, muss ein Gleichheitszeichen (=) als alternatives Trennzeichen verwendet werden. Diese Methode zum Entpacken und Anzeigen von Dateien funktioniert wiederum nicht, wenn less in einer Ausgabe-Pipe aufgerufen wird und die Umgebungsvariable LESSOPEN mit den Zeichen |- beginnt. Wie auch fur die Syntaxhervorhebung, ist die Losung die Verwendung eines zweiten Arguments, das mit einem Doppelpunkt beginnt. Dann wurde der vorige Befehl folgendermassen lauten: cat Ubergeordnetes_Archiv | less - :Archiv:enthaltene_Datei VERVOLLSTANDIGUNGSMECHANISMUS FUR ARCHIVINHALTE Mit den bereitgestellten Dateien lesscomplete (fur zsh(1) und bash(1)), _less (fur zsh) und less_completion (fur bash) ist eine Tab-Vervollstandigung fur Dateien in Archiven moglich. Wenn Sie nach dem Namen einer Archivdatei einen Doppelpunkt (:) oder ein Gleichheitszeichen (=) eingeben und dann die Tabulatortaste drucken, wird die Vervollstandigung ausgelost. Dies funktioniert auch in verketteten Archiven. Die Dateien lesscomplete und less_completion mussen sich in einem der in $PATH aufgelisteten Verzeichnisse und die Funktion _less fur zsh(1) in einem in $fpath aufgelisteten Verzeichnis befinden. Das Skript less_completion muss innerhalb eines Bash-Initialisierungsskripts liegen, zum Beispiel in ~/.bashrc. Neue Verzeichnisse wie ~/scripts und ~/.fpath konnen mit folgenden Befehlen hinzugefugt werden: PATH=~/scripts:$PATH und fpath=(~/.fpath $fpath) BENUTZERDEFINIERTE FILTERUNG Das Filtern mit lesspipe.sh kann durch ein benutzerdefiniertes Programm ersetzt oder erweitert werden. Ein solches Programm muss entweder .lessfilter heissen (und sich im Home-Verzeichnis des Benutzers befinden) oder lessfilter heissen (und sich in einem in $PATH erwahnten Verzeichnis befinden). Es muss ausfuhrbar 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 lesspipe.sh verbleibt. Dieser Mechanismus kann dazu verwendet werden, dass Filtern fur neue Formate hinzuzufugen oder z.B. das Filtern fur bestimmte Dateitypen zu unterbinden. AUTOR Wolfgang Friebel FEHLER MELDEN Melden Sie Fehler an . COPYRIGHT Copyright (C) 2005-2023 Wolfgang Friebel Dies ist freie Software, in den Quellen finden Sie die Bedingungen zur Weitergabe. Es gibt KEINE Garantie, auch nicht fur die MARKTREIFE oder die TAUGLICHKEIT FUR EINEN BESTIMMTEN ZWECK. SIEHE AUCH less(1) Eine Beschreibung von lesspipe.sh finden Sie auch in der Datei README, die im Quellcode-Paket enthalten ist. UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von Mario Blattermann und Helge Kreutzmann erstellt. Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezuglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG ubernommen. Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Ubersetzer . lesspipe.sh Januar 2023 LESSPIPE.SH(1)