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 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 Werner Lemberg Reinhard Kotucha Appendix B: Setting Environment Variables ========================================== (This is not needed for MikTeX) UNIX ~~~~ Personal installation --------------------- Put TEXMFCNF= 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