Hm, kreirajte i održavajte vlastite Ubuntu man stranice

o um

U sljedećem članku ćemo pogledati Um. Danas niko ne može sumnjati u korisnost man stranica i njihovih alternativa. Ove alternative se uglavnom koriste za pristup prilagođeni primjeri, a samim tim i ne mora prolaziti kroz cijele stranice s uputama. Ako tražite brz način da lako komunicirate ili naučite Gnu / Linux naredbu, vrijedi isprobati ove alternative. Um će nam omogućiti da kreiramo vlastite stranice pomoći za naredbu. Ovo je uslužni program za terminal, što je vrlo korisno 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 da uzmemo u obzir slučaj koji nas zanima. Ako si ikad želio 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 kada ovo pišem, jednostavno može se instalirati pomoću Linuxbrew upravitelja paketa na Gnu / Linux sistemima. 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 sa 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 bash završetak za Um. Da biste to učinili, otvorite svoju datoteku ~ / .bash_profile:

vi ~/.bash_profile

I, dodajte sljedeće redove u datoteku:

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žuriraj promjene:

source ~/.bash_profile

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

Konfiguriraj Um

para pogledajte trenutne postavke, pokrenite:

UM konfiguracija

um config

U ovoj datoteci moći ćemo uređivati ​​i mijenjati vrijednosti opcija kao što su zadana tema, direktorij stranica i stranice, kako nas najviše zanima. Recimo na primjer da ako želite sačuvati kreirane Um stranice u svoju Dropbox mapu, samo promijenite vrijednost direktive direktorija pages i pošaljite ih u Dropbox mapu u arhiva ~ / .um / umconfig pisanje u njemu.

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

Ako se datoteka ne kreira, 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 će otvoriti a predložak u vašem zadanom uređivaču:

predložak man stranice o apt-u stvoren pomoću um

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

cijela stranica um apt

Kao što se vidi na snimku zaslona iznad, kao primjer sam dodao sinopsis, opis i neke opcije naredbe apt. Moći ćete 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 unesite: wq.

Sada možeš pogledajte vašu 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. 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 lista man stranica stvorenih nedavno korištenjem Um, pokrenite u terminalu (Ctrl + Alt + T):

um list

Ako ne više vam nije potrebna određena stranica, samo ga izbrišite kao što je prikazano dolje:

um rm dpkg

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

um pomoć

um --help

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


Ostavite komentar

Vaša e-mail adresa neće biti objavljena. Obavezna polja su označena sa *

*

*

  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 obavezi.
  5. Pohrana podataka: Baza podataka koju hostuje Occentus Networks (EU)
  6. Prava: U bilo kojem trenutku možete ograničiti, oporaviti i izbrisati svoje podatke.