Pagine man online in HTML con ancore di sezione?
Sarebbe bello avere una versione online delle pagine man di Ubuntu con collegamenti diretti in sottosezioni. Ciò consentirebbe di indirizzare qualcuno alla documentazione pertinente in molti casi, ad esempio nelle risposte di vari siti StackExchange.
Descriverò come potrebbe apparire una soluzione completa e in che modo sarebbe utile. Non credo che una soluzione completa sia disponibile da qualche parte, quindi la domanda è
Quali soluzioni parziali esistono oggi?
Ad esempio, in qualche modo modi sistematici di cercare nelle pagine man, invece di creare collegamenti, sarebbe una soluzione parziale.
Le pagine man di manpages.ubuntu.com risolvono la maggior parte del problema, ma non hanno ancore sulle intestazioni o sezioni.
Ciò significa che, se voglio indicare la sezione "Espansione dei parametri" in
man bash
linea, devo usare
Vedi "Parameter Expansion" in [... e usa il tuo browser per cercare "Parameter Expansion"]
man bash
Questo apre la pagina man di bash in alto, come una lunga pagina web.
Nella shell, posso dire
Vedere
man bash | less "+/Parameter Expansion"
che salta nel posto giusto all'avvio.
Sarebbe davvero utile avere ancore di collegamento denominate come le intestazioni a cui puntano. Le ancore indicate da un qualche tipo di numero di indice sarebbero comunque utili, ma per utilizzarlo è necessaria una ricerca manuale sulla pagina Web effettiva.
Dato che non è difficile a livello HTML aggiungere ancore alle intestazioni, sono sicuro che tali pagine man esistano;
Ma c'è una raccolta di pagine man di Ubuntu con ancore online da qualche parte, o almeno un buon sottoinsieme?
Codice di esempio
L'intestazione della sezione "Espansione dei parametri" da
http://manpages.ubuntu.com/bash
che reindirizza a
http://manpages.ubuntu.com/manpages/trusty/en/man1/bash.1.html
[ ... ]
tildes in assignments to <b>PATH</b>, <b>MAILPATH</b>, and <b>CDPATH</b>, and the shell
assigns the expanded value.
<b>Parameter</b> <b>Expansion</b>
The `<b>$</b>' character introduces parameter expansion, command substitution,
or arithmetic expansion. The parameter name or symbol to be expanded
[ ... ]
Per poter collegare direttamente a questa sezione, abbiamo bisogno di qualcosa come:
[ ... ]
tildes in assignments to <b>PATH</b>, <b>MAILPATH</b>, and <b>CDPATH</b>, and the shell
assigns the expanded value.
<a href="#ParameterExpansion"><b>Parameter</b> <b>Expansion</b></a>
The `<b>$</b>' character introduces parameter expansion, command substitution,
or arithmetic expansion. The parameter name or symbol to be expanded
[ ... ]
Ciò aggiunge un tag al codice HTML e un attributo, il nome della sezione senza spazi:
<b>Parameter</b> <b>Expansion</b>
<a href="#ParameterExpansion"><b>Parameter</b> <b>Expansion</b></a>
Ora, possiamo collegarci alla sezione come
http://manpages.ubuntu.com/bash#ParameterExpansion
o anche
manpages.ubuntu.com/bash#ParameterExpansion
che utilizza una nota a piè di pagina ed è scritto come
[manpages.ubuntu.com/bash#ParameterExpansion[[6]
Uso di altri documenti di riferimento
In molti casi, sono disponibili documenti di riferimento alternativi, a parte la pagina man. Questi spesso hanno una buona struttura di collegamenti che viene utilizzata per collegare da un sommario alle sezioni, proprio ciò di cui abbiamo bisogno.
Ma questo non risolve il problema generale , in quanto non esiste un modo comune per scoprire se / dove esiste un documento del genere e utilizzare la struttura dei collegamenti.
Per l'esempio bash usato sopra, il Manuale di riferimento di Bash potrebbe essere usato come soluzione individuale cercata manualmente:
Sezione del manuale di riferimento di Bash Espansione dei parametri della shell
scritta come
[Sezione del manuale di riferimento di Bash Espansione dei parametri della shell] (http://www.gnu.org/software/bash/manual/bash.html#Shell-Parameter-Expansion)
Implementazione proposta
Per proporre effettivamente l'implementazione di questa idea su manpages.ubuntu.com ,
ho presentato una richiesta di bug / miglioramento strettamente correlata al progetto associato "ubuntu-manpage-repository":
launchpad # 1355271: Usa HTML a tag per consentire collegamenti esterni a sottosezioni di man pagine