summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/fonts/hwkatakana/README
blob: 366e392dd71df6e8b5139a8b0e5d9b0bdd380688 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
Half-width katakana Type 1 fonts in SJIS encoding are provided to
integrate with the Wadalab fonts for use with, for example, the CJK
package.  Auxiliary files to use the font with Unicode UTF8 encoding
are also provided.  The origin of the font is the Wadalab gothic font
katakana glyphs, which have been modified to make up the JIS X 0201
set of half-width katakana characters using Fontforge.  The Wadalab
fonts need to be available for this package to work.  Installation
instructions and examples of usage are provided.

Half-width katakana font, Gernot Hassenpflug (aikishugyo@gmail.com).

1 LICENCE
2 CHANGELOG
3 FILES
4 INSTALLATION
5 CONFIGURATION
6 USAGE
7 DERIVATION


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

1 - LICENCE

The license of these half-width katakana fonts and accompanying files
in this package (see Section 3 FILES) is GPL (GNU Public License)
Version 2 or higher, see URL: http://www.gnu.org/copyleft/gpl.html.

The original Wadalab fonts by TANAKA Tetsuro
(ktanaka@tanaka.ecc.u-tokyo.ac.jp) are available from the URL:
ftp.ipl.t.u-tokyo.ac.jp and are licensed under a DFSG-free license
given in ISO-2022-JP encoding at the URL:
ftp://ftp.dante.de/pub/tex/support/ghostscript/3rdparty/fonts/kanji/README.nihongo.

Modifications to the Wadalab fonts were carried out using the wftodm
patch by Werner Lemberg licensed under GPL, and the resultant Type 1
font file dgjkata.pfb was used as the basis for these half-width
katakana fonts.


2 - CHANGELOG

This is version 1.0 (2008-01-16).

NEW in version 1.0:

* complete JIS X 0201 half-width katakana characters

* Type 1 font in SJIS encoding

* TeX virtual fonts for UTF8 encoding

* TeX .tfm files for SJIS and UTF8 encoding

* LaTeX .fd files for SJIS encoding

* dvips .map file

* installation instructions


3 - FILES

This package contains the following files:

* README: this file

* hwkatakana-sampler-UTF8.tex,
  hwkatakana-sampler-SJIS.tex: sample files

* hwkatakana-sampler-UTF8.pdf,
  hwkatakana-sampler-SJIS.pdf: compiled sample files

* dgjhw.map: dvips map file

* c49min.fd, c49goth.fd, c49maru.fd: latex font definition files
  for SJIS encoding

* dgjhw.pfb: Type 1 font file for SJIS encoding

* dgjhw.tfm: TeX font metric file for SJIS encoding

* udgjff.tfm, udmjff.tfm, umrjff.tfm, umcjff.tfm: TeX font metric files
  for UTF8 encoding

* udgjff.vf, udmjff.vf, umrjff.vf, umcjff.vf: Virtual font files
  for UTF8 encoding


4 - INSTALLATION

The texmf tree provides a standard TDS.  The files in this
distribution mimic the structure of this tree.  You have to install
the following files in one of your texmf trees (or create a new one).
It is important to first install the Wadalab fonts, since this package
relies on the Wadalab installation and supplies some alternative
subfonts replacing those of the Wadalab-supplied subfonts. The
installation will then overwrite these subfonts with the alternative
ones from this package, thus you should keep the original ones for
when you uninstall this package.

* dgjhw.tfm:  $TEXMF/fonts/tfm/wadalab/dgjhw/

* dgjhw.pfb:  $TEXMF/fonts/type1/wadalab/dgjhw/

* dgjhw.map:    $TEXMF/fonts/map/dvips/dgjhw/

% Note: Those files overwrite existing ones!
* udgjff.tfm:  $TEXMF/fonts/tfm/wadalab/udgj/
* udmjff.tfm:  $TEXMF/fonts/tfm/wadalab/udmj/
* umrjff.tfm:  $TEXMF/fonts/tfm/wadalab/umrj/
* umcjff.tfm:  $TEXMF/fonts/tfm/wadalab/umcj/

% Note: Those files overwrite existing ones!
* udgjff.vf:  $TEXMF/fonts/type1/wadalab/udgj/
* udmjff.vf:  $TEXMF/fonts/type1/wadalab/udmj/
* umrjff.vf:  $TEXMF/fonts/type1/wadalab/umrj/
* umcjff.vf:  $TEXMF/fonts/type1/wadalab/umcj/

* c49min.fd:  $TEXMF/tex/latex/CJK/contrib/wadalab/
* c49goth.fd: $TEXMF/tex/latex/CJK/contrib/wadalab/
* c49maru.fd: $TEXMF/tex/latex/CJK/contrib/wadalab/

* README      $TEXMF/doc/fonts/wadalab/dgjh/
* hwkatakana-sampler-UTF8.tex $TEXMF/doc/fonts/wadalab/dgjh/
* hwkatakana-sampler-SJIS.tex $TEXMF/doc/fonts/wadalab/dgjh/

* hwkatakana-sampler-UTF8.pdf $TEXMF/doc/fonts/wadalab/dgjh/
* hwkatakana-sampler-SJIS.pdf $TEXMF/doc/fonts/wadalab/dgjh/

5 - CONFIGURATION

After installing the files and new directories, you should run

% sudo texhash

Then run updmap-sys

% sudo updmap-sys --enable Map dgjhw.map

If you don't have updmap-sys or don't want to use it:

  . For dvips, add this line in config.ps:

      p +dgjhw.map

  . For pdf(la)tex add this line in pdftex.cfg:

      map +dgjhw.map

  . Following this you need to run again

      % sudo texhash

If you have problems when installing the half-width katakana fonts,
please contact me.


6 - USAGE

The Wadalab fonts must be available first, so that the "min", "goth"
and "maru" typefaces can be used. To these typefaces are now added
newly the half-width katakana glyphs.

When writing in SJIS encoded files, the command \CJKhwkatakana must be
used in the document to activate the use of half-width katakana
(\CJKnohwkatakana converts them to full-width katakana).  Then,
half-width katakana can be entered at the keyboard and be present in
the output.

When writing UTF8 encoded files, no special commands are needed;
half-width katakana can simply be entered at the keyboard and are
automatically handled by the CJK package. The \CJKnohwkatakana will
convert all entered half-width katakana to full-width in the output,
and vice versa for \CJKhwkatakana.

No support is currently provided for the use of half-width katakana in
EUC encoded files.


7 - DERIVATION

The modified (by wftodm patch, see Section 1 LICENSE) Wadalab Gothic
Type 1 full-width katakana font file dgjkata.pfb was used as the basis
for the half-width katakana font of this package.  Fontforge was used
to edit the glyphs and create the .pfb and .tfm files.

To make the virtual font for UTF8 encoding, clonevf.pl from the CJK
package repository was used to make a mapped copy (to itself) of
dgjhw.tfm.  The vf file was converted to vpl, and the entries modified
to reflect a mapping from UTF8 to SJIS.  Then they were added, along
with a reference to the mapped font,  to the .vpl version of the
existing Wadalab udgjff.vf.  Then new .vf and .tfm were created from
udgjff.vpl.