1MAKEJVF(1)                  General Commands Manual                 MAKEJVF(1)
2
3
4

NAME

6       makejvf - Make Japanese VF file from Japanese TeX TFM file
7

SYNOPSIS

9       makejvf [<options>] <TeX TFM file> <PS font TFM>
10

DESCRIPTION

12       makejvf  is  a  tool to generate Japanese VF file from Japanese TeX TFM
13       (JFM) file for use with dvips.
14
15       When processing Japanese texts, pTeX refers to JFM (min10.tfm,  jis.tfm
16       etc.),  which  includes  definitions of some different character widths
17       and metric glue/kerns. For most punctuations and quotation  marks,  the
18       character  widths  are  truncated to less than 1 zw (zenkaku-width; the
19       width of ordinary Kanji characters), and metric glue/kerns are inserted
20       as a substitute.
21
22       On the other hand, in Japanese PS fonts, all punctuations and quotation
23       marks have the same character widths as ordinary Kanji characters.  For
24       this  reason,  when dvips processes the resulting DVI, these characters
25       have to be shifted to the left by the amount of glue/kerns inserted.
26
27       To achieve this, Virtual fonts (VF) and PS TFM files are required; When
28       VF  contains  the commands of shifting characters, PS font TFM can have
29       the exact character widths of PS fonts.
30
31       The program makejvf can be used for this purpose. It inputs a pTeX  JFM
32       file  (referred  to as <TeX TFM file> in SYNOPSIS above), and outputs a
33       corresponding VF file (with the same basename as <TeX TFM file>) and  a
34       JFM file for a PS font JFM file (<PS font TFM> above).
35

OPTIONS

37       -C        Condensed ("Cho-tai") mode.
38
39       -K <PS-TFM>
40                 Map  Kana  (more exactly, non-Kanji) characters to another PS
41                 font JFM named <PS-TFM>.
42
43       -b <integer>
44                 Base line shift amount; the  integer  represents  a  relative
45                 value,  using the character height as a base of 1000.  When a
46                 positive integer is specified, the  characters  are  lowered.
47                 When  a  negative  integer  is  specified, the characters are
48                 raised.
49
50       -m        Replace single/double  quotation  marks  (',  '')  with  sin‐
51                 gle/double prime quotation marks (so-called "minute") in ver‐
52                 tical writing.  The replacement is realized  by  manipulating
53                 glyphs of prime and double prime (JIS 0x216C and 0x216D; Uni‐
54                 code U+2032 and U+2033), not by  putting  actual  glyphs  de‐
55                 signed    for    quotation    marks   (Unicode   U+301D   and
56                 U+301E/U+301F).
57
58       -a <AFMfile>
59                 Name of the input AFM file used for  Kana-tsume  mode.   This
60                 option is unsupported.
61
62       -k <integer>
63                 Kana-tsume  (narrower  spaces between Kana characters) margin
64                 amount; the integer represents a relative  value,  using  the
65                 character  width as a base of 1000. This option should be ac‐
66                 companied with -a option.  This option is unsupported.
67
68       -i        Start mapped font ID from No. 0 in  output  VF  (by  default,
69                 makejvf defaults to No. 1).
70
71       -e        Enhanced mode; the horizontal shift amount is determined from
72                 the glue/kern table of input JFM file.
73
74       By default, makejvf uses the hard-coded value as the  horizontal  shift
75       amount,  which  is (mostly) optimized for Japanese fonts. When enhanced
76       mode (option -e) is enabled, the shift amount is  determined  from  the
77       input  pTeX  TFM (JFM) file, which is likely to output most suitable VF
78       for the JFM.
79
80       For most standard Japanese JFM (like jis.tfm and its derivatives),  the
81       output  VFs  from  both  modes will have no significant difference. For
82       simplified/traditional Chinese JFM  (like  upschrm-h.tfm  and  uptchrm-
83       h.tfm),  the output VF from enhanced mode will be better. For min10.tfm
84       and its derivatives, enhanced mode should never be enabled,  since  the
85       characterization in min10.tfm is non-standard.
86
87       -t <CNFfile>
88                 Use <CNFfile> as a configuration file.
89
90       -O        Omit  entries  in VF for characters with default metric. This
91                 option is not allowed to be used with the option -t.
92
93       -u <Charset>
94                 UCS mode. Available charsets are: gb (GB  =  Simplified  Chi‐
95                 nese), cns (CNS = Traditional Chinese), ks (KS = Korean), jis
96                 (JIS = Japanese), jisq (JIS quote only), custom (user-defined
97                 CHARSET  from  <CNFfile>;  see CONFIGURATION FILE FORMAT sec‐
98                 tion).
99
100       Options below are effective only in UCS mode:
101
102       -J <PS-TFM>
103                 Map single/double quote to another JIS-encoded PSfont TFM.
104
105       -U <PS-TFM>
106                 Map single/double quote to another UCS-encoded PSfont TFM.
107
108       -3        Use set3, that is, enable non-BMP  characters  support  (with
109                 UCS  mode).  By default makejvf does not output >=U+10000, to
110                 reduce file size and to avoid problems with old DVI  drivers.
111                 Recent  versions  of  dvipdfmx  and others can handle VF with
112                 >=U+10000 (= set3 in DVI language),  therefore  -3  might  be
113                 helpful.
114
115       -H        Use half-width Katakana.
116

EXAMPLE

118       If you want to use min10 as Ryumin-Light-H, run
119                 makejvf min10.tfm rml
120
121       This  generates min10.vf and rml.tfm. Put these files in an appropriate
122       directory under TEXMF tree, and add the following line to psfonts.map.
123                 rml Ryumin-Light-H
124

CONFIGURATION FILE FORMAT

126       With -t option, you can give makejvf a custom settings  for  generating
127       VF. The syntax is:
128
129                 % comment line
130                 MOVE <code>    <right>   <down>
131
132                 REPLACE   <code>    <new code>
133                 CHARSET   <code>,<code>,<code>..<code>,<code>,
134                 +    <code>,<code>..<code>
135
136
137       Each  line  should  begin  with a command, and should be TAB-separated.
138       Line starting with % is a comment, and empty lines are ignored.
139
140       The MOVE command specifies horizontal/vertical shift amount for the in‐
141       dividual  character  <code>. The REPLACE command replaces the character
142       <code> with <new code>. The CHARSET command sets the  custom  character
143       set of output VF; the + character continues from the previous line.
144
145       An example usage can be found in uptex-fonts project. See GitHub repos‐
146       itory
147                 <https://github.com/texjporg/uptex-fonts>.
148

SEE ALSO

150       More detailed description of makejvf in Japanese is available at
151            $TEXMFDIST/doc/fonts/ptex-fonts/README_makejvf
152

AUTHOR

154       This manual page was written  by  Japanese  TeX  Development  Community
155       <https://texjp.org>.   For  more  information,  see  GitHub  repository
156       <https://github.com/texjporg/ptex-fonts>.
157
158       Many thanks to Atsuhito KOHDA <kohda@debian.org>, for providing another
159       manpage in Debian GNU/Linux system.
160
161
162
163                                                                    MAKEJVF(1)
Impressum