.\" -*- coding: UTF-8 -*- .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH LESSPIPE.SH 1 "ianuarie 2023" lesspipe.sh "Comenzi utilizator" .SH NUME lesspipe.sh \- un filtru pentru less .SH SINOPSIS \fBlesspipe.sh\fP [\fIFIȘIER[e]\fP]... .SH DESCRIERE .PP Scopul lui \fBlesspipe.sh\fP este de a îmbunătăți rezultatul lui \fBless\fP. Alegerea regulilor care urmează să fie aplicate pentru a modifica rezultatul se bazează pe conținutul fișierului. Extensia fișierului este respectată doar în ultimă instanță. De obicei, \fBlesspipe.sh\fP este apelat ca un filtru de intrare pentru \fBless\fP. .PP Cu ajutorul acestui filtru, \fBless\fP va afișa conținutul necomprimat al fișierelor comprimate (\fIgzip, bzip2, compress, zstd, lz4, lzip, xz, lzma sau brotli\fP). Pentru fișierele care conțin arhive și directoare, se va afișa un tabel de conținut (\fIformatele tar, ar, zip, i7\-zip, rar, jar, rpm, deb ms\-cabinet și iso\fP). Multe alte fișiere vor fi reformatate pentru afișare. Sunt incluse formatele de suite \fIpdf, dvi, markdown, Office (MS și Openoffice)\fP, \fINetCDF, matlab, html\fP și \fImedia (imagine, audio și video)\fP. Acest lucru necesită instalarea unor programe de ajutor. .PP De asemenea, filtrul poate fi aplicat în mod recursiv pentru a extrage și afișa din mers fișierele din arhive. Acest lucru funcționează până la o adâncime de 6, unde aplicarea unui algoritm de decomprimare contează ca un nivel separat. .PP Dacă instrumentu\fIfile\fP raportează un text cu o codificare diferită de cea utilizată în terminal, atunci textul va fi transformat folosind \fIiconv\fP în codificarea implicită. Acest lucru presupune că instrumentul \fIfile\fP obține codificarea corectă a fișierului, ceea ce poate fi greșit în anumite situații. Dacă se adaugă două puncte „:” la numele fișierului, conversia este suprimată. .PP Atunci când se utilizează programele \fBgit\fP, \fBvim\fP sau \fBmutt\fP, acestea pot fi activate pentru a citi fișiere care nu sunt de tip text, utilizând lesspipe.sh. Acest lucru este descris în Wiki la adresa \fIhttps://github.com/wofr06/lesspipe/wiki\fP. .SH "ACTIVAREA FILTRULUI" Filtrul este apelat din \fBless\fP cu condiția ca variabila de mediu \fBLESSOPEN\fP să fie definită corespunzător. În cazul shell\-urilor de tip ksh (\fIbash, zsh\fP), comanda .RS \fILESSOPEN="|lesspipe.sh %s"; export LESSOPEN\fP .RE activează filtrul pentru «less». Utilizați ruta complet calificată, dacă \fBlesspipe.sh\fP nu se află în ruta de căutare. Comanda pentru a defini \fBLESSOPEN\fP poate fi, de asemenea, afișată prin apelarea \fBlesspipe.sh\fP fără argumente. Aceasta poate fi utilizată chiar și pentru a defini direct \fBLESSOPEN\fP: .RS \fIeval `lesspipe.sh`\fP (bash) sau .RE .RS \fIlesspipe.sh|source /dev/stdin\fP (zsh) .RE După ce ați definit variabila de mediu în modul descris mai sus, \fBless\fP va afișa informații textuale pentru o gamă largă de formate de fișiere. .PP În mod normal, filtrul nu este apelat dacă intrarea este direcționată către «less» ca în .RS \fIcat somefile | less\fP .RE Așa cum este descris în pagina de manual a «less», filtrarea într\-o conductă poate fi totuși forțată prin începerea \fBLESSOPEN\fP cu caracterele \fI|\-\fP. .PP \fBLESSOPEN\fP care începe cu cele două caractere \fI||\fP pentru a gestiona fișierele goale și erorile de comandă este implementată doar parțial, de obicei la eșecurile comenzilor din \fBlesspipe.sh\fP se afișează mesajele de eroare. .PP Variabila \fBLESS_ADVANCED_PREPROCESSOR\fP, acum obsoletă, era utilizată pentru a decide dacă \fIhtml\fP, \fIxml\fP și \fIperl pod\fP trebuie să fie afișate ca text pur sau nu. Acest lucru a fost schimbat, aceste formate sunt acum întotdeauna interpretate, cu excepția cazului în care la numele fișierului se adaugă două puncte „:”. Dacă urmează tipul de fișier corect (\fIhtml\fP, \fIxml\fP, \fIpod\fP), ieșirea poate fi colorată (a se vedea mai jos). .PP .RS Exemplu: \fIless index.html:html\fP .RE .PP Pentru a suprima mesajele informale din prima linie de ieșire a filtrului, variabila ENV \fBLESSQUIET\fP poate fi fixată la o valoare nevidă. .PP Pentru a dezactiva temporar filtrul, se pot adăuga două puncte la numele fișierului „:”. În cazul în care numele fișierului conține două puncte, în locul acestora trebuie folosit un semn egal. .SH "COLORAREA IEȘIRII" Filtrul este capabil să evidențieze sintaxa pentru o mare varietate de tipuri de fișiere. Dacă este instalat, \fIbat\fP/\fIbatcat\fP este utilizat pentru colorarea ieșirii. Dacă nu, se încearcă pe rând \fIpygmentize\fP, \fIsource\-highlight\fP, \fIcode2color\fP și \fIvimcolor\fP. Pentru bat/batcat, tema este stabilită la \fIansi\fP, iar stilul este stabilit la \fIplain\fP, care se apropie mai mult de ieșirea nefiltrată de \fBless\fP. Aceste configurații pot fi modificate în \fI~/.config/bat/config\fP sau prin variabilele de mediu \fBBAT_STYLE\fP și \fBBAT_THEME\fP. .PP Dintre programele de colorare, se poate forța utilizarea unuia dintre ele prin definirea variabilei ENV \fBLESSCOLORIZER\fP la numele programului de colorare. Pentru \fIpygmentize\fP și \fIbat\fP/\fIbatcat\fP sunt permise configurări de opțiuni restrânse, după cum urmează: .RS \fILESSCOLORIZER='pygmentize \-O style=foo'\fP .RE .RS \fILESSCOLORIZER='bat \-\-style=foo \-\-theme=bar'\fP .RE Evidențierea sintaxei este activată dacă variabila de mediu \fBLESS\fP există și conține opțiunea \fI\-R\fP sau dacă «less» este apelat cu această opțiune. Acest lucru garantează că secvențele de control sunt convertite în culori și nu distorsionează afișarea. Utilizarea opțiunii \fI\-r\fP nu este recomandată, deoarece dispunerea ecranului poate fi greșită, dacă în ieșire se află linii lungi. .PP Evidențierea sintaxei poate fi dezactivată prin adăugarea a două puncte după numele fișierului, dacă ieșirea a fost colorată. Dacă a fost aleasă un limbaj greșit pentru evidențierea sintaxei, atunci poate fi forțată un alt limbaj prin adăugarea a două puncte și a unui sufix după numele fișierului. .PP Într\-o conductă, această metodă nu poate fi utilizată. Ca o soluție se poate adăuga un ultim argument care este inspectat de \fBlesspipe.sh\fP. Este posibil să se folosească doar două puncte „:” (dezactivarea filtrului) sau :extensia (forțarea limbajului), de exemplu cu .RS \fIcomandă care generează cod c | less \- :c\fP .RE .PP Atunci când sunt îndeplinite condițiile de evidențiere a sintaxei, listele de directoare și listele cu conținutul fișierelor tar sunt de asemenea colorate. .PP Deoarece \fBless\fP este utilizat ca navigator implicit în alte programe, alegerea programului de colorare poate afecta rezultatul acestor programe. Pentru \fIman\fP, \fIgit\fP și \fIperldoc\fP) lesspipe.sh nu face filtrare. .SH "URMĂRIREA CREȘTERII FIȘIERELOR" De îndată ce \fBlesspipe.sh\fP apelează un program pentru a converti datele de intrare, capacitatea de a urmări fișierele în creștere (utilizând comanda F din less) este pierdută. Acest lucru este de obicei dorit pentru fișiere de jurnal precum syslog. Pentru a dezactiva temporar \fBlesspipe.sh\fP trebuie adăugate două puncte ca ultim argument pentru \fBless\fP ca de exemplu în .RS \fIless /var/log/syslog :\fP .RE sau \fBless\fP pot fi apelat cu argumentul +F, care este echivalent cu F în paginator: .RS \fIless +F /var/log/syslog\fP .RE Adăugarea a două puncte la numele fișierului nu funcționează, deoarece atunci filtrul trebuie să fie activat pentru a elimina cel puțin cele două puncte și pentru a utiliza «cat» pentru fișierul original. Pe de altă parte, fișierele jurnal care nu cresc pot fi colorate folosind \fBccze\fP. Recunoașterea sa ca fișier jurnal este dificilă dacă nu se termină în \fI.log\fP, dar poate fi forțată prin adăugarea \fB:.log\fP la numele fișierului, ca de exemplu în .RS \fIless /var/log/syslog:.log\fP .RE .SH "UTILIZARE AVANSATĂ" Această versiune a \fBlesspipe.sh\fP vă permite să vizualizați fișiere individuale conținute într\-o arhivă de fișiere, care la rândul ei poate fi conținută într\-o altă arhivă. .PP Notația pentru vizualizarea fișierelor din arhivele multi\-fișiere este .RS \fBless\fP \fIfișier_arhivă\fP:\fIfișier_conținut\fP .RE sau chiar .RS \fBless\fP \fIsuper_arhivă\fP:\fIfișier_arhivă\fP:\fIfișier_conținut\fP .RE Pentru a afișa ultimul fișier în formatul brut al lanțului, trebuie adăugate două puncte (\fI:\fP) la numele fișierului. Dacă acesta conține două puncte, atunci trebuie să se utilizeze semnul egal (\fI=\fP) drept caracter de separare alternativ. .PP Din nou, această metodă de extragere și afișare a fișierelor nu funcționează dacă \fBless\fP este apelat într\-o conductă de ieșire și \fBLESSOPEN\fP începe cu caracterele \fB|\-\fP. Ca și în cazul evidențierii sintaxei, soluția este de a utiliza un al doilea argument care începe cu două puncte. În acest caz, comanda de mai sus ar fi scrisă sub forma .RS \fBcat \fP\fIsuper_arhivă\fP\fB | less \- :\fP\fIarhivă\fP\fB:\fP\fIfișier_conținut\fP .RE .PP .SH "MECANISM DE COMPLETARE A CONȚINUTULUI ARHIVEI" Cu ajutorul fișierelor \fIlesscomplete\fP (pentru \fBzsh\fP și \fBbash\fP), \fI_less\fP (pentru \fBzsh\fP) și \fIless_completion\fP (pentru \fBbash\fP) furnizate, se poate realiza o completare a numelui cu ajutorul tastei «TAB» pentru fișierele din arhive. Introducerea a două puncte (:) sau a unui semn egal (=) după numele unui fișier de arhivă și apoi apăsarea tastei de tabulare declanșează mecanismul de completare. Acest lucru funcționează și în arhivele înlănțuite. Fișierele \fIlesscomplete\fP și \fIless_completare\fP trebuie să se afle într\-unul dintre directoarele enumerate în \fB$PATH\fP, iar funcția \fI_less\fP pentru \fBzsh\fP într\-un director enumerat de \fI$fpath\fP. Scriptul less_completion trebuie să aibă ca sursă un script de inițializare bash, de exemplu, în \fI~/.bashrc\fP. Se pot adăuga directoare noi, cum ar fi \fI~/scripts\fP și \fI~/.fpath\fP, utilizând comenzile .RS \fBPATH\fP=\fI~/scripts:$PATH\fP și \fBfpath\fP=\fI(~/.fpath $fpath)\fP .RE .SH "FILTRAREA DEFINITĂ DE UTILIZATOR" Filtrarea lesspipe.sh poate fi înlocuită sau îmbunătățită de un program definit de utilizator. Un astfel de program trebuie să se numească fie \&\fB.lessfilter\fP (și să fie plasat în directorul personal al utilizatorului), fie \fBlessfilter\fP (și să fie accesibil dintr\-un director menționat în \fB$PATH\fP). Acesta trebuie să fie executabil și trebuie să se încheie cu un cod de ieșire 0, dacă filtrarea a fost efectuată în cadrul scriptului respectiv. În caz contrar, un cod de ieșire diferit de zero înseamnă că filtrarea este lăsată în seama «lesspipe.sh». .PP Acest mecanism poate fi utilizat pentru a adăuga filtre pentru noi formate sau, de exemplu, pentru a inhiba filtrarea pentru anumite tipuri de fișiere. .SH AUTOR Wolfgang Friebel .SH "RAPORTAREA ERORILOR" Raportați erorile la . .SH "DREPTURI DE AUTOR" Drepturi de autor \(co 2005\-2023 Wolfgang Friebel .br Acesta este software liber; consultați sursa pentru condițiile de copiere. NU există NICIO garanție; nici măcar pentru COMERCIALIZARE sau POTRIVIRE PENTRU UN ANUMIT SCOP. .SH "CONSULTAȚI ȘI" less(1) .PP O descriere a \fBlesspipe.sh\fP este, de asemenea, conținută în fișierul README conținut în pachetul de cod sursă .PP .SH TRADUCERE Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu . .PP Această traducere este documentație gratuită; citiți .UR https://www.gnu.org/licenses/gpl-3.0.html Licența publică generală GNU Versiunea 3 .UE sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE. .PP Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la .MT translation-team-ro@lists.sourceforge.net .ME .