1MAKEJVF(1) General Commands Manual MAKEJVF(1)
2
3
4
6 makejvf - Make Japanese VF file from Japanese TeX TFM file
7
9 makejvf [<options>] <TeX TFM file> <PS font TFM>
10
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 (refered 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
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
55 designed 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
66 accompanied 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 -u <Charset>
91 UCS mode. Available charsets are: gb (GB = Simplified Chi‐
92 nese), cns (CNS = Traditional Chinese), ks (KS = Korean), jis
93 (JIS = Japanese), jisq (JIS quote only), custom (user-defined
94 CHARSET from <CNFfile>; see CONFIGURATION FILE FORMAT sec‐
95 tion).
96
97 Options below are effective only in UCS mode:
98
99 -J <PS-TFM>
100 Map single/double quote to another JIS-encoded PSfont TFM.
101
102 -U <PS-TFM>
103 Map single/double quote to another UCS-encoded PSfont TFM.
104
105 -3 Use set3, that is, enable non-BMP characters support (with
106 UCS mode). By default makejvf does not output >=U+10000, to
107 reduce file size and to avoid problems with old DVI drivers.
108 Recent versions of dvipdfmx and others can handle VF with
109 >=U+10000 (= set3 in DVI language), therefore -3 might be
110 helpful.
111
112 -H Use half-width Katakana.
113
115 If you want to use min10 as Ryumin-Light-H, run
116 makejvf min10.tfm rml
117
118 This generates min10.vf and rml.tfm. Put these files in an appropriate
119 directory under TEXMF tree, and add the following line to psfonts.map.
120 rml Ryumin-Light-H
121
123 With -t option, you can give makejvf a custom settings for generating
124 VF. The syntax is:
125
126 % comment line
127 MOVE <code> <right> <down>
128
129 REPLACE <code> <new code>
130 CHARSET <code>,<code>,<code>..<code>,<code>,
131 + <code>,<code>..<code>
132
133
134 Each line should begin with a command, and should be TAB-separated.
135 Line starting with % is a comment, and empty lines are ignored.
136
137 The MOVE command specifies horizontal/vertical shift amount for the
138 individual character <code>. The REPLACE command replaces the character
139 <code> with <new code>. The CHARSET command sets the custom character
140 set of output VF; the + character continues from the previous line.
141
142 An example usage can be found in uptex-fonts project. See GitHub repos‐
143 itory
144 <https://github.com/texjporg/uptex-fonts>.
145
147 More detailed description of makejvf in Japanese is available at
148 $TEXMFDIST/doc/fonts/ptex-fonts/README_makejvf
149
151 This manual page was written by Japanese TeX Development Community
152 <https://texjp.org>. For more information, see GitHub repository
153 <https://github.com/texjporg/ptex-fonts>.
154
155 Many thanks to Atsuhito KOHDA <kohda@debian.org>, for providing another
156 manpage in Debian GNU/Linux system.
157
158
159
160 MAKEJVF(1)