grohtml(1)

NAMN

grohtml, post-grohtml, pre-grohtml – groff-utdatadrivrutin för HTML

SYNOPSIS

pre-grohtml [-epV] [-a anti-aliasing-text-bits] [-D image-directory]
            [-F font-directory] [-g anti-aliasing-graphic-bits]
            [-i resolution] [-I image-stem]
            [-o image-vertical-offset] [-x html-dialect]
            troff-command troff-argument ...

pre-grohtml --help

pre-grohtml -v

pre-grohtml --version

post-grohtml [-bCGhlnrVy] [-F font-directory] [-j output-stem]
             [-k encoding] [-s base-point-size] [-S heading-level]
             [-x html-dialect] [file ...]

post-grohtml --help

post-grohtml -v

post-grohtml --version

BESKRIVNING

GNU roff-systemets HTML-stöd består av en preprocessor, pre-grohtml, och en utdatadrivrutin, post-grohtml; tillsammans översätter de roff(7)-dokument till HTML.

Eftersom en preprocessor, unikt, krävs för denna utdatadrivrutin bör användare anropa grohtml via kommandot groff(1) med optionerna -Thtml eller -Txhtml.

I denna installation är ps standardutdataenhet.

Använd groffs option -P för att skicka alla optioner som visas ovan till grohtml.

Om inga operander anges, eller om file är “-”, läser grohtml standardindataströmmen.

Det skriver till standardutdataströmmen.

grohtml anropar groff två gånger.

I första passet renderar preprocessorn pre-grohtml bilder, ekvationer och tabeller som bilder i PostScript-format med utdataenheten ps.

I andra passet översätter utdatadrivrutinen post-grohtml utdata från troff(1) till HTML.

grohtml skriver UTF-8-kodad utdata, men se optionen -k, och producerar HTML-teckenreferenser för de flesta icke-sammansatta, icke-grundläggande latinska Unicode-tecken.

Trots detta kan groff utfärda varningar om okända specialtecken om de inte kan hittas under första passet.

Du kan ignorera dessa varningar om inte specialtecknen förekommer inne i en tabell eller ekvation.

Typsnitt

grohtml stöder de fyra standardstilarna: R (roman), I (italic), B (bold) och BI (bold-italic).

Typsnitt grupperas i familjerna T och C med medlemmar i varje stil.

TR     Times roman
TI     Times italic
TB     Times bold
TBI    Times bold-italic
CR     Courier roman
CI     Courier italic
CB     Courier bold
CBI    Courier bold-italic

Ett särskilt typsnitt, S, tillhandahålls också för att stödja roff-dokument som förväntar sig att det alltid finns tillgängligt.

grohtml stöder dessutom ett namngivningsschema för östasiatiska typsnitt som delas med gropdf(1), grops(1) och grotty(1).

CSH    Simplified Chinese, Hei style
CSS    Simplified Chinese, Song style
CTH    Traditional Chinese, Hei style
CTS    Traditional Chinese, Song style
JPG    Japanese, Gothic style
JPM    Japanese, Mincho style
KOG    Korean, Gothic style
KOM    Korean, Mincho style

Typsnittsbeskrivningsfiler

Typsnittsbeskrivningsfilerna som används med grohtml exponerar samma glyfrepertoar i sina charset-sektioner.

Se groff_font(5).

Beroenden

pre-grohtml genererar en bild närhelst en eqn-ekvation, tbl-tabell eller pic-bild påträffas i indatan.

grohtml kan därför köra flera kommandon som del av sin funktion.

Dessa inkluderar Netpbm-verktygen pamcut, pnmcrop och pnmtopng, samt Ghostscripts gs och ps2ps.

OPTIONER

--help visar ett användningsmeddelande, medan -v och --version visar versionsinformation; alla avslutar därefter.

-a anti-aliasing-text-bits

Antal bitar antialiasinginformation som ska användas av text när PNG-bilder genereras.

Standard är 4, men 0, 1 och 2 är också giltiga.

Systemets version av gs måste stödja optionen -dTextAlphaBits för att kunna utnyttja antialiasing.

Ett värde på 0 stoppar grohtml från att utfärda antialiasingkommandon till gs.

-b

Initiera bakgrundsfärgen till vit.

-C

Undertryck utdata av HTML-kommentaren “CreationDate:”.

-D image-directory

Instruera grohtml att placera alla bildfiler i katalogen image-directory.

-e

Styr eqn till att producera MathML.

Denna option bör inte anges manuellt; den syntetiseras av groff beroende på om det gavs optionen -Thtml eller -Txhtml.

-F font-directory

Lägg katalogen font-directory/devname först i sökvägen för typsnitts- och enhetsbeskrivningsfiler; name är namnet på enheten, vanligtvis html.

-g anti-aliasing-graphic-bits

Antal bitar antialiasinginformation som ska användas av grafik när PNG-bilder genereras.

Standard är 4, men 0, 1 och 2 är också giltiga.

Systemets version av gs måste stödja optionen -dGraphicAlphaBits för att kunna utnyttja antialiasing.

Ett värde på 0 stoppar grohtml från att utfärda antialiasingkommandon till gs.

-G

Undertryck utdata av HTML-kommentaren “Creator:”.

-h

Generera sektionsrubriker genom att använda HTML-elementen B och öka teckenstorleken, i stället för HTML-elementen H.

-i resolution

Sätt bildupplösningen i pixlar per tum; standard är 100.

-I image-stem

Bestäm bildfilnamnets stam.

Om den utelämnas använder grohtml grohtml-XXXXX, där XXXXX är process-ID.

Ett bindestreck läggs till stammen för att skilja den från det följande bildnumret.

-j output-stem

Instruera grohtml att dela HTML-utdata i flera filer.

Utdata skrivs till en ny fil vid varje sektionsrubrik, men se optionen -S nedan, namngiven output-stem-n.html.

-k encoding

Välj teckenkodningen som används i det genererade dokumentet, vilket påverkar den deklarerade kodningen i ingressen och formen på teckenenhetsreferenser.

Giltiga värden är “ASCII” och “UTF-8”.

Standard är “UTF-8”.

-l

Stäng av produktionen av automatiska sektionslänkar längst upp i dokumentet.

-n

Generera enkla rubrikankare närhelst en sektions-/nummerrubrik hittas.

Utan optionen är ankarvärdet den textuella rubriken.

Detta kan orsaka problem när en rubrik innehåller ett “?” i äldre versioner av vissa webbläsare.

Denna funktion aktiveras automatiskt om en rubrik innehåller en bild.

-o image-vertical-offset

Ange den vertikala förskjutningen för bilder i punkter.

-p

Visa sidrenderingsförlopp till standardfelströmmen.

grohtml visar endast ett sidnummer när en bild krävs.

-r

Stäng av den automatiska huvud- och fotlinjen, HTML-regel.

-s base-type-size

Sätt dokumentets grundläggande teckenstorlek i punkter.

När denna storlek används i källan motsvarar den HTML:s grundläggande teckenstorlek.

Varje ökning med två punkter i källan producerar ett “big”-element, och omvänt, när en minskning med två punkter ses, avges ett “small”-element.

-S heading-level

När HTML-utdata delas, se optionen -j ovan, dela vid varje nästlad rubriknivå som definieras av heading-level, eller högre.

Standard är 1.

-V

Skapa en XHTML- eller HTML-validator-knapp längst ned på varje sida i dokumentet.

-x html-dialect

Välj HTML-dialekt.

För närvarande bör html-dialect vara antingen siffran 4 eller bokstaven x, vilket anger om grohtml ska generera HTML 4 respektive XHTML.

Denna option bör inte anges manuellt; den syntetiseras av groff beroende på om det gavs optionen -Thtml eller -Txhtml.

-y

Producera en högerjusterad groff-signatur i slutet av dokumentet, endast om -V också anges.

AVSLUTNINGSSTATUS

pre-grohtml och post-grohtml avslutas vardera med status 0 vid framgångsrik körning, status 2 om programmet inte kan tolka sina kommandoradsargument, och status 1 om det stöter på ett fel under körning.

MILJÖ

GROFF_FONT_PATH

Listar kataloger där devhtml, grohtmls katalog med enhets- och typsnittsbeskrivningsfiler, ska sökas.

Se troff(1) och groff_font(5).

SOURCE_DATE_EPOCH

En tidsstämpel, uttryckt som sekunder sedan Unix-epoken, att använda som skapandetidsstämpel för utdata i stället för aktuell tid.

Tiden konverteras till läsbar form med gmtime(3) och asctime(3), och registreras i en HTML-kommentar.

TZ

Tidszonen som ska användas när aktuell tid konverteras till läsbar form; se tzset(3).

Om SOURCE_DATE_EPOCH används konverteras den alltid till läsbar form med UTC.

FILER

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

Beskriver utdataenheten html.

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

Beskriver typsnittet känt som F på enheten html.

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

Definierar typsnittsmappningar, specialtecken och färger för användning med utdataenheten html.

Den laddas automatiskt av troffrc när någon av utdataenheterna html eller xhtml väljs.

/usr/local/share/groff/1.24.1/tmac/html-end.tmac

Slutför inställningen av utdataenheten html.

Den laddas automatiskt av troffrc-end när någon av utdataenheterna html eller xhtml väljs.

grohtml använder temporära filer.

Se groff(1) för detaljer om var sådana filer skapas.

FEL

grohtml är fortfarande betakod.

grohtml stöder inte avstavning på riktigt, men du kan lura det att avstava långa indatarader, vilket kan förekomma i HTML-utdata med ett avstavat ord följt av ett mellanslag men ingen radbrytning.

SE ÄVEN

groff(1), troff(1), groff_font(5)

KOLOFON

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

Information om projektet finns på:

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

Om du har en felrapport för denna manualsida, se:

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

Denna sida hämtades från arkivet:

groff-1.24.1.tar.gz

hämtat från: https://ftp.gnu.org/gnu/groff/

den 24 maj 2026.

Om Ni upptäcker renderingsproblem i denna HTML-version av sidan, eller om du anser att det finns en bättre eller mer aktuell källa för sidan, eller om du har rättelser eller förbättringar av informationen i denna KOLOFON, som inte är en del av den ursprungliga manualsidan, skicka e-post till:

man-pages@man7.org

Sidslut

Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/grohtml.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 Datorservice som har sponsrat Linux.se med webbhotell.