Co to jest format pliku 1?
Pliki .1 przechowują strony podręcznika Unix w formacie tekstowym, konkretnie dla sekcji 1 - programów wykonywalnych i poleceń użytkownika. Są one powszechnie nazywane stronami man i są pisane w znacznikach .roff przy użyciu pakietu makr man (groff), z dyrektywami poprzedzonymi kropką, takimi jak .TH, .SH, .B i .TP, które kontrolują układ podczas renderowania.
Strony podręcznika przegląda się, uruchamiając man nazwa_aplikacji w terminalu Unix. Cyfrowy przyrostek wskazuje sekcję podręcznika: .1 obejmuje polecenia użytkownika, podczas gdy sekcje od .2 do .8 obejmują odpowiednio wywołania systemowe, funkcje biblioteczne, formaty plików, gry i polecenia administracyjne. Wszystkie sekcje współdzielą ten sam bazowy format źródłowy roff.
Pliki stron podręcznika mogą być przechowywane w formie skompresowanej - w większości systemów Linux i macOS znajdują się one w ścieżkach takich jak /usr/share/man/man1/ls.1.gz i są dekompresowane na żądanie przez polecenie man. Kompresja .gz jest niewidoczna z perspektywy użytkownika.
Windows używa innego systemu pomocy: w trybie graficznym pomoc jest dostępna po naciśnięciu klawisza F1, a w PowerShell poprzez dodanie /? lub -? do polecenia. Dla stron man w stylu Unix na Windows, Windows Subsystem for Linux (WSL) zapewnia pełne środowisko man i groff. Oczywiście pliki stron podręcznika muszą być zainstalowane dla danej aplikacji, zanim będą mogły zostać wyświetlone na dowolnej platformie.
Bezpieczeństwo
RYZYKO: LOWŹródło strony man jest zwykłym tekstem i nie wykonuje się podczas przeglądania. Jedyną teoretyczną uwagą jest to, że roff jest językiem makr kompletnym w sensie Turinga, a groff historycznie miewał błędy parsowania, więc renderowanie pliku .1 z całkowicie niezaufanego źródła najlepiej wykonywać za pomocą bezpieczniejszego, piaskownicowego mandoc zamiast pełnego groff. W normalnym użytkowaniu (czytanie dokumentacji z pakietów i projektów) plik .1 jest nieszkodliwy; otwarcie go w edytorze tekstu jest całkowicie bezpieczne.
Szczegóły formatu
w pigułceProgramy otwierające pliki 1
Windows2 apps
WSL (man + groff)
Wbudowany W Windows Subsystem for Linux uruchom „man ./nazwa.1”; lub zainstaluj groff przez MSYS2, aby wyrenderować stronę.
Notepad / any text editor
Darmowy Otwórz źródło .1 jako zwykły tekst, aby przeczytać surowe znaczniki roff w systemie Windows (bez zastosowanego formatowania). 
macOS2 apps
man / groff (built-in)
Wbudowany macOS dostarcza man i groff: „man ./nazwa.1”, aby go przeczytać; groff, aby przekonwertować na tekst/PS/PDF.
Terminal text editor / BBEdit
Freemium Otwórz źródło .1 w dowolnym edytorze, aby przeglądać/edytować znaczniki roff. 
Linux3 apps
man (man-db)
Open-source Uruchom „man ./nazwa.1”, aby wyświetlić sformatowaną stronę w terminalu; man wywołuje groff, aby wyrenderować pogrubienie/kursywę.
groff
Open-source Renderuj bezpośrednio: „groff -man -Tascii nazwa.1 | less” dla tekstu, „-Thtml” dla HTML, „-Tpdf” dla PDF.
Text editor (Vi/Vim, GNU Emacs, nano, Notepad++)
Open-source Otwórz surowe źródło .1, aby czytać/edytować znaczniki roff (zobaczysz makra .TH, .SH, a nie sformatowaną stronę). Szczegóły techniczne
specyfikacja| Typ formatu | Źródło roff/groff w formacie tekstowym przy użyciu pakietu makr man |
| Kodowanie | Zwykły tekst ASCII lub UTF-8; nie jest wymagany nagłówek binarny ani BOM |
| Typ MIME | text/troff (akceptowany również jako application/x-troff-man) |
| Sygnatura pliku | Brak binarnych magicznych bajtów; źródła man konwencjonalnie zaczynają się od linii tytułowej .TH, np. .TH LS 1 |
| Objęta sekcja podręcznika | Sekcja 1 - programy wykonywalne i ogólne polecenia użytkownika |
| Makra znaczników | .TH (tytuł/nagłówek), .SH (nagłówek sekcji), .B (pogrubienie), .I (kursywa), .TP (akapit z etykietą), .PP (koniec akapitu) |
| Przechowywanie na dysku | Często kompresowane gzip jako nazwa.1.gz, przechowywane w /usr/share/man/man1/ w systemie Linux |
| Typowy rozmiar nieskompresowany | 1 KB - 100 KB |
| Renderer / przeglądarka | Przetwarzane przez groff lub nroff; wyświetlane za pomocą polecenia man w terminalu |
| Standardowa struktura strony | Obowiązkowe sekcje: NAME, SYNOPSIS, DESCRIPTION; typowe dodatki: OPTIONS, FILES, SEE ALSO, AUTHOR, BUGS |
| Rozszerzenia sekcji pokrewnych | .2 (wywołania systemowe), .3 (funkcje biblioteczne), .5 (formaty plików), .8 (administracja systemem) |
| Powiązane systemy operacyjne | Linux, macOS, warianty BSD; dostępne na Windows przez WSL (Windows Subsystem for Linux) |
| Deweloper / opiekun | Powstał w Bell Labs (1971); implementacja groff utrzymywana przez Projekt GNU |
| Wariant wstępnie sformatowany | Niektóre pliki .1 to strony cat - wyrenderowany tekst z pogrubieniem uzyskanym przez nadpisywanie znakiem backspace, a nie źródło roff |
| Wydano | 1971 (Unix Programmer's Manual, V1); man macros standardized over the 1970s-80s |
| Najnowsza wersja | N/A (roff/man-macro convention; groff is the active implementation) |
| Otwarty standard | Tak · bezpłatny (royalty-free) |
| Specyfikacja | man7.org |
Konwersje 1
Pytania i odpowiedzi społeczności
pytania użytkownikówBrak pytań - bądź pierwszą osobą, która zapyta o pliki 1.
