Obtaining and Installing Z2HTML

Z2HTML is just a few scripts, a directory of images for the Z symbols, and a stylesheet. Use the scripts to translate your LaTeX source to HTML. The HTML pages contain links to the images. The stylesheet controls the appearance of the Z text.


Back to the Z2HTML home page.


The z2html.sed script is the first pass; it translates the Z LaTeX macros and some other LaTeX commands to HTML.

The paragraph.awk script is the second pass; it puts paragraph tags around each informal paragraph with so they don't all run together in the browser. It also puts paragraph tags between consecutive Z formulas to provide some space.

The z2html shell command invokes these two scripts in a pipeline, taking the name of the LaTeX source file from the command line.

The toc.sed script creates a table of contents from the HTML output of z2html.sed.

The scripts are just text files. Use your browser's Save As... function to copy them. Here they are:

Here are links to a no-style-sheet version and a symbol-font version.

(Note that the file at the link shown as z2html.sed is named z2html.txt so your browser will display it. Ditto for the others. Be sure to rename the files when you copy them to your system).

Obviously, you must run the scripts on a system that provides sed and awk. If you want to use the z2html shell command it must also provide a Unix-like shell with pipes.

The scripts were developed under Linux (Red Hat 5.2) and have also been tested under HP-UX 10.20. The z2html.sed script does not work with the sed shipped with HP-UX -- it requires GNU sed. However the paragraph.awk script does work with HP-UX awk -- it does not require GNU awk (gawk).


The Z2HTML tool represents the Z symbols with images. The z2html.sed script translates each Z symbol command in the LaTeX source to an img link to an image file in the zimg directory.

You can download this gzipped tar file of the entire zimg directory (less than 4.5 kbytes).

All of the Z symbol images linked to pages translated by Z2HTML have names like power-m.gif, where power is the name of the LaTeX command and -m indicates medium size. The -m medium symbol images were designed to look best with the 14 point Helvetica font with Netscape 4 under Linux on a 1024 x 768 pixel display (usual for 17 inch monitors). They look alright with 12 point Helvetica also.

The several black-*.gif and clear.gif images are used to make the borders and spaces in the Z boxes.

The zimg directory also contains power-s.gif and several other -s (small) images designed to match the 12 point Helvetica font. The Z2HTML tool does not use any of these small images, and there are no plans to make a complete set. Once there were plans to make an -l (large) set to match the 18 point font.

If you would like to make your own symbol images, here are some instructions.

In every directory on the web server where you install the translated HTML output, there must be a zimg subdirectory that contains all the symbol image files. The easiest way to provide this on Unix-like systems is to make a symbolic link in each directory to a single zimg directory.


Pages translated by Z2HTML contain a link to an external stylesheet named zed.css. Use the stylesheet to control the appearance of the Z text. For example, you can specify the font and size of the Z text to match the symbol images. Here is the version used at this site:

Follow this link for an explanation and other examples of Z stylesheets.

In every directory on the web server where you install the translated HTML output, you should also put a copy of zed.css. Again, the easiest way is to make a symbolic link in each directory to a single stylesheet.

Back to top
Jonathan Jacky / Department of Radiation Oncology Box 356043
University of Washington / Seattle, Washington 98195-6043 / USA
Tel (206) 598-4117 / Fax (206) 598-6218

E-mail: jon@u.washington.edu