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>.
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>