wprint

Langue: en

Version: perl 5.005, patch 03 (debian - 07/07/09)

Section: 1 (Commandes utilisateur)

NAME

wprint - A filter for Mozilla/Netscape to print non-latin1 pages using TrueType fonts.

SYNOPSIS

wprint [OPTION...]

DESCRIPTION

This program allows Netscape and Mozilla users to print web pages written in (at least) UNICODE, Big5 and all ISO-8859- charsets provided a suitable TTF font.

OPTIONS


-c conffile
The filename to the config file. Used if -f is present. The default filename is /etc/wprint.conf.
-i encoding
The encoding of the original page, KOI8-R or ISO_8859-3 or UTF-8 or whatever encoding is supported by iconv (the list is rather impressive). The default is UTF-8. NONE means that no conversion should be done (passthrough) and UNICODELITTLE is the value to use with Mozilla. (Note that some versions of Netscape print BIG5 as EUC-TW)
-l entry
The entry in the config file. The default entry is `default' if you use -c and not -l or if you use no parameters or just -p. This overrides the other settings: -f, -i and makes the output go to the filter or file at the end of the entry
-f font_list
You can either write the *filename* of a unicode font such a cyberbit or you can type a list in the form: font1[=encoding1[;xr;yr;pt]], font2[=encoding2[;xr;yr;pt]], ... If you don't specify the font encoding the unicode map will be used. The values xr, yr and pt default to 72, 72 and 14.0.
-p filename
The name of the postscript file you want to process and print. If you don't specify it standard input will be used instead.
-v
Just adds some diagnostic output to stderr.
-x
By default the font tables are constructed using a 64 character map. You can also use a 159 character map that lead to fewer subfonts. It is optional because I have not tested it enough.

RUNNING THE PROGRAM

You can either use the program directly from the print dialog or use it to process a file saved by it.

At the print dialog

When you print from Mozilla/Netscape you have to type the print command in the print dialog box. That is usually something like `lpr -P myprinter'.

Mozilla/Netscape--->'lpr -P myprinter'--->myprinter

From now on Mozilla/Netscape will send their output to wprint which in turn (after processing) is going to send its output to the printer or a file using a print command that is specified in the last part of each configuration entry.

Mozilla/Netscape--->wprint -l entry--->'lpr -P myprinter'--->myprinter

Note that there might be other filters involved between `lpr' and the printer but that does not concern wprint.

In order to get wprint to work you just have to type `wprint' as your printing command for the default entry, for the other you will have to type 'wprint -l name_of_entry'. See the same wprint.conf entry `default' and change the printing command to suit your system. It might be a good idea to print like that first.

Check the provided wprint.conf file, it is documented and will give you a good idea on how to set up the font conversions for the program to work. All my entries are there, using the font cyberbit.ttf, and I use them regularly to print unicode text.

From the command line

You can also run wprint from the command line, to process a file saved by choosing `print to a file' in the Mozilla/Netscape dialog.

wprint -p filename.ps -i encoding -f font_list -v -x -c conffile -l entry

for example, the test program runs:

wprint -i UTF-8 -p netscape.ps -f courier-8859_3=ISO_8859-3 > test1.ps

wprint -c wprint-test.conf -p netscape.ps

Both lines achieve the same things, the first one with every option in the command line and the second one using a configuration file. If the configuration file had been /etc/wprint.conf then just `wprint -p netscape.ps' would have been enough.

The output of the program when there is no configuration file is stdout, so you can pipe it to whatever you want.

I recommend that instead of printing right away to a printer you do it to a file first and check the result with, for example, ghostscript to see if you have your fonts set up properly. You will help save a bit of the world's forest by running your tests this way :).

ABOUT FONT ORDER AND SUBSTITUTION

The order of fonts in this case is very important since the fonts Netscape uses are going to be replaced in the same order. If you specify fewer fonts then the last ones are going to be replaced by the last font you listed.

Netscape fonts Mozilla fonts
                     Times-Roman
                     Times-Bold
 Times-Roman         Times-Italic
 Times-Bold          Times-BoldItalic
 Times-Italic        Helvetica-Roman
 Times-BoldItalic    Helvetica-Bold
 Courier-Roman       Helvetica-Oblique
 Courier-Bold        Helvetica-BoldOblique
 Courier-Oblique     Courier-Roman
 Courier-BoldOblique Courier-Bold
                     Courier-Oblique
                     Courier-BoldOblique
                     Symbol

IMPORTANT NOTES

For BIG5 pages Netscape generates EUC-TW output, so you should use EUC-TW each time you are dealing with BIG5 in the config files.

Netscape does all the positioning so that if your font does not scale well to the size Netscape wants it to use there is very little the filter can do at this moment. You can try to use the xy, yr and pt parameters to change the resolution and pointsize of the characters to be created.

If you have any suggestions or corrections to the program don't hesitate to write to me to etrapani@unesco.org.uy

FILES


/etc/wprint.conf
Default configuration file.

SEE ALSO

To obtain more information about wprint please visit <http://www.esperanto.org.uy/programoj/angle/wprint.html>. This package is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; version 2 dated June, 1991.

AUTHORS

Eduardo Trapani <etrapani@unesco.org.uy>