TLDR: pàgines man fàcils d'entendre per a cada usuari de Linux


Una de les maneres més utilitzades i fiables d'obtenir ajuda amb sistemes semblants a Unix és a través de pàgines man. Les pàgines man són la documentació estàndard per a tots els sistemes semblants a Unix i corresponen a manuals en línia per a programes, funcions, biblioteques, trucades al sistema, estàndards i convencions formals, formats de fitxers, etc. Tanmateix, les pàgines de manual pateixen molts errors, un dels quals és que són massa llargues i que algunes persones simplement no els agrada llegir massa text a la pantalla.

Les pàgines TLDR (significa Too Long; Didn't Read) són exemples pràctics d'ús d'ordres en diferents sistemes operatius, inclòs Linux. Simplifican les pàgines de manual oferint exemples pràctics.

TLDR és un argot d'Internet, és a dir, una publicació, article, comentari o qualsevol cosa, com ara una pàgina de manual, era massa llarg, i qui va utilitzar la frase no la va llegir per aquest motiu. El contingut de les pàgines TLDR està disponible obertament sota la permissiva llicència MIT.

En aquest breu article, mostrarem com instal·lar i utilitzar pàgines TLDR a Linux.

  1. Instal·leu la darrera versió de Nodejs i NPM als sistemes Linux

Abans d'instal·lar, podeu provar la demostració en directe de TLDR.

Com instal·lar pàgines TLDR en sistemes Linux

Per accedir còmodament a les pàgines TLDR, heu d'instal·lar un dels clients compatibles anomenat Node.js, que és el client original del projecte tldr-pages. Podem instal·lar-lo des de NPM executant-lo.

$ sudo npm install -g tldr

TLDR també disponible com a paquet Snap, per instal·lar-lo, executar.

$ sudo snap install tldr

Després d'instal·lar el client TLDR, podeu veure les pàgines man de qualsevol ordre, per exemple l'ordre tar aquí (podeu utilitzar qualsevol altra ordre aquí):

$ tldr tar

Aquí hi ha un altre exemple d'accés a la pàgina de manual resumida per a l'ordre ls.

$ tldr ls

Per llistar totes les ordres de la plataforma escollida a la memòria cau, utilitzeu el senyalador -l.

$ tldr -l 

Per llistar totes les ordres admeses a la memòria cau, utilitzeu el senyalador -a.

$ tldr -a

Podeu actualitzar o esborrar la memòria cau local executant-lo.

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

Per cercar pàgines amb paraules clau, utilitzeu les opcions -s, per exemple.

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

Per canviar el tema de color (simple, base16, ocean), utilitzeu la marca -t.

$ tldr -t ocean

També podeu mostrar una ordre aleatòria, amb el senyalador -r.

$ tldr -r   

Podeu veure una llista completa d'opcions admeses executant.

$ tldr -h

Nota: podeu trobar una llista de totes les aplicacions de client admeses i dedicades per a diferents plataformes, a la pàgina wiki de clients TLDR.

Pàgina d'inici del projecte TLDR: https://tldr.sh/

Això és tot per ara! Les pàgines TLDR es resumeixen exemples pràctics d'ordres proporcionades per la comunitat. En aquest breu article, hem mostrat com instal·lar i utilitzar pàgines TLDR a Linux. Utilitzeu el formulari de comentaris per compartir els vostres pensaments sobre TLDR o compartiu amb nosaltres qualsevol programa similar.