Hva er 1-filformatet?
.1-filer lagrer Unix manualsider i ren tekst-format, spesifikt for seksjon 1 - kjørbare programmer og brukerkommandoer. De blir vanligvis referert til som «man pages» og er skrevet i .roff-markup ved bruk av man-makropakken (groff), med punktum-prefiksede direktiver som .TH, .SH, .B og .TP som kontrollerer layout når de rendres.
Manualsider vises ved å kjøre man navn_på_applikasjonen i en Unix-terminal. Det numeriske suffikset indikerer manualseksjonen: .1 dekker brukerkommandoer, mens .2 til .8 dekker henholdsvis systemkall, biblioteksfunksjoner, filformater, spill og administrasjonskommandoer. Alle seksjoner deler det samme underliggende roff-kildeformatet.
Manualside-filer kan lagres komprimert - på de fleste Linux- og macOS-systemer ligger de på stier som /usr/share/man/man1/ls.1.gz og dekomprimeres ved behov av man-kommandoen. .gz-komprimeringen er usynlig fra brukerens perspektiv.
Windows bruker et annet hjelpesystem: i grafisk modus får man tilgang til hjelp ved å trykke F1, og fra PowerShell ved å legge til /? eller -? til en kommando. For Unix-aktige manualsider på Windows, tilbyr Windows Subsystem for Linux (WSL) et fullstendig man- og groff-miljø. Selvfølgelig må manualside-filene være installert for en gitt applikasjon før de kan vises på noen plattform.
Sikkerhet og trygghet
RISIKO: LOWEn kilde til en manualside er ren tekst og kjører ikke ved visning. Den eneste teoretiske forsiktighetsregelen er at roff er et Turing-komplett makrospråk og groff har historisk sett hatt parsettingsfeil, så rendring av en .1 fra en helt upålitelig kilde gjøres best med den sikrere, sandkasse-baserte mandoc i stedet for full groff. Ved normal bruk (lesing av dokumentasjon fra pakker og prosjekter) er en .1-fil ufarlig; å åpne den i et tekstredigeringsprogram er helt trygt.
Formatdetaljer
i et nøtteskallProgrammer som åpner 1-filer
Tekniske detaljer
dyp spesifikasjon| Format-type | Ren tekst roff/groff-kilde som bruker man-makropakken |
| Koding | ASCII eller UTF-8 ren tekst; ingen binær header eller BOM kreves |
| MIME-type | text/troff (også akseptert som application/x-troff-man) |
| Filsignatur | Ingen binære magiske byte; man-kilder starter konvensjonelt med en .TH-tittellinje, f.eks. .TH LS 1 |
| Manualseksjon dekket | Seksjon 1 - kjørbare programmer og generelle brukerkommandoer |
| Markup-makroer | .TH (tittel/header), .SH (seksjonsoverskrift), .B (fet), .I (kursiv), .TP (tagget avsnitt), .PP (avsnittsskift) |
| Lagring på disk | Ofte gzip-komprimert som navn.1.gz, lagret under /usr/share/man/man1/ på Linux |
| Typisk ukomprimert størrelse | 1 KB - 100 KB |
| Renderer / fremviser | Behandles av groff eller nroff; vises via man-kommandoen i en terminal |
| Standard sidestruktur | Obligatoriske seksjoner: NAME, SYNOPSIS, DESCRIPTION; vanlige tillegg: OPTIONS, FILES, SEE ALSO, AUTHOR, BUGS |
| Søskenseksjons-utvidelser | .2 (systemkall), .3 (biblioteksfunksjoner), .5 (filformater), .8 (systemadministrasjon) |
| Tilknyttede operativsystemer | Linux, macOS, BSD-varianter; tilgjengelig på Windows via WSL (Windows Subsystem for Linux) |
| Utvikler / vedlikeholder | Oppsto ved Bell Labs (1971); groff-implementeringen vedlikeholdes av GNU Project |
| Pre-formatert variant | Noen .1-filer er «cat pages» - ferdig rendret tekst med overskriving for fet skrift, ikke roff-kilde |
| Utgitt | 1971 (Unix Programmer's Manual, V1); man macros standardized over the 1970s-80s |
| Siste versjon | N/A (roff/man-macro convention; groff is the active implementation) |
| Åpen standard | Ja · royalty-fri |
| Spesifikasjon | man7.org |
1-konverteringer
Spørsmål og svar fra fellesskapet
spurt av brukereIngen spørsmål ennå - vær den første til å spørre om 1-filer.