Was ist das 1-Dateiformat?
.1-Dateien speichern Unix Manual Pages im Klartextformat, speziell für Abschnitt 1 - ausführbare Programme und Benutzerbefehle. Sie werden gemeinhin als „Manpages“ bezeichnet und sind in .roff-Markup unter Verwendung des man-Makropakets (groff) verfasst, wobei mit Punkten beginnende Direktiven wie .TH, .SH, .B und .TP das Layout beim Rendern steuern.
Manpages werden durch Ausführen von man name_der_anwendung in einem Unix-Terminal angezeigt. Das numerische Suffix gibt den Handbuchabschnitt an: .1 deckt Benutzerbefehle ab, während .2 bis .8 jeweils Systemaufrufe, Bibliotheksfunktionen, Dateiformate, Spiele und Administrationsbefehle abdecken. Alle Abschnitte teilen das gleiche zugrunde liegende roff-Quellformat.
Manpage-Dateien können komprimiert gespeichert sein - auf den meisten Linux- und macOS-Systemen befinden sie sich unter Pfaden wie /usr/share/man/man1/ls.1.gz und werden bei Bedarf vom man-Befehl dekomprimiert. Die .gz-Komprimierung ist aus Sicht des Benutzers unsichtbar.
Windows verwendet ein anderes Hilfesystem: Im grafischen Modus wird die Hilfe durch Drücken von F1 aufgerufen, und in der PowerShell durch Anhängen von /? oder -? an einen Befehl. Für Unix-ähnliche Manpages unter Windows bietet das Windows Subsystem for Linux (WSL) eine vollständige man- und groff-Umgebung. Natürlich müssen Manpage-Dateien für eine bestimmte Anwendung installiert sein, bevor sie auf einer beliebigen Plattform angezeigt werden können.
Sicherheit
RISIKO: LOWEine Manpage-Quelle ist Klartext und wird beim Betrachten nicht ausgeführt. Die einzige theoretische Vorsicht ist, dass roff eine Turing-vollständige Makrosprache ist und groff historisch Parsing-Fehler aufwies; das Rendern einer .1-Datei aus einer völlig unvertrauenswürdigen Quelle erfolgt daher am besten mit dem sichereren, Sandbox-basierten mandoc anstelle des vollständigen groff. Bei normalem Gebrauch (Lesen von Dokumentationen aus Paketen und Projekten) ist eine .1-Datei harmlos; das Öffnen in einem Texteditor ist völlig sicher.
Formatdetails
kurz gefasstProgramme zum Öffnen von 1-Dateien
Windows2 apps
WSL (man + groff)
Integriert Führen Sie im Windows Subsystem for Linux „man ./name.1“ aus; oder installieren Sie groff über MSYS2, um die Seite zu rendern.
Notepad / any text editor
Kostenlos Öffnen Sie den .1-Quellcode als Klartext, um das roff-Markup unter Windows zu lesen (keine Formatierung angewendet). 
macOS2 apps
man / groff (built-in)
Integriert macOS liefert man und groff mit: „man ./name.1“ zum Lesen; groff zum Konvertieren in Text/PS/PDF.
Terminal text editor / BBEdit
Freemium Öffnen Sie den .1-Quellcode in einem beliebigen Editor, um das roff-Markup anzuzeigen/zu bearbeiten. 
Linux3 apps
man (man-db)
Open Source Führen Sie „man ./name.1“ aus, um sie formatiert im Terminal anzuzeigen; man ruft groff auf, um Fett- und Kursivdruck zu rendern.
groff
Open Source Direkt rendern: „groff -man -Tascii name.1 | less“ für Text, „-Thtml“ für HTML, „-Tpdf“ für PDF.
Text editor (Vi/Vim, GNU Emacs, nano, Notepad++)
Open Source Öffnen Sie den .1-Quellcode, um das roff-Markup zu lesen/bearbeiten (Sie sehen .TH, .SH Makros, keine formatierte Seite). Technische Details
technische Spezifikation| Formattyp | Klartext roff/groff-Quelle unter Verwendung des man-Makropakets |
| Kodierung | ASCII oder UTF-8 Klartext; kein binärer Header oder BOM erforderlich |
| MIME-Typ | text/troff (auch akzeptiert als application/x-troff-man) |
| Dateisignatur | Keine binären Magic Bytes; man-Quellen beginnen konventionell mit einer .TH-Titelzeile, z. B. .TH LS 1 |
| Abgedeckter Handbuchabschnitt | Abschnitt 1 - ausführbare Programme und allgemeine Benutzerbefehle |
| Markup-Makros | .TH (Titel/Header), .SH (Abschnittsüberschrift), .B (fett), .I (kursiv), .TP (markierter Absatz), .PP (Absatzumbruch) |
| Speicherung auf Datenträger | Häufig gzip-komprimiert als name.1.gz, gespeichert unter /usr/share/man/man1/ unter Linux |
| Typische unkomprimierte Größe | 1 KB - 100 KB |
| Renderer / Viewer | Verarbeitet durch groff oder nroff; Anzeige über den man-Befehl in einem Terminal |
| Standard-Seitenstruktur | Pflichtabschnitte: NAME, SYNOPSIS, DESCRIPTION; häufige Ergänzungen: OPTIONS, FILES, SEE ALSO, AUTHOR, BUGS |
| Erweiterungen verwandter Abschnitte | .2 (Systemaufrufe), .3 (Bibliotheksfunktionen), .5 (Dateiformate), .8 (Systemadministration) |
| Zugehörige Betriebssysteme | Linux, macOS, BSD-Varianten; verfügbar unter Windows via WSL (Windows Subsystem for Linux) |
| Entwickler / Maintainer | Ursprünglich bei Bell Labs (1971); groff-Implementierung wird vom GNU Project gepflegt |
| Vorformatierte Variante | Einige .1-Dateien sind „cat pages“ - vorgerenderter Text mit Backspace-Overstrike für Fettdruck, kein roff-Quellcode |
| Veröffentlicht | 1971 (Unix Programmer's Manual, V1); man macros standardized over the 1970s-80s |
| Neueste Version | N/A (roff/man-macro convention; groff is the active implementation) |
| Offener Standard | Ja · lizenzgebührenfrei |
| Spezifikation | man7.org |
1-Konvertierungen
Community Q&A
von Nutzern gefragtNoch keine Fragen - stellen Sie die erste Frage zu 1-Dateien.
