summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/vntex/INSTALL
blob: 756591a67d2762dacc2dba295631f0878ec5c4a1 (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
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