Drucken Sie Manpages mit fester Breite

Mit dem Beispielbefehl

man apropos > outputfile

Es wird eine Textdatei generiert, die die formatierte manSeite von enthält apropos(mit einigen kleinen Unterschieden in Bezug auf man aproposdirekt auf dem Bildschirm gedruckte, z. B. fett gedruckte Zeichen).

Ich möchte jedoch die maximale Zeilenbreite der generierten Ausgabedatei manuell festlegen, damit alle Absätze auf diese Breite ausgerichtet werden.

manSeiten werden erstellt durch groff: Ich habe beispielsweise versucht, .ll 50einen Absatz der ursprünglichen .gz manQuelltextdatei vorzulegen, aber es ist trivial, wenn ich an mehreren manSeiten arbeiten muss. Außerdem werden nicht alle Zeichen erkannt:

apropos.1:45: warning: can't find character with input code 195
apropos.1:45: warning: can't find character with input code 168
apropos.1:47: warning: can't find character with input code 178
apropos.1:131: warning: can't find character with input code 169

Ich frage mich also, ob es eine einfachere Methode gibt. Wie ändere ich die maximale Linienbreite während der Erstellung eines outputfile? Gibt es einen bestimmten Befehl?

Bearbeiten :

(Alle folgenden Überlegungen beziehen sich auf Ubuntu 18.04: Ich kann sie in früheren Versionen nicht mehr testen, einschließlich 14.04 der obigen Frage.)

Bei einer einzeiligen temporären Lösung MANWIDTHgibt es keinen Unterschied , wenn sie noch nicht mit einem benutzerdefinierten Wert exportiert wurde

$ MANWIDTH=60 man apropos > outputfile

und

$ COLUMNS=60 man apropos > outputfile

Die erste Verwendung MANWIDTHist jedoch im Prinzip besser.

Bearbeiten 2 (nicht eng mit der Frage verbunden):

Um stattdessen eine permanente Breiteneinstellung vorzunehmen, die auf jeden Manpage-Druck angewendet werden soll, muss der gewünschte Wert der Variablen exportiert werden. Mit:

$ export MANWIDTH=60
# zero or more additional lines
$ man apropos > outputfile

man aproposwird unabhängig von der Größe des Terminalfensters mit derselben Breite gedruckt. Stattdessen,

$ export COLUMNS=60
# zero or more additional lines
$ man apropos > outputfile

liefert nur dann das gleiche Ergebnis wie zuvor, wenn die Größe des Terminalfensters zwischen exportund nicht geändert wird man <page> > outputfile.

Verwenden Sie die MANWIDTHUmgebungsvariable:

MANWIDTH=60 man apropos > apropos.txt

Die Manpage für man 2.7.4 sagt:

Wenn $ MANWIDTH festgelegt ist, wird sein Wert als Zeilenlänge verwendet, für die Handbuchseiten formatiert werden sollen. Wenn es nicht festgelegt ist, werden Handbuchseiten mit einer Zeilenlänge formatiert, die dem aktuellen Terminal entspricht (unter Verwendung des Werts $ COLUMNS, eines ioctl (2), falls verfügbar, oder unter Verwendung von 80 Zeichen, falls keines verfügbar ist).

Das heißt, es überschreibt sowohl COLUMNSals auch den ioctlWert. Ich ziehe es vor, mich nicht auf Änderungen zu verlassen COLUMNS(obwohl dies hier funktioniert), da der Wert jedes Mal dynamisch aktualisiert wird, wenn sich die Fenstergröße ändert.

Wenn Sie MANWIDTHanstelle von verwenden, COLUMNSkönnen Sie die Änderung auch dauerhaft machen, indem Sie eine Zeile hinzufügen, z. B. export MANWIDTH=60zu Ihrer Shell-Startdatei.

Versuchen Sie, die COLUMNSUmgebungsvariable festzulegen. Funktioniert für mich mit manab mandb2.7.0.2 unter Debian mit groff1.22.3.

$ COLUMNS=60 man apropos | head
APROPOS(1)          Manual pager utils          APROPOS(1)



NAME
       apropos - search the manual page names and descrip‐
       tions

SYNOPSIS
       apropos [-dalv?V] [-e|-w|-r]  [-s  list]  [-m  sys‐

$ COLUMNS=70 man apropos | head
APROPOS(1)               Manual pager utils               APROPOS(1)



NAME
       apropos - search the manual page names and descriptions

SYNOPSIS
       apropos  [-dalv?V] [-e|-w|-r] [-s list] [-m system[,...]] [-M
       path] [-L locale] [-C file] keyword ...

Mit der Version unter Ubuntu 14.04 muss ich es schreiben:

COLUMNS=60 < /dev/null man apropos | head

Dort, man scheint die COLUMNSUmgebungsvariable zu ignorieren , wenn stdin ein Terminal ist (es fragt dann das Terminalgerät nach der Terminalbreite ab).

Sie können auch versuchen:

s=$(stty -g); stty cols 60; man apropos | head; stty "$s"

Welches mit zsh Ihnen verkürzen kann auf:

STTY='cols 60' man apropos | head

Sie können dies durch Aufrufen tun groff von Hand :

gzip -dcf "$(man -w apropos)" |
  groff -ekpstR -mtty-char -mandoc -Tutf8 -rLL=60n |
  col -bpx

Sie können Zeichen mit Eingabecodefehlern nicht finden, weil Sie die Dateien -Tasciianstelle von verwendet -Tutf8und nicht verwendet haben -k, um sie vorzuverarbeiten preconv.

Sie können den fmtBefehl verwenden, der meines Wissens in jeder Linux-Distribution vorhanden ist.

man apropos | fmt -w 70 

schließt Zeilen mit 70 Zeichen ein.

Sie können verwenden fold

man cp | fold -w 20

wird nach jeweils 20 Zeichen (!) gefaltet. Beachten Sie, dass dadurch Wörter in zwei Teile geteilt werden, da die einzige Option "Alle 20 Zeichen falten" ist.

Um dies zu gewährleisten, können Sie sedFolgendes verwenden (mit dynamischer Linienlänge)

man cp | sed 's/.\{20\} /&\n/g'

fügt nach 20 zufälligen Zeichen eine neue Zeile hinzu, gefolgt von einem Leerzeichen (dh einem neuen Wort). Zeilen können also länger als 20 Zeichen sein (Übereinstimmung ist 20 Zeichen, dann ein Leerzeichen, sodass ein Wort mit 26 Zeichen zu einer Zeile mit 26 Zeichen führen würde).

Zum Weglassen des letzten Leerzeichens im sedBefehl:

sed 's/\(.\{20\}\) /\1\n/g'