Hm, stvorite i održavajte vlastite Ubuntu man stranice

o um

U sljedećem ćemo članku pogledati Um. Danas nitko ne može dovesti u pitanje korisnost man stranica i njihovih alternativa. Te se alternative uglavnom koriste za pristup primjeri po mjeri, i stoga ne moraju prolaziti kroz cijele stranice s uputama. Ako tražite brz način za komunikaciju ili lako naučite Gnu / Linux naredbu, vrijedi isprobati ove alternative. Um će nam omogućiti da stvorimo vlastite stranice pomoći za naredbu. Ovo je uslužni program za terminal, koji je vrlo koristan za lako stvoriti i održavati vlastite stranice s man koji sadrže samo ono što nas zanima.

Stvaranjem vlastitih stranica za pomoć možete izbjeći mnoge "detalji"Man stranice i na nju uključite samo ono što je potrebno uzeti u obzir za slučaj koji nas zanima. Ako ste ikad željeli stvorite svoj vlastiti set Man stranica, Hm će vam definitivno biti od koristi.

Instalirajte Um na Ubuntu 18.04

Um je dostupan za Gnu / Linux i Mac OS. U vrijeme kad ovo pišem, jednostavno može se instalirati pomoću Linuxbrew upravitelja paketa na Gnu / Linux sustavima. Provjerite sljedeće članak ako još niste instalirali Linuxbrew na vašem Ubuntuu, jer je potrebno učiniti sljedeće.

Jednom kada je Linuxbrew instaliran, pokrenite sljedeću naredbu u terminalu (Ctrl + Alt + T) na instaliraj Um:

UM instalacija s linuxbrew

brew install sinclairtarget/wst/um

Ako sve bude u redu, terminal će nam reći da je instalacija zadovoljavajuće završena.

Prije nego što ga upotrijebite za izradu man stranica, morate omogućiti završetak basha za Um. Da biste to učinili, otvorite svoju datoteku ~ / .bash_profile:

vi ~/.bash_profile

U datoteku dodajte sljedeće retke:

bash profil um instalirati linuxbrew

if [ -f $(brew --prefix)/etc/bash_completion.d/um-completion.sh ]; then
. $(brew --prefix)/etc/bash_completion.d/um-completion.sh
fi

Spremite i zatvorite datoteku. Sada pokrenite sljedeću naredbu za ažurirati promjene:

source ~/.bash_profile

Sve je spremno. Sada možemo stvoriti našu prvu man stranicu.

Konfiguriraj Hm

u pogledajte trenutne postavke, trčanje:

UM konfiguracija

um config

U ovoj ćemo datoteci moći uređivati ​​i mijenjati vrijednosti opcija kao što su zadana tema, direktorij stranica i stranica, kako nas najviše zanima. Recimo, na primjer, ako želite spremiti stvorene Um stranice u svoju mapu Dropbox, samo promijenite vrijednost direktive direktorija stranica i pošaljite ih u mapu Dropbox u Arhiva ~ / .um / umconfig zapisujući unutar nje.

pages_directory = /home/tu-usuario/Dropbox/um

Ako se datoteka ne stvori, morat će se stvoriti za pohranu konfiguracije.

Stvorite i održavajte vlastite stranice s man

Recimo ako ste zainteresirani izradite vlastitu man stranicu za naredbu 'apt', pokrenite u terminalu (Ctrl + Alt + T):

um edit apt

Gornja naredba otvorit će a predložak u vašem zadanom uređivaču:

Predložak stranice o apt stvoren s um

Moj zadani urednik je Vi. Sada možemo početi dodajte sve što trebate zapamtiti o naredbi 'apt' u ovom predlošku.

cijela stranica um apt

Kao što se vidi na gornjoj snimci zaslona, ​​kao primjer sam dodao sinopsis, opis i neke opcije naredbe apt. Moći ćeš dodajte onoliko odjeljaka koliko želite na ovim stranicama. Obavezno navedite odgovarajuće i lako razumljive naslove za svaki odjeljak. Kada završite, spremite i zatvorite datoteku. Ako koristite Vi editor, pritisnite tipku ESC i upišite: wq.

Sada možeš pogledajte svoju novostvorenu man stranicu pomoću naredbe:

Man stranica kreirana s apt um

um apt

Kao što vidite, man stranica za apt izgleda isto kao i službene stranice s uputama. Ako želite urediti i / ili dodati više detalja na man stranici, ponovo pokrenite istu naredbu i dodajte željene detalje.

um edit apt

Da je vidim popis man stranica stvorenih nedavno korištenjem Um, pokrenite u terminalu (Ctrl + Alt + T):

um list

Ako ne više ne trebate određenu stranicu, samo ga izbrišite kao što je prikazano dolje:

um rm dpkg

u pogledajte odjeljak pomoći i sve opće dostupne opcije, pokrenite naredbu:

hm pomoć

um --help

Sve stranice s uputama bit će spremljene u direktorij zvan ~ / .um u vašem kućnom direktoriju. Tko želi, može znati više o ovoj aplikaciji u spremištu u kojem je projekt GitHub.


Ostavite svoj komentar

Vaša email adresa neće biti objavljen. Obavezna polja su označena s *

*

*

  1. Za podatke odgovoran: Miguel Ángel Gatón
  2. Svrha podataka: Kontrola neželjene pošte, upravljanje komentarima.
  3. Legitimacija: Vaš pristanak
  4. Komunikacija podataka: Podaci se neće dostavljati trećim stranama, osim po zakonskoj obvezi.
  5. Pohrana podataka: Baza podataka koju hostira Occentus Networks (EU)
  6. Prava: U bilo kojem trenutku možete ograničiti, oporaviti i izbrisati svoje podatke.