Ubuntu Manpage: html2psrc - configuration file format for html2ps(1)

NAME

       html2psrc - configuration file format for html2ps(1)

DESCRIPTION

       Configuration files are used for layout control, resource information etc. Normally, there
       should always exist a global configuration file.   In  this  file  one  typically  specify
       things like: what image conversion packages are available on the system, the default paper
       size, the default text fonts and sizes, etc.

       For  Unix  and  Windows  systems,  the  installation  script  'install'  can  be  used  to
       automatically  build  a  global  configuration  file  with  all necessary definitions, and
       install all files. The files replaced by the installation  are  saved.  If  you  for  some
       reason  are  not satisfied with the new version: execute the script 'backout' to reinstall
       your earlier version.

       On other systems, you will have to manually create a global configuration file, and insert
       the  name  of this file into the html2ps script (close to the beginning, the line starting
       with "$globrc="). The configuration file should contain a package block, and perhaps paper
       and hyphenation blocks, described below.

       Each  user  can then have a personal configuration file (by default $HOME/.html2psrc) that
       complements/overrides the definitions made in the global file.  It  is  also  possible  to
       specify alternative files on the command line, using the -f option.

FILE FORMAT

A configuration file can include other configuration files. This is done with:

@import "filename";

The rest of the configuration file consists of zero or more blocks. A block is given by a
block name, followed by the block definition, as in:

BODY {
font-size: 12pt;
font-family: Helvetica;
text-align: justify
}

The block definition, enclosed by curly braces: { }, consists of key-value pairs and/or
other blocks. A key-value pair consists of the key name followed by a colon, followed by
the value. Blocks and key-value pairs are separated by semicolons. The semicolon may be
omitted after a block.

Several blocks can share the same definition. The block names are then separated be
commas, as in:

H2, H4, H6 { font-style: italic }

A comment in a configuration file starts with the characters "/*" and ends with "*/":

@html2ps {
seq-number: 1; /* Automatic numbering of headings */
}

Notations

Here are some definitions of terms used below:

Flag: A value of either 0 (absence, inactive etc) or 1 (presence, active etc).
Absolute size:
A real number optionally followed by one of the following two-letter unit
identifiers: cm (centimeters), mm (millimeters), in (inches), pt (points,
1pt = 1/72 inch), pc (picas, 1pc = 12pt). The default unit is centimeters.
Relative size:
A size relative to current fontsize. The default and currently only
recognized unit is em. One em equals the size of the current font. The
value should be given as a real number, optionally followed by 'em', as in
'0.25em'.
Whitespace:
Any one of the characters: space, tab, newline, or carriage return.

CSS2 blocks

All blocks, except one: the @html2ps block, coincides with a subset of the Cascading Style
Sheets, level 2 CSS2 Specification (http://www.w3.org/TR/REC-CSS2/). The following
default settings for html2ps illustrate just about everything that currently can be used
from the CSS2 specification:

BODY {
font-family: Times;
font-size: 11pt;
text-align: left;
background: white;
}

H1, H2, H3, H4, H5, H6 {
font-weight: bold;
margin-top: 0.8em;
margin-bottom: 0.5em;
}
H1 { font-size: 19pt }
H2 { font-size: 17pt }
H3 { font-size: 15pt }
H4 { font-size: 13pt }
H5 { font-size: 12pt }
H6 { font-size: 11pt }

P, OL, UL, DL, BLOCKQUOTE, PRE {
margin-top: 1em;
margin-bottom: 1em;
}

P {
line-height: 1.2em;
text-indent: 0;
}

OL, UL, DD { margin-left: 2em }

TT, KBD, PRE { font-family: Courier }

PRE { font-size: 9pt }

BLOCKQUOTE {
margin-left: 1em;
margin-right: 1em;
}

ADDRESS {
margin-top: 0.5em;
margin-bottom: 0.5em;
}

TABLE {
margin-top: 1.3em;
margin-bottom: 1em;
}

DIV.noprint { display: none }

DEL { text-decoration: line-through }

A:link, HR { color: black }

@page {
margin-left: 2.5cm;
margin-right: 2.5cm;
margin-top: 3cm;
margin-bottom: 3cm;
}

The program specific block @html2ps:

This block is used to specify parameters that are specific to html2ps, and not covered by
CSS2. The @html2ps block has several sub-blocks and key-value pairs, these are described
in this section.

The package block
This block is used to specify which program packages are installed on the system.
Typically, this is done in the global configuration file.

PerlMagick
A flag specifying whether the Perl module PerlMagick is installed or not. The
default is 0.

ImageMagick
A flag specifying whether the ImageMagick package is installed or not. The
default is 0.

pbmplus
A flag specifying whether the pbmplus package is installed or not. The default
is 0.

netpbm A flag specifying whether the netpbm package is installed or not. The default
is 0.

djpeg A flag specifying whether djpeg is installed or not. The default is 0.

Ghostscript
A flag specifying whether Ghostscript is installed or not. The default is 0.

TeX A flag specifying whether the TeX package is installed or not. The default is
0.

dvips A flag specifying whether dvips is installed or not. The default is 0.

libwww-perl
A flag specifying whether the Perl module library libwww-perl is installed or
not. The default is 0.

geturl When neither of the Perl packages for retrieving remote documents are
available, it is possible to use some other program like wget or lynx. This
value should be set to a command that retrieves a document with a complete
MIME header, such as "wget -s -q -O-" or "lynx -source -mime_header".

check The name of a program used for syntax checking HTML documents. No default, a
good choice is weblint.

path A colon separated list of directories where the executables from the program
packages are. It is only necessary to include directories that are not in the
PATH for a typical user.

The paper block
The paper size is defined in this block. The size can either be given as one of the
recognized paper types or by giving explicit values for the paper height and width.
As of version 1.0 beta2, one can also use the @page block in CSS2 for the paper size.
The paper block is kept for backwards compatibility. Also, one can only specify
explicit dimensions in @page, not any paper types by name.

type Paper type, possible choices are: A0, A1, A2, A3, A4,...,A10, B0, B1,...,B10,
letter, legal, arche, archd, archc, archb, archa, flsa, flse, halfletter,
11x17, and ledger (this set of paper types is taken from Aladdin Ghostscript).
The default is A4.

height An absolute size specifying the paper height.

width An absolute size specifying the paper width.

The option block
This block is used to set default values for the command line options. The key in the
key-value pair is the option name, in either its long or short form.

twoup Two column (2-up) output. The default is one column per page.

base Use URL as a base to expand relative references for in-line images. This is
useful if you have downloaded a document to a local file. The URL should then
be the URL of the original document.

check Check the syntax of the HTML file (using an external syntax checker). The
default is to not make a syntax check.

toc Generate a table of contents (ToC). The value should be a string consisting of
one of the letters 'f', 'h', or 't', optionally combined with the letter 'b':

b The ToC will be printed first. This requires that Ghostscript is
installed.
f The ToC will be generated from the links in the converted document.
h The ToC will be generated from headings and titles in the converted
documents. Note that if the document author for some strange reason has
chosen to use some other means to represent the headings than the HTML
elements H1,...,H6, you are out of luck!
t The ToC will be generated from links having the attribute rev=TOC in
the converted document.

debug Generate debugging information. You should always use this option when
reporting problems with html2ps.

DSC Generate DSC compliant PostScript. This requires Ghostscript and can take
quite some time to do. Note that a PostScript file generated with this option
cannot be used as input to html2ps for reformatting later.

encoding
The document encoding. Currently recognized values are ISO-8859-1, EUC-JP,
SHIFT-JIS, and ISO-2022-JP (other EUC-xx encodings may also work). The default
is ISO-8859-1.

rcfile A colon separated list of configuration file names to use instead of the
default personal configuration file $HOME/.html2psrc. Definitions made in one
file override definitions in previous files (the last file in the list has
highest precedence). An empty file name (as in ':file', 'file1::file3', or
'file:') will expand to the default personal file. The environment variable
HTML2PSPATH is used to specify the directories where to search for these
files. (Note: this is only supposed to be used on the command line, not in a
configuration file.)

frame Draw a frame around the text on each page. The default is to not draw a frame.

grayscale
Convert colour images to grayscale images. Note that the PostScript file will
be smaller when the images are converted to grayscale. The default is to
generate colour images.

help Show usage information.

hyphenate
Hyphenate the text. This requires TeX hyphenation pattern files.

scaleimage
Scale in-line images with a factor num. The default is 1.

cookie Enable cookie support, using a netscape formatted cookie file (requires
libwww-perl).

language
Specifies the language of the document (overrides an eventual LANG attribute
of the BODY element). The language should be given according to RFC1766
(ftp://ftp.nordu.net/rfc/rfc1766.txt) and ISO 639
(http://www.w3.org/WAI/ER/IG/ert/iso639.htm).

landscape
Generate code for printing in landscape mode. The default is portrait mode.

scalemath
Scale mathematical formulas with a factor num. The default is 1.

mainchapter
Specifies the start number for automatic numbering of headings (by setting the
seq-number parameter), the default is 1.

number Insert page numbers. The default is to not number the pages.

startno
Specifies the starting page number, the default is 1.

output Write the PostScript code to file. The default is to write to standard output.

original
Use PostScript original images if they exist. For example, if a document
contains an image figure.gif, and an encapsulated PostScript file named
figure.ps exists in the same directory, that file will be use instead. This
only work for documents read as local files. Note: if the PostScript file is
large or contains bitmap images, this must be combined with the -D option. In
HTML 4.0 this can be achieved in a much better way with:

<OBJECT data="figure.ps" type="application/postscript">
<OBJECT data="figure.gif" type="image/gif">
<PRE>[Maybe some ASCII art for text browsers]</PRE>
</OBJECT>
</OBJECT>

rootdir
When a document is read from a local file, this value specifies a base
directory for resolving relative links starting with "/". Typically, this
should be the directory where your web server's home page resides.

xref Insert cross references at every link to within the set of converted
documents.

scaledoc
Scale the entire document with a factor num. The default is 1.

style This option complements/overrides definitions made in the configuration files.
The string must follow the configuration file syntax. (Note: this is only
supposed to be used on the command line, not in a configuration file.)

titlepage
Generate a title page. The default is to not generate one.

text Text mode, ignore images. The default is to include the images.

underline
Underline text that constitutes a hypertext link. The default is to not
underline.

colour Produce colour output for text and background, when specified. The default is
black text on white background (mnemonic: coloUr ;-).

version
Print information about the current version of html2ps.

web Process a web of documents by recursively retrieve and convert documents that
are referenced with hyperlinks. When dealing with remote documents it will of
course be necessary to impose restrictions, to avoid downloading the entire
web... The value should be a string consisting of one of the letters 'a', 'b',
'l', 'r', or 's', optionally combined with a combination of the letters 'p',
'L', and a positive integer:

a Follow all links.
b Follow only links to within the same directory, or below, as the start
document.
l Follow only links specified with "<LINK rel=NEXT>" in the document.
p Prompt for each remote document. This mode will automatically be
entered after the first 50 documents.
r Follow only relative links.
s Follow only links to within the same server as the start document.
L With this option, the order in which the documents are processed will
be: first all top level documents, then the documents linked to from
these etc. For example, if the document A has links to B and C, and B
has a link to D, the order will be A-B-C-D. By default, each document
will be followed by the first document it links to etc; so the default
order for the example is A-B-D-C.
# A positive integer giving the number of recursive levels. The default
is 4 (when the option is present).

duplex Generate postscript code for single or double sided printing. No default,
valid values are:

0 Single sided.
1 Double sided.
2 Double sided, opposite page reversed (tumble mode).

The margin block
This block is used to specify page margins. The left, right, top and bottom margins,
previously defined with this block, should now be defined using the @page
construction from CSS2.

middle An absolute size for the distance between the columns when printing two
columns per page, default is 2cm.

The xref block
At every hyperlink (to within the set of converted documents) it is possible to have
a cross reference inserted. The xref block is used to control this function.

text This defines the cross reference text to be inserted; the symbol $N will
expand to the page number, default is "[p $N]".

passes The number of passes used to insert the cross references. Normally, only one
pass is run. But since the insertion of the page numbers may effect the page
breaks, it might for large documents with many links be necessary with more
than one pass to get the cross references right. The default is 1.

The quote block
Language specific quotation marks are defined in this block. These quotation marks
are used with the HTML 4.01 element Q for short quotations. Quotation marks are
predefined for a few languages (English, Swedish, Danish, Norwegian (also Nynorsk and
Bokmål), Finnish, Spanish, French, German and Italian). It is possible to define
different quotation marks for quotes within quotes.

A quotation mark is defined as a string, using the same encoding as the converted
document (normally ISO-8859-1), and/or with character entities. Note that quotation
mark characters for several languages are not included in ISO-8859-1, and their
corresponding character entities were not been defined prior to HTML 4.0.

Quotation marks for a language can be defined explicitly in a sub-block of the quote
block. One can also identify the set of quotation marks with another previously
defined language, using a key-value pair. The sub-block/key name should equal the
language code as defined in ISO 639. The language sub-block can have the following
key-values:

open The quote opening character(s).
close The quote closing character(s). If undefined, it will equal open.
open2 The quote opening character(s) for quotes within quotes. If undefined,
it will equal open.
close2 The quote closing character(s) for quotes within quotes. If undefined,
it will equal close.

Example: English and Spanish use the same set of quotation marks - at least according
to my book on typography. These (already known to html2ps) are defined with:

quote {
en {
open: "&ldquo;";
close: "&rdquo;";
open2: "`";
close2: "'";
}
es: en;
}

The toc block
When a table of contents (ToC) is generated from document headings and titles, the
appearance is controlled by this block.

heading
A string with HTML code specifying a heading used on the first ToC page.

level The maximum heading level used for building the ToC. The default is 6, which
means that all headings will generate ToC entries.

indent The ToC entries are indented proportional to the corresponding heading level.
This value specifies the size of the indentation. The default is 1em.

The titlepage block
When a title page is generated, its appearance is controlled by this block.

content
A string with HTML code specifying a heading used on the title page, The
default is "<DIV align=center> <H1><BIG>$T</BIG></H1>
<H2>$[author]</H2></DIV>".

margin-top
The size of the top margin on the title page, The default is 4cm.

The font block
Currently, html2ps recognizes the fonts: Times, New-Century-Schoolbook, Helvetica,
Helvetica-Narrow, Palatino, Avantgarde, Bookman, and Courier. To add a new font
(family), choose a name (consisting of letters, digits, hyphens, and underscores) for
the font. Then define a sub-block to the font block, with the same name as the chosen
font name. This block can contain two key-value pairs:

names A string containing four PostScript font names, separated by
whitespace, corresponding to the font styles normal, italic, bold, and
bold-italic. If less than four names are given, the first is used for
the missing names. Note that PostScript font names are case sensitive.
files A string of four file names, separated by whitespace, for files
containing font definitions for the four font styles as specified
above.

Example: A font 'myfont' has its four font styles defined in local files. To use
this font in all tables in the converted documents, one can use something like:

TABLE { font-family: myfont }

@html2ps {
font {
myfont {
names: "MyFont-Roman MyFont-Italic MyFont-Bold MyFont-BoldItalic";
files: "/x/y/myfr.pfa /x/y/myfi.pfa /x/y/myfb.pfa /x/y/myfbi.pfa";
}
}
}

The hyphenation block
Hyphenation pattern files for different languages are specified in sub-blocks within
this block. The blocks names should equal the language code as defined in ISO 639.
These language blocks can contain the following two key-values:

file A hyphenation pattern file in TeX format for this language.
extfile
A file containing a list of hyphenation exceptions for this language.
The exception file should contain words, separated by whitespaces, with
hyphens inserted where hyphenation is allowed, as in: "in-fra-struc-
ture white-space".

For example, for English (with language code 'en') one can have a block like:

en {
file: "/opt/tex/lib/macros/hyphen.tex";
extfile: "/opt/tdb/lib/html2ps/enhyphext";
}

The hyphenation block itself can furthermore have these key-values:

min A positive integer defining the minimum number of letters a word must contain
to make it a candidate for hyphenation. The default is 8.

start A positive integer defining the minimum number of letters that must precede
the hyphen when a word is hyphenated. The default is 4.

end A positive integer defining the minimum number of letters that must follow the
hyphen when a word is hyphenated. The default is 3.

The header block
This block is used to specify page headers. It is possible to define left, center,
and right headers. Different headers for odd and even pages can be specified. Some
symbols can be used that will expand to document title, author, date etc. See below.

left A left aligned header. If the alternate flag in this block is set to 1, this
will be the right header on even pages.

center A centered header.

right A right aligned header. If the alternate flag in this block is set to 1, this
will be the left header on even pages.

odd-left
A left aligned header on odd pages.

odd-center
A centered header on odd pages.

odd-right
A right aligned header on odd pages.

even-left
A left aligned header on even pages.

even-center
A centered header on even pages.

even-right
A right aligned header on even pages.

font-family
The font used for the header, default is Helvetica.

font-size
The font size for the header, default is 8pt.

font-style
The default is "normal".

font-weight
The default is "normal".

color The header color, default is black.

alternate
A flag indicating whether the headers given by the left and right keys should
change place on even pages. Typically used for double sided printing. The
default is 1.

The footer block
This block is used to specify page footers. It is possible to define left, center,
and right footers. Different footers for odd and even pages can be specified. Some
symbols can be used that will expand to document title, author, date etc. See below.

left A left aligned footer. If the alternate flag in this block is set to 1, this
will be the right footer on even pages.

center A centered footer.

right A right aligned footer. If the alternate flag in this block is set to 1, this
will be the left footer on even pages.

odd-left
A left aligned footer on odd pages.

odd-center
A centered footer on odd pages.

odd-right
A right aligned footer on odd pages.

even-left
A left aligned footer on even pages.

even-center
A centered footer on even pages.

even-right
A right aligned footer on even pages.

font-family
The font used for the footer, default is Helvetica.

font-size
The font size for the footer, default is 8pt.

font-style
The default is "normal".

font-weight
The default is "normal".

color The footer color, default is black.

alternate
A flag indicating whether the footers given by the left and right keys should
change place on even pages. Typically used for double sided printing. The
default is 1.

The frame block
The appearance of the optional frame (drawn on each page) is controlled by this
block.

width The width of the frame, default is 0.6pt.

margin The size of the frame margin, default is 0.5cm.

color The colour of the frame, default is black.

The justify block
This block specifies the maximum amount of extra space inserted between words and
letters when text justification is in effect.

word Maximum amount of extra space inserted between words. The default is 15pt.

letter Maximum amount of extra space inserted between letters within words. The
default is 0pt.

The draft block
It is possible to have some text written in a large font diagonally across each page.
Typically this is a word, written in a very light colour, indicating that the
document is a draft.

text The text to be printed, default is "DRAFT".

print A flag specifying whether the draft text should be printed or not. If
unspecified, the draft text is printed when the document head contains <META
name="Status" content="Draft">.

dir Specifies print direction, 0=downwards, 1=upwards.

font-family
The default is Helvetica.

font-style
The default is "normal".

font-weight
The default is "bold".

color The default is "F0F0F0".

The colour block
The 16 standard colour names from HTML 4.01 (although their use in HTML elements are
now deprecated) are recognized by html2ps. Use this block to extend this list of
colours. This is done with key-value pairs, where the key is the colour name, and the
value is the colour given as a hexadecimal RGB value, for example: "brown: A52A2A;".
Key-value pairs in the @html2ps block

html2psrc
The name of the default personal configuration file. The default is
$HOME/.html2psrc.

imgalt Specifies which text should be written as a replacement for in-line images when the
IMG element has no ALT attribute. The default is "[IMAGE]".

datefmt
The symbol $D can be used in page headers and footers to insert the current
date/time; the value of the datefmt key specifies the format used. The syntax is
the same as in the strftime(3) routine. The default is "%e %b %Y %R", which gives
a date string like " 7 May 2010 13:22".

locale The locale (language code) used for formating language dependent parts of the
date/time in datefmt. If unspecified, the value is taken from environment
variables, see setlocale(3). No default.

doc-sep
A string of HTML code that will be inserted between the documents when more than
one are converted. The default is "", which will cause a page break.
You may use (almost) any HTML code, for example "<HR><HR>" or "<IMG src=...>".

ball-radius
The radius, given as a relative size, of the balls used in unordered lists. The
default is 0.25em.

numbstyle
Page numbering style, 0=arabic, 1=roman. The default is 0.

showurl
When this flag is set to 1, the URL for external links are shown within parentheses
after the link. The default is 0.

seq-number
When this flag is set, the headings in the document will be sequentially numbered:
H1 headings will be numbered 1, 2,..., H2 headings 1.1, 1.2, etc. The starting
number for H1 can be changed using the -M (--mainchapter) option. The default is 0.

extrapage
A flag specifying whether an extra (empty) page should be printed, when necessary,
to ensure that the title page, the table of contents, and the document itself will
start on odd pages. This is typically desirable for double sided printing. The
default is 1.

break-table
A flag specifying if a table should be broken across two pages when it does not fit
on the current page, but it does on a page of its own. The default is 0 (avoid
breaking tables when possible).

forms This flag is used to specify whether FORM elements in the document should be
processed or ignored. Some forms may be suitable for printing out and be filled out
(with a pen), others are not. The default is 1.

textarea-data
When a TEXTAREA element contains prefilled data, the text will be used as labels if
this flag is set, otherwise ignored. The default is 0.

page-break
Set this flag to 0 to suppress the normal behavior of generating page breaks from
the comment  etc, as specified below. The default is 1.

expand-acronyms
A flag specifying whether acronyms, given by the ACRONYM element, should be
expanded or not. The default is 0.

spoof Some web servers return different documents depending on which user agent is used
to retrieve the document. You can fool the web server that a certain browser is
used, by setting this value to the identification used by the browser, such as
"Mozilla/4.0". This only works if you are using one of the Perl packages to
retrieve remote documents.

ssi When this flag is set, some Server Side Includes will be processed when the
document is read from a local file. Examples are <!--#include file=...>, <!--#echo
var="LAST_MODIFIED">, <!--#config timefmt=...>. The default is 0.

prefilled
This flag controls whether the content of form elements should be rendered or not.
That is, when this flag is set, the content of TEXTAREA elements, and the value of
the value attribute of text INPUT elements will be shown. Also, checked radio
buttons and checkboxes will be marked. The default is 0.

SYMBOLS

       The following symbols can be used on the title page, the page headers/footers, and in  the
       heading for the table of contents:

       Symbols  of  the  form "$[name]" will expand to the value of the content attribute of META
       elements,  having  either  of  the  attributes  "name=name"  or  "http-equiv=name"   (case
       insensitive string matching).  For example, when a document containing:

          <META name="expires" content="31 Dec 2011">

       is converted, using a configuration file with:

          footer { left: "Expires: $[expires]" }

       this left footer will be inserted:

          Expires: 31 Dec 2011

       In addition, these symbols are defined:

              $T     Current document title.
              $A     Author   of   current   document,  as  specified  with  <META  name="Author"
                     content="..."> in the document head.
              $U     The URL, or file name, of current document.
              $N     Page number.
              $H     Current document heading (level 1-3).
              $D     Current date/time. The format is given by the datefmt key.

       So $A is equivalent to $[author], but kept for backwards compatibility.

       To avoid symbol expansion, precede the dollar sign with a backslash, as in "\$T".

HINTS

       I imagine that a typical use of configuration files can be something along  the  following
       lines.

       System  specific definitions (e.g. specification of available program packages) and global
       defaults (paper type etc) are defined in the global configuration file.

       If there is more than one user of the program on the system, each user  can  also  have  a
       personal  configuration  file  with  his/hers own personal preferences.  (On a single user
       system one can use the global configuration file for this purpose as well.)

       One may also develop a collection of configuration files  for  typical  situations.  These
       files  are  placed  in a directory that is searched by html2ps (the search path is defined
       with the environment variable HTML2PSPATH).  For example, to print a document as slides  -
       in  landscape  mode,  with  large  text in Helvetica, and a thick frame - one can create a
       configuration file, called 'slides' say, containing:

          @html2ps {
            option {
              landscape: 1;
              frame: 1;
            }
            frame { width: 3pt }
          }
          BODY {
            font-family: Helvetica;
            font-size: 20pt;
          }
          H1 { font-size: 35pt }
          H2 { font-size: 32pt }
          H3 { font-size: 29pt }
          H4 { font-size: 26pt }
          H5 { font-size: 23pt }
          H6 { font-size: 20pt }
          PRE { font-size: 18pt }

       Then use the command:

          html2ps -f slides ...

       to convert the document. Note that with this command the file 'slides' is used instead  of
       the  personal  configuration  file.  If  you  want  both  to be used, giving precedence to
       definitions made in the file 'slides', use the command:

          html2ps -f :slides ...

       (The page breaks  between  the  slides  can  for  example  be  generated  by  adding  '<HR
       class=PAGE-BREAK>' to the HTML document.)

       For  features  that  are  frequently  turned  on and off, and that cannot be controlled by
       command line options, it may be a  good  idea  to  create  small  configuration  files  as
       "building  blocks".  For  example  a  file 'A4' for printing on A4 paper (if you have some
       other default paper type):

          @html2ps { paper { type: A4 } }

       and a file 'hnum' for automatic numbering of headings:

          @html2ps { seq-number: 1 }

       Combining this with the previous example: to convert a document for printing on  A4  sized
       slides with all headings numbered, use the command:

          html2ps -f :slides:A4:hnum ...

VERSION

       This manpage describes html2ps version 1.0 beta7.

AVAILABILITY

       http://user.it.uu.se/~jan/html2ps.html

AUTHOR

       Jan Karrman (jan@it.uu.se)

NAME

DESCRIPTION

FILE FORMAT

SYMBOLS

HINTS

SEE ALSO

VERSION

AVAILABILITY

AUTHOR