summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/vntex/INSTALL
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/vntex/INSTALL')
-rw-r--r--Master/texmf-dist/doc/generic/vntex/INSTALL324
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>