LESSPIPE.SH(1)                Comenzi utilizator                LESSPIPE.SH(1)

NUME
       lesspipe.sh - un filtru pentru less

SINOPSIS
       lesspipe.sh [FI<?>IER[e]]...

DESCRIERE
       Scopul lui lesspipe.sh este de a imbunata<?>i rezultatul lui less.
       Alegerea regulilor care urmeaza sa fie aplicate pentru a modifica
       rezultatul se bazeaza pe con<?>inutul fi<?>ierului. Extensia
       fi<?>ierului este respectata doar in ultima instan<?>a. De obicei,
       lesspipe.sh este apelat ca un filtru de intrare pentru less.

       Cu ajutorul acestui filtru, less va afi<?>a con<?>inutul necomprimat al
       fi<?>ierelor comprimate (gzip, bzip2, compress, zstd, lz4, lzip, xz,
       lzma, zlib sau brotli). Pentru fi<?>ierele care con<?>in arhive <?>i
       directoare (de exemplu, formatele tar, ar, zip, 7-zip, rar, jar, cpio,
       rpm, deb, ms-cabinet, iso, dmg, appimage <?>i snap), se va afi<?>a un
       tabel de con<?>inut. Multe alte fi<?>iere vor fi reformatate pentru
       afi<?>are. Sunt incluse formatele pdf, dvi, markdown, suite Office (MS
       <?>i Openoffice), NetCDF, matlab, device tree blob, html <?>i media
       (imagine, audio <?>i video). Acesta necesita instalarea unor programe
       ajutatoare.

       De asemenea, filtrul poate fi aplicat in mod recursiv pentru a extrage
       <?>i afi<?>a din mers fi<?>ierele din arhive. Acest lucru
       func<?>ioneaza pana la o adancime de 6, unde aplicarea unui algoritm de
       decomprimare conteaza ca un nivel separat.

       Daca instrumentufile raporteaza un text cu o codificare diferita de cea
       utilizata in terminal, atunci textul va fi transformat folosind iconv
       in codificarea implicita. Acest lucru presupune ca instrumentul file
       ob<?>ine codificarea corecta a fi<?>ierului, ceea ce poate fi gre<?>it
       in anumite situa<?>ii. Daca se adauga doua puncte ,,:" la numele
       fi<?>ierului, conversia este suprimata.

       Atunci cand se utilizeaza programele git, vim sau mutt, acestea pot fi
       activate pentru a citi fi<?>iere care nu sunt de tip text, utilizand
       lesspipe.sh. Acest lucru este descris in Wiki la adresa
       https://github.com/wofr06/lesspipe/wiki.

ACTIVAREA FILTRULUI
       Filtrul este apelat din less cu condi<?>ia ca variabila de mediu
       LESSOPEN sa fie definita corespunzator. In cazul shell-urilor de tip
       ksh (bash, zsh), comanda
              LESSOPEN="|lesspipe.sh %s"; export LESSOPEN
       activeaza filtrul pentru <<less>>. Utiliza<?>i ruta complet calificata,
       daca lesspipe.sh nu se afla in ruta de cautare. Comanda pentru a defini
       LESSOPEN poate fi, de asemenea, afi<?>ata prin apelarea lesspipe.sh
       fara argumente. Aceasta poate fi utilizata chiar <?>i pentru a defini
       direct LESSOPEN:
              eval `lesspipe.sh`
              (bash) or
              lesspipe.sh|source /dev/stdin
              (zsh)
       Comenzile de mai sus func<?>ioneaza numai in modul descris daca numele
       fi<?>ierului este lesspipe.sh. Daca acesta este instalat sub un nume
       diferit, atunci apelarea fara un argument va func<?>iona ca un filtru
       cu fanionul LESSQUIET activat <?>i a<?>teptand intrare de la STDIN.

       Dupa ce a<?>i definit variabila de mediu in modul descris mai sus, less
       va afi<?>a informa<?>ii textuale pentru o gama larga de formate de
       fi<?>iere.

       In mod normal, filtrul nu este apelat daca intrarea este direc<?>ionata
       catre <<less>> ca in
              cat somefile | less
       A<?>a cum este descris in pagina de manual a <<less>>, filtrarea intr-o
       conducta poate fi totu<?>i for<?>ata prin inceperea LESSOPEN cu
       caracterele |-.

       Daca comenzile din lesspipe.sh e<?>ueaza, in unele cazuri sunt
       afi<?>ate mesaje de eroare. Acest lucru este considerat un comportament
       defectuos <?>i trebuie raportat.

       Pentru a suprima mesajele informale din prima linie de ie<?>ire a
       filtrului, variabila ENV LESSQUIET poate fi fixata la o valoare nevida.

       Pentru a dezactiva temporar filtrul, se pot adauga doua puncte la
       numele fi<?>ierului ,,:". In cazul in care numele fi<?>ierului
       con<?>ine doua puncte, in locul acestora trebuie folosit un semn egal.

Fi<?>iere HTML, XML <?>i Perl POD
       Fi<?>ierele in format html<?>i perl pod sunt intotdeauna interpretate.
       Cu toate acestea, uneori con<?>inutul original al fi<?>ierului ar
       trebui sa fie vizualizat in schimb. Dupa cum s-a men<?>ionat anterior,
       acest lucru poate fi realizat prin adaugarea de doua puncte (,,:") la
       numele fi<?>ierului. Daca urmeaza tipul corect de fi<?>ier (html, pod),
       ie<?>irea poate fi colorata (a se vedea <?>i sec<?>iunea de mai jos).

              Exemplu: less index.html:html

       Daca este instalat binarul xmq, atunci xml este redat diferit, astfel
       incat structura xml sa fie mai bine recunoscuta. O afi<?>are similara
       pentru con<?>inutul html folosind xmq se ob<?>ine prin adaugarea a doua
       puncte (,,:") la numele fi<?>ierului. Pentru a ob<?>ine con<?>inutul
       original al fi<?>ierului html, sunt necesare de doua ori doua puncte in
       acest caz (,,::").

COLORAREA IE<?>IRII
       Filtrul este capabil sa eviden<?>ieze sintaxa pentru o mare varietate
       de tipuri de fi<?>iere. Daca este instalat, nvimpager este utilizat
       pentru colorarea ie<?>irii. Daca nu, sunt incercate pe rand bat/batcat,
       pygmentize, source-highlight, vimcolor <?>i code2color. Pentru
       bat/batcat, tema este stabilita la ansi <?>i stilul este stabilit la
       plain, ceea ce se apropie de rezultatul nefiltrat al less. Aceste
       op<?>iuni pot fi modificate in ~/.config/bat/config sau prin
       variabilele de mediu BAT_STYLE <?>i BAT_THEME.

       Con<?>inutul fi<?>ierelor jurnal poate fi afi<?>at in culori daca
       programul tspin este instalat <?>i daca la numele fi<?>ierului se
       adauga <?>irul ,,:log" sau daca extensia fi<?>ierului este ,,log".

       Dintre programele de colorare, se poate for<?>a utilizarea unuia dintre
       ele prin definirea variabilei ENV LESSCOLORIZER la numele programului
       de colorare. Pentru pygmentize <?>i bat/batcat sunt permise configurari
       de op<?>iuni restranse, dupa cum urmeaza:
              LESSCOLORIZER='pygmentize -O style=foo' # -P este permisa, de asemenea
              LESSCOLORIZER='bat --style=foo --theme=bar' # implicit: theme=ansi, style=plain
       Eviden<?>ierea sintaxei este activata daca variabila de mediu LESS
       exista <?>i con<?>ine op<?>iunea -R sau daca <<less>> este apelat cu
       aceasta op<?>iune. Acest lucru garanteaza ca secven<?>ele de control
       sunt convertite in culori <?>i nu distorsioneaza afi<?>area. Utilizarea
       op<?>iunii -r nu este recomandata, deoarece dispunerea ecranului poate
       fi gre<?>ita, daca in ie<?>ire se afla linii lungi.

       Eviden<?>ierea sintaxei poate fi dezactivata prin adaugarea a doua
       puncte dupa numele fi<?>ierului, daca ie<?>irea a fost colorata. Daca a
       fost ales un limbaj gre<?>it pentru eviden<?>ierea sintaxei, atunci
       poate fi for<?>at un alt limbaj prin adaugarea a doua puncte <?>i a
       unui sufix dupa numele fi<?>ierului. Lista sufixelor <?>i a limbilor
       acceptate poate fi imprimata folosind urmatoarele comenzi de colorare:
              bat --list-languages
              batcat --list-languages
              pygmentize -L lexers
              source-highlight --lang-list
              code2color -h
              vimcolor -L (atat pentru vimcolor, cat <?>i pentru nvimpager)

       Intr-o conducta, aceasta metoda nu poate fi utilizata. Ca o solu<?>ie
       se poate adauga un ultim argument care este inspectat de lesspipe.sh.
       Este posibil sa se foloseasca doar doua puncte ,,:" (dezactivarea
       filtrului) sau :extensia (for<?>area limbajului), de exemplu cu
              comanda care genereaza cod c | less - :c

       Atunci cand sunt indeplinite condi<?>iile de eviden<?>iere a sintaxei,
       listele de directoare <?>i listele cu con<?>inutul fi<?>ierelor tar
       sunt de asemenea colorate.

       Deoarece less este utilizat ca navigator implicit in alte programe (de
       exemplu, man, git <?>i perldoc) lesspipe.sh poate fi angajat <?>i poate
       modifica rezultatul acestor programe.

URMARIREA CRE<?>TERII FI<?>IERELOR
       Abilitatea de a vizualiza fi<?>ierele pe masura ce cresc (utila de
       obicei pentru fi<?>ierele jurnal, cum ar fi syslog)  (folosind comanda
       F din less sau apeland less cu op<?>iunea +F)  se poate pierde daca
       lesspipe.sh stocheaza datele de intrare intr-un fi<?>ier temporar
       pentru procesare ulterioara.  Aceasta problema poate fi remediata
       adaugand doua puncte (,,:") ca ultim argument pentru less, de exemplu:
              less /var/log/syslog :
       sau daca LESSOPEN incepe cu |- <?>i less: este apelat printr-o conducta
              cat /var/log/syslog | less +F - :

UTILIZARE AVANSATA
       Aceasta versiune a lesspipe.sh va permite sa vizualiza<?>i fi<?>iere
       individuale con<?>inute intr-o arhiva de fi<?>iere, care la randul ei
       poate fi con<?>inuta intr-o alta arhiva.

       Nota<?>ia pentru vizualizarea fi<?>ierelor din arhivele multi-fi<?>iere
       este
              less fi<?>ier_arhiva:fi<?>ier_con<?>inut
       sau chiar
              less super_arhiva:fi<?>ier_arhiva:fi<?>ier_con<?>inut
       Pentru a afi<?>a ultimul fi<?>ier in formatul brut al lan<?>ului,
       trebuie adaugate doua puncte (:) la numele fi<?>ierului. Daca acesta
       con<?>ine doua puncte, atunci trebuie sa se utilizeze semnul egal (=)
       drept caracter de separare alternativ.

       Din nou, aceasta metoda de extragere <?>i afi<?>are a fi<?>ierelor nu
       func<?>ioneaza daca less este apelat intr-o conducta de ie<?>ire <?>i
       LESSOPEN incepe cu caracterele |-. Ca <?>i in cazul eviden<?>ierii
       sintaxei, solu<?>ia este de a utiliza un al doilea argument care incepe
       cu doua puncte. In acest caz, comanda de mai sus ar fi scrisa sub forma
              cat super_arhiva | less - :arhiva:fi<?>ier_con<?>inut

MECANISM DE COMPLETARE A CON<?>INUTULUI ARHIVEI
       Cu fi<?>ierul lesscomplete furnizat (pentru zsh <?>i bash) <?>i
       fi<?>ierele _less (pentru zsh) <?>i less (pentru bash) generate in
       timpul instalarii, se poate realiza completarea cu tasta <<Tab>> pentru
       fi<?>ierele din arhive. Introducerea unui semn de doua puncte (:) sau a
       unui semn egal (=) dupa numele unui fi<?>ier arhivat <?>i apoi apasarea
       tastei <<Tab>> activeaza mecanismul de completare. Acest lucru
       func<?>ioneaza <?>i in arhivele in lan<?>. Fi<?>ierele necesare pentru
       algoritmul de completare sunt instalate in directoare in conformitate
       cu op<?>iunile selectate in timpul instalarii (scriptul de
       configurare).

       Fi<?>ierul lesscomplete trebuie sa se afle intr-unul dintre
       directoarele listate in $PATH, iar func<?>ia _less pentru zsh intr-un
       director listat de $fpath. Fi<?>ierul less cu instruc<?>iuni de
       completare pentru bash trebuie sa fie sursa intr-un script de
       ini<?>ializare bash, de exemplu in ~/.bashrc. Directoare noi, precum
       ~/scripts <?>i ~/.fpath (pentru zsh), pot fi adaugate folosind
       comenzile
              PATH=~/scripts:$PATH # (lesspipe.sh, less) and fpath=(~/.fpath
              $fpath) # (_less, zsh only)

       In zsh, trebuie apelat compinit <?>i trebuie activata op<?>iunea
       menucomplete, daca nu a fost deja facuta. Acest lucru se poate realiza
       cu ajutorul comenzilor
              autoload compinit
              compinit -Uz
              setopt menucomplete

       In bash, bash-completion (de obicei un pachet cu acest nume)  trebuie
       sa fie instalat.

FILTRAREA DEFINITA DE UTILIZATOR
       Filtrarea lesspipe.sh poate fi inlocuita sau imbunata<?>ita de un
       program definit de utilizator. Un astfel de program trebuie sa se
       numeasca fie .lessfilter (<?>i sa fie plasat in directorul personal al
       utilizatorului), fie lessfilter (<?>i sa fie accesibil dintr-un
       director men<?>ionat in $PATH). Acesta trebuie sa fie executabil <?>i
       trebuie sa se incheie cu un cod de ie<?>ire 0, daca filtrarea a fost
       efectuata in cadrul scriptului respectiv. In caz contrar, un cod de
       ie<?>ire diferit de zero inseamna ca filtrarea este lasata in seama
       <<lesspipe.sh>>.

       Acest mecanism poate fi utilizat pentru a adauga filtre pentru noi
       formate sau, de exemplu, pentru a inhiba filtrarea pentru anumite
       tipuri de fi<?>iere. Un exemplu de .lessfilter ar putea arata astfel:

       #!/usr/bin/env bash
       case $1 in
       *.md|*.MD|*.mkd|*.markdown|*.rst)
       # daca modulul Python rich.markdown nu este gasit, atunci
       # codul de ie<?>ire nu este nul <?>i se apeleaza lesspipe.sh
       python3 -m rich.markdown -c $1 ;;
       *.html|*.htm)
       # apeleaza programul tau preferat de formatare HTML, <<cat -b>> este doar un exemplu plictisitor
       cat -b $1 ;;
       *)
       exit 1;;
       esac


AUTOR
       Wolfgang Friebel

RAPORTAREA ERORILOR
       Raporta<?>i erorile la <wp.friebel AT gmail DOT com>.

DREPTURI DE AUTOR
       Drepturi de autor (C) 2005-2026 Wolfgang Friebel
       Acesta este software liber; consulta<?>i sursa pentru condi<?>iile de
       copiere. NU exista NICIO garan<?>ie; nici macar pentru COMERCIALIZARE
       sau POTRIVIRE PENTRU UN ANUMIT SCOP.

CONSULTA<?>I <?>I
       less(1)

       O descriere a lesspipe.sh poate fi de asemenea gasita in fi<?>ierul
       README con<?>inut in pachetul de cod sursa

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

lesspipe.sh                      aprilie 2026                   LESSPIPE.SH(1)