TLDR - Lako razumljive stranice priručnika za Linux naredbe


Jedan od najčešće korištenih i pouzdanih načina dobivanja pomoći pod sustavima sličnim Unixu je putem stranica s priručnikom, koje su standardna dokumentacija za svaki sustav sličan Unixu i odgovaraju mrežnim priručnicima za programe, funkcije , knjižnice, sistemski pozivi, formalni standardi i konvencije, formati datoteka i tako dalje.

Međutim, man stranice pate od mnogih nedostataka od kojih je jedan taj što su preduge i neki ljudi jednostavno ne vole čitati previše teksta na ekranu.

TLDR (skraćenica za “Predugo; Nisam pročitao“) projekt je vođen zajednicom koji pruža sažetu i pojednostavljenu dokumentaciju za razne Linux naredbe.

TLDR ima za cilj ponuditi brze i praktične primjere korištenja naredbi, olakšavajući korisnicima razumijevanje i korištenje naredbi bez potrebe za zadubljenjem u opsežne priručnike ili dugačka objašnjenja.

TLDR se obično pristupa putem naredbenog retka pomoću naredbe “tldr”, iza koje slijedi naziv naredbe o kojoj želite saznati.

tldr ls

TLDR je internetski sleng, što znači da je objava, članak, komentar ili bilo što poput stranice priručnika bilo predugačko i tko god je upotrijebio izraz nije ga pročitao iz tog razloga. Sadržaj TLDR stranica otvoreno je dostupan pod dopuštenom MIT licencom.

U ovom kratkom članku pokazat ćemo kako instalirati i koristiti TLDR stranice u Linuxu.

Kako instalirati TLDR stranice u Linux sustavima

Za praktičan pristup stranicama TLDR morate instalirati jedan od podržanih klijenata pod nazivom Node.js, koji je izvorni klijent za tldr-pages projekt.

Da biste instalirali Node.js, možete koristiti upravitelj paketa specifičan za vašu distribuciju.

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]    

Nakon što su Node.js i npm instalirani, možete nastaviti s instalacijom TLDR pomoću naredbe npm kao što je prikazano .

sudo npm install -g tldr

TLDR također je dostupan kao Snap paket za instalaciju i pokretanje.

sudo snap install tldr

Nakon instaliranja TLDR klijenta, možete vidjeti man stranice bilo koje naredbe, na primjer, naredbu tar ovdje (ovdje možete koristiti bilo koju drugu naredbu):

tldr tar

Evo još jednog primjera pristupa sažetoj stranici priručnika za naredbu ls.

tldr ls

Za popis svih naredbi za odabranu platformu u predmemoriju, koristite oznaku -l.

tldr -l 

Za popis svih podržanih naredbi u predmemoriji, koristite oznaku -a.

tldr -a

Možete ažurirati ili izbrisati lokalnu predmemoriju pokretanjem.

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

Za pretraživanje stranica koristeći ključne riječi, koristite opcije -s, na primjer.

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

Za promjenu teme boja (jednostavna, base16, ocean), upotrijebite oznaku -t.

tldr -t ocean

Također možete prikazati nasumične naredbe, s oznakom -r.

tldr -r   

Potpuni popis podržanih opcija možete vidjeti pokretanjem.

tldr -h

Popis svih podržanih i namjenskih klijentskih aplikacija za različite platforme možete pronaći na wiki stranici TLDR klijenata.

To je sve za sada! Stranice TLDR sažeti su praktični primjeri naredbi koje daje zajednica. U ovom kratkom članku pokazali smo kako instalirati i koristiti TLDR stranice u Linuxu.

Upotrijebite obrazac za povratne informacije da podijelite svoje mišljenje o TLDR-u ili podijelite s nama sve slične programe.