Cos'è una pagina man ?
Una pagina man (abbreviazione di pagina manuale) è la tradizionale forma di documentazione software su un sistema operativo simile a Unix come Ubuntu. Per la stragrande maggioranza dei comandi e dei programmi c'è una pagina man che elenca le sue opzioni e ne spiega l'utilizzo.
Come posso trovare e visualizzare le pagine man?
Offline in un terminale
Le pagine man vengono installate automaticamente sul tuo sistema insieme ai comandi che descrivono. Per visualizzare e cercare le pagine man c'è il comando man
:
man mv
visualizza la pagina man di mv
while
man -k mv
cerca i nomi e le brevi descrizioni di tutte le pagine man installate per la stringa mv
. Sono consentite espressioni regolari estese POSIX ed è una ricerca , quindi questo troverà anche ad esempio git-mv
e semver
, se si desidera cercare, mv
utilizzare esattamente ^mv$
.
Vedi Qual è la differenza tra `man` e` man (#) `? per leggere le sezioni della pagina man. Per maggiori informazioni leggi man
la pagina man. ;)
Come posso influenzare come viene visualizzata una pagina man?
Il programma predefinito per visualizzare le pagine man è less
. Questo cosiddetto cercapersone fornisce un'utile funzione di ricerca, basta inserire /
seguito dal termine di ricerca, ad es
/--version
e premere Enter. Questo segnerà ogni scoperta e scorrerà fino alla prima. Premere Nper passare alla successiva ricerca e ⇧ Shift+ Nper passare alla precedente (vedere Come posso effettuare una ricerca in una manpage? ). Per un elenco di comandi premere H, per uscire less
premere Q.
Accanto less
ci sono altri cercapersone disponibili: pg
, most
e w3m
solo per la lista a tre. Consiglio most
: viene fornito con una colorazione molto utile delle parole chiave che rende molto più facile la lettura e la navigazione di una pagina man , vedere di persona:
Per visualizzare una pagina man in un pager diverso da quello predefinito, utilizzare l' -P
opzione, ad esempio:
man -P most mv
Se si desidera modificare le pagine man predefinite del cercapersone vengono visualizzate con sono disponibili due opzioni:
cambia il cercapersone predefinito solo di man
export MANPAGER=most
Per rendere persistente la modifica, aggiungi questo comando al tuo ~/.bashrc
file.
cambia il cercapersone predefinito dell'intero sistema
sudo update-alternatives --config pager
I fan possono anche (ab) usare vim
come MANPAGER
, vedi questo articolo scritto da Muru .
Le pagine man vengono visualizzate nel tipo di carattere specificato nelle impostazioni dell'emulatore di terminale. Se lavori regolarmente con il terminale, potresti voler cambiare questo carattere; Posso solo raccomandare Hack - un carattere tipografico progettato per il codice sorgente , vedi lo screenshot sopra per la sua bellezza.
Offline tramite GUI
Un programma semplice e intuitivo per visualizzare le pagine man con una semplice GUI è il yelp
programma preinstallato . Per avviare una pagina man con yelp
execute yelp man:PROGRAM
o gnome-help man:PROGRAM
, ad esempio:
yelp man:mv
Puoi anche visualizzare le pagine man con il tuo browser preferito , vedi Come posso aprire le pagine man in un browser web? , ad esempio per man mv
in firefox
:
man -Hfirefox mv
Ultimo ma non meno importante, puoi convertire le pagine man in PDF e visualizzarle con il tuo visualizzatore PDF preferito, vedi: Esiste un modo per stampare informazioni / pagine man in PDF?
in linea
Puoi visualizzare le pagine man dei programmi disponibili tramite i repository di ogni versione di Ubuntu attualmente supportata con l'URL di scorciatoia manpg.es/PROGRAM
, ad esempio http://manpg.es/mv . Questo apre mv
la pagina man dell'ultima versione di Ubuntu, puoi scegliere una versione diversa nella barra in alto. Per cercare pagine man è possibile utilizzare ad esempio http://manpages.ubuntu.com/cgi-bin/search.py?q=mv .
Come spiegato sopra, è man
possibile visualizzare solo le pagine man del software installato sul sistema. Per visualizzare le pagine man da http://manpages.ubuntu.com usando un cercapersone terminale è dman
disponibile nel bikeshed
pacchetto.
Altre fonti
Quando leggi la documentazione da altre fonti online è una buona idea tenere d'occhio la versione del programma. La maggior parte dei programmi ha --version
un'opzione che visualizza la versione del programma in questione, ad es
$ mv --version
mv (GNU coreutils) 8.25
Ci sono molti siti Web che si sono dedicati a rendere facilmente disponibili le pagine man, presenterò solo le due che mi piacciono di più:
- man7.org viene fornito con l'evidenziazione della sintassi utile, ma presenta solo l'ultima versione rilasciata del programma
- manpag.es ospita le pagine man delle versioni di Ubuntu ormai obsolete
Fonte non già collegata: https://wiki.ubuntuusers.de/man/