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 sau brotli). Pentru fi<?>ierele care con<?>in arhive <?>i
       directoare, se va afi<?>a un tabel de con<?>inut (formatele tar, ar,
       zip, i7-zip, rar, jar, rpm, deb ms-cabinet <?>i iso). Multe alte
       fi<?>iere vor fi reformatate pentru afi<?>are. Sunt incluse formatele
       de suite pdf, dvi, markdown, Office (MS <?>i Openoffice), NetCDF,
       matlab, html <?>i media (imagine, audio <?>i video). Acest lucru
       necesita instalarea unor programe de ajutor.

       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) sau
              lesspipe.sh|source /dev/stdin (zsh)
       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 |-.

       LESSOPEN care incepe cu cele doua caractere || pentru a gestiona
       fi<?>ierele goale <?>i erorile de comanda este implementata doar
       par<?>ial, de obicei la e<?>ecurile comenzilor din lesspipe.sh se
       afi<?>eaza mesajele de eroare.

       Variabila LESS_ADVANCED_PREPROCESSOR, acum obsoleta, era utilizata
       pentru a decide daca html, xml <?>i perl pod trebuie sa fie afi<?>ate
       ca text pur sau nu. Acest lucru a fost schimbat, aceste formate sunt
       acum intotdeauna interpretate, cu excep<?>ia cazului in care la numele
       fi<?>ierului se adauga doua puncte ,,:". Daca urmeaza tipul de fi<?>ier
       corect (html, xml, pod), ie<?>irea poate fi colorata (a se vedea mai
       jos).

              Exemplu: less index.html:html

       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.

COLORAREA IE<?>IRII
       Filtrul este capabil sa eviden<?>ieze sintaxa pentru o mare varietate
       de tipuri de fi<?>iere. Daca este instalat, bat/batcat este utilizat
       pentru colorarea ie<?>irii. Daca nu, se incearca pe rand pygmentize,
       source-highlight, code2color <?>i vimcolor. Pentru bat/batcat, tema
       este stabilita la ansi, iar stilul este stabilit la plain, care se
       apropie mai mult de ie<?>irea nefiltrata de less. Aceste configura<?>ii
       pot fi modificate in ~/.config/bat/config sau prin variabilele de mediu
       BAT_STYLE <?>i BAT_THEME.

       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'
              LESSCOLORIZER='bat --style=foo --theme=bar'
       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 aleasa un limbaj gre<?>it pentru eviden<?>ierea sintaxei, atunci
       poate fi for<?>ata un alt limbaj prin adaugarea a doua puncte <?>i a
       unui sufix dupa numele fi<?>ierului.

       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,
       alegerea programului de colorare poate afecta rezultatul acestor
       programe. Pentru man, git <?>i perldoc) lesspipe.sh nu face filtrare.

URMARIREA CRE<?>TERII FI<?>IERELOR
       De indata ce lesspipe.sh apeleaza un program pentru a converti datele
       de intrare, capacitatea de a urmari fi<?>ierele in cre<?>tere
       (utilizand comanda F din less) este pierduta. Acest lucru este de
       obicei dorit pentru fi<?>iere de jurnal precum syslog. Pentru a
       dezactiva temporar lesspipe.sh trebuie adaugate doua puncte ca ultim
       argument pentru less ca de exemplu in
              less /var/log/syslog :
       sau less pot fi apelat cu argumentul +F, care este echivalent cu F in
       paginator:
              less +F /var/log/syslog
       Adaugarea a doua puncte la numele fi<?>ierului nu func<?>ioneaza,
       deoarece atunci filtrul trebuie sa fie activat pentru a elimina cel
       pu<?>in cele doua puncte <?>i pentru a utiliza <<cat>> pentru
       fi<?>ierul original. Pe de alta parte, fi<?>ierele jurnal care nu cresc
       pot fi colorate folosind ccze. Recunoa<?>terea sa ca fi<?>ier jurnal
       este dificila daca nu se termina in .log, dar poate fi for<?>ata prin
       adaugarea :.log la numele fi<?>ierului, ca de exemplu in
              less /var/log/syslog:.log

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 ajutorul fi<?>ierelor lesscomplete (pentru zsh <?>i bash), _less
       (pentru zsh) <?>i less_completion (pentru bash) furnizate, se poate
       realiza o completare a numelui cu ajutorul tastei <<TAB>> pentru
       fi<?>ierele din arhive. Introducerea a doua puncte (:) sau a unui semn
       egal (=) dupa numele unui fi<?>ier de arhiva <?>i apoi apasarea tastei
       de tabulare declan<?>eaza mecanismul de completare. Acest lucru
       func<?>ioneaza <?>i in arhivele inlan<?>uite. Fi<?>ierele lesscomplete
       <?>i less_completare trebuie sa se afle intr-unul dintre directoarele
       enumerate in $PATH, iar func<?>ia _less pentru zsh intr-un director
       enumerat de $fpath. Scriptul less_completion trebuie sa aiba ca sursa
       un script de ini<?>ializare bash, de exemplu, in ~/.bashrc. Se pot
       adauga directoare noi, cum ar fi ~/scripts <?>i ~/.fpath, utilizand
       comenzile
              PATH=~/scripts:$PATH <?>i fpath=(~/.fpath $fpath)

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.

AUTOR
       Wolfgang Friebel

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

DREPTURI DE AUTOR
       Drepturi de autor (C) 2005-2023 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 este, de asemenea, con<?>inuta 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                      ianuarie 2023                  LESSPIPE.SH(1)