man wprint (Commandes) - A filter for Mozilla/Netscape to print non-latin1 pages using TrueType fonts.
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
The filename to the config file. Used if -f is present. The default filename is /etc/wprint.conf. 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) 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 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. The name of the postscript file you want to process and print. If you don't specify it standard input will be used instead. Just adds some diagnostic output to stderr. 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
Default configuration file.
SEE ALSO
To obtain more information about wprint please visit <http://www.esperanto.org.uy/programoj/angle/wprint.html>.
COPYRIGHT
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>