Installer les manpages linux sur MacOS

Les recommandations d'utiliser man7.org et ss64.com sont légitimes. J'utilise régulièrement ces deux sites.

Mais j'ai généralement envie de lire des pages d'homme. dans le terminal Je me suis donc récemment mis à la recherche d'un référentiel semi-complet de pages de manuel GNU/Linux au format brut roff, en pensant pouvoir groff -T utf8 à la volée.

J'ai proposé quelques options :

• Manpages Debian
• l'instance cgit pour le Projet de pages de manuel Linux
• l'instance cgit pour le Pages de manuel POSIX sur kernel.org

Voici un exemple de fonction Bash qui va chercher la page de manuel demandée sur le serveur des pages de manuel de Debian, puis la tape avec groff .

# fetch Debian Linux man pages from https://manpages.debian.org
lman() {
    local encoding=utf8
    local lang=en
    local baseurl='https://manpages.debian.org/stable'
    local manpage=${1:?What manual page do you want?}

    curl -sL "$baseurl/$manpage.$lang.gz" \
      | groff -man -T$encoding \
      | less
}

J'ai un récent groff de MacPorts, mais celui qui est fourni avec MacOS devrait être suffisante.

Sur mon système, cela donne une sortie de 80 colonnes. Si vous voulez être plus fantaisiste, voici comment vous pouvez ajuster la sortie à un nombre spécifique de colonnes ( maxwidth ), et le centre à l'intérieur du terminal. Cela améliore considérablement la lisibilité lorsque votre écran principal peut afficher un grand nombre de colonnes.

# fetch Debian Linux man pages from https://manpages.debian.org and reformat
# to `maxwidth` columns, centered within the terminal
lman() {
    local maxwidth=100
    local encoding=utf8
    local lang=en
    local baseurl='https://manpages.debian.org/stable'
    local termwidth=$(tput cols)
    local width=$(( termwidth < maxwidth ? termwidth : maxwidth ))
    local margin=$(( (termwidth - width) / 2 ))
    local pad=$(printf "%${margin}s")
    local manpage=${1:?What manual page do you want?}

    curl -sL "$baseurl/$manpage.$lang.gz" \
      | groff -man -T$encoding -rLL=${width}n \
      | sed "s/^/$pad/" \
      | less
}

Les fonctions ci-dessus ne sont pas parfaites, car bien sûr les pages de manuel rendues ne sont pas mises en cache, il y a donc toujours un délai, et elles ne font pas la différence entre les sections du manuel, par exemple , crontab(1) vs. crontab(5) . L'implémentation de ces fonctionnalités est laissée comme un exercice pour le lecteur. ;)

Pour récupérer à partir d'une des autres sources mentionnées ci-dessus, comme les pages de manuel POSIX de kernel.org, il suffit d'ajuster l'URL récupérée par curl selon les besoins. Par exemple, la source roff pour le programme POSIX cp peut être récupérée à partir de https://git.kernel.org/pub/scm/docs/man-pages/man-pages-posix.git/plain/man-pages-posix-2017/man1p/cp.1p Vous devez donc mettre à jour le fichier lman comme suit :

# fetch a POSIX man page from git.kernel.org's man-pages repository
pman() {
    local encoding=utf8
    local baseurl='https://git.kernel.org/pub/scm/docs/man-pages/man-pages-posix.git/plain/man-pages-posix-2017/man1p'
    local manpage=${1:?What manual page do you want?}

    curl -sL "$baseurl/$manpage.1p" \
      | groff -man -T$encoding \
      | less
}

La réponse de DarkDust est toujours le meilleur si vous avez besoin d'un accès hors ligne, cependant.