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
|
vntex-3.2.1
This file is part of VnTeX.
Copyright 2005-2008 Reinhard Kotucha <reinhard.kotucha@web.de>
This work may be distributed and/or modified under the conditions of
the LaTeX Project Public License, either version 1.3 of this license
or (at your option) any later version. The latest version of this
license is in
http://www.latex-project.org/lppl.txt
The current maintainer is Reinhard Kotucha.
_______________________________________
Appendix A describes where to get help.
_______________________________________
Installation
============
MikTeX
------
Official versions of VnTeX are provided by MikTeX.
Please use MikTeX's package manager to install or update VnTeX.
You only have to read on if you are going to install a beta release.
Beta releases are supposed for testing only but not for production.
The first line of this file contains the version number of the release
you downloaded. You only have to follow the instructions below if it
contains the word "beta" and you really want to install it.
* Remove (if any) previous version of VnTeX by running
[Programs]-->[MikTeX]-->[MikTeX Options], then select
[Packages]-->[Language]-->[Vietnamese]-->[vntex].
* Unpack the 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
Map arevvn.map
Map classicovn.map
Map cmbrightvn.map
Map comicvn.map
Map concretevn.map
Map garamondvn.map
Map grotesqvn.map
Map vntopia.map
Map txttvn.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.
TeX Live (UNIX, Linux, MacOS/X, Windows)
----------------------------------------
If you have TeX Live 2008 or later, run
tlmgr install vntex
or
tlmgr gui
if you prefer the graphical user interface. On Windows you can invoke
the TeX Live Manager from the start menu.
Please consult the TeX Live documentation for more information.
teTeX, older versions of TeX Live (UNIX, Linux, MacOS/X, Windows)
-----------------------------------------------------------------
=====================================================================
If you have a version of TeX Live older than TeX Live 2008, keep in
mind that TeX Live for Windows behaves differently than TeX Live for
UNIX. Please consult the TeX Live manual.
=====================================================================
In order to install VnTeX on a web2c system you have to unpack
vntex-3.2.1.zip inside of a texmf tree. There are two ways to
install VnTeX:
1. If you want to test beta versions it is recommended that you create
a separate directory for VnTeX so that you can remove old versions
of VnTeX easily. How to add a directory tree to the TEXMF search
path is described in the manual of the TeX distribution you are
using.
2. If you want to install an official release, it is recommended to
put it into the texmf-local local directory. In order to find out
where it is, type
kpsewhich --expand-var=\$TEXMFLOCAL (UNIX)
kpsewhich --expand-var=$TEXMFLOCAL (Windows)
on the command line. If you don't have root access you can either
ask your system administrator to install VnTeX for you (this is
preferred because other users might be interested as well).
You alse can install it to your HOME directory. To find out
where it is, type
kpsewhich --expand-var=\$TEXMFHOME (UNIX)
kpsewhich --expand-var=$TEXMFHOME (Windows)
on the command line. This directory might not exist and you have
to create it manually. If the output of kpsewhich looks
reasonable, you can say:
mkdir `kpsewhich --expand-var=\$TEXMFHOME` (UNIX only)
* Unpack the .zip file in TEXMFLOCAL or TEXMFHOME.
* Run texhash.
* Now you have to update the map files.
This is a quite inconvenient task. But there is a little Perl
script in the same directory as the file you are just reading.
It's called "vntex-update-maps". If you type on the command
line
perl vntex-update-maps
(without any arguments) you'll get a usage message. If you say
perl vntex-update-maps -help
you'll get the same message but it will also tell you the content
of the variables TEXMFHOME and TEXMFLOCAL.
If you extracted the zip archive to TEXMFHOME you have to run
perl vntex-update-maps -home
and if you extracted it to TEXMFLOCAL you have to run
perl vntex-update-maps -sys
If you supply the -n option, the commands that would be
executed are printed to screen, but nothing is executed.
Hence, if you want to create your own batch file, you can say:
perl vntex-update-maps -sys -n > my_own_batchfile.bat
This might be useful if you need a customized version of the
script.
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 or Context.
* Download from:
http://ctan.tug.org/tex-archive/macros/plain/plnfss
* 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.sf.net
The current maintainers are:
Han The Thanh <HanTheThanh@gmx.net>
Werner Lemberg <WL@gnu.org>
Reinhard Kotucha <Reinhard.Kotucha@web.de>
|
