diff options
Diffstat (limited to 'Master/texmf-dist/source/generic/vntex/doc/vntex.tex')
| -rwxr-xr-x | Master/texmf-dist/source/generic/vntex/doc/vntex.tex | 418 |
1 files changed, 261 insertions, 157 deletions
diff --git a/Master/texmf-dist/source/generic/vntex/doc/vntex.tex b/Master/texmf-dist/source/generic/vntex/doc/vntex.tex index 19a7db051db..979a3c89675 100755 --- a/Master/texmf-dist/source/generic/vntex/doc/vntex.tex +++ b/Master/texmf-dist/source/generic/vntex/doc/vntex.tex @@ -19,32 +19,21 @@ % Reinhard Kotucha. \documentclass[a4paper,11pt]{article} -% \InputIfFileExists{vntexdoc-conf.tex}{}{} -% \makeatletter -% \@ifundefined{vntexdoc-amsldoc-vi} -% {\message{***undef***}} -% {\message{***def***}} -% \stop - -%%%%% TODO %%%%%%%%% -% -% Add last-modified date to the document -% -% Sadly, Eitan doesn't maintain tex4ht any more :( - \usepackage{amsmath,amsfonts,amssymb} \usepackage[utf8]{inputenc} \usepackage[T1,T2A,T5]{fontenc} -\usepackage[russian,vietnam]{babel} +%\usepackage[T1]{fontenc} +%\usepackage[T2A]{fontenc} +%\usepackage[T5]{fontenc} +\usepackage[russian,vietnamese]{babel} \usepackage{charter} -%\usepackage{tgpagella} -%\usepackage{mathpazo}\def\textsc#1{\bgroup\usefont{T5}{fpl}{m}{sc}#1\egroup} \usepackage{textcomp} \usepackage[scaled=.9]{helvet} \usepackage{parskip} \usepackage{upquote} \usepackage{microtype} \usepackage{url} +\usepackage{graphicx} % for XeTeX logo \usepackage{fancyvrb}\DefineShortVerb{\|} %\usepackage{showframe} %\usepackage{mparhack} @@ -62,7 +51,7 @@ \raggedbottom -\def\vi#1{\foreignlanguage{vietnam}{#1}} +%\def\vi#1{\foreignlanguage{vietnamese}{#1}} \makeatletter \let\ifundefined\@ifundefined @@ -105,7 +94,6 @@ \makeatother - %%% Colors \definecolor{labelitemicolor}{rgb}{0,.5,0} @@ -129,14 +117,19 @@ %\def\codecolor{\color[named]{OliveGreen}} \def\codecolor{\color[cmyk]{.65,0,.65,.7}} +%%%\def\codecolor{\color[cmyk]{.65,0,.65,.0}} + +\def\pkg#1{{\sffamily#1}} \def\marginnote#1{\marginpar{\headcolor{\textit{#1}}}} \def\marginnote#1{\vadjust{\llap{\smash{\headcolor{\textit{#1~~}}}}}} \def\marginnote#1{\leavevmode\llap{\headcolor{\textit{\smash{\parbox[t]{2.5cm}{\raggedleft #1}~~}}}}} + + + \def\mailto#1{$\langle$\href{mailto:#1}{\texttt{\hrefcolor{#1}}}$\rangle$} -\def\pkg#1{{\sffamily#1}} \def\URL#1{{\fontfamily{cmvtt}\selectfont{\xbibcolor{http://#1}}}} @@ -144,12 +137,16 @@ \def\http#1{\ifvmode\leavevmode\texttt{\phantom{xx}}\fi\href{http://#1}{\URL{#1}}} \def\ftp#1{\ifvmode\leavevmode\texttt{\phantom{xx}}\fi\href{ftp://#1}{\URL{#1}}} +\def\path#1{\texttt{#1}} +\def\file#1{\texttt{#1}} + %%% Internal/External Documentation \def\texmfdocvi{../../../../texmf-doc/doc/vietnamese} \def\CTANbase{ctan.org/tex-archive/info} \def\bibfile#1#2#3{\textit{#1, }\href{file:#2}{\bibcolor{#3}}} +\def\bibfilenoauthor#1#2{\href{file:#1}{\bibcolor{#2}}} \def\bibfileprint#1{\ifx\printversion\undefined\hspace{\fill}\href{file:#1}{[\bibcolor{print~version}]}\fi} \def\xbibfile#1#2#3{\textit{#1, }\href{http://#2}{\xbibcolor{#3}}} @@ -161,13 +158,13 @@ %%%\reversemarginpar -\makeatletter -\let\docpath\@namedef -%\InputIfFileExists{vntexdoc-conf.tex}{}{} +% \makeatletter +% \let\docpath\@namedef +% %\InputIfFileExists{vntexdoc-conf.tex}{}{} -\makeatletter -\let\docpath\@nameuse -\makeatother +% \makeatletter +% \let\docpath\@nameuse +% \makeatother %%% Verbatim @@ -192,21 +189,43 @@ \advance\textheight by 4cm \advance\textheight by 2pt +%%% From File: ltlogos.dtx +\makeatletter +\DeclareRobustCommand{\LaTeX}{L\kern-.26em% orig: -.36em + {\sbox\z@ T\vbox to\ht\z@{\hbox{\check@mathfonts + \fontsize\sf@size\z@\math@fontsfalse\selectfont{}A}\vss}}% + \kern-.07em% orig: -.15em + \TeX}\makeatother + +%%%\def\TeX{T\kern-.1667em\lower.5ex\hbox{E}\kern-.125emX\@} + +\makeatletter +\DeclareRobustCommand{\XeTeX}{X\kern-.125em + \lower.5ex\hbox{\reflectbox{E}}\kern-.1667em\TeX}\makeatother + +\def\releasenotes{ + \parskip 0pt + \def\version[##1]##2##3{\par\normalfont\normalsize + \textcolor[named]{BrickRed}{Version~\textbf{##2}} --- released ##3 + ##1\par\penalty10000\small}} + \edef\YR{\number\year} \edef\MO{\ifnum\month<10 0\fi\number\month} \edef\DY{\ifnum\day<10 0\fi\number\day} -\usepackage[colorlinks, urlcolor=black, filecolor=black, -pdftitle={VnTeX - Typesetting Vietnamese (Revision \YR/\MO/\DY)}, -pdfauthor={Han The Thanh and Reinhard Kotucha}, -pdfsubject={VnTeX User Manual}, -pdfkeywords={VnTeX, typesetting Vietnamese, Vietnamese fonts, - encodings, LaTeX macro packages}]{hyperref} +\usepackage[unicode, colorlinks, urlcolor=black, filecolor=black, +pdfdisplaydoctitle=true]{hyperref} + +% we need \hypersetup if we are using unicode +\hypersetup{pdftitle={VnTeX - Typesetting Vietnamese (Revision \YR/\MO/\DY)}} +\hypersetup{pdfsubject={VnTeX User Manual}} +\hypersetup{pdfauthor={Hàn Thế Thành and Reinhard Kotucha}} +\hypersetup{pdfkeywords={VnTeX, typesetting Vietnamese, Vietnamese fonts, + encodings, LaTeX macro packages}} \hypersetup{pdfnewwindow=true} + \begin{document} -%\vrule -%\vspace*{0cm} \leavevmode{\centering\Huge\textbf{\headcolor{Vn\TeX\ --- Typesetting Vietnamese}}\par} \vspace{3mm} @@ -214,7 +233,7 @@ pdfkeywords={VnTeX, typesetting Vietnamese, Vietnamese fonts, \vspace{1cm} \begin{abstract} -\parskip=1ex \parindent=0pt \noindent +\vspace*{-1ex}\parskip=1ex \parindent=0pt \noindent Vn\TeX\ is an extension to Donald Knuth's \TeX\ typesetting system which provides support for typesetting Vietnamese. @@ -230,10 +249,14 @@ The current maintainers of Vn\TeX\ are: \end{itemize} There is a mailing list (very low traffic) for questions about -Vn\TeX\ and typesetting Vietnamese. To subscribe to the list, visit +Vn\TeX\ and typesetting Vietnamese. To subscribe to the list, visit: \http{lists.sourceforge.net/lists/listinfo/vntex-users} +There is also a Wiki: + +\http{vntex.info} + \section{Related Documents} The following files are part of the Vn\TeX\ distribution\ifx\printversion\undefined\footnote{The print versions @@ -278,16 +301,16 @@ The following files are not part of Vn\TeX\ but might be part of the \begin{itemize} \item \textit{The American Mathematical Society}, Hướng dẫn sử dụng gói \pkg{amsmath},\\ - \URL{\CTANbase/amslatex/vietnamese/amsldoc-vi.pdf}\\ - \URL{\CTANbase/amslatex/vietnamese/amsldoc-print-vi.pdf} + \http{\CTANbase/amslatex/vietnamese/amsldoc-vi.pdf}\\ + \http{\CTANbase/amslatex/vietnamese/amsldoc-print-vi.pdf} \item \textit{H.~Partl, E.~Schlegl, I.~Hyna, T.~Oetiker}, Một tài liệu ngắn gọn giới thiệu về \LaTeXe, Translated by Nguyễn Tân Khoa.\\ - \URL{\CTANbase/lshort/vietnamese/lshort-vi.pdf} + \http{\CTANbase/lshort/vietnamese/lshort-vi.pdf} \item \textit{Wolfgang May, Andreas Schlechte}, Mở rộng môi trường định lý. Translated by Huỳnh Kỳ Anh.\\ - \URL{\CTANbase/translations/vn/ntheorem-doc-vn.pdf} + \http{\CTANbase/translations/vn/ntheorem-doc-vn.pdf} \end{itemize} @@ -295,7 +318,7 @@ The following files are not part of Vn\TeX\ but might be part of the In order to typeset Vietnamese, you need a text editor which supports Vietnamese. In particular, it should support an \emph{input encoding} -an an \emph{input method} suitable for Vietnamese. +and an \emph{input method} suitable for Vietnamese. If you are not familiar with encodings, here is a brief explanation: Each key on your keyboard is assigned to a letter. Computers don't @@ -313,8 +336,8 @@ Hindi,\ldots characters in one and the same file. UTF-8 is the encoding system of the future and it becomes even more popular in Vietnam. -Vn\TeX\ supports many input encodings such as VISCII, TCVN, or UTF-8, but -there is no support for VNI (nor will there ever be). +Vn\TeX\ supports many input encodings such as VISCII, TCVN, or UTF-8, +but there is no support for VNI (nor will there ever be). You can use the input encoding of your choice, but you have tell \TeX\ which one you are using. How to do this is decribed below. @@ -345,8 +368,8 @@ see ``\texttt{H\`a N\d\ocircumflex i}'' on screen and you get ``H\`a N\d\ocircumflex i'' in your typeset document. However, input methods are quite system dependent. If your operating -system doesn't support anything appropriate, check -whether your editor or \TeX\ shell supports them. +system doesn't support anything appropriate, check whether your editor +or \TeX\ shell supports them. \marginnote{editors}It's not easy to propose a particular editor. If you are using a reasonably powerful editor for writing your own @@ -361,6 +384,8 @@ On Windows there are some alternatives, like \xbibfilenoauthor{projectory.de/texshell}{\pkg{\TeX{}shell}}, \xbibfilenoauthor{www.winedt.com}{\pkg{WinEDT}}, and \xbibfilenoauthor{www.texniccenter.org}{\pkg{\TeX{}nicCenter}}. +\xbibfilenoauthor{www.texniccenter.org}{\pkg{\TeX{}nicCenter}} +supports UTF-8 as of version 2.0. If you are on Mac\,OS\,X, \xbibfilenoauthor{www.uoregon.edu/~koch/texshop}{\pkg{\TeX{}shop}} is @@ -370,13 +395,11 @@ you click on a particular word in the PDF file, the cursor moves to this word in the text editor, and vice versa. \xbibfilenoauthor{tug.org/texworks}{\pkg{\TeX{}works}} is something very similar. But it is supposed to work on all operating -systems and will probably be the default editor in \TeX~Live and -Mik\TeX. +systems and is shipped with \TeX~Live and Mik\TeX. - -There are some different flavours of -\TeX, such as Plain \TeX, \LaTeX, and Context. \LaTeX\ is the most -popular one and there are many books available about it. +There are some different flavours of \TeX, such as Plain \TeX, \LaTeX, +and Context. \LaTeX\ is the most popular one and there are many books +available about it. \subsection{Typesetting with \LaTeX} @@ -428,7 +451,6 @@ Examples: %\par\kern -2pt % avoid and unpleasant page break \end{document} \end{Code} - Both packages, \pkg{vietnam} and \pkg{vntex}, have the following additional options: @@ -451,7 +473,6 @@ The \pkg{cmap} packages makes the PDF file searchable. \subsubsection{Using \pkg{babel} instead of \pkg{vietnam}/\pkg{vntex}} - For multilingual documents it's better to use the \pkg{babel} package, which is part of the \LaTeX\ core. Though the \pkg{inputenc} package allows you to select the input encoding of your choice, UTF-8 is the @@ -461,13 +482,13 @@ preferred encoding for multilingual documents. \documentclass{report} \usepackage[T2A,T5]{fontenc} \usepackage[utf8]{inputenc} - \usepackage[russian,vietnam]{babel} + \usepackage[russian,vietnamese]{babel} \begin{document} Tiếng Việt, \selectlanguage{russian}% |selectlanguage(russian)русский язык, - \selectlanguage{vietnam}% - |selectlanguage(vietnam)tiếng Việt. + \selectlanguage{vietnamese}% + |selectlanguage(vietnamese)tiếng Việt. \end{document} \end{Code} @@ -480,9 +501,19 @@ The result of the example above is:~~ Tiếng Việt, \selectlanguage{russian}% русский язык, - \selectlanguage{vietnam}% + \selectlanguage{vietnamese}% tiếng Việt.}} +\subsubsection{Using \pkg{hyperref}} +In order to use Vietnamese characters in the bookmark panel or in the +``Document Properties'' box, \pkg{hyperref} must be loaded with the +{\code|unicode|} option. + +\begin{Code} + \usepackage[unicode]{hyperref} + \hypersetup{pdftitle={VnTeX – hỗ trợ tiếng Việt cho TeX}} +\end{Code} + \subsubsection{Using \pkg{TCX} files} \TeX\ itself can't use non-ASCII characters when writing error messages to screen or to the log file. Instead, it prints non-ASCII @@ -492,18 +523,22 @@ table is loaded, and all files \TeX\ reads are translated before they are processed. If you are using \pkg{TCX}, you can't use the \pkg{inputenc} package because the translation can be done only once. -\pkg{TCX} and \pkg{inputenc} are more or less equivalent. The -advantage of \pkg{TCX} is that you get Vietnamese characters in -messages about overfull/underfull boxes and the like. The main -drawback is that it doesn't support UTF-8. +If you are using an engine which supports UTF-8 natively, like \XeTeX\ +or Lua\TeX\, you can't use \pkg{TCX} (and you don't need to). -Vn\TeX\ provides two \pkg{TCX} tables, {\code|viscii-t5|} -and {\code|tcvn-t5|}. Here is an example: +% \pkg{TCX} and \pkg{inputenc} are more or less equivalent. The +% advantage of \pkg{TCX} is that you get Vietnamese characters in +% messages about overfull/underfull boxes and the like. The main +% drawback is that it doesn't support UTF-8. On the other hand, \XeTeX\ +% and Lua\TeX\ support UTF-8 natively but not \pkg{TCX}. + +Vn\TeX\ provides two \pkg{TCX} tables, {\code|viscii-t5|} and +{\code|tcvn-t5|}. Here is an example: \begin{Code} %& -translate-file=viscii-t5 \documentclass{report} - \usepackage[noinputenc]{vietnam} + \usepackage[noinputenc]{vntex} \begin{document} |sometext(text in VISCII encoding) \end{document} @@ -521,7 +556,7 @@ on the command line. Using TCVN is similar. \subsubsection{Creating HTML from \LaTeX\ sources} -In order to create HTML documents from La\TeX\ sources, run +In order to create HTML documents from \LaTeX\ sources, run {\code|tex4ht "html,uni-html4,charset=utf8"|} \textit{yourfile.tex} @@ -553,10 +588,10 @@ TeX yet. distribution any more but it is very likely that they are part of the \TeX\ system you are using. -If you have a version of \pkg{plnfss}\ which doesn't already support -Vietnamese, please install +%If you have a version of \pkg{plnfss}\ which doesn't already support +%Vietnamese, please install -\http{vntex.sf.net/download/vntex-support/plnfss.zip} +%\http{vntex.sf.net/download/vntex-support/plnfss.zip} \subsubsection{Using \pkg{TCX}} @@ -592,50 +627,78 @@ Vn\TeX\ provides a lot of Vietnamese fonts. If you are using {\code|T5|} font encoding but do not specify any font (as in the examples above) you get \pkg{Vietnamese Computer Modern}. These VNR fonts are extensions to Donald Knuth's \pkg{Computern Modern Fonts} -and have been designed by Hàn Thế Thành. +and were designed by Hàn Thế Thành. + +\subsection{Acquiring Vietnamese Fonts} + +\subsubsection{Fonts provided by Vn\TeX} -\marginnote{nonfree fonts}Vn\TeX\ provides Vietnamese versions of free -fonts donated by Adobe, URW, and Bitstream. Some of the URW fonts can -be used freely but they can't be distributed if money is charged for -the distribution. These fonts are not part of the Vn\TeX\ core -distribution because otherwise Vn\TeX\ can't be in \pkg{TeX Live} or -in Linux distributions. There is an extra package containing these -fonts: +The following fonts are part of Vn\TeX. Vietnamese Glyphs were added +by Hàn Thế Thành. +\begin{itemize} +\item Arev (a version of Bitstream Vera Sans) +\item Bitstream Charter +\item Computer Modern +\item Computer Modern Bright +\item Concrete +\item txtt +\item URW Grotesk +\item urwvn (URW version of Adobe's LaserWriter fonts) +\item Vntopia (based on Adobe Utopia) +\end{itemize} + +\subsubsection{Vn\TeX\ nonfree Fonts} +%\marginnote{nonfree fonts}Vn\TeX\ provides Vietnamese versions of free +%fonts donated by Adobe, URW, and Bitstream. + +Some of the fonts donated by URW can be used freely but they can't be +distributed if money is charged for the distribution. These fonts are +not part of the Vn\TeX\ core distribution because otherwise Vn\TeX\ +can't be in \pkg{TeX Live} or in Linux distributions. + +These fonts are: +\begin{itemize} +\item URW Classico (URW version of Hermann Zapf's Optima) +\item URW Garamond +\end{itemize} + +There is an extra package containing these fonts: \indenturl\http{vntex.sourceforge.net/download/vntex/vntex-nonfree.zip}\\ -\indenturl\http{vntex.sourceforge.net/download/vntex/vntex-nonfree.tar.bz2} +\indenturl\http{vntex.sourceforge.net/download/vntex/vntex-nonfree.tar.xz} + +If you are using \pkg{TeX Live}, you can download and execute +\pkg{install-getnonfreefonts} from -If you are using \pkg{TeX Live}, intallation is very simple. Just run +\indenturl\http{tug.org/fonts/getnonfreefonts} -{\code|getnonfreefonts --help|} +and run {\code|getnonfreefonts --help|} on the command line for more +information. -on the command line in order to get more information. +\subsubsection{Microsoft Core Fonts} -\marginnote{\pkg{Latin Modern} and \pkg{\TeX Gyre}}There are many other - fonts supporting Vietnamese which are not shipped with Vn\TeX\ - because they are an integral part of any modern \TeX\ distribution - anyway. Some quite interesting fonts are the \pkg{Latin Modern} and - \pkg{\TeX\ Gyre} fonts created by Bogus\l{}aw Jackowski and Janusz - M. Nowacki. They fully support Vietnamese but their main advantage - is that they support virtually all Latin scripts used today. Thus, - they are well suited for multilingual documents. +Support for Microsoft's \emph{Web Fonts} was removed from Vn\TeX\ +because the actual fonts cannot be provided for legal reasons. Please +consult the \href{http://vntex.sf.net}{\xbibcolor{Vn\TeX\ homepage}} +for more information. - \marginnote{MS core fonts}The Microsoft core fonts are supported - too. Vn\TeX\ only provides the additional files needed to make them - accessible to \TeX, but not the fonts themselves. If you are on - Windows, they are available already. +\subsubsection{Other Fonts supporting Vietnamese} -If you are on Unix, you have to install them yourself. -\http{sourceforge.net/project/showfiles.php?group\_id=34153} +There are many other fonts supporting Vietnamese which are not shipped +with Vn\TeX\ because they are an integral part of any modern \TeX\ +distribution anyway. -Though the quality of the original fonts was quite good, the -Vietnamese accents were added later, and obviously not by -the guys who designed the fonts. The only exception is \pkg{Palatino - Linotype}. Inspect the fonts carefully before you decide which one -you want to use. +\newpage -\marginnote{font samples}There are sample files for all fonts which +% \marginnote{\pkg{Latin Modern} and \pkg{\TeX Gyre}} Some quite +% interesting fonts are the \pkg{Latin Modern} and \pkg{\TeX\ Gyre} +% fonts created by Bogus\l{}aw Jackowski and Janusz M. Nowacki. They +% fully support Vietnamese but their main advantage is that they support +% virtually all Latin scripts used today. Thus, they are well suited +% for multilingual documents. + +\marginnote{font samples}There are sample files of all fonts which support Vietnamese, can be used with \TeX, and can be used freely, even commercially. However, some of them can't be distributed if you charge money for the distribution. @@ -645,26 +708,35 @@ charge money for the distribution. Not every font supports maths. If you have to typeset math formulas, consult: - \http{ctan.org/tex-archive/info/Free\_Math\_Font\_Survey/vn/survey-vn.pdf} +\http{ctan.org/tex-archive/info/Free\_Math\_Font\_Survey/vn/survey-vn.pdf} + -\subsection{Selecting Fonts in \LaTeX} +\subsection{Font Selection} We describe how to use fonts with \LaTeX\ first. A description of \pkg{plnfss} (plain TeX) is given below. +\subsubsection{Selecting Fonts in \LaTeX} +Some fonts provide a \LaTeX\ macropackage which loads the necessary +fonts. + To use Latin Modern instead of VNR, simply \begin{Code} \usepackage{lmodern} - \usepackage[viscii]{vietnam} + \usepackage{vntex} \end{Code} For Antikwa Toru\'nska, do \begin{Code} \usepackage{anttor} - \usepackage[viscii]{vietnam} + \usepackage{vntex} \end{Code} -\ldots or use \pkg{inputenc} and \pkg{babel} instead of \pkg{vietnam}. +\ldots or use \pkg{inputenc} and \pkg{babel} instead of \pkg{vietnam} +or \pkg{vntex}. + +Some font packages do not provide such a \LaTeX\ macro package. An +example is \pkg{urwvn}. 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. @@ -699,9 +771,9 @@ You can use it like this: \sometext{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. +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. \marginnote{math fonts}If you have to typeset math formulas, be aware that not all fonts support math. The following fonts support math @@ -717,7 +789,8 @@ very well: There are many others too, please consult: - \http{ctan.org/tex-archive/info/Free\_Math\_Font\_Survey/vn/survey-vn.pdf} +% \http{ctan.org/tex-archive/info/Free\_Math\_Font\_Survey/vn/survey-vn.pdf} + \http{vntex.sf.net/fonts/samples/survey-vn.pdf} However, some of the fonts borrow math symbols from other fonts and it's worthwhile to check whether all the symbols you need blend well @@ -728,8 +801,7 @@ There are many others too, please consult: one is a lowercase ``\texttt{L}'', the second one is an uppercase ``\texttt{i}''. - -\clearpage +%\clearpage \marginnote{MS core fonts}If you are using Windows, you also can use the fonts provided by Microsoft: @@ -746,7 +818,7 @@ Command & PostScript Name & Font Family Name 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: +Vietnamese accents (except in \emph{Palatino Linotype}). See: \http{vntex.sf.net/fonts/samples} @@ -759,17 +831,18 @@ Unless someone insists that you use these fonts, you can use |VnURWPalladioL| & instead of |PalatinoLinotype| & Palatino\\\hline \end{tabular} +\subsubsection{Selecting Fonts in plain \TeX} If you are using plain \TeX, you can use \pkg{plnfss.tex} to select fonts. -Instead of -\begin{Code} - \renewcommand\rmdefault{...} - \renewcommand\sfdefault{...} - \renewcommand\ttdefault{...} -\end{Code} +% Instead of +% \begin{Code} +% \renewcommand\rmdefault{...} +% \renewcommand\sfdefault{...} +% \renewcommand\ttdefault{...} +% \end{Code} -you have to select fonts like this: +% you have to select fonts like this: \begin{Code} \setrmdefault{...} \setsfdefault{...} @@ -791,28 +864,27 @@ all other files are under LPPL, version 1.3 or newer. \item \http{www.latex-project.org/lppl.txt} \item \http{tug.org/fonts/utopia/LICENSE-utopia.txt} \end{itemize} -\clearpage +%\clearpage -\section{Contributors} - -\LaTeX\ support (input encoding files, font encoding files, babel support -and vietnam.sty) had been provided by Werner Lemberg. \pkg{vntex.sty} -had been proposed by Huỳnh Kỳ Anh. -Vietnamese fonts for \pkg{tex4ht} had originally been provided by Hàn -Thế Thành, but they are now maintained by Eitan Gurari. +\section{Contributors} +The author of Vn\TeX\ is Hàn Thế Thành. Current maintainers are +Reinhard Kotucha and Werner Lemberg. -\pkg{plnfss} had been removed from Vn\TeX\ because it supports many other -languages as well. You can download it from +\LaTeX\ support (input encoding files, font encoding files, +\pkg{babel} support files and vietnam.sty) were provided by Werner +Lemberg. \pkg{vntex.sty} was proposed by Huỳnh Kỳ Anh. - \http{ctan.tug.org/tex-archive/macros/plain/plnfss} +Vietnamese fonts for \pkg{tex4ht} originally were provided by Hàn +Thế Thành, but they are now part of the \pkg{tex4ht} distribution. +\pkg{plnfss} was written by Hàn Thế Thành and Michal Konečný. It was +removed from Vn\TeX\ because it supports many other languages as well. \section{Known Problems} - \begin{itemize} -\item In order to use \pkg{amsart.cls} (and other AMS La\TeX\ document +\item In order to use \pkg{amsart.cls} (and other AMS \LaTeX\ document classes) with Unicode you must add the following lines immediately before {\code|\begin{document}|}: \begin{Code} @@ -820,44 +892,61 @@ languages as well. You can download it from \let\uppercase\firstofone \let\MakeUppercase\firstofone \end{Code} +\end{itemize} 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. -\item In order to use Vn\TeX\ with \pkg{Prosper}, you have to install - - \http{vntex.sf.net/download/vntex-support/prosper-vn.zip} - - \item In order to use Vn\TeX\ with Foil\TeX, you have to install - - \http{vntex.sf.net/download/vntex-support/foiltex-vn.zip} +\ifx\printversion\undefined +\section{Release Notes} + The Vn\TeX\ history is \bibfilenoauthor{ReleaseNotes.pdf}{here}. +\fi - \item If you have an old version of \LaTeX\ which does not support - UTF-8, you have to use \pkg{ucs.sty}. If \pkg{ucs.sty} is not - present on your system you can install - \http{vntex.sf.net/download/vntex-support/ucs-vn.zip} +\end{document} - We will keep this file as long as \pkg{ucs} is unmaintained. If - a maintainer is found you should download a fresh \pkg{ucs} - distribution from the original site. +% \item In order to use Vn\TeX\ with \pkg{prosper}, you have to install + +% \http{vntex.sf.net/download/vntex-support/prosper-vn.zip} - This is a small subset of the \pkg{ucs} package which supports - Vietnamese only. You can invoke it with - {\code|\usepackage[utf8x]{inputenc}|}. +% \item In order to use Vn\TeX\ with \pkg{prosper}, put the lines +% \begin{verbatim} +% \usepackage[T1,T5]{fontenc} +% \def\usefont#1#2#3#4{% +% \fontfamily{#2}\fontseries{#3}\fontshape{#4}\selectfont} +% \end{verbatim} +% into the preamble before you laod \pkg{prosper}. Or better use +% \pkg{beamer} instead. - Instead of installing ucs we recommend you update \LaTeX. The - latest version can be downloaded from + +% \item In order to use Vn\TeX\ with Foil\TeX, you have to install - \begin{itemize} - \item \leavevmode\http{www.dante.de/tex-archive/macros/latex/base.zip} (Germany) - \item \leavevmode\http{www.tex.ac.uk/tex-archive/macros/latex/base.zip} (UK) - \item \leavevmode\http{tug.ctan.org/tex-archive/macros/latex/base.zip} (USA) - \end{itemize} -\end{itemize} +% \http{vntex.sf.net/download/vntex-support/foiltex-vn.zip} + +% \item If you have an old version of \LaTeX\ which does not support +% UTF-8, you have to use \pkg{ucs.sty}. If \pkg{ucs.sty} is not +% present on your system you can install + +% \http{vntex.sf.net/download/vntex-support/ucs-vn.zip} + +% We will keep this file as long as \pkg{ucs} is unmaintained. If +% a maintainer is found you should download a fresh \pkg{ucs} +% distribution from the original site. + +% This is a small subset of the \pkg{ucs} package which supports +% Vietnamese only. You can invoke it with +% {\code|\usepackage[utf8x]{inputenc}|}. + +% Instead of installing ucs we recommend you update \LaTeX. The +% latest version can be downloaded from + +% \begin{itemize} +% \item \leavevmode\http{www.dante.de/tex-archive/macros/latex/base.zip} (Germany) +% \item \leavevmode\http{www.tex.ac.uk/tex-archive/macros/latex/base.zip} (UK) +% \item \leavevmode\http{tug.ctan.org/tex-archive/macros/latex/base.zip} (USA) +% \end{itemize} -\end{document} __ Everything below the line above is ignored. @@ -867,3 +956,18 @@ End: %%% initemxf --edit-config-file updmap + +% \marginnote{MS core fonts}The Microsoft core fonts are supported too. +% Vn\TeX\ only provides the additional files needed to make them +% accessible to \TeX, but not the fonts themselves. If you are on +% Windows, they are available already. + +% If you are on Unix, you have to install them yourself. + +% \http{sourceforge.net/project/showfiles.php?group\_id=34153} + +% Though the quality of the original fonts was quite good, the +% Vietnamese accents were added later, and obviously not by +% the guys who designed the fonts. The only exception is \pkg{Palatino +% Linotype}. Inspect the fonts carefully before you decide which one +% you want to use. |