179543Sru.ig 2151497SruCopyright (C) 1999-2000, 2001, 2002, 2003, 2004 Free Software Foundation, Inc. 375584Sru 475584SruPermission is granted to make and distribute verbatim copies of this 575584Srumanual provided the copyright notice and this permission notice are 675584Srupreserved on all copies. 775584Sru 875584SruPermission is granted to copy and distribute modified versions of this 975584Srumanual under the conditions for verbatim copying, provided that the 1075584Sruentire resulting derived work is distributed under the terms of a 1175584Srupermission notice identical to this one. 1275584Sru 1375584SruPermission is granted to copy and distribute translations of this 1475584Srumanual into another language, under the above conditions for modified 1575584Sruversions, except that this permission notice may be included in 1675584Srutranslations approved by the Free Software Foundation instead of in 1775584Sruthe original English. 1875584Sru.. 19151497Sru. 20151497Sru. 2175584Sru.\" Like TP, but if specified indent is more than half 2275584Sru.\" the current line-length - indent, use the default indent. 2375584Sru.de Tp 24151497Sru. ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP 25151497Sru. el .TP "\\$1" 2675584Sru.. 27151497Sru. 28151497Sru. 2975584Sru.TH GROHTML @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@" 30104862Sru. 31151497Sru. 3275584Sru.SH NAME 3375584Srugrohtml \- html driver for groff 34104862Sru. 35151497Sru. 3675584Sru.SH SYNOPSIS 3775584Sru.nr a \n(.j 3875584Sru.ad l 3975584Sru.nr i \n(.i 4075584Sru.in +\w'\fBgrohtml 'u 4175584Sru.ti \niu 4275584Sru.B grohtml 43151497Sru. 4475584Sru.de OP 45151497Sru. ie \\n(.$-1 .RI "[\ \fB\\$1\fP" "\\$2" "\ ]" 46151497Sru. el .RB "[\ " "\\$1" "\ ]" 4775584Sru.. 48151497Sru. 49151497Sru.OP \-bhlnprv 50151497Sru.OP \-a \%aa-text-bits 5179543Sru.OP \-D dir 5275584Sru.OP \-F dir 53151497Sru.OP \-g \%aa-graphic-bits 54151497Sru.OP \-i \%resolution 55104862Sru.OP \-I \%image-stem 56151497Sru.OP \-j \%filename 57104862Sru.OP \-o \%image-vertical-offset 58151497Sru.OP \-s size 59151497Sru.OP \-S level 6075584Sru.RI "[\ " files\|.\|.\|. "\ ]" 6175584Sru.br 6275584Sru.ad \na 63104862Sru. 64151497Sru. 6575584Sru.SH DESCRIPTION 66104862SruThe 6775584Sru.B grohtml 68104862Srufront end (which consists of a preprocessor, 69104862Sru.BR pre-grohtml , 70104862Sruand a device driver, 71104862Sru.BR post-grohtml ) 7275584Srutranslates the output of GNU 7375584Sru.B troff 7475584Sruto html. 7575584SruUsers should always invoke 7675584Sru.B grohtml 7775584Sruvia the groff command with a 7875584Sru.B \-Thtml 7975584Sruoption. 8075584SruIf no files are given, 8175584Sru.B grohtml 8275584Sruwill read the standard input. 8375584SruA filename of 8475584Sru.B \- 8575584Sruwill also cause 8675584Sru.B grohtml 8775584Sruto read the standard input. 8875584SruHtml output is written to the standard output. 8975584SruWhen 9075584Sru.B grohtml 9175584Sruis run by 9275584Sru.B groff 9375584Sruoptions can be passed to 9475584Sru.B grohtml 9575584Sruusing 9675584Sru.BR groff 's 9775584Sru.B \-P 9875584Sruoption. 99151497Sru. 100151497Sru. 10175584Sru.SH OPTIONS 10275584Sru.TP 103104862Sru.BI \-a aa-text-bits 104104862SruNumber of bits of antialiasing information to be used by 105104862Sru.I text 106104862Sruwhen generating png images. 107151497SruThe default is\~4 but valid values are 0, 1, 2, and\~4. 108104862SruNote your version of 109104862Sru.B gs 110104862Sruneeds to support the 111104862Sru.B \%\-dTextAlphaBits 112104862Sruand 113104862Sru.B \%\-dGraphicAlphaBits 114104862Sruoptions in order to exploit antialiasing. 115104862SruA value of\~0 stops 116104862Sru.B grohtml 117104862Srufrom issuing antialiasing commands to 118104862Sru.BR gs . 119151497Sru. 12075584Sru.TP 121151497Sru.B \-b 122151497SruInitialize the background color to white. 123151497Sru. 124151497Sru.TP 125151497Sru.BI \-D dir 126151497SruInform 127151497Sru.B grohtml 128151497Sruto place all image files into directory 129151497Sru.IR dir . 130151497Sru. 131151497Sru.TP 132151497Sru.BI \-F dir 133151497SruPrepend directory 134151497Sru.IB dir /dev name 135151497Sruto the search path for font and device description files; 136151497Sru.I name 137151497Sruis the name of the device, usually 138151497Sru.BR html . 139151497Sru. 140151497Sru.TP 141104862Sru.BI \-g aa-graphic-bits 142104862SruNumber of bits of antialiasing information to be used by 143104862Sru.I graphics 144104862Sruwhen generating png images. 145151497SruThe default is\~4 but valid values are 0, 1, 2, and\~4. 146104862SruNote your version of 147104862Sru.B gs 148104862Sruneeds to support the 149104862Sru.B \%\-dTextAlphaBits 150104862Sruand 151104862Sru.B \%\-dGraphicAlphaBits 152104862Sruoptions in order to exploit antialiasing. 153104862SruA value of\~0 stops 154104862Sru.B grohtml 155104862Srufrom issuing antialiasing commands to 156104862Sru.BR gs . 157151497Sru. 15875584Sru.TP 159151497Sru.B \-h 160151497SruGenerate section and number headings by using 161104862Sru.BR <B> .\|.\|. </B> 162104862Sruand increasing the font size, rather than using the 163104862Sru.BI <H n >\c 164104862Sru\&.\|.\|.\c 165104862Sru.BI </H n > 166104862Srutags. 167151497Sru. 168104862Sru.TP 16975584Sru.BI \-i resolution 17079543SruSelect the resolution for all images. 171104862SruBy default this is 100 pixels per inch. 172151497SruExample: 173151497Sru.B \-i200 174151497Sruindicates 200 pixels per inch. 175151497Sru. 17675584Sru.TP 17779543Sru.BI \-I stem 17879543SruDetermine the image stem name. 17979543SruIf omitted grohtml uses 180151497Sru.BI \%grohtml- XXX 18179543Sru.RI ( XXX 18279543Sruis the process ID). 183151497Sru. 18479543Sru.TP 185151497Sru.BI \-j filename 186151497SruInform 187151497Sru.B grohtml 188151497Sruto split the html output into multiple files. 189151497SruThe 190151497Sru.I filename 191151497Sruis the stem and specified section headings 192151497Sru(default is level one) start a new file, named 193151497Sru.IR filename-n.html . 194151497Sru. 195151497Sru.TP 196151497Sru.B \-l 197151497SruTurn off the production of automatic section links at the top of the 198151497Srudocument. 199151497Sru. 200151497Sru.TP 201151497Sru.B \-n 202151497SruGenerate simple heading anchors whenever a section/number heading is found. 203151497SruWithout the option the anchor value is the textual heading. 204151497SruThis can cause problems when a heading contains a `?' on older versions of 205151497Srusome browsers (Netscape). 206151497SruThis flag is automatically turned on if a heading contains an image. 207151497Sru. 208151497Sru.TP 209104862Sru.BI \-o vertical-offset 210104862SruSpecify the vertical offset of images in points. 211151497Sru. 212104862Sru.TP 213151497Sru.B \-p 214151497SruDisplay page rendering progress to stderr. 21579543Sru.B grohtml 216151497Sruonly displays a page number when an image is required. 217151497Sru. 21879543Sru.TP 219151497Sru.B \-r 220151497SruTurn off the automatic header and footer line (html rule). 221151497Sru. 222151497Sru.TP 223151497Sru.B \-s size 224151497SruSet the base point size of the source file. 225151497SruThereafter when this point size is used in the source it will correspond 226151497Sruto the html base size. 227151497SruEvery increase of two points in the source will yield a 228151497Sru.B <big> 229151497Srutag, and conversely when a decrease of two points is seen a 230151497Sru.B <small> 231151497Srutag is emitted. 232151497Sru. 233151497Sru.TP 234151497Sru.BI \-S level 235151497SruWhen splitting html output, 236151497Srusplit at the heading level (or higher) defined by 237151497Sru.IR level . 238151497Sru. 239151497Sru.TP 24075584Sru.B \-v 24175584SruPrint the version number. 242104862Sru. 243151497Sru. 24475584Sru.SH USAGE 24575584SruThere are styles called 24675584Sru.BR R , 24775584Sru.BR I , 24875584Sru.BR B , 24975584Sruand 25075584Sru.B BI 251151497Srumounted at font positions 1 to\~4. 252151497Sru. 253151497Sru. 25475584Sru.SH DEPENDENCIES 25575584Sru.B grohtml 25679543Sruis dependent upon the png utilities 257151497Sru.RB ( \%pnmcut , 258151497Sru.BR \%pnmcrop , 259151497Sru.BR \%pnmtopng ) 26079543Sruand GhostScript 26179543Sru.RB ( gs ). 262104862Sru.B \%pnmtopng 263104862Sru(version 2.37.6 or greater) 264104862Sruand 265104862Sru.B \%pnmcut 266104862Srufrom the netpbm package (version 9.16 or greater) will work also. 267104862SruIt is also dependent upon 268104862Sru.B \%psselect 269104862Srufrom the 270104862Sru.B PSUtils 271104862Srupackage. 27275584SruImages are generated whenever a table, picture, equation or line is 27375584Sruencountered. 274151497Sru. 275151497Sru. 27675584Sru.SH BUGS 27775584Sru.B Grohtml 27875584Sruhas been completely redesigned and rewritten. 279151497SruIt is still beta code. 280151497Sru. 281151497Sru. 28275584Sru.SH "SEE ALSO" 28375584Sru.BR afmtodit (@MAN1EXT@), 28475584Sru.BR groff (@MAN1EXT@), 28575584Sru.BR @g@troff (@MAN1EXT@), 28675584Sru.BR psbb (@MAN1EXT@), 28775584Sru.BR groff_out (@MAN5EXT@), 28875584Sru.BR groff_font (@MAN5EXT@), 28975584Sru.BR groff_char (@MAN7EXT@) 29079543Sru. 29179543Sru.\" Local Variables: 29279543Sru.\" mode: nroff 29379543Sru.\" End: 294