TLDR – lengvai suprantami „Linux“ komandų vadovo puslapiai

Vienas iš dažniausiai naudojamų ir patikimiausių būdų gauti pagalbą naudojant Unix tipo sistemas yra man puslapiai, kurie yra standartinė kiekvienos Unix tipo sistemos dokumentacija ir atitinka internetinius programų, funkcijų vadovus. , bibliotekos, sistemos iškvietimai, formalūs standartai ir konvencijos, failų formatai ir pan.

Tačiau man puslapiai kenčia nuo daugelio trūkumų, iš kurių vienas yra per ilgi, o kai kurie žmonės tiesiog nemėgsta skaityti per daug teksto ekrane.

TLDR (reiškia „Per ilgai; neperskaitė“) yra bendruomenės sukurtas projektas, kuriame pateikiama glausta ir supaprastinta įvairių „Linux“ komandų dokumentacija.

TLDR tikslas – pateikti greitus ir praktiškus komandų naudojimo pavyzdžius, kad naudotojai galėtų lengviau suprasti ir naudoti komandas, nesigilinant į išsamius vadovus ar ilgus paaiškinimus.

TLDR paprastai pasiekiama per komandų eilutę naudojant komandą tldr, po kurios nurodomas komandos, apie kurią norite sužinoti, pavadinimas.

tldr ls

TLDR yra interneto slengas, reiškiantis, kad įrašas, straipsnis, komentaras ar bet kas, pvz., vadovo puslapis, buvo per ilgas, ir kas vartojo šią frazę, jos neskaitė dėl šios priežasties. TLDR puslapių turinys yra atvirai prieinamas pagal leistiną MIT licenciją.

Šiame trumpame straipsnyje parodysime, kaip įdiegti ir naudoti TLDR puslapius sistemoje „Linux“.

Kaip įdiegti TLDR puslapius „Linux“ sistemose

Norėdami patogiai pasiekti TLDR puslapius, turite įdiegti vieną iš palaikomų klientų, vadinamų Node.js, kuris yra originalus tldr-pages projekto klientas.

Norėdami įdiegti Node.js, galite naudoti savo platinimui skirtą paketų tvarkyklę.

sudo apt install nodejs npm         [On Debian, Ubuntu and Mint]
sudo yum install nodejs npm         [On RHEL/CentOS/Fedora and Rocky/AlmaLinux]
sudo emerge -a sys-apps/nodejs npm  [On Gentoo Linux]
sudo apk add nodejs npm             [On Alpine Linux]
sudo pacman -S nodejs npm           [On Arch Linux]
sudo zypper install nodejs npm      [On OpenSUSE]    

Įdiegę Node.js ir npm, galite pradėti diegti TLDR naudodami komandą npm, kaip parodyta .

sudo npm install -g tldr

TLDR taip pat galimas kaip „Snap“ paketas, kurį galima įdiegti ir paleisti.

sudo snap install tldr

Įdiegę TLDR klientą, galite peržiūrėti bet kurios komandos man puslapius, pvz., komandą tar (čia galite naudoti bet kurią kitą komandą):

tldr tar

Štai dar vienas pavyzdys, kaip pasiekti apibendrintą ls komandos vadovo puslapį.

tldr ls

Norėdami talpykloje išvardyti visas pasirinktai platformai skirtas komandas, naudokite vėliavėlę -l.

tldr -l 

Norėdami išvardyti visas palaikomas komandas talpykloje, naudokite vėliavėlę -a.

tldr -a

Galite atnaujinti arba išvalyti vietinę talpyklą paleisdami.

tldr -u	#update local cache 
OR
tldr -c 	#clear local cache 

Norėdami ieškoti puslapių naudodami raktinius žodžius, naudokite, pavyzdžiui, parinktis -s.

tldr -s  "list of all files, sorted by modification date"

Norėdami pakeisti spalvų temą (paprasta, bazė16, vandenynas), naudokite vėliavėlę -t.

tldr -t ocean

Taip pat galite parodyti atsitiktinę komandą su vėliava -r.

tldr -r   

Paleidę galite pamatyti visą palaikomų parinkčių sąrašą.

tldr -h

Visų palaikomų ir skirtų klientų programų, skirtų skirtingoms platformoms, sąrašą galite rasti TLDR klientų wiki puslapyje.

Tai kol kas viskas! Puslapiai TLDR yra apibendrinti praktiniai bendruomenės teikiamų komandų pavyzdžiai. Šiame trumpame straipsnyje parodėme, kaip įdiegti ir naudoti TLDR puslapius Linux sistemoje.

Naudokite atsiliepimų formą ir pasidalykite mintimis apie TLDR arba pasidalykite su mumis panašiomis programomis.