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
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
|
vntex-3.02
This file is part of VnTeX. License: LPPL, version 1.3 or newer,
see: http://www.latex-project.org/lppl.txt
Author: Reinhard Kotucha <reinhard.kotucha@web.de>
See Appendix A where to get help.
When do I need vntex-3.02-TDS-1.0.zip?
===========================================
VnTeX complies with version 1.1 of the TDS (TeX Directory Structure).
To find out whether your system supports version 1.1, look whether
there is a directory fonts/map in at least one texmf tree. If this is
*not* the case, you need vntex-3.02-TDS-1.0.zip.
Installation
============
UNIX, Linux, MacOS/X, TeXLive (UNIX or Windows)
-----------------------------------------------
To install VnTeX on a web2c system you have to unpack vntex-3.02.zip
or vntex-3.02-TDS-1.0.zip inside of a texmf tree. It is recommended
to create an own directory tree for vntex so that you can remove it easily
when you update your TeX system.
This directory tree should be the first item of TeX's search path,
otherwise you have to remove old versions of VnTeX or vncmr completely.
On UNIX systems this is something like /usr/local/share/texmf-vntex
for a system-wide installation or $HOME/texmf-vntex if you do not have
access to this directory. On Windows c:\texmf-vntex is a good place.
* Unpack the .zip file in this directory.
* Create a local copy of the system texmf.cnf file.
* Edit this copy:
-- Add texmf-vntex with its complete path to the variable TEXMF. It
should appear before TEXMFDIST and TEXMFMAIN.
-- Set font_mem_size to a value of at least 1100000 if you want to
compile the font samples in texmf-vntex/doc/generic/vntex/tests.
(This is not required, see README in the tests directory).
Add C:/WINDOWS/FONTS to TTFONTS if you're under Windows.
* Set the environment variable TEXMFCNF to the directory in which
your local copy of texmf.cnf resides. See Appendix B for details.
* Run texhash.
* Now you have to update the map files.
System-wide installation
~~~~~~~~~~~~~~~~~~~~~~~~
If there is a program updmap-sys on your system, run
updmap-sys --nohash --nomkmap --disable vnr.map
updmap-sys --nohash --nomkmap --enable MixedMap vnrtext.map
updmap-sys --nohash --nomkmap --enable MixedMap vnrother.map
updmap-sys --nohash --nomkmap --enable Map urwvn.map
updmap-sys --nohash --nomkmap --enable Map chartervn.map
updmap-sys --nohash --nomkmap --enable Map mscorevn.map
updmap-sys
Otherwise, run
updmap --nohash --nomkmap --disable vnr.map
updmap --nohash --nomkmap --enable MixedMap vnrtext.map
updmap --nohash --nomkmap --enable MixedMap vnrother.map
updmap --nohash --nomkmap --enable Map urwvn.map
updmap --nohash --nomkmap --enable Map chartervn.map
updmap --nohash --nomkmap --enable Map mscorevn.map
updmap
from your command line. But don't use updmap if updmap-sys is
available.
Personal installation
~~~~~~~~~~~~~~~~~~~~~
If you don't have access to the system directories, you have unpacked
your files in $HOME/texmf-vntex or c:\texmf-vntex.
If there is a program updmap-sys on your system, run
updmap --nohash --nomkmap --disable vnr.map
updmap --nohash --nomkmap --enable MixedMap vnrtext.map
updmap --nohash --nomkmap --enable MixedMap vnrother.map
updmap --nohash --nomkmap --enable Map urwvn.map
updmap --nohash --nomkmap --enable Map mscorevn.map
updmap
from the command line. If not, ask your system administrator to
install VnTeX.
MikTeX
------
* Remove (if any) previous version of VnTeX by running
[Programs]-->[MikTeX]-->[MikTeX Options], then select
[Packages]-->[Language]-->[Vietnamese]-->[vntex].
* Unpack vntex .zip file to some location, e.g., c:\texmf-vntex if you
have installed MikTeX to c:\texmf. If you have installed MikTeX to
e.g c:\miktex\texmf, then it is recommended to unpack it in
c:\miktex\texmf-vntex.
* Run [Programs]-->[MikTeX]-->[MikTeX Options], then select
[Roots]-->[Add] and add c:\texmf-vntex (or c:\miktex\texmf-vntex).
* Refresh the file name database.
* If you want to use the T1 fonts that come with VnTeX, you also
need to make dvips and pdftex aware of those fonts:
Add the following lines to updmap.cfg:
MixedMap vnrtext.map
MixedMap vnrother.map
Map urwvn.map
Map chartervn.map
Map mscorevn.map
If there is an entry `MixedMap vnr.map', remove it.
* Run "initexmf -mkmaps".
* Edit the file MIKTEX.INI
-- Add c:\windows\fonts to TTFPath.
-- Set font_mem_size to a value of at least 1100000 if you want to
compile the font samples in texmf-vntex/doc/generic/vntex/tests.
Tex4ht (all systems)
--------------------
The Vietnamese fonts for tex4ht are now part of the tex4ht distribution.
In order to use tex4ht you have to install the files needed by VnTeX.
Make sure your tex4ht distribution is not too old.
plnfss (all systems)
--------------------
The plain TeX font selection macros are now a separate package.
You don't neeed it if you are using LaTeX.
* Download from:
http://vntex.org/download/vntex-support
* Unpack the archive in the same texmf tree as VnTeX.
* Refresh the file database.
_______________________________________________________________________
_______________________________________________________________________
Appendix A: Getting Help
=========================
If you have any problems, don't hesitate to ask. There is a mailing
list (very low traffic) for questions about VnTeX and typesetting
Vietnamese. To subscribe to the list, visit
http://lists.sourceforge.net/lists/listinfo/vntex-users
The primary site of VnTeX is:
http://vntex.org
The current maintainers are:
Han The Thanh <HanTheThanh@gmx.net>
Werner Lemberg <WL@gnu.org>
Reinhard Kotucha <Reinhard.Kotucha@web.de>
Appendix B: Setting Environment Variables
==========================================
(This is not needed for MikTeX)
UNIX
~~~~
Personal installation
---------------------
Put
TEXMFCNF=<path_to_texmf.cnf>
into the file ~/.profile .
TEXMFCNF must be an absolute path (beginning with /) to the
directory in which the file texmf.cnf resides.
Run "source ~/.profile" to execute this file in the current shell.
Next time you log in this file will be evaluated automatically.
System wide installation
------------------------
Put the variable into /etc/profile. If there is a directory
/etc/profile.d, add a file "vntex.sh" to this directory which
contains the variable.
The variable is evaluated when a user logs in.
Windows (TeXLive) ^1
~~~~~~~~~~~~~~~~~~~~
-- Windows 95/98
Edit your autoexec.bat. Add the line:
set TEXINPUTS=c:\texmf-vntex//:
and reboot your system.
-- Windows ME
You need to run the special program c:\windows\system\msconfig.exe
to be able to change any environment variable. From this program,
select the `Environment' tab, and then add or modify the variable
you want. You will be asked to reboot the machine upon any
change.
-- Windows NT/2K/XP
Click left on "Start-->Settings-->Control Panel-->Environment variables".
Now the window with the control panel icons opens. Double click
on System. The System Properties window opens. Click on the tab
Environment or look for a button named Environment Variables among
the dialog boxes. Now you can change the environment variables
for your user account.
Note:
There are also displayed the environment settings for the
system. Normally, you can't change the system variables unless
you have administrator rights on your machine. If you want to
change the PATH for all users, you will have to contact your system
administrator or be the system administrator yourself -- in the
latter case you should know what you are doing.
########################################################################
Don't forget to remove TEXMFCNF (and your copy of the file texmf.cnf)
if you install a new TeX system which already provides VnTeX-3.0!
########################################################################
________________
^1 See: http://tug.org/texlive/doc/texlive-en/live.html
|
