Qual è il modo semplice per convertire tutte le pagine man in html?

1

Sedici anni nel XXI secolo rimango sconcertato dal fatto che dobbiamo ancora smarcarci se vogliamo vedere una pagina man

  • reso in un font proporzionale (cioè non Courier o simile)
  • con collegamenti ad altre pagine di riferimento

Ci sono siti Web allettanti con pagine man HTML con link, come questo , ma Non ho trovato un sito di questo tipo con pagine aggiornate per la versione attuale di macOS. E naturalmente un sito web non mostrerà le pagine man per i software che hai installato tramite Homebrew, ecc.

C'è una soluzione a questo problema? Ho guardato e guardato. Questo

function manp {
  man -t "$1" | open -f -a /Applications/Preview.app/
}

esegue il rendering di una pagina e la mostra in Anteprima (dopo aver atteso un interprete PostScript per convertirlo in PDF), ma non ottieni collegamenti in tempo reale.

La pagina man per l'uomo dice:

HTML PAGES

Man will find HTML pages if they live in directories named as expected to be ".html", thus a valid name for an HTML version of the ls(1) man page would be /usr/share/man/htmlman1/ls.1.html.

Potrei scrivere uno script per convertire tutte le pagine man del mio sistema su HTML, ma scommetto che qualcuno lo ha già fatto. E scommetto che hanno anche risolto il problema del rendering VEDERE ANCHE i riferimenti come link, che il comando man apparentemente non fa.

    
posta daveyost 15.12.2016 - 03:16
fonte

2 risposte

2

Installa Bwana che ti consente di sfogliare le pagine man nel tuo browser preferito.

Per citare la pagina sopra "Digita semplicemente" man: "seguito dalla pagina man che stai cercando nel campo URL del tuo browser. Premi invio e lascia fare a Bwana il resto." Ha collegamenti in tempo reale.

    
risposta data 15.12.2016 - 05:39
fonte
1

bcat ti consente di reindirizzare stdout al tuo browser predefinito. Un'alternativa alla tua funzione di anteprima sarebbe:

bman () 
{ 
    : Display man page in default browser
    man $* | col -b | bcat
}

... o imposta semplicemente il% cercapersone di man :

export MANPAGER='col -b | bcat'
man grep

bcat funziona con qualsiasi comando che scrive su stdout :

pbpaste  | bcat
make test | bcat
tail -n 1000 -f /var/log/messages | bcat

... etc.

È una gemma di rubini, quindi l'installazione è facile come:

gem install bcat

Se la conversione "al volo" non è sufficiente e vuoi produrre HTML tutto in una volta o in anticipo, questo post su Unix.se ha un numero di suggerimenti (purtroppo uno dei miei strumenti preferiti, il potente pandoc , non funzionerà per questo ...)

    
risposta data 15.12.2016 - 09:22
fonte

Leggi altre domande sui tag