summaryrefslogtreecommitdiff
path: root/language/vietnamese/vntex/doc/INSTALL
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /language/vietnamese/vntex/doc/INSTALL
Initial commit
Diffstat (limited to 'language/vietnamese/vntex/doc/INSTALL')
-rw-r--r--language/vietnamese/vntex/doc/INSTALL216
1 files changed, 216 insertions, 0 deletions
diff --git a/language/vietnamese/vntex/doc/INSTALL b/language/vietnamese/vntex/doc/INSTALL
new file mode 100644
index 0000000000..b228d2f8a0
--- /dev/null
+++ b/language/vietnamese/vntex/doc/INSTALL
@@ -0,0 +1,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>
+