# phpman > man > grohtml(1)

[GROHTML(1)](https://www.chedong.com/phpMan.php/man/GROHTML/1/markdown)                             General Commands Manual                            [GROHTML(1)](https://www.chedong.com/phpMan.php/man/GROHTML/1/markdown)



## NAME
       grohtml - HTML driver for groff

## SYNOPSIS
       **grohtml** [**-bhlnprVy**] [**-a** _aa-text-bits_] [**-D** _dir_] [**-F** _dir_] [**-g** _aa-graphic-bits_] [**-i** _resolution_]
               [**-I** _image-stem_] [**-j** _filename_] [**-o** _image-vertical-offset_] [**-s** _size_] [**-S** _level_]
               [**-x** _html-dialect_] [_file_ ...]

### grohtml --help

### grohtml -v
### grohtml --version

## DESCRIPTION
       The  **grohtml**  front  end (which consists of a preprocessor, **pre-grohtml**, and a device driver,
       **post-grohtml**) translates the output of GNU **troff** to HTML.  Users should always invoke **grohtml**
       via  the  groff  command  with a **-Thtml** option.  If no files are given, **grohtml** will read the
       standard input.  A filename of **-** will also cause **grohtml** to read the  standard  input.   Html
       output is written to the standard output.  When **grohtml** is run by **groff** options can be passed
       to **grohtml** using **groff**'s **-P** option.

       **grohtml** invokes **groff** twice.  In the first pass, pictures, equations, and tables are rendered
       using the **ps** device, and in the second pass HTML output is generated by the **html** device.

       **grohtml**  always writes output in UTF-8 encoding and has built-in entities for all non-compos‐
       ite unicode characters.  In spite of this, groff may issue  warnings  about  unknown  special
       characters if they can't be found during the first pass.  Such warnings can be safely ignored
       unless the special characters appear inside a table or equation.

## OPTIONS
### -a
              Number of bits of antialiasing information to be used by _text_ when generating PNG  im‐
              ages.   The default is 4 but valid values are 0, 1, 2, and 4.  Note your version of **gs**
              needs to support the **-dTextAlphaBits** and **-dGraphicAlphaBits** options in  order  to  ex‐
              ploit  antialiasing.  A value of 0 stops **grohtml** from issuing antialiasing commands to
              **gs**.

### -b

### -D

### -e
              utilized by **groff** when **-Thtml** or **-Txhtml** is specified.  It is used by the **grohtml** pre‐
              processor to determine whether **eqn** should attempt to produce  MathML  (if  **-Txhtml**  is
              specified).

### -F
              files; _name_ is the name of the device, usually **html**.

### -g
              Number of bits of antialiasing information to be used by _graphics_ when generating  PNG
              images.   The  default is 4 but valid values are 0, 1, 2, and 4.  Note your version of
              **gs** needs to support the **-dTextAlphaBits** and **-dGraphicAlphaBits** options in order to ex‐
              ploit  antialiasing.  A value of 0 stops **grohtml** from issuing antialiasing commands to
              **gs**.

### -h
              rather than using the **<H**_n_**>**...**</H**_n_**>** tags.

### -i
              Select  the resolution for all images.  By default this is 100 pixels per inch.  Exam‐
              ple: **-i200** indicates 200 pixels per inch.

### -I
              process ID).

### -j
              Inform **grohtml** to split the HTML output into multiple files.  The _filename_ is the stem
              and specified section headings (default is level one) start a new  file,  named  _file__‐
              _name-n.html_.

### -l

### -n
              the option the anchor value is the textual heading.  This can cause  problems  when  a
              heading  contains  a ‘?’a on older versions of some browsers (Netscape).  This flag is
              automatically turned on if a heading contains an image.

### -o
              Specify the vertical offset of images in points.

### -p
              an image is required.

### -r

### -s size
              Set  the  base point size of the source file.  Thereafter when this point size is used
              in the source it will correspond to the HTML base size.  Every increase of two  points
              in  the source will yield a **<big>** tag, and conversely when a decrease of two points is
              seen a **<small>** tag is emitted.

### -S
              When splitting HTML output, split at the heading level (or higher) defined by _level_.

### -v

### -V

### -x
              Select HTML dialect.  Currently, _dialect_ should be either the digit **4** or the letter  **x**
              which  indicates  whether **grohtml** should generate HTML 4 or XHTML, respectively.  This
              option should not be directly invoked by the user as it is an internal option utilized
              by **groff** when **-Thtml** or **-Txhtml** is specified.

### -y
              generated if the **-V** flag is also specified.

## USAGE
       There are styles called **R**, **I**, **B**, and **BI** mounted at font positions 1 to 4.

## DEPENDENCIES
       **grohtml** is dependent upon the PNG utilities (**pnmcut**, **pnmcrop**, **pnmtopng**) and GhostScript (**gs**).
       **pnmtopng**  (version  2.37.6  or  greater)  and **pnmcut** from the netpbm package (version 9.16 or
       greater) will work also.  It is also dependent upon **psselect** from the **PSUtils**  package.   Im‐
       ages are generated whenever a table, picture, equation or line is encountered.

## FILES
       **grohtml**  uses  temporary  files.   See the [**groff**(1)](https://www.chedong.com/phpMan.php/man/groff/1/markdown) man page for details where such files are
       created.

## ENVIRONMENT
       _GROFF_FONT_PATH_
              A list of directories in which to search for the _dev_name directory in addition to  the
              default ones.  See [**troff**(1)](https://www.chedong.com/phpMan.php/man/troff/1/markdown) and **groff**___**[font**(5)](https://www.chedong.com/phpMan.php/man/font/5/markdown) for more details.

       _SOURCE_DATE_EPOCH_
              A  timestamp  (expressed as seconds since the Unix epoch) to use as the creation time‐
              stamp in place of the current time.

## BUGS
       **Grohtml** has been completely redesigned and rewritten.  It is still beta code.

## SEE ALSO
       [**afmtodit**(1)](https://www.chedong.com/phpMan.php/man/afmtodit/1/markdown), [**groff**(1)](https://www.chedong.com/phpMan.php/man/groff/1/markdown), [**troff**(1)](https://www.chedong.com/phpMan.php/man/troff/1/markdown), [**psbb**(1)](https://www.chedong.com/phpMan.php/man/psbb/1/markdown), **groff**___**[out**(5)](https://www.chedong.com/phpMan.php/man/out/5/markdown), **groff**___**[font**(5)](https://www.chedong.com/phpMan.php/man/font/5/markdown), **groff**___**[char**(7)](https://www.chedong.com/phpMan.php/man/char/7/markdown)



groff 1.22.4                                23 March 2022                                 [GROHTML(1)](https://www.chedong.com/phpMan.php/man/GROHTML/1/markdown)