summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/vntex/vntex.txt
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/vntex/vntex.txt')
-rw-r--r--Master/texmf-dist/doc/generic/vntex/vntex.txt328
1 files changed, 0 insertions, 328 deletions
diff --git a/Master/texmf-dist/doc/generic/vntex/vntex.txt b/Master/texmf-dist/doc/generic/vntex/vntex.txt
deleted file mode 100644
index 69510eafdfe..00000000000
--- a/Master/texmf-dist/doc/generic/vntex/vntex.txt
+++ /dev/null
@@ -1,328 +0,0 @@
-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
-
-Authors: Han The Thanh <HanTheThanh@gmx.net> and
- Reinhard Kotucha <Reinhard.Kotucha@web.de>
-
-The primary site of VnTeX is
-
- http://vntex.sf.net
-
-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
-
-
-I. Typesetting Vietnamese
-*************************
-
-Editor
-======
-In order to typeset Vietnamese you need an editor in which you can
-write Vietnamese. This is highly system-dependent. The good news
-is that VnTeX supports most popular encodings used for Vietnamese
-like VISCII, TCVN or UTF8. VNI is however not supported (and will
-not be). In most cases, you can use your favourite editor or TeX shell
-(like WinEDT, Texniccenter, Emacs, VIM, ...) with a Vietnamese font.
-
-
-Typesetting with LaTeX
-======================
-Some examples and hints for a quick start:
-
-
-* The simplest case:
- ________________________________________________________
- \documentclass{report}
- \usepackage[viscii]{vietnam} % use VISCII input encoding
-
- \begin{document}
- <...text in VISCII encoding...>
- \end{document}
- ________________________________________________________
-
- vietnam.sty has the following options:
-
- viscii use VISCII input encoding
- mviscii use MVISCII input encoding
- tcvn use TCVN input encoding
- vps use VPS input encoding
- utf8 use UTF8 input encoding (LaTeX)
- utf8x use UTF8 input encoding (ucs package)
- noinputenc do not load the inputenc package (use of TCX is assumed)
- nocaptions do not define Vietnamese captions
-
-
-* Use babel instead of vietnam package:
- ________________________________________________________
- \documentclass{report}
- \usepackage[utf8]{inputenc} % other encoding as `viscii'
- % or `tcvn' can be used
- % instead of utf8
- \usepackage[vietnam]{babel}
-
- \begin{document}
- <...text in utf8 encoding...>
- \end{document}
- ________________________________________________________
-
-
-* TCX is useful if you want to able to read Vietnamese characters in
- messages about overfull/underfull boxes and the like. VnTeX comes
- with two TCX tables: viscii-t5 and tcvn-t5. This implies that you
- can use TCX only with VISCII or TCVN input encoding. Using TCX
- excludes using inputenc:
-
- ________________________________________________________
- %& -translate-file=viscii-t5
- \documentclass{report}
- \usepackage[noinputenc]{vietnam}
-
- \begin{document}
- <...text in VISCII encoding...>
- \end{document}
- ________________________________________________________
-
- The very first line says that the option `-translate-file=viscii-t5'
- is passed to TeX when compiling the document. It has the same effect
- as you run:
-
- latex -translate-file=viscii-t5 foo.tex
-
- Using TCVN is similar.
-
-
-Typesetting with plain TeX
-==========================
-UTF8 input encoding is not supported by plain TeX. Otherwise it is
-quite similar to LaTeX:
-
-* Use with plainenc and plnfss packages:
- ________________________________________________________
- \input t5code
- \input plnfss
- \input plainenc
-
- \fontencoding{T5}
- \inputencoding{viscii} % or any other encoding except utf8
- \setfontencoding{T5}
- \selectfont
-
- <...text in VISCII encoding...>
- \bye
- ________________________________________________________
-
-
-* Use with TCX:
- ________________________________________________________
- %& -translate-file=viscii-t5
- \input t5code
- \input plnfss
-
- \setfontencoding{T5}
- \selectfont
-
- <...text in VISCII encoding...>
- \bye
- ________________________________________________________
-
-
-Use with texinfo
-================
-TCX is required:
- ________________________________________________________
- %& -translate-file=viscii-t5
- \def\fontprefix{vn}
- \input t5code.tex
- \input texinfo
-
- <...text in VISCII encoding...>
- ________________________________________________________
-
-plainenc and plnfss are not part of the VnTeX distribution any more but
-it is very likely that they are part of the TeX system you are using.
-
-If you have a plnfss which does not support Vietnamese, please install
-
- http://vntex.sf.net/download/vntex-support/plnfss.zip
-
-
-Use with tex4ht
-===============
-In order to create HTML documents from LaTeX sources, run
-
- tex4ht "html,uni-html4,charset=utf8" yourfile.tex
-
-You cannot use TCX with tex4ht.
-
-
-There are some test files for VnTeX in the tests subdirectory.
-Please read the file README in this directory.
-
-
-II. Vietnamese Fonts
-********************
-
-VnTeX provides a lot of Vietnamese fonts. If you do not specify any
-font (as in the examples above) you get Vietnamese Computer Modern.
-This is an extension to Donald Knuth's Computern Modern Fonts designed
-by Han The Thanh.
-
-VnTeX provides Vietnamese characters for some free fonts donated by
-URW and Bitstream as well as the Microsoft core fonts.
-
-To get an overview, look at:
-
- http://vntex.sf.net/fonts/samples
-
-There are many fonts, but most of them do not provide support for
-mathematics. If you have to typeset math formulas, you are restricted
-to Computer Modern, Latin Modern, Times and Palatino.
-
-Latin Modern (Boguslaw Jackowski and Janusz M. Nowacki) is an
-extension to Computer Modern which supports (almost) all latin
-languages. It provides even different accents for Vietnamese
-uppercase and lowercase letters.
-
-
-We describe how to use fonts with LaTeX first. A description of
-plnfss (plain TeX) is given below.
-
-To use Latin Modern instead of VNR, simply
-
- \usepackage{lmodern}
- \usepackage[viscii]{vietnam}
-
-For Antikwa Torunska, do
-
- \usepackage{anttor}
- \usepackage[viscii]{vietnam}
-
-... or use inputenc and babel instead of vietnam.
-
-It is recommended to specify a roman font, a sans serif font and a
-typewriter font separately. You do not have to specify all of them.
-It makes sense, for instance, not to specify a typewriter font -- you
-get Computer Modern Typewriter then, which is by far the best
-typewriter font you can get today.
-
-\renewcommand\sfdefault{uag} VnURWGothicL (AvantGarde)
-\renewcommand\rmdefault{ubk} VnURWBookmanL (Bookman)
-\renewcommand\ttdefault{ucr} VnNimbusMonL (Courier)
-\renewcommand\sfdefault{uhv} VnNimbusSanL (Helvetica)
-\renewcommand\rmdefault{unc} VnCenturySchL (New Century Schoolbok)
-\usepackage{mathpazo} VnURWPalladioL (Palatino)
-\usepackage{mathptm} VnNimbusRomNo9L (Times)
-
-There is also a real small caps font for VnURWPalladioL, made by Ralf Stubner
-and extended by Han The Thanh. There are still some support files missing.
-
-By default, you get the faked small caps but you can use real small caps with
-some restrictions. To make use of it, put the following macro definition
-into the preamble of your document:
-
-\newcommand{\textfplsc}[1]{\bgroup\usefont{T5}{fpl}{m}{sc}#1\egroup}
-
-You can use it like this:
-
- some text \textfplsc{some text in small caps} some text
-
-The macro argument should not contain any numbers because they will appear
-as oldstyle numbers, but you cannot use oldstyle numbers with other font
-shapes in T5 encoding (Vietnamese) yet. This problem will be fixed in a
-future release.
-
-
-If you have to typeset mathematics, there are very few fonts available:
-
- * Computer Modern: do nothing
- * Latin Modern: \usepackage{lmodern}
- * Palatino: \usepackage{mathpazo}
- * Times: \usepackage{mathptm}
-
-The other fonts do not support mathematics.
-
-If you are using Windows, you also can use the fonts provided by
-Microsoft:
-
-\renewcommand\sfdefault{ma1} ArialMT (Arial)
-\renewcommand\ttdefault{mcr} CourierNewPSMT (Courier)
-\renewcommand\rmdefault{lpr} PalatinoLinotype (Palatino)
-\renewcommand\rmdefault{mns} TimesNewRomanPSMT (Times New Roman)
-\renewcommand\sfdefault{jth} Tahoma (Tahoma)
-\renewcommand\sfdefault{jvn} Verdana (Verdana)
-
-None of the Microsoft fonts supports mathematics. Though the quality of
-the fonts is quite high, not much care had been taken in the design of
-Vietnamese accents. See:
-
- http://vntex.sf.net/fontsamples
-
-Unless someone insists that you use these fonts, you can use
-
- * VnNimbusMonL instead of CourierNewPSMT (Courier)
- * VnNimbusSanL instead of ArialMT (Helvetica/Arial)
- * VnNimbusRomNo9L instead of TimesNewRomanPSMT (Times/Times New Roman)
- * VnURWPalladioL instead of PalatinoLinotype (Palatino)
-
-
-If you are using plain TeX, you can use plnfss.tex to select fonts.
-
-Instead of
-
- \renewcommand\rmdefault{...}
- \renewcommand\sfdefault{...}
- \renewcommand\ttdefault{...}
-
-you have to select fonts like this:
-
- \setrmdefault{...}
- \setsfdefault{...}
- \setttdefault{...}
-
-See the plnfss documentation for more details.
-
-
-III. Known Problems
-*******************
-
-* To use amsart.cls (and other AMS LaTeX document classes) with Unicode you
- must add the following lines right before `\begin{document}':
-
- \def\firstofone#1{#1}
- \let\uppercase\firstofone
- \let\MakeUppercase\firstofone
-
- This completely disables LaTeX's uppercasing commands which might cause
- bad secondary effects. Note that this problem is not specific to
- Vietnamese but affects any multibyte encoding.
-
-* In order to use VnTeX with Prosper, you have to install
-
- http://vntex.sf.net/download/vntex-support/prosper-vn.zip
-
-* In order to use VnTeX with Foiltex, you have to install
-
- http://vntex.sf.net/download/vntex-support/foiltex-vn.zip
-
-* If have an old version of LaTeX which does not support utf8, you have to
- use ucs.sty. If ucs.sty is not present on your system you can install
-
- http://vntex.sf.net/download/vntex-support/ucs-vn.zip
-
- We keep this file as long as ucs is unmaintained. If a maintainer is
- found you better download a fresh ucs distribution from the original site.
-
- This is a small subset of the ucs package which supports Vietnamese only.
- You can invoke it with \usepackage[utf8x]{inputenc}.
-
- Instead of installing ucs we recommend to update LaTeX. The latest version
- can be downloaded from
-
- ftp://dante.ctan.org/tex-archive/macros/latex/base.zip (Germany)
- ftp://cam.ctan.org/tex-archive/macros/latex/base.zip (United Kingdom)
- ftp://tug.ctan.org/tex-archive/macros/latex/base.zip (USA)
-