diff options
Diffstat (limited to 'Master/texmf-dist/doc/generic/vntex/INSTALL')
-rw-r--r-- | Master/texmf-dist/doc/generic/vntex/INSTALL | 324 |
1 files changed, 129 insertions, 195 deletions
diff --git a/Master/texmf-dist/doc/generic/vntex/INSTALL b/Master/texmf-dist/doc/generic/vntex/INSTALL index ea6963b9e99..4386aff35d7 100644 --- a/Master/texmf-dist/doc/generic/vntex/INSTALL +++ b/Master/texmf-dist/doc/generic/vntex/INSTALL @@ -1,131 +1,44 @@ -vntex-3.1.2 +vntex-3.1.7 -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> +This file is part of VnTeX. +Copyright 2005-2008 Reinhard Kotucha <reinhard.kotucha@web.de> -See Appendix A where to get help. +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. -Installation -============ - -UNIX, Linux, MacOS/X, TeXLive (UNIX or Windows) ------------------------------------------------ -To install VnTeX on a web2c system you have to unpack vntex-3.1.2.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 - manually. - This is not required if you use tha Makefile, see README in the - tests directory. - Add C:/WINDOWS/FONTS to TTFONTS if you're under Windows. +_______________________________________ +Appendix A describes where to get help. +_______________________________________ -* Set the environment variable TEXMFCNF to the directory in which - your local copy of texmf.cnf resides. See Appendix B for details. -* Run texhash. +Installation +============ -* Now you have to update the map files. +MikTeX +------ +Official versions of VnTeX are provided by MikTeX. +Please use MikTeX's package manager to install or update VnTeX. - 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 --nohash --nomkmap --enable Map arevvn.map - updmap-sys --nohash --nomkmap --enable Map classicovn.map - updmap-sys --nohash --nomkmap --enable Map cmbrightvn.map - updmap-sys --nohash --nomkmap --enable Map comicvn.map - updmap-sys --nohash --nomkmap --enable Map concretevn.map - updmap-sys --nohash --nomkmap --enable Map garamondvn.map - updmap-sys --nohash --nomkmap --enable Map grotesqvn.map - updmap-sys --nohash --nomkmap --enable Map vntopia.map - updmap-sys --nohash --nomkmap --enable Map txttvn.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 --nohash --nomkmap --enable Map arevvn.map - updmap --nohash --nomkmap --enable Map classicovn.map - updmap --nohash --nomkmap --enable Map cmbrightvn.map - updmap --nohash --nomkmap --enable Map comicvn.map - updmap --nohash --nomkmap --enable Map concretevn.map - updmap --nohash --nomkmap --enable Map garamondvn.map - updmap --nohash --nomkmap --enable Map grotesqvn.map - updmap --nohash --nomkmap --enable Map vntopia.map - updmap --nohash --nomkmap --enable Map txttvn.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 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 --nohash --nomkmap --enable Map arevvn.map - updmap --nohash --nomkmap --enable Map classicovn.map - updmap --nohash --nomkmap --enable Map cmbrightvn.map - updmap --nohash --nomkmap --enable Map comicvn.map - updmap --nohash --nomkmap --enable Map concretevn.map - updmap --nohash --nomkmap --enable Map garamondvn.map - updmap --nohash --nomkmap --enable Map grotesqvn.map - updmap --nohash --nomkmap --enable Map vntopia.map - updmap --nohash --nomkmap --enable Map txttvn.map - updmap - - from the command line. If not, ask your system administrator to - install 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. -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 +* 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 @@ -153,7 +66,7 @@ MikTeX Map vntopia.map Map txttvn.map - If there is an entry `MixedMap vnr.map', remove it. + If there is an entry "MixedMap vnr.map", remove it. * Run "initexmf -mkmaps". @@ -165,121 +78,142 @@ MikTeX 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. +TeX Live (UNIX, Linux, MacOS/X, Windows) +---------------------------------------- -Make sure your tex4ht distribution is not too old. +If you have TeX Live 2008 or later, run + tlmgr --location <URL> update vntex -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 -* Download from: + tlmgr gui - http://ctan.tug.org/tex-archive/macros/plain/plnfss +if you prefer the graphical user interface. On Windows you can invoke +the TeX Live Manager from the start menu. -* Unpack the archive in the same texmf tree as VnTeX. +Please consult the TeX Live documentation for more information. -* 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 +teTeX, older versions of TeX Live (UNIX, Linux, MacOS/X, Windows) +----------------------------------------------------------------- - http://lists.sourceforge.net/lists/listinfo/vntex-users +===================================================================== +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. +===================================================================== -The primary site of VnTeX is: +In order to install VnTeX on a web2c system you have to unpack +vntex-3.1.7.zip inside of a texmf tree. There are two ways to +install VnTeX: - http://vntex.org +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. -The current maintainers are: +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 - Han The Thanh <HanTheThanh@gmx.net> - Werner Lemberg <WL@gnu.org> - Reinhard Kotucha <Reinhard.Kotucha@web.de> + 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) -Appendix B: Setting Environment Variables -========================================== -(This is not needed for MikTeX) + 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: -UNIX -~~~~ + mkdir `kpsewhich --expand-var=\$TEXMFHOME` (UNIX only) - Personal installation - --------------------- - Put +* Unpack the .zip file in TEXMFLOCAL or TEXMFHOME. - TEXMFCNF=<path_to_texmf.cnf> +* Run texhash. - into the file ~/.profile . +* Now you have to update the map files. - TEXMFCNF must be an absolute path (beginning with /) to the - directory in which the file texmf.cnf resides. + 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 - Run "source ~/.profile" to execute this file in the current shell. - Next time you log in this file will be evaluated automatically. + perl vntex-update-maps - 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. + (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. -Windows (TeXLive) ^1 -~~~~~~~~~~~~~~~~~~~~ - -- Windows 95/98 + Hence, if you want to create your own batch file, you can say: - Edit your autoexec.bat. Add the line: + perl vntex-update-maps -sys -n > my_own_batchfile.bat - set TEXINPUTS=c:\texmf-vntex//: + This might be useful if you need a customized version of the + script. - and reboot your system. - -- Windows ME +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. - 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 +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. - 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. +* Download from: - 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. + http://ctan.tug.org/tex-archive/macros/plain/plnfss -######################################################################## - 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! -######################################################################## +* Unpack the archive in the same texmf tree as VnTeX. -________________ +* Refresh the file database. -^1 See: http://tug.org/texlive/doc/texlive-en/live.html +_______________________________________________________________________ +_______________________________________________________________________ + +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> |