grotty(1)

Från Wiki.linux.se -Linux wikipedia på Svenska.
Hoppa till navigering Hoppa till sök


NAMN

grotty – groff-utdatadrivrutin för skrivmaskinsliknande terminalenheter

SYNOPSIS

grotty [-dfhot] [-i|-r] [-F fontkatalog] [fil ...]

grotty -c [-bBdfhouU] [-F fontkatalog] [fil ...]

grotty --help

grotty -v

grotty --version

BESKRIVNING

GNU roffs TTY-utdatadrivrutin, alltså Teletype-drivrutin, översätter utdata från troff(1) till en form som passar skrivmaskinsliknande enheter, inklusive videobaserade terminalemulatorer.

Normalt anropas grotty av groff(1) när något av följande utdataformat anges: 

-T ascii
-T latin1
-T utf8

I denna installation är ps standardenhet för utdata.

Använd groffs option -P för att skicka optioner vidare till grotty.

Om inga filargument anges, eller om fil är: 

-

läser grotty från standardindata.

Programmet skriver till standardutdata.

Som standard skriver grotty SGR-escape-sekvenser från ISO 6429, ofta kallade ANSI-escape-sekvenser, för att ändra textattribut som:

  • fetstil
  • kursiv
  • understrykning
  • omvänd video, alltså negativ bild
  • färger

Enheter som stöder SGR-sekvenserna 30–37 och 40–47 kan visa roff-dokument med åtta olika förgrunds- och bakgrundsfärger.

Filen tty.tmac definierar de åtta färgnamnen från ISO 6429:

  • black
  • white
  • red
  • green
  • blue
  • yellow
  • magenta
  • cyan

Okända färger mappas till standardfärgen, vars värde beror på terminalens inställningar.

Se även optionen -t.

Som standard skapar grotty OSC 8-hyperlänkar på enheter som använder SGR-escape-sekvenser.

I enlighet med gammal praxis, och eftersom terminaler ofta saknar stöd för lutande typsnitt, markerar grotty normalt kursiverade teckenceller med understrykning i stället.

Se även optionen -i.

SGR- OCH OSC-STÖD I SIDVISARE

När grotty-utdata visas med less(1) måste less instrueras att släppa igenom SGR- och OSC-sekvenser till terminalen.

Optionen: 

-R

är ett sätt att göra detta.

För OSC 8-stöd krävs less version 566 eller senare.

Program som man(1) och som visar roff-dokument via less måste därför anropa less med lämplig option.

ÄLDRE UTDATAFORMAT

Optionen -c gör att grotty använder ett äldre utdataformat kompatibelt med pappersterminaler, som de Teletype-maskiner för vilka roff och nroff ursprungligen utvecklades.

SGR-escape-sekvenser skrivs inte ut.

Textattribut som fetstil, kursiv och understrykning hanteras därför inte med terminalattribut.

I stället använder grotty överstrykning:

Stil Representation
fetstil tecken, backsteg, samma tecken
kursiv understreck, backsteg, tecken
fet kursiv understreck, backsteg, tecken, backsteg, tecken

Detta är tvetydigt när tecknet självt är understreck.

Det äldre formatet kan visas på en videoterminal genom att skicka grotty-utdata genom ul(1).

ul kan visa fet kursiv som omvänd video.

Vissa implementationer av more(1) kan också visa dessa sekvenser. Det kan vara värt att prova optionen -b till more.

less(1) visar äldre fetstil och kursiv utan särskilda optioner.

Till skillnad från terminaldrivrutiner i vissa andra roff-implementationer skriver grotty aldrig ut omvänd radmatning.

Du behöver därför inte filtrera dess utdata genom col(1) för att ta bort sådana.

ENHETSUTÖKNINGSKOMMANDON

grotty känner igen ett enhetsutökningskommando som skapas av groff-begäran device eller roff-escape-sekvensen \X. 

\X'tty: link [uri [nyckel=värde] ...]'

Bädda in en hyperlänk med terminalens OSC 8-escape-sekvens.

Om uri anges startar länkad text.

Om uri utelämnas avslutas hyperlänken.

När uri finns kan valfritt antal nyckel/värde-par anges. Hur dessa tolkas är sidvisarens eller terminalens ansvar.

Mellanslag eller tabbar får inte förekomma bokstavligt i uri, nyckel eller värde. De måste representeras på annat sätt.

ENHETSBESKRIVNINGSFILER

Om DESC-filen för teckenkodningen innehåller direktivet: 

unicode

skriver grotty Unicode-tecken i UTF-8-kodning.

Annars skrivs tecken i en enkelbytekodning beroende på information i fontbeskrivningsfilerna.

Se groff_font(5).

En fontbeskrivningsfil kan innehålla direktivet: 

internalname n

där n är ett decimalt heltal.

Om bit 01 i n är satt behandlar grotty fonten som lutande.

Om bit 02 är satt behandlar grotty fonten som fet.

TYPSNITT

grotty stöder de fyra standardstilarna:

Namn Betydelse
R roman
I italic, kursiv/lutande
B bold, fetstil
BI bold-italic, fet kursiv

Eftersom drivrutinen kör i nroff-läge ignoreras försök att sätta eller ändra fontfamilj eller textstorlek.

grotty delar ett namnschema för östasiatiska typsnitt med grohtml(1), gropdf(1) och grops(1).

Namn Betydelse
CSH förenklad kinesiska, Hei-stil
CSS förenklad kinesiska, Song-stil
CTH traditionell kinesiska, Hei-stil
CTS traditionell kinesiska, Song-stil
JPG japanska, Gothic-stil
JPM japanska, Mincho-stil
KOG koreanska, Gothic-stil
KOM koreanska, Mincho-stil

OPTIONER

--help

Visa ett användningsmeddelande och avsluta.

-v

Visa versionsinformation och avsluta.

--version

Visa versionsinformation och avsluta.

-b

Undertryck användning av överstrykning för feta tecken i äldre utdataformat.

-B

Använd endast överstrykning för fet-kursiva tecken i äldre utdataformat.

-c

Använd grottys äldre utdataformat.
SGR- och OSC-escape-sekvenser skrivs inte ut.

-d

Ignorera alla ritkommandon i indatan.
Som standard renderar grotty ritkommandon av typen D l med minst ett nollargument, alltså horisontella eller vertikala linjer.
För utf8-enheten används Unicode-boxritningstecken.
För andra enheter används:
-
|
+
grotty hanterar även D p-kommandon som enbart består av horisontella och vertikala linjer på liknande sätt.
Se groff_out(5).

-f

Skriv ett form feed-tecken i slutet av varje sida som saknar utdata på sista raden.

-F katalog

Lägg katalogen katalog/devnamn först i sökvägen för font- och enhetsbeskrivningsfiler.
namn beskriver utdataenhetens teckenkodning, en av:
ascii
latin1
utf8

-h

Använd bokstavliga horisontella tabbtecken i utdata.
Tabbar antas vara satta var åttonde kolumn.

-i

Rendera fonter markerade som lutande med SGR-attributet för kursiv text i stället för understrykning.
Många terminaler stöder inte detta attribut.
xterm(1) stöder det sedan patch 314 från den 28 december 2014.
Ignoreras om -c också anges.

-o

Undertryck överstrykning, utom för fetstil och/eller understrukna tecken när äldre utdataformat används.
Se optionerna -b och -u.

-r

Rendera fonter markerade som lutande med SGR-attributet för omvänd video i stället för understrykning.
Ignoreras om -c eller -i också anges.

-t

Anta att utdataenheten stöder SGR 38- och 48-escape-sekvenser.
Dessa gör det möjligt att ange förgrunds- och bakgrundsfärger i RGB-färgrymden med 8 bitar per kanal.

-u

Undertryck användning av understrykning för kursiva tecken i äldre utdataformat.

-U

Använd endast understrykning för fet-kursiva tecken i äldre utdataformat.

AVSLUTNINGSSTATUS

grotty avslutas med status:

0

Körningen lyckades.

2

Programmet kunde inte tolka kommandoradsargumenten.

1

Ett fel uppstod under körningen.

MILJÖ

GROFF_FONT_PATH

En lista med kataloger där katalogen för vald utdataenhets enhets- och fontbeskrivningsfiler söks.
Se troff(1) och groff_font(5).

GROFF_NO_SGR

Om variabeln är satt används grottys äldre utdataformat, som om optionen -c hade angetts.

FILER

/usr/local/share/groff/1.24.1/font/devascii/DESC

Beskriver utdataenheten ascii.

/usr/local/share/groff/1.24.1/font/devascii/F

Beskriver fonten F på enheten ascii.

/usr/local/share/groff/1.24.1/font/devlatin1/DESC

Beskriver utdataenheten latin1.

/usr/local/share/groff/1.24.1/font/devlatin1/F

Beskriver fonten F på enheten latin1.

/usr/local/share/groff/1.24.1/font/devutf8/DESC

Beskriver utdataenheten utf8.

/usr/local/share/groff/1.24.1/font/devutf8/F

Beskriver fonten F på enheten utf8.

/usr/local/share/groff/1.24.1/tmac/tty.tmac

Definierar makron för utdataenheterna ascii, latin1 och utf8.
Den laddas automatiskt av troffrc när någon av dessa utdataenheter väljs.

/usr/local/share/groff/1.24.1/tmac/tty-char.tmac

Definierar ersättningstecken för användning med grotty.
Se nroff(1).

BEGRÄNSNINGAR

grotty är endast avsett för enkla dokument.

Det finns inget stöd för horisontella eller vertikala rörelser mindre än en teckencell.

Ritkommandon som skapar annat än horisontella och vertikala linjer stöds inte.

Färghantering skiljer sig från andra utdrivrutiner.

GNU troff-utdatakommandon som skapas av begäranden och escape-sekvenser för linje- och fyllnadsfärg sätter i stället förgrunds- och bakgrundsfärg för teckencellen.

Kommandon som skapas av escape-sekvenserna: 

\l
\L

å ena sidan, och ritningssekvensen: 

\D'l'

å andra sidan, gör olika kompromisser på grund av begränsningarna ovan.

Mer specifikt:

  • \l ritar horisontella linjer med understreck.
  • \D'l' använder ACS- eller Unicode-linjetecken om möjligt, annars bindestreck-minus.
  • \D'l' ritar vertikala linjer en extra teckencell höga och horisontella linjer en extra cell åt höger.

grotty gör detta för att kunna upptäcka korsande linjer och ersätta dem med lämpliga tecken, till exempel +.

Exempel på indata: 

Hello,\L'1v'
world.\l'1n'
.sp 2v
Hello,\D'l 0 1v'
world.\D'l 1n 0'
.pl \n(nlu \" kapa sidan av bekvämlighetsskäl

Renderat med: 

nroff -T ascii

ger ungefär: 

Hello,
      | world._

Hello,|
      |world.--

EXEMPEL

Följande groff-dokument testar flera funktioner där terminalstödet varierar:

  • fetstil
  • kursiv/understrykning
  • fet kursiv
  • teckensammansättning genom överstrykning
  • förgrundsfärg
  • bakgrundsfärg
  • horisontell och vertikal linjeritning
You might see \f[B]bold\f[] and \f[I]italic\f[].
Some people see \f[BI]both at once\f[].
If the output device does (not) co\z\[ad]operate,
you might see \m[red]red\m[].
Black on cyan can have a \M[cyan]\m[black]prominent\m[]\M[]
\D'l 1i 0'\D'l 0 2i'\D'l 1i 0' look.
.\" If in nroff mode, end page now.
.if n .pl \n[nl]u

Jämför utdata från: 

groff -T ascii fil
groff -T utf8 -P -i fil
groff -T utf8 -P -c fil | ul

SE ÄVEN

Dokumentation om styrfunktioner för kodade teckenuppsättningar: 

Control Functions for Coded Character Sets
ECMA-48, 5:e upplagan
Ecma International, juni 1991

En fri version av ISO 6429, med normativ beskrivning av SGR-escape-sekvenser: 

https://ecma-international.org/wp-content/uploads/ECMA-48_5th_edition_june_1991.pdf

Hyperlänkar i terminalemulatorer: 

https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda

Manualsidor:

KOLOFON

Denna sida är en del av projektet groff, GNU troff.

Information om projektet finns på: 

http://www.gnu.org/software/groff/

Felrapporter för manualsidan hänvisas till: 

http://www.gnu.org/software/groff/

Sidan hämtades från arkivet: 

groff-1.24.1.tar.gz

Arkivet hämtades från: 

https://ftp.gnu.org/gnu/groff/

den 24 maj 2026.

Om du upptäcker renderingsproblem i HTML-versionen av sidan, eller anser att det finns en bättre eller mer aktuell källa, kan du skicka e-post till: 

man-pages@man7.org

KORT SAMMANFATTNING

grotty är groffs utdrivrutin för terminalformaten: 

ascii
latin1
utf8

Vanlig användning sker via groff: 

groff -T utf8 fil.roff

Skicka optioner till grotty via groff -P: 

groff -T utf8 -P -i fil.roff

Använd äldre terminalformat: 

groff -T utf8 -P -c fil.roff

Visa äldre format med ul: 

groff -T utf8 -P -c fil.roff | ul

Stäng av ritkommandon: 

grotty -d fil

Använd bokstavliga tabbar i utdata: 

grotty -h fil

Sidslut

Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/grotty.1.html Det här är en maskinöversättning av Linux man sidor till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på https://www.linux.se/kontaka-linux-se/

Tack till Datorhjälp Huddinge som har sponsrat Linux.se med webbhotell.

Hämtad från "https://wiki.linux.se/index.php?title=grotty(1)&oldid=9829"