diff options
Diffstat (limited to 'Master/texmf-dist/source/generic/vntex/doc')
10 files changed, 2550 insertions, 0 deletions
diff --git a/Master/texmf-dist/source/generic/vntex/doc/abbr.tex b/Master/texmf-dist/source/generic/vntex/doc/abbr.tex new file mode 100644 index 00000000000..84617cf0935 --- /dev/null +++ b/Master/texmf-dist/source/generic/vntex/doc/abbr.tex @@ -0,0 +1,268 @@ +\ifx\abbrloaded\relax + \let\next=\endinput +\else + \let\next=\relax +\fi + +\next + +\let\abbrloaded=y + +\def\<#1>{% + \expandafter\ifx\csname<#1>\endcsname\relax + \errmessage{abbreviation <#1> undefined!}% + \else + \csname<#1>\endcsname + \fi +} + +\def\abbrA#1#2#3{% + \expandafter\def\csname<#1>\endcsname{#2}% +} + +\def\abbrB#1#2#3{% + \def\abbrdef{#3}% + \ifx\abbrdef\empty + \expandafter\def\csname<#1>\endcsname{#2}% + \else + \expandafter\def\csname<#1>\endcsname{#3}% + \fi +} + +\ifx\HCode\undefined % tex4ht is not being used + \let\abbr=\abbrA +\else + \let\abbr=\abbrB +\fi + +\abbr{.}{.\,}{} +\abbr{3B2}{3B2}{} +\abbr{A2AC}{\texttt{a2ac}}{} +\abbr{ADOBE}{Adobe}{} +\abbr{AFM}{AFM}{} +\abbr{AFM}{AFM}{} +\abbr{AMIGA}{Amiga}{} +\abbr{AND}{\char038\relax}{&} +\abbr{APACHE}{Apache}{} +\abbr{AR}{Acrobat Reader}{} +\abbr{ASCII}{ASCII}{} +\abbr{BASH}{Bash}{} +\abbr{BLUESKY}{BlueSky}{} +\abbr{BS}{\char92}{} +\abbr{bull}{$\bullet$}{} +\abbr{C}{C}{} +\abbr{CMACTEX}{CMac\TeX}{CMacTeX} +\abbr{CM}{Computer Modern}{} +\abbr{CMR}{CMR}{} +\abbr{CMSS}{CMSS}{} +\abbr{CMSUPER}{CM-Super}{} +\abbr{CPP}{C++}{} +\abbr{CS}{CS}{} +\abbr{DANTE}{DANTE}{} +\abbr{DEBIAN}{Debian}{} +\abbr{DHSP}{ÐHSP}{} +\abbr{DJBDNS}{\textsf{djbdns}}{} +\abbr{DJGPP}{DJGPP}{} +\abbr{DNSCACHE}{\textsf{dnscache}}{} +\abbr{DOS}{DOS}{} +\abbr{DOTNET}{Visual~.NET}{} +\abbr{...}{\dots}{} +\abbr{DTP}{DTP}{} +\abbr{DVI}{DVI}{} +\abbr{DVIPDFM}{\textsf{dvipdfm}}{} +\abbr{DVIPDFMX}{\textsf{dvipdfmx}}{} +\abbr{DVIPS}{\textsf{dvips}}{} +\abbr{EC}{EC}{} +\abbr{EK}{\textit{{\Large$\varepsilon$\kern-.1em}k}}{} +\abbr{ELIB}{eLib}{} +\abbr{EMACS}{Emacs}{} +\abbr{EMAIL}{Email}{} +\abbr{EOF}{EOF}{} +\abbr{ET5}{ET5}{} +% \abbr{ETEX}{$\varepsilon$-\TeX}{eTeX} +\abbr{ETEX}{e\TeX}{eTeX} +\abbr{EUROTEX}{Euro\TeX}{EuroTeX} +\abbr{FLOITEX}{Floi\TeX}{} +\abbr{FMP}{FMP}{} +\abbr{FONTINST}{\texttt{fontinst}}{} +\abbr{FONTLAB}{FontLab}{} +\abbr{FPTEX}{fp\TeX}{} +\abbr{FTP}{Ftp}{} +\abbr{GCC}{GCC}{} +\abbr{GOOGLE}{Google}{} +\abbr{GS}{\textsf{ghostscript}}{} +\abbr{GUST}{GUST}{} +\abbr{GUT}{GUTenberg}{} +\abbr{GVSBK}{GVSBK}{} +\abbr{HCMUP}{HCMUP}{} +\abbr{HJ}{H\kern.1em<AND>\kern.1emJ}{} +\abbr{HREF}{hyperref}{} +\abbr{HSQL}{HSQL}{} +\abbr{HTML}{HTML}{} +\abbr{HZ}{\textit{hz}}{} +\abbr{ID}{InDesign}{} +\abbr{IIS}{IIS}{} +\abbr{INTERNET}{Internet}{} +\abbr{JAVA}{Java}{} +\abbr{JP}{\textit{jp}}{} +\abbr{KF}{\textit{kf\kern-.05em}}{} +\abbr{KR}{\textit{K$\varrho$}}{} +\abbr{LATEX}{\LaTeX}{LaTeX} +\abbr{LDAP}{LDAP}{} +\abbr{LF}{\textrm{\it letter\!\_\kern.1emfit}}{} +\abbr{LIBPNG}{LIBPNG}{} +\abbr{LIBTIFF}{LIBTIFF}{} +\abbr{LINUX}{Linux}{} +\abbr{LISP}{LISP}{} +\abbr{LM}{LM}{LM} +\abbr{M2}{\,m$^2$}{} +\abbr{MAC}{Macintosh}{} +\abbr{MF}{\MF}{} +\abbr{MG}{MetaFog}{} +\abbr{MIKTEX}{Mik\TeX}{MikTeX} +\abbr{MIRKA}{Miroslava Mis\'akov\'a}{} +\abbr{MMINSTANCE}{MMInstance}{} +\abbr{MM}{Multiple Master}{} +\abbr{MMTOOLS}{MMTOOLS}{} +\abbr{MP}{\MP}{} +\abbr{MVISCII}{Mac VISCII}{} +\abbr{MYSQL}{MySQL}{} +\abbr{NL}{\hfil\break}{} +\abbr{NTG}{NTG}{} +\abbr{NTS}{NTS}{} +\abbr{OMEGA}{$\Omega$}{} +\abbr{OPENTYPE}{OpenType}{} +\abbr{PASCAL}{Pascal}{} +\abbr{PDFETEX}{pdf\<ETEX>}{pdfeTeX} +\abbr{PDF}{PDF}{} +\abbr{PDFTEX}{pdf\TeX}{pdfTeX} +\abbr{PDFLATEX}{pdf\LaTeX}{pdfLaTeX} +\abbr{PDFXTEX}{pdfx\kern-.1em\TeX}{pdfxTeX} +\abbr{CONTEXT}{Con\TeX{}t}{ConTeXt} +\abbr{PERCENT}{\unskip\,\%}{} +\abbr{PERL}{Perl}{} +\abbr{PFA}{PFA}{} +\abbr{PFB}{PFB}{} +\abbr{PHP}{PHP}{} +\abbr{PK}{PK}{} +\abbr{PLAIN}{plain \TeX}{plain TeX} +\abbr{POSTGRESQL}{PostgreSQL}{} +\abbr{PROSPER}{Prosper}{} +\abbr{PS}{PS}{} +\abbr{RA}{$\longrightarrow$}{-->} +\abbr{RESIN}{Resin}{} +\abbr{SGML}{SGML}{} +\abbr{SP}{\hskip1cm}{} +\abbr{STL}{STL}{} +\abbr{T1}{Type\nobreak\,1}{Type1} +\abbr{T3}{Type\nobreak\,3}{} +\abbr{T5}{T5}{} +\abbr{TCVN}{TCVN1}{} +\abbr{TCX}{TCX}{} +\abbr{TETEX}{\textsf{te\TeX}}{teTeX} +\abbr{TEX4HT}{\TeX{}4ht}{TeX4ht} +\abbr{TEXINFO}{\texttt{texinfo}}{} +\abbr{TEXLIVE}{\TeX{}Live}{TeXLive} +\abbr{TEXME}{\TeX{}Me}{TeXMe} +\abbr{TEXMF}{\textsf{texmf}}{} +\abbr{TEXNICCENTER}{TeXnicCenter}{} +\abbr{TEX}{\TeX}{TeX} +\abbr{TEXTRACE}{\TeX{}trace}{TeXtrace} +\abbr{TFM}{TFM}{} +\abbr{TFTOPL}{TFtoPL}{} +% \abbr{THANH}{H\`an Th\^e\llap{\raise 0.5ex\hbox{\'{}}} Th\`anh}{Han The Thanh} +% \abbr{THANH}{H\`an Th\^e\llap{\raise 0.5ex\hbox{\'{}}} Th\`anh}{} +\abbr{THANH}{H\`an Th\'\ecircumflex{} Th\`anh}{} +\abbr{TINYDNS}{\textsf{tinydns}}{} +\abbr{TOMCAT}{Tomcat}{} +\abbr{TPHCM}{Tp.\,HCM}{} +\abbr{TRUETYPE}{True\kern-.1em Type}{TrueType} +\abbr{TUG}{TUG}{} +\abbr{UNICODE}{Unicode}{} +\abbr{UNIKEY}{Unikey}{} +\abbr{UNIX}{UNIX}{} +\abbr{UPORTAL}{uPortal}{} +\abbr{URW}{URW}{} +\abbr{URWVN}{URWVN}{} +\abbr{UTF8}{UTF8}{} +\abbr{VB}{Visual Basic}{} +\abbr{VC6}{Visual~C++~6.0}{} +\abbr{VIETLUG}{VietLUG}{} +\abbr{VIM}{Vim}{} +\abbr{VIM}{Vim}{} +\abbr{VISCII}{VISCII}{} +\abbr{VI}{Vi}{} +\abbr{VNCMR}{\textsf{vncmr}}{} +\abbr{VNI}{VNI}{} +\abbr{VNR}{VNR}{} +\abbr{VNTEX}{V\kern-.1em n\TeX}{VnTeX} +\abbr{VPS}{VPS}{} +\abbr{WC}{Windows Commander}{} +\abbr{WEB}{Web}{} +\abbr{WIN32}{Win32}{} +\abbr{WINDOWS}{Windows}{} +\abbr{WINEDT}{WinEdt}{} +\abbr{WWW}{WWW}{} +\abbr{XEMACS}{XEmacs}{} +\abbr{XEMTEX}{Xem\TeX}{XemTeX} +\abbr{XML}{XML}{} +\abbr{XPDF}{XPDF}{} +\abbr{YANDY}{Y<AND>Y}{} +\abbr{ZLIB}{ZLIB}{} +\abbr{EMAIL}{Email}{} +\abbr{WEBSITE}{Website}{} +\abbr{ASP}{ASP}{} +\abbr{FRONTPAGE}{FrontPage}{} +\abbr{DRW}{DreamWeaver}{} +\abbr{ABC}{ABC}{} +\abbr{VNI}{VNI}{} +\abbr{CTAN}{CTAN}{} +\abbr{PDFCPROT}{\textsf{pdfcprot}}{} +\abbr{PDFEXPAND}{\textsf{pdfexpand}}{} +\abbr{MICROTYPE}{\textsf{microtype}}{} +\abbr{PDFFONTS}{\textsf{pdffonts}}{} +\abbr{AFM2TFM}{\textsf{afm2tfm}}{} +\abbr{VF}{VF}{} +\abbr{TUGBOAT}{TUGboat}{} +\abbr{PSTRICKS}{\textsf{PStricks}}{} +\abbr{WEB2C}{\textsf{web2c}}{} +\abbr{IE}{i.\,e.\,\ignorespaces}{} +\abbr{ie}{i.\,e.\,\ignorespaces}{} +\abbr{GNU}{GNU}{} +\abbr{LIBAVL}{\textsf{libAVL}}{} +\abbr{TTF2AFM}{\textsf{ttf2afm}}{} +\abbr{PDFSYNC}{\textsf{pdfsync}}{} +\abbr{CFF}{CFF}{} +\abbr{GNOME}{GNOME}{} +\abbr{SGLUG}{SaigonLUG}{} +\abbr{SAIGON}{Sài Gòn}{} +\abbr{SQL}{SQL}{} +\abbr{RVT}{RVT}{} +\abbr{XML2PDF}{XML2PDF}{} +\abbr{GUI}{GUI}{} +\abbr{NFSS}{NFSS}{} +\abbr{VNOSS}{VnOSS}{} +\abbr{GPL}{GPL}{} +\abbr{LPPL}{LPPL}{} +\abbr{AFPL}{AFPL}{} +\abbr{X11}{X11}{} +\abbr{XETEX}{Xe\TeX}{} +\abbr{EXTEX}{Ex\TeX}{} +\abbr{LUATEX}{Lua\TeX}{} +\abbr{XDVI}{XDvi}{} +\abbr{YAP}{Yap}{} +\abbr{DVIPSONE}{DVIPSONE}{} +\abbr{PLNFSS}{PLNFSS}{} +\abbr{MSWORD}{MS~Word}{} +\abbr{OOWRITER}{OpenOffice~Writer}{} +\abbr{THAIHOA}{Th\'ai Ph\'u Kh\'anh H\`oa}{} +\abbr{TEXMAKER}{TeXMaker}{} +\abbr{WINSHELL}{WinShell}{} +\abbr{XUNIKEY}{XUniKey}{} +\abbr{XVNKB}{Xvnkb}{} +\abbr{URL}{URL}{} +\abbr{KILE}{Kile}{} +\abbr{LM}{Latin Modern}{} +\abbr{SRC}{SRC}{} + +\endinput diff --git a/Master/texmf-dist/source/generic/vntex/doc/test-accents.tex b/Master/texmf-dist/source/generic/vntex/doc/test-accents.tex new file mode 100644 index 00000000000..3c9b8824d3c --- /dev/null +++ b/Master/texmf-dist/source/generic/vntex/doc/test-accents.tex @@ -0,0 +1,186 @@ +% Copyright 2003-2005 Han The Thanh <hanthethanh@gmx.net>. +% This file is part of vntex. License: LPPL, version 1.3 or newer, +% according to http://www.latex-project.org/lppl.txt + +\large +\def\X#1{\hbox to 2em{\hss#1\hss}} +\begin{multicols}{2} +\noindent +\X{\ABREVE} \verb|\ABREVE| \\ +\X{\Abreve} \verb|\Abreve| \\ +\X{\ACIRCUMFLEX} \verb|\ACIRCUMFLEX| \\ +\X{\Acircumflex} \verb|\Acircumflex| \\ +\X{\ECIRCUMFLEX} \verb|\ECIRCUMFLEX| \\ +\X{\Ecircumflex} \verb|\Ecircumflex| \\ +\X{\Ocircumflex} \verb|\Ocircumflex| \\ +\X{\OCIRCUMFLEX} \verb|\OCIRCUMFLEX| \\ +\X{\OHORN} \verb|\OHORN| \\ +\X{\Ohorn} \verb|\Ohorn| \\ +\X{\UHORN} \verb|\UHORN| \\ +\X{\Uhorn} \verb|\Uhorn| \\ +\X{\abreve} \verb|\abreve| \\ +\X{\acircumflex} \verb|\acircumflex| \\ +\X{\DJ} \verb|\DJ| \\ +\X{\dj} \verb|\dj| \\ +\X{\ecircumflex} \verb|\ecircumflex| \\ +\X{\i} \verb|\i| \\ +\X{\ocircumflex} \verb|\ocircumflex| \\ +\X{\ohorn} \verb|\ohorn| \\ +\X{\uhorn} \verb|\uhorn| \\ +\X{\'A} \verb|\'A| \\ +\X{\'E} \verb|\'E| \\ +\X{\'I} \verb|\'I| \\ +\X{\'O} \verb|\'O| \\ +\X{\'U} \verb|\'U| \\ +\X{\'Y} \verb|\'Y| \\ +\X{\'\ABREVE} \verb|\'\ABREVE| \\ +\X{\'\Abreve} \verb|\'\Abreve| \\ +\X{\'\ACIRCUMFLEX} \verb|\'\ACIRCUMFLEX| \\ +\X{\'\Acircumflex} \verb|\'\Acircumflex| \\ +\X{\'\ECIRCUMFLEX} \verb|\'\ECIRCUMFLEX| \\ +\X{\'\Ecircumflex} \verb|\'\Ecircumflex| \\ +\X{\'\OCIRCUMFLEX} \verb|\'\OCIRCUMFLEX| \\ +\X{\'\Ocircumflex} \verb|\'\Ocircumflex| \\ +\X{\'\OHORN} \verb|\'\OHORN| \\ +\X{\'\Ohorn} \verb|\'\Ohorn| \\ +\X{\'\UHORN} \verb|\'\UHORN| \\ +\X{\'\Uhorn} \verb|\'\Uhorn| \\ +\X{\'\abreve} \verb|\'\abreve| \\ +\X{\'\acircumflex} \verb|\'\acircumflex| \\ +\X{\'\ecircumflex} \verb|\'\ecircumflex| \\ +\X{\'\ocircumflex} \verb|\'\ocircumflex| \\ +\X{\'\ohorn} \verb|\'\ohorn| \\ +\X{\'\uhorn} \verb|\'\uhorn| \\ +\X{\'a} \verb|\'a| \\ +\X{\'e} \verb|\'e| \\ +\X{\'i} \verb|\'i| \\ +\X{\'o} \verb|\'o| \\ +\X{\'u} \verb|\'u| \\ +\X{\'y} \verb|\'y| \\ +\X{\^A} \verb|\^A| \\ +\X{\^E} \verb|\^E| \\ +\X{\^O} \verb|\^O| \\ +\X{\^a} \verb|\^a| \\ +\X{\^e} \verb|\^e| \\ +\X{\^o} \verb|\^o| \\ +\X{\`A} \verb|\`A| \\ +\X{\`E} \verb|\`E| \\ +\X{\`I} \verb|\`I| \\ +\X{\`O} \verb|\`O| \\ +\X{\`U} \verb|\`U| \\ +\X{\`Y} \verb|\`Y| \\ +\X{\`\ABREVE} \verb|\`\ABREVE| \\ +\X{\`\Abreve} \verb|\`\Abreve| \\ +\X{\`\ACIRCUMFLEX} \verb|\`\ACIRCUMFLEX| \\ +\X{\`\Acircumflex} \verb|\`\Acircumflex| \\ +\X{\`\ECIRCUMFLEX} \verb|\`\ECIRCUMFLEX| \\ +\X{\`\Ecircumflex} \verb|\`\Ecircumflex| \\ +\X{\`\OCIRCUMFLEX} \verb|\`\OCIRCUMFLEX| \\ +\X{\`\Ocircumflex} \verb|\`\Ocircumflex| \\ +\X{\`\OHORN} \verb|\`\OHORN| \\ +\X{\`\Ohorn} \verb|\`\Ohorn| \\ +\X{\`\UHORN} \verb|\`\UHORN| \\ +\X{\`\Uhorn} \verb|\`\Uhorn| \\ +\X{\`\abreve} \verb|\`\abreve| \\ +\X{\`\acircumflex} \verb|\`\acircumflex| \\ +\X{\`\ecircumflex} \verb|\`\ecircumflex| \\ +\X{\`\ocircumflex} \verb|\`\ocircumflex| \\ +\X{\`\ohorn} \verb|\`\ohorn| \\ +\X{\`\uhorn} \verb|\`\uhorn| \\ +\X{\`a} \verb|\`a| \\ +\X{\`e} \verb|\`e| \\ +\X{\`i} \verb|\`i| \\ +\X{\`o} \verb|\`o| \\ +\X{\`u} \verb|\`u| \\ +\X{\`y} \verb|\`y| \\ +\X{\d A} \verb|\d A| \\ +\X{\d E} \verb|\d E| \\ +\X{\d I} \verb|\d I| \\ +\X{\d O} \verb|\d O| \\ +\X{\d U} \verb|\d U| \\ +\X{\d Y} \verb|\d Y| \\ +\X{\d \ABREVE} \verb|\d \ABREVE| \\ +\X{\d \Abreve} \verb|\d \Abreve| \\ +\X{\d \ACIRCUMFLEX} \verb|\d \ACIRCUMFLEX| \\ +\X{\d \Acircumflex} \verb|\d \Acircumflex| \\ +\X{\d \ECIRCUMFLEX} \verb|\d \ECIRCUMFLEX| \\ +\X{\d \Ecircumflex} \verb|\d \Ecircumflex| \\ +\X{\d \OCIRCUMFLEX} \verb|\d \OCIRCUMFLEX| \\ +\X{\d \Ocircumflex} \verb|\d \Ocircumflex| \\ +\X{\d \OHORN} \verb|\d \OHORN| \\ +\X{\d \Ohorn} \verb|\d \Ohorn| \\ +\X{\d \UHORN} \verb|\d \UHORN| \\ +\X{\d \Uhorn} \verb|\d \Uhorn| \\ +\X{\d \abreve} \verb|\d \abreve| \\ +\X{\d \acircumflex} \verb|\d \acircumflex| \\ +\X{\d \ecircumflex} \verb|\d \ecircumflex| \\ +\X{\d \ocircumflex} \verb|\d \ocircumflex| \\ +\X{\d \ohorn} \verb|\d \ohorn| \\ +\X{\d \uhorn} \verb|\d \uhorn| \\ +\X{\d a} \verb|\d a| \\ +\X{\d e} \verb|\d e| \\ +\X{\d i} \verb|\d i| \\ +\X{\d o} \verb|\d o| \\ +\X{\d u} \verb|\d u| \\ +\X{\d y} \verb|\d y| \\ +\X{\h A} \verb|\h A| \\ +\X{\h E} \verb|\h E| \\ +\X{\h I} \verb|\h I| \\ +\X{\h O} \verb|\h O| \\ +\X{\h U} \verb|\h U| \\ +\X{\h Y} \verb|\h Y| \\ +\X{\h \ABREVE} \verb|\h \ABREVE| \\ +\X{\h \Abreve} \verb|\h \Abreve| \\ +\X{\h \ACIRCUMFLEX} \verb|\h \ACIRCUMFLEX| \\ +\X{\h \Acircumflex} \verb|\h \Acircumflex| \\ +\X{\h \ECIRCUMFLEX} \verb|\h \ECIRCUMFLEX| \\ +\X{\h \Ecircumflex} \verb|\h \Ecircumflex| \\ +\X{\h \OCIRCUMFLEX} \verb|\h \OCIRCUMFLEX| \\ +\X{\h \Ocircumflex} \verb|\h \Ocircumflex| \\ +\X{\h \OHORN} \verb|\h \OHORN| \\ +\X{\h \Ohorn} \verb|\h \Ohorn| \\ +\X{\h \UHORN} \verb|\h \UHORN| \\ +\X{\h \Uhorn} \verb|\h \Uhorn| \\ +\X{\h \abreve} \verb|\h \abreve| \\ +\X{\h \acircumflex} \verb|\h \acircumflex| \\ +\X{\h \ecircumflex} \verb|\h \ecircumflex| \\ +\X{\h \ocircumflex} \verb|\h \ocircumflex| \\ +\X{\h \ohorn} \verb|\h \ohorn| \\ +\X{\h \uhorn} \verb|\h \uhorn| \\ +\X{\h a} \verb|\h a| \\ +\X{\h e} \verb|\h e| \\ +\X{\h i} \verb|\h i| \\ +\X{\h o} \verb|\h o| \\ +\X{\h u} \verb|\h u| \\ +\X{\h y} \verb|\h y| \\ +\X{\~A} \verb|\~A| \\ +\X{\~E} \verb|\~E| \\ +\X{\~I} \verb|\~I| \\ +\X{\~O} \verb|\~O| \\ +\X{\~U} \verb|\~U| \\ +\X{\~Y} \verb|\~Y| \\ +\X{\~\ABREVE} \verb|\~\ABREVE| \\ +\X{\~\Abreve} \verb|\~\Abreve| \\ +\X{\~\ACIRCUMFLEX} \verb|\~\ACIRCUMFLEX| \\ +\X{\~\Acircumflex} \verb|\~\Acircumflex| \\ +\X{\~\ECIRCUMFLEX} \verb|\~\ECIRCUMFLEX| \\ +\X{\~\Ecircumflex} \verb|\~\Ecircumflex| \\ +\X{\~\OCIRCUMFLEX} \verb|\~\OCIRCUMFLEX| \\ +\X{\~\Ocircumflex} \verb|\~\Ocircumflex| \\ +\X{\~\OHORN} \verb|\~\OHORN| \\ +\X{\~\Ohorn} \verb|\~\Ohorn| \\ +\X{\~\UHORN} \verb|\~\UHORN| \\ +\X{\~\Uhorn} \verb|\~\Uhorn| \\ +\X{\~\abreve} \verb|\~\abreve| \\ +\X{\~\acircumflex} \verb|\~\acircumflex| \\ +\X{\~\ecircumflex} \verb|\~\ecircumflex| \\ +\X{\~\ocircumflex} \verb|\~\ocircumflex| \\ +\X{\~\ohorn} \verb|\~\ohorn| \\ +\X{\~\uhorn} \verb|\~\uhorn| \\ +\X{\~a} \verb|\~a| \\ +\X{\~e} \verb|\~e| \\ +\X{\~i} \verb|\~i| \\ +\X{\~o} \verb|\~o| \\ +\X{\~u} \verb|\~u| \\ +\X{\~y} \verb|\~y| \\ +\end{multicols} diff --git a/Master/texmf-dist/source/generic/vntex/doc/vn-fonts-print.tex b/Master/texmf-dist/source/generic/vntex/doc/vn-fonts-print.tex new file mode 100644 index 00000000000..15f07c9cc3c --- /dev/null +++ b/Master/texmf-dist/source/generic/vntex/doc/vn-fonts-print.tex @@ -0,0 +1,2 @@ +\def\printversion{true} +\input vn-fonts.tex diff --git a/Master/texmf-dist/source/generic/vntex/doc/vn-fonts.tex b/Master/texmf-dist/source/generic/vntex/doc/vn-fonts.tex new file mode 100644 index 00000000000..ad6bdbb8b20 --- /dev/null +++ b/Master/texmf-dist/source/generic/vntex/doc/vn-fonts.tex @@ -0,0 +1,610 @@ +\ifx\printversion\undefined + \documentclass[12pt]{article} +% \advance\textwidth by 32.4pt +\else + \documentclass[11pt,a4paper]{article} + \RequirePackage[monochrome]{color} + \advance\topmargin by -2.2cm + \advance\textheight by 3.3cm + \advance\footskip by .5cm + \advance\oddsidemargin by -0.5cm + \advance\textwidth by 1cm +\fi +\usepackage{url} +\usepackage[colorlinks,bookmarks=false]{hyperref} +\usepackage{mflogo} +\usepackage{fancyvrb} +\usepackage[utf8]{vietnam} +\usepackage{charter} +\usepackage{microtype} + +%%\parskip.5\baselineskip +%%\parindent0pt +\usepackage{parskip} +\raggedbottom +\DefineShortVerb{\|} +\input{abbr.tex} + +\begin{document} + +\title{Dùng font vá»›i \<VNTEX>} +\author{Hà n Thế Thà nh và Thái Phú Khánh Hòa} +\maketitle + +\section{Giá»›i thiệu} +Tà i liệu nà y hÆ°á»›ng dẫn cách sá» dụng các font tiếng Việt vá»›i +\<VNTEX>. Tà i liệu giả sá» rằng bạn đã +\begin{itemize} +\item cà i đặt được \<VNTEX> lên hệ thống \<TEX> của bạn (nếu bạn dùng + \<TEXLIVE>\,$\ge$\,2005 hoặc \<MIKTEX>\,$\ge$\,2.5 thì \<VNTEX> đã + được tÃch hợp sẵn, bạn không phải tá»± cà i đặt); +\item gõ (và hiển thị) được tiếng Việt; +\item đã biên dịch được má»™t tà i liệu và dụ vá»›i ná»™i dung tÆ°Æ¡ng tá»± sau: +\begin{verbatim} +\documentclass{report} +\usepackage[utf8]{vietnam} +\begin{document} +Tiếng Việt +\end{document} +\end{verbatim} +\end{itemize} + +Nếu bạn chÆ°a thá»±c hiện được các bÆ°á»›c trên, xin vui lòng tham khảo các +tà i liệu hoặc các diá»…n Ä‘Ã n liên quan trÆ°á»›c khi tiếp tục. + +Tà i liệu nà y chỉ Ä‘á» cáºp đến các font có trong \<VNTEX>, và các font có +há»— trợ cho tiếng Việt được phân phối cùng vá»›i các hệ thống \<TEX> +thông dụng hiện nay nhÆ° \<TEXLIVE> hay \<MIKTEX>. Còn nhiá»u font khác +tuy cÅ©ng há»— trợ tiếng Việt nhÆ°ng không được Ä‘á» cáºp ở đây vì nhiá»u lý +do khác nhau. \<VNTEX> chỉ há»— trợ các font: +\begin{itemize} +\item có chất lượng tÆ°Æ¡ng đối tốt; +\item miá»…n phÃ, có bản quyá»n rõ rà ng và có thể phân phối lại; +\item có thể dùng được vá»›i ``classic'' (8-bit) \<TEX> và các \<DVI> + driver thông dụng nhÆ° \<XDVI>, \<YAP>, \<DVIPS>, \<DVIPSONE> hay + \<DVIPDFM>. Ngoại lệ duy nhất là má»™t số font \<TRUETYPE> (MS core) + yêu cầu phải có driver há»— trợ font \<TRUETYPE>, và dụ \<PDFTEX> hay + \<DVIPDFMX>. +\end{itemize} + +Các hÆ°á»›ng dẫn ở đây chỉ dùng cho \<LATEX>. Nếu bạn dùng \<CONTEXT>, +xin vui lòng Ä‘á»c tà i liệu hÆ°á»›ng dẫn dà nh cho \<CONTEXT>. Còn nếu bạn +dùng \<PLAIN>, thì bạn phải tá»± mà y mò lấy |:)|. Mẹo: có thể dùng gói +\<PLNFSS> để dùng \<NFSS> vá»›i \<PLAIN>. + +\section{CÆ¡ chế chá»n font trong \<LATEX>} +Má»™t chút kiến thức vá» \<NFSS> (cÆ¡ chế chá»n font trong \<LATEX>) sẽ rất +có Ãch ở đây. Chúng tôi sẽ giá»›i thiệu \<NFSS> má»™t cách nôm na (và đôi +khi có thể thiếu chÃnh xác), vá»›i hy vá»ng là là m nhÆ° váºy sẽ dá»… hiểu +hÆ¡n. + +\subsection{Các thuá»™c tÃnh của font} +Khi chúng ta dùng \<MSWORD>, \<OOWRITER> hay má»™t trình soạn thảo tÆ°Æ¡ng +tá»± tạo má»™t văn bản má»›i thì luôn có má»™t font chữ mặc định, thÆ°á»ng là +Times New Roman, cỡ chữ 12pt, chữ thÆ°á»ng (không nghiêng không +Ä‘áºm). Chúng ta có thể thay đổi font chữ mặc định bằng cách chá»n chữ +nghiêng, chữ Ä‘áºm, hay thay đổi cỡ chữ. NhÆ° váºy để xác định má»™t font, +ta thấy chỉ dùng tên của font (Times) chÆ°a đủ, mà ta còn phải mô tả +thêm các tÃnh chất khác, nhÆ° Ä‘á»™ nghiêng, Ä‘á»™ Ä‘áºm hay cỡ chữ. Các tÃnh +chất của má»™t font ta gá»i là các thuá»™c tÃnh (attribute) của font. Khi +ta thay đổi má»™t font, thá»±c ra là ta thay đổi (chá»n) các thuá»™c tÃnh +khác nhau của font. Ta cÅ©ng có thể coi tên gá»i của font là má»™t thuá»™c +tÃnh. Ta có thể chá»n kiểu chữ khác, và dụ Arial, bằng cách thay đổi +tên (hay ``thuá»™c tÃnh tên'') của font. + +Khi ta dùng \<LATEX> thì cÆ¡ chế chá»n font cÅ©ng hoạt Ä‘á»™ng tÆ°Æ¡ng tá»±. Khi +ta tạo má»™t văn bản \<LATEX>, thì ban đầu cÅ©ng có má»™t font mặc định, +thÆ°á»ng là font |cmr10| (Computer Modern, cỡ chữ 10pt, chữ thÆ°á»ng). +Các câu lệnh \<LATEX> dùng để thay đổi kiểu font mà ta vẫn hay gặp nhÆ° +|\textit|, |\texttt|, |\bf|, |\large|, \<...> thá»±c ra là các lệnh dùng +để thay đổi các thuá»™c tÃnh của font. Và dụ lệnh |\textit| sẽ chá»n +``thuá»™c tÃnh nghiêng'' của font. + +Váºy giá» ta chỉ cần biết font trong \<LATEX> có các thuá»™c tÃnh nà o và +cách thay đổi các thuá»™c tÃnh đó là có thể chá»n lá»±a font theo ý thÃch +của mình. + +Các thuá»™c tÃnh của font trong \<LATEX> là : +\begin{description} +\item[bảng mã (font encoding):] xác định font chứa các ký tá»± nà o. Các + bảng mã thÆ°á»ng gặp: +\begin{itemize} +\item |OT1| -- bảng mã dùng cho các font Compuder Modern (7-bit) +\item |T1| -- bảng mã cho các font chứa các ký tá»± trong các ngôn ngữ latin +Tây Âu (iso-8859-1) và Äông Âu (iso-8859-2) +\item |T5| -- bảng mã cho tiếng Việt +\end{itemize} + +\item[há» font (font family):] xác định kiểu (há») font, tÆ°Æ¡ng tá»± nhÆ° Times +New Roman hay Arial. Vì nhiá»u lý do mà há» font trong \<LATEX> thÆ°á»ng có tên +rất ngắn (3--5 ký tá»±) và tÆ°Æ¡ng đối khó nhá»›. Má»™t số há» font thÆ°á»ng gặp: +\begin{itemize} +\item |cmr| -- Computer Modern Roman +\item |ptm| -- Times Roman +\item |phv| -- Helvetica +\end{itemize} + +\item [Ä‘á»™ Ä‘áºm (font series):] xác định Ä‘á»™ Ä‘áºm nhạt của font. Äôi khi cả +thuá»™c tÃnh chiá»u rá»™ng (width) cÅ©ng được gán và o đây. Các giá trị +thÆ°á»ng gặp: +\begin{itemize} +\item |m| (medium) -- chữ thÆ°á»ng (không Ä‘áºm) +\item |b| (bold) -- chữ Ä‘áºm +\item |bx| (bold extended) -- chữ Ä‘áºm và rá»™ng hÆ¡n chữ thÆ°á»ng +\end{itemize} + +\item [kiểu dáng (font shape):] xác định kiểu dáng font, và dụ chữ thẳng +hay chữ nghiêng. Các giá trị thÆ°á»ng gặp: +\begin{itemize} +\item |n| -- chữ thÆ°á»ng (thẳng) +\item |it| -- chữ nghiêng ``italic'' +\item |sl| -- chữ nghiêng ``oblique'' +\item |sc| -- chữ ``smallcap'' (các chữ thÆ°á»ng có hình dáng nhÆ° chữ hoa, +nhÆ°ng bé hÆ¡n) +\end{itemize} +Chữ nghiêng italic và oblique khác nhau ở chá»— hình dáng chữ nghiêng +oblique trông giống nhÆ° chữ thẳng (chỉ trừ má»—i khoản ``nghiêng''), còn +chữ italic có hình dáng khác khá nhiá»u so vá»›i chữ thẳng, thÆ°á»ng chữ +italic có hình dáng gần vá»›i chữ viết tay hÆ¡n. Muốn biết rõ hÆ¡n bạn có +thể phóng to và so sánh chữ |a| của chữ nghiêng italic vá»›i chữ thẳng. + +\item [cỡ chữ (font size):] xác định cỡ chữ. +\end{description} + +Äể thay đổi thuá»™c tÃnh của font, ta có thể xem và dụ sau: + +\begin{verbatim} +\fontshape{it} +\selectfont +\end{verbatim} + +Và dụ trên chá»n giá trị ``nghiêng italic'' cho thuá»™c tÃnh ``kiểu +dáng'' (|fontshape|). LÆ°u ý là sau khi thay đổi thuá»™c tÃnh font, ta +phải dùng lệnh |\selectfont| để chá»n font có thuá»™c tÃnh má»›i. Cách chá»n +font nhÆ° trong và dụ trên ta Ãt khi gặp, vì ta hay dùng lệnh |\it| +hoặc |\textit| để chá»n chữ nghiêng. Các lệnh nà y thá»±c ra là các lệnh +gõ tắt (shortcut) để tiện cho ngÆ°á»i dùng. Dá»±a trên nguyên tắc nà y, ta +có thể Ä‘oán được lệnh dùng để chá»n font chữ Ä‘áºm ta hay dùng (|\bf| hay +|\textbf|) thá»±c ra là lệnh gõ tắt của: + +\begin{verbatim} +\fontseries{b} +\selectfont +\end{verbatim} + +Ta cÅ©ng có thể thay đổi nhiá»u thuá»™c tÃnh cùng má»™t lúc rồi dùng +|\selectfont| để chá»n font. Và dụ sau sẽ chá»n font vừa nghiêng vừa Ä‘áºm: + +\begin{verbatim} +\fontshape{it} +\fontseries{b} +\selectfont +\end{verbatim} + +Äến đây chắc bạn cÅ©ng có thể Ä‘oán ra là các lệnh thay đổi cỡ chữ nhÆ° +|\large|, |\huge|,\<...> là các lệnh gõ tắt dùng để thay đổi thuá»™c +tÃnh |fontsize| của font. + +\subsection{Các há» (kiểu) chữ mặc định} +Ta sẽ tìm hiểu thêm vá» việc thay đổi thuá»™c tÃnh |fontfamily| của má»™t +font. Còn |fontencoding| thì \emph{rất Ãt khi} cần thay đổi nên ta +không Ä‘á» cáºp đến ở đây. + +Khi ta bắt đầu má»™t văn bản \<LATEX>, font chữ mặc định là kiểu chữ +``có chân'' (roman, serif). Khi ta dùng lệnh |\sf| hay |\textsf|, thì +\<LATEX> chuyển sang font chữ ``không chân'' (sans serif). Việc chuyển +font nà y được thá»±c hiện bởi các lệnh thay đổi thuá»™c tÃnh ta đã biết: + +\begin{verbatim} +\fontfamily{\sfdefault} +\selectfont +\end{verbatim} + +|\sfdefault| là má»™t macro chứa giá trị |fontfamily| của font không +chân mặc định, thÆ°á»ng là |cmss| (Computer Modern Sans Serif). TÆ°Æ¡ng tá»± +nhÆ° váºy, việc chuyển sang font ``máy chữ'' (typewriter) bằng lệnh +|\tt| hay |\texttt| thá»±c ra là việc thay đổi thuá»™c tÃnh |fontfamily| +nhÆ° sau: + +\begin{verbatim} +\fontfamily{\ttdefault} +\selectfont +\end{verbatim} + +Thông thÆ°á»ng |\ttdefault| có giá trị |cmtt| (Computer Modern Typewriter). + +Ta tóm tắt lại các giá trị mặc định của |fontfamily| mà \<LATEX> dùng +cho các há» chữ: +\begin{itemize} +\item |\rmdefault| -- dùng cho font có chân, thÆ°á»ng là |cmr|. Font nà y + được chá»n sau dòng |\begin{document}| +\item |\sfdefault| -- dùng cho font không chân, thÆ°á»ng là + |cmss|. Font nà y được chá»n khi ta dùng lệnh |\sf| hay |\textsf| +\item |\sfdefault| -- dùng cho font máy chữ, thÆ°á»ng là |cmtt|. Font + nà y được chá»n khi ta dùng lệnh |\tt| hay |\texttt| +\end{itemize} + +Và dụ khi ta muốn dùng font Bitstream Charter nhÆ° font có chân mặc định +trong văn bản, thì ta thêm dòng sau và o ``preamble'' của văn bản (phần +trÆ°á»›c |\begin{document}|): + +\begin{verbatim} +\renewcommand{\rmdefault}{bch} +\end{verbatim} + +Ta cÅ©ng có thể dùng gói |charter.sty| để kÃch hoạt font Bitstream Charter +cho văn bản của mình bằng cách thêm và o preamble dòng sau: + +\begin{verbatim} +\usepackage{charter} +\end{verbatim} + +Nếu ta xem ná»™i dung của gói |charter.sty| thì cÅ©ng sẽ thấy ná»™i dung tÆ°Æ¡ng +tá»± nhÆ° trên. + +\section{Là m sao biết được có thể chá»n font nà o?} +Äến đây chắc bạn Ä‘á»c cÅ©ng hình dung ra được việc thay đổi font có +chân, không chân và font máy chữ cho má»™t văn bản thá»±c ra chỉ là việc +định nghÄ©a lại các macro |\rmdefault|, |\sfdefault| và +|\ttdefault|. Vấn Ä‘á» còn lại là là m sao biết được các giá trị +|fontfamily| của font mà ta muốn dùng. Và dụ ta muốn dùng font +Palatino, là m sao biết được giá trị |fontfamily| của font nà y mà chá»n? + +Cách Ä‘Æ¡n giản nhất là xem các mẫu font của \<VNTEX> (và má»™t số font +khác cÅ©ng há»— trợ tiếng Việt) tại +\href{http://vntex.sf.net/fonts/samples}{đây}. Ta xem thá» má»™t và dụ sau: +xem mẫu font \<URWVN> +(\href{http://vntex.sf.net/fonts/samples/urwvn-test.pdf}{urwvn-test.pdf}), +ta thấy có các cá»™t (theo thứ tá»± từ trái sang phải): +\begin{description} +\item [NFSS] -- các thuá»™c tÃnh của font nhÆ° ta đã tìm hiểu, theo thứ tá»±\\ +|fontencoding/fontfamily/fontseries/fontshape|. Thuá»™c tÃnh |fontsize| không +được Ä‘á» cáºp đến ở đây vì không cần thiết. +\item [TFM] -- tên táºp tin chứa font (tạm thá»i ta không cần quan tâm) +\item [PostScript] -- tên ``thông thÆ°á»ng'' của font +\item [Sample] -- mẫu font +\end{description} + +Và dụ xem dòng đầu tiên ta thấy \textbf{NFSS} = |T5/uag/db/n| và +\textbf{PostScript} = |VnURWGothicL-Demi|, có thể hiểu nhÆ° sau: font +nà y có tên thông thÆ°á»ng là |VnURWGothicL-Demi|, và các thuá»™c tÃnh +\<NFSS> của font nà y là :\\[1ex] +\begin{tabular}{ll} +|fontencoding| & = |T5|\\ +|fontfamily| & = |uag|\\ +|fontseries| & = |db|\\ +|fontshape| & = |n|\\ +\end{tabular} + +\selectfont + + +Giả sá» bây giá» ta muốn chá»n font Century Schoolbook là m font có chân +mặc định trong văn bản. Xem ở cá»™t \textbf{PostScript} ta thấy các font +trong há» nà y có tên bắt đầu vá»›i |VnCenturySchoolbookL| (có má»™t số font +cùng trong há» font nà y có tên \textbf{PostScript} là |N/A|, Ä‘iá»u nà y +tạm thá»i ta cÅ©ng chÆ°a cần quan tâm). Xem ở cá»™t \textbf{NFSS} ta thấy +các font nà y có |fontfamily| là |unc|. Äể chá»n font nà y ta thêm và o +preamble dòng: + +\begin{verbatim} +\renewcommand{\rmdefault}{unc} +\end{verbatim} + +TÆ°Æ¡ng tá»± nhÆ° váºy, nếu ta muốn chá»n font VnNimbusSansL (giống nhÆ° +Helvetica) là m font không chân mặc định, thì ta dùng: + +\begin{verbatim} +\renewcommand{\sfdefault}{uhv} +\end{verbatim} + +Ta cÅ©ng có thể chá»n má»™t font tùy ý mà không cần phải thay đổi các giá +trị mặc định. Và dụ ta muốn dùng font VnURWGothicL-Demi chỉ cho má»™t +Ä‘oạn ngắn nà o đó trong văn bản thì ta chá»n font nà y dá»±a và o các thuá»™c +tÃnh ở cá»™t \textbf{NFSS} nhÆ° sau: + +\begin{verbatim} +\fontencoding{T5} +\fontfamily{uag} +\fontseries{db} +\fontshape{n} +\selectfont +\end{verbatim} + +Các lệnh trên có thể viết gá»n hÆ¡n: +\begin{verbatim} +\usefont{T5}{uag}{db}{n} +\end{verbatim} + +\section{Má»™t số vấn Ä‘á» liên quan} +\subsection{Chá»n font nhÆ° thế nà o là hợp lý?} +Chá»n font cÅ©ng nhÆ° trang Ä‘iểm, nếu không rà nh mà cứ dùng tháºt nhiá»u font +cho má»™t văn bản thì cÅ©ng nhÆ° trang Ä‘iểm dùng tháºt nhiá»u các mỹ phẩm khác +nhau cho má»™t khuôn mặt. Kết quả là ta tưởng ta đẹp trong khi ngÆ°á»i khác +nhìn và o thấy buồn cÆ°á»i. + +Váºy là m sao để có thể ``rà nh''? Câu trả lá»i duy nhất theo chúng tôi là qua +há»c há»i, tìm tòi và kinh nghiệm thá»±c tế. BÆ°á»›c đầu thì nên theo những hÆ°á»›ng +dẫn cÆ¡ bản, khi đã có kinh nghiệm thì ta có thể là m theo sở thÃch của mình. +Các qui tắc có Ãch khi má»›i bắt đầu là : +\begin{itemize} +\item nên tránh dùng các lệnh chá»n font của \<LATEX> phiên bản cÅ© (2.09) nhÆ° +|\bf|, |\it|, |\tt|\<...> Thay và o đó hãy dùng các lệnh tÆ°Æ¡ng ứng của +\<LATEX>2e nhÆ° |\textbf|, |\textit|, |\texttt|,\<...> + +\item trong má»™t văn bản chỉ nên dùng tối Ä‘a 3 há» font: có chân, không + chân và máy chữ + +\item nên thay đổi các há» font mặc định bằng các gói tÆ°Æ¡ng ứng nếu + có. Và dụ nếu đã có gói |charter.sty| thì ta nên dùng + +\begin{verbatim} +\usepackage{charter} +\end{verbatim} + +thay vì + +\begin{verbatim} +\renewcommand{\rmdefault}{bch} +\end{verbatim} + +Lý do chÃnh là má»™t số gói có thể chứa thêm các Ä‘iá»u chỉnh cần thiết +ngoà i việc định nghÄ©a lại |\rmdefault|, |\sfdefault| hay +|\ttdefault|. Ngoà i ra má»™t số gói có thể chá»n nhiá»u font ``hợp nhau'' +cùng má»™t lúc, Và dụ gói |newcent.sty| ngoà i việc chá»n |pnc| (New +Century SchoolBook) cho font có chân mặc định (|\rmdefault|) còn chá»n +|pag| (Avant Garde) cho font không chân mặc định (|\sfdefault|) và +|pcr| (Courier) cho font máy chữ mặc định (|\ttdefault|), vì 3 font +nà y có vẻ ``hợp nhau''. + +Các gói để chá»n font cho \<VNTEX> sẽ được mô tả ở phần sau. + +\item Chú ý là không phải cứ chá»n font bằng gói là tối Æ°u, vì có má»™t + số gói đã ``lá»—i thá»i'' (obsolete). Nên Ä‘á»c tà i liệu + \href{http://ctan.org/tex-archive/info/l2tabu/english/l2tabuen.pdf}{l2tabuen} + để biết thêm thông tin vá» các gói lá»—i thá»i và cách dùng các gói + tÆ°Æ¡ng ứng. + +\item nếu bạn muốn dùng má»™t font mà không tìm được gói tÆ°Æ¡ng ứng, thì + nên nên tìm hiểu kỹ (qua tà i liệu, Internet, các diá»…n Ä‘Ã n,\<...>) để + biết các há» font nà o thÃch hợp vá»›i nhau, +\end{itemize} + +\subsection{Chá»n font toán nhÆ° thế nà o cho hợp lý?} +Tà i liệu tốt nhất cho Ä‘á» tà i nà y là +\href{http://ctan.tug.org/tex-archive/info/Free_Math_Font_Survey/survey.html}{Free + Math Font Survey}. Hiện bản tiếng Việt chÆ°a được dịch. LÆ°u ý có má»™t +số font trong tà i liệu nà y chÆ°a há»— trợ tiếng Việt. Trong tÆ°Æ¡ng lai có +thể chúng tôi sẽ Việt hóa các font nà y. + +\section{Cách chá»n các font vá»›i \<VNTEX>} +\subsection{\<VNR>} +Các font \<VNR> là font mặc định khi dùng \<VNTEX> nên không cần phải +là m gì thêm. + +\subsection{\<LM>} +Dá»± án font \<LM> nhằm thống nhất các bản ``địa phÆ°Æ¡ng hóa'' font \<CM> +cho các ngôn ngữ khác nhau. Äể dùng các font \<LM> thay cho font +\<VNR>, bạn chỉ cần dùng: + +\begin{verbatim} +\usepackage{lmodern} +\end{verbatim} + +\subsection{Antykwa Torunska} +Äây là bá»™ font có chân do nhà thiết kế chữ ngÆ°á»i Ba Lan Zygfryd +Gardzielewski tạo ra, sau đó được Janusz Marian Nowacki chuyển sang +định dạng \<T1> và thêm há»— trợ cho nhiá»u ngôn ngữ khác trong đó có cả +tiếng Việt. Bá»™ font nà y miá»…n phà và có sẵn trong nhiá»u bản phân phối +\<TEX> thông dụng. Bạn có thể Ä‘á»c thêm vá» bá»™ font nà y tại +\href{http://www.janusz.nowacki.strefa.pl}{đây}. + +Äể dùng bá»™ font nà y bạn có thể dùng gói |anttor| vá»›i các lá»±a chá»n khác +nhau:\\[1ex] +\begin{tabular}{ll} +|\usepackage{anttor}| & chá»n kiểu font thÆ°á»ng\\ +|\usepackage[light]{anttor}| & chá»n kiểu font mảnh\\ +|\usepackage[condensed]{anttor}| & chá»n kiểu font hẹp\\ +|\usepackage[light,condensed]{anttor}| & chá»n kiểu font vừa mảnh vừa hẹp\\ +\end{tabular}\\[1ex] + +\subsection{Kurier} +Bá»™ font Kurier cÅ©ng do Janusz Marian Nowacki thá»±c hiện và được công bố +tại cùng địa chỉ vá»›i font Antykwa Torunska. + +TÆ°Æ¡ng tá»±, để dùng bá»™ font nà y bạn có thể dùng gói |kurier| vá»›i các lá»±a +chá»n khác nhau:\\[1ex] +\begin{tabular}{ll} +|\usepackage{kurier}| & chá»n kiểu font thÆ°á»ng\\ +|\usepackage[light]{kurier}| & chá»n kiểu font mảnh\\ +|\usepackage[condensed]{kurier}| & chá»n kiểu font hẹp\\ +|\usepackage[light,condensed]{kurier}| & chá»n kiểu font vừa mảnh vừa hẹp\\ +\end{tabular}\\[1ex] + +\subsection{Iwona} +Bá»™ font Iwona cÅ©ng do Janusz Marian Nowacki thá»±c hiện và được công bố tại +cùng địa chỉ vá»›i font Antykwa Torunska. + +TÆ°Æ¡ng tá»±, để dùng bá»™ font nà y bạn có thể dùng gói |iwona| vá»›i các lá»±a chá»n +khác nhau:\\[1ex] +\begin{tabular}{ll} +|\usepackage{iwona}| & chá»n kiểu font thÆ°á»ng\\ +|\usepackage[light]{iwona}| & chá»n kiểu font mảnh\\ +|\usepackage[condensed]{iwona}| & chá»n kiểu font hẹp\\ +|\usepackage[light,condensed]{iwona}| & chá»n kiểu font vừa mảnh vừa hẹp\\ +\end{tabular}\\[1ex] + +\subsection{\<URWVN>} +Tà i liệu hÆ°á»›ng dẫn sá» dụng cho các font \<PS> thông thÆ°á»ng (35 font \<PS> +``chuẩn'') cÅ©ng dùng được vá»›i các font \<URWVN>. Tà i liệu nà y có tên là +|psnfss2e.pdf| hoặc |psnfss2e.dvi| và thÆ°á»ng có sẵn trong các bản \<TEX>. +Nếu chÆ°a có tà i liệu nà y trên máy thì bạn có thể tải vá» từ +\href{http://www.ctan.org/tex-archive/macros/latex/required/psnfss/psnfss2e.pdf}{đây}. + +Ở đây chúng tôi chỉ ghi lại phần giá»›i thiệu để bạn có thể sá» dụng ngay các +font nà y. Nếu bạn có thắc mắc gì xin hãy Ä‘á»c tà i liệu nguyên bản để biết +thêm chi tiết. +\begin{quotation} +\parindent0pt +\noindent Cách Ä‘Æ¡n giản nhất để sá» dụng các font \<PS> thông dụng là +định nghÄ©a lại các giá trị mặc định của các font có chân (roman), +không chân (sans serif) và font máy chữ (typewriter). Äể là m việc nà y +bạn có thể sá» dụng các gói trong bảng dÆ°á»›i đây. Dòng đầu tiên liệt kê +các há» font mặc định (Computer Modern). Cá»™t nà o trống có nghÄ©a là gói +tÆ°Æ¡ng ứng không thay đổi giá trị font mặc định cho cá»™t đó. Có má»™t số +gói được giải thÃch chi tiết hÆ¡n, và dụ gói |helvet|, |mathpazo| và +|mathptmx|. + +\begin{table}[!htb] +\caption{Các gói dùng cho việc sá» dụng các font \<PS> thông dụng} +\medskip +\begin{center} +\UndefineShortVerb{\|} +\renewcommand{\arraystretch}{1.2} +\newcommand{\Lpack}[1]{\textsf{#1}} +\def\NL{\hfil\break} +\ifx\printversion\undefined + %\footnotesize + %\begin{tabular}{|l|p{1.8cm}p{2.2cm}p{2.4cm}p{2.2cm}|} + \small + \begin{tabular}{|l|p{2.8cm}p{2.4cm}p{2.6cm}p{2.3cm}|} +\else + \small + \begin{tabular}{|l|p{2.8cm}p{2.4cm}p{2.6cm}p{2.3cm}|} +\fi + \hline + \textbf{tên gói} & \textbf{font có \NL chân \NL(roman)} & + \textbf{font \NL không chân \NL (sans serif)} & + \textbf{font máy chữ \NL(typewriter)} & + \textbf{font công \NL thức toán} \\\hline\hline + (none) & CM Roman & CM Sans Serif + & CM Typewriter & $\approx$ CM Roman\\\hline + \Lpack{mathpazo} & Palatino + & + & + & $\approx$ Palatino\\\hline + \Lpack{mathptmx} & Times + & + & + & $\approx$ Times\\\hline + \Lpack{helvet} & + & Helvetica + & + & \\\hline + \Lpack{avant} & + & Avant~Garde + & + & \\\hline + \Lpack{courier} & + & + & Courier + & \\\hline + \Lpack{chancery} & Zapf Chancery + & + & + & \\\hline + \Lpack{bookman} & Bookman + & Avant~Garde + & Courier + & \\\hline + \Lpack{newcent} & \raggedright New Century Schoolbook + & Avant~Garde + & Courier + & \\\hline + \Lpack{charter} & Charter + & + & + & \\\hline +\end{tabular} +\end{center} +\end{table} + + +Và dụ khi ta dùng +\begin{verbatim} +\usepackage{bookman} +\end{verbatim} + +thì sẽ được\\[1ex] +\begin{tabular}{ll} +font có chân & = Bookman\\ +font không chân & = Avant~Garde\\ +font máy chữ & = Courier\\ +\end{tabular}\\[1ex] +do gói nà y định nghÄ©a lại cả 3 há» font. Còn nếu ta dùng +\begin{verbatim} +\usepackage{charter} +\end{verbatim} + +thì sẽ được\\[1ex] +\begin{tabular}{ll} +font có chân & = Charter\\ +font không chân & = CM Sans Serif (default)\\ +font máy chữ & = CM Typewriter (default)\\ +\end{tabular}\\[1ex] +do gói nà y chỉ định nghÄ©a lại há» font có chân, còn 2 há» font kia vẫn giữ giá +trị mặc định. + +\end{quotation} + +Má»™t lÆ°u ý quan trá»ng là các tên \<PS> của các font \<URWVN> (thá»±c chất +là tên các font \<URW> có thêm prefix |Vn|) không giống nhÆ° tên của 35 +font \<PS> chuẩn, vì các tên nà y do \<URW> đặt cho các font của mình +trong khi tên của 35 font \<PS> chuẩn do Adobe đặt. Bạn có thể tham +khảo bảng dÆ°á»›i đây để biết các font nà o tÆ°Æ¡ng Ä‘Æ°Æ¡ng vá»›i nhau: + +\begin{center} +\UndefineShortVerb{\|} +\renewcommand{\arraystretch}{1.2} +\begin{tabular}{|l|l|} +\hline +VnURWGothicL & AvantGarde\\ +VnURWBookmanL & Bookman\\ +VnNimbusMonoL & Courier\\ +VnNimbusSansL & Helvetica\\ +VnURWPalladioL & Palatino\\ +VnNimbusRomanNo9L & Times\\ +VnURWChanceryL & ZapfChancery\\ +\hline +\end{tabular} +\end{center} + + +\subsection{Bitstream Charter} +Dùng gói |charter| nhÆ° sau: +\begin{verbatim} +\usepackage{charter} +\end{verbatim} + +\subsection{MS core} +Các font MS core do Monotype và Linotype thá»±c hiện và bán lại cho +Microsoft (trừ các font Tahoma và Verdana do Microsoft tá»± thá»±c +hiện). Các font nà y có định dạng \<TRUETYPE> và yêu cầu phải có driver +há»— trợ font \<TRUETYPE>, và dụ \<PDFTEX> hay \<DVIPDFMX>. + +Hiện nay chÆ°a có gói nà o há»— trợ việc dùng các font nà y, do đó ta phải +tá»± định nghÄ©a lại các há» font mặc định |\rmdefault|, |\sfdefault| và +|\ttdefault| nhÆ° đã trình bà y ở trên. Ở đây chúng tôi chỉ nêu má»™t và +dụ: giả sá» sau khi xem mẫu font mscore tại +\href{http://vntex.sf.net/fonts/samples/mscore-test.pdf}{đây}, ta muốn +dùng font Verdana là m font không chân mặc định. Các font nà y có thuá»™c +tÃnh |fontfamily| là |jvn|, do đó ta cần thêm và o preamble dòng: + +\begin{verbatim} +\renewcommand{\sfdefault}{jvn} +\end{verbatim} + +Muốn sá» dụng các font còn lại ta là m tÆ°Æ¡ng tá»±. + +Nếu bạn muốn viết các gói để há»— trợ các font nà y thì chúng tôi rất +hoan nghênh. + +Äa số các font trong bá»™ font nà y Ä‘á»u có phiên bản tÆ°Æ¡ng ứng trong bá»™ +\<URWVN> (trừ các font Tahoma và Verdana). Bạn có thể dùng font nà o +bạn thÃch hÆ¡n. Theo ý kiến chủ quan của chúng tôi thì các font +\<URWVN> có các dấu tiếng Việt ``đẹp'' hÆ¡n. + +\section{Góp ý} +Má»i ý kiến đóng góp xin gởi đến các tác giả |hanthethanh| hoặc +|h2vnteam| tại |gmail| chấm |com|. +\end{document} diff --git a/Master/texmf-dist/source/generic/vntex/doc/vn-min-print.tex b/Master/texmf-dist/source/generic/vntex/doc/vn-min-print.tex new file mode 100644 index 00000000000..f610e7d9875 --- /dev/null +++ b/Master/texmf-dist/source/generic/vntex/doc/vn-min-print.tex @@ -0,0 +1,2 @@ +\RequirePackage[monochrome]{color} +\input{vn-min.tex} diff --git a/Master/texmf-dist/source/generic/vntex/doc/vn-min.tex b/Master/texmf-dist/source/generic/vntex/doc/vn-min.tex new file mode 100644 index 00000000000..459a98e18b3 --- /dev/null +++ b/Master/texmf-dist/source/generic/vntex/doc/vn-min.tex @@ -0,0 +1,109 @@ +\documentclass[a4paper,12pt]{article} +\usepackage[ + a4paper, + nohead, + nofoot, + top=2cm, + bottom=2cm, + left=2cm, + right=2cm, + pdftex]{geometry} +% \usepackage{array} +\usepackage{fancyvrb} +\usepackage{url} +\usepackage{charter} +\usepackage{multicol} +\usepackage[colorlinks,bookmarks=false]{hyperref} +\usepackage[vietnam,english]{babel} + +% \pagestyle{empty} +\def\arraystretch{1.3} +\DefineShortVerb{\|} +\parskip.5\baselineskip +\parindent0pt +\raggedbottom + +\input{abbr.tex} +\begin{document} + +\title{\bfseries Minimal steps to typeset Vietnamese} +\author{\fontencoding{T5}\selectfont H\`an Th\'\ecircumflex{} Th\`anh} +\maketitle + +This document tries to answer the question that has been often asked: +\textit{How can I typeset \textbf{just a few Vietnamese words} in my +document, which is in English (or French/German/...)?} + +The answer depends very much on a particular scenario, however I +assume that you are in a hurry, you don't want to bother with issues like +how to display and write Vietnamese in your \<TEX> editor. You only have a few +Vietnamese words in your \<LATEX> file and you would like to see them +properly displayed in your final \<PDF> or \<PS> file. + +\begin{enumerate} +\item As the very first requirement, you must have some minimal \<LATEX> +support for Vietnamese: +\begin{itemize} +\item Check whether you have \<VNTEX> installed. \<VNTEX> is included +in \<TETEX>, \<MIKTEX> and \<TEXLIVE>. + +\item If the above is not the case, try to download and install \<VNTEX> by +following the instructions at \url{http://vntex.sf.net/download/vntex}. + +\item If you can't install \<VNTEX>, you must have at least Latin Modern +fonts installed. Then download +\url{http://vntex.sf.net/download/vntex-support/t5enc.def} and put it to the +directory where your \<LATEX> file is. + +\item If all the above fails, try to get help from someone else to solve +at least one of those issues. +\end{itemize} + +\item Make sure you have package |fontenc| loaded with T5 encoding. For +example, if your document contains European languague(s) only, then you +should have a line saying + +\begin{verbatim} +\usepackage[T1,T5]{fontenc} +\end{verbatim} + +in your preamble. + +\item An example how to input Vietnamese words may look like this: + +\begin{verbatim} +{\fontencoding{T5}\selectfont Ti\'\ecircumflex{}ng Vi\d\ecircumflex{}t} +\end{verbatim} + +which gives the output as \texttt{\fontencoding{T5}\selectfont +Ti\'\ecircumflex{}ng Vi\d\ecircumflex{}t}. + +\item The following table contains all Vietnamese letters for your +reference: + +{\fontencoding{T5}\selectfont +\input{test-accents} +} + +\item If you have quite a lot of Vietnamese words, then it can be somewhat +tedious to translate them to the above form (often called as \<LATEX> +Internal Character Representation -- LICR). On \<WINDOWS> you can use the +package \url{http://vntex.sf.net/download/vntex-support/tovntex.zip} +to translate text in clipboard from VIQR or UTF-8 to LICR by one key press. + +The same (or close) convenience could be made for \<UNIX>/\<LINUX> +users, but at somewhat higher cost due to deficiencies of \<UNIX>-like +systems. So if you don't use \<WINDOWS> then you are out of luck, sorry. +However, if you use \<VIM>, you can still download the package mentioned +above, and use the vim script inside the zip archive to do the conversion. +If you want to make this easier for \<UNIX> users then let me know. + +\item If you still have questions, join the \<VNTEX> mailing list +at \url{https://lists.sourceforge.net/lists/listinfo/vntex-users}. + +\end{enumerate} + +Good luck! + +% \DefineShortVerb{\|} +\end{document} diff --git a/Master/texmf-dist/source/generic/vntex/doc/vntex-man-print.tex b/Master/texmf-dist/source/generic/vntex/doc/vntex-man-print.tex new file mode 100644 index 00000000000..5c1c3a15287 --- /dev/null +++ b/Master/texmf-dist/source/generic/vntex/doc/vntex-man-print.tex @@ -0,0 +1,2 @@ +\RequirePackage[monochrome]{color} +\input{vntex-man.tex} diff --git a/Master/texmf-dist/source/generic/vntex/doc/vntex-man.tex b/Master/texmf-dist/source/generic/vntex/doc/vntex-man.tex new file mode 100644 index 00000000000..63b57ecfdcc --- /dev/null +++ b/Master/texmf-dist/source/generic/vntex/doc/vntex-man.tex @@ -0,0 +1,514 @@ +\documentclass[12pt,a4paper]{article} +\usepackage{url} +\usepackage[colorlinks,bookmarks=false]{hyperref} +\usepackage{fancyvrb} +\usepackage[utf8]{vietnam} +\usepackage{charter} +\usepackage{ifpdf} +\usepackage{microtype} +% \usepackage{graphicx} +% \usepackage{array} + +\parindent0pt +\parskip.4\baselineskip +\def\arraystretch{1.3} +\hyperlinkfileprefix{} + + +\advance\topmargin by -2cm +\advance\textheight by 3cm +\advance\footskip by .5cm +\advance\oddsidemargin by -0.5cm +\advance\textwidth by 1cm + +\input{abbr.tex} + +%% These abbrs are are not defined in abbr.tex: +\abbr{FD}{FD}{} +\abbr{MAKEINDEX}{MakeIndex}{} +\abbr{LATEXPIX}{LaTeXPIX}{} + +\newcommand{\htmlheader} +{Há»— trợ tiếng Việt cho \<TEX>} + +\newcommand{\htmlfooter}{} + +\begin{document} +\setcounter{tocdepth}{1} +\setcounter{secnumdepth}{1} +\DefineShortVerb{\|} + +\title{\<VNTEX>} + +% \noindent +% Chà o bạn đã đến vá»›i trang web của \<VNTEX>. + +% \HCode{<h2>} +% Các tin đáng chú ý +% \HCode{</h2>} +% \begin{itemize} +% \item 06/10/2006: thêm phần hÆ°á»›ng dẫn dịch bản tiếng Việt của +% \href{http://www.tug.org/tex-archive/info/Free_Math_Font_Survey/survey.html} +% {Free Math Font Survey} ở phần \hyperlink{tai-lieu-vntex}{Tà i liệu} + +% \item 05/10/2006: cáºp nháºt bản dịch Free Math Font Survey tại +% \href{doc/survey-vn.pdf}{trang chủ} và +% \href{http://vntex.sarovar.org/survey-vn.pdf}{mirror tại sarovar} + +% \item 04/09/2006: công bố \href{download/vntex-beta}{vntex-beta-20060904} + +% \item 19/08/2006: công bố phiên bản \<TRUETYPE> của bá»™ font \<URWVN>-3.03 +% tại \href{http://forum.vnoss.org/viewtopic.php?id=3334}{\<VNOSS>}. Xem +% \href{fonts/urwvn-ttf}{hÆ°á»›ng dẫn cà i đặt}. + +% \item 08/08/2006: hoà n thà nh việc Việt hóa các text font trong +% tà i liệu +% \href{http://www.tug.org/tex-archive/info/Free_Math_Font_Survey/survey.html} +% {Free Math Font Survey} và công bố +% \href{fonts/samples/survey-vn.pdf}{bản dịch} + +% % \item 18/07/2006: cáºp nháºt mục \hyperlink{du-dinh-phat-trien}{dá»± +% % định phát triển}. + +% \item 16/07/2006: thêm mẫu font má»›i: +% VnGaramond +% (\href{http://vntex.sf.net/fonts/samples/garamondvn-test.pdf}{test}, +% \href{http://vntex.sf.net/fonts/samples/garamondvn-sample.pdf}{sample}) +% và VnGrotesq +% (\href{http://vntex.sf.net/fonts/samples/grotesqvn-test.pdf}{test}, +% \href{http://vntex.sf.net/fonts/samples/grotesqvn-sample.pdf}{sample}). Các +% font nà y sẽ được công bố để ngÆ°á»i dùng tải vá» trong thá»i gian tá»›i. + +% \item 13/07/2006: hÆ°á»›ng dẫn cách tạo ``searchable'' \<PDF> vá»›i tiếng Việt. +% Xem \hyperlink{cmap-vn}{chi tiết}. + +% \item 24/06/2006: há»— trợ \<UNICODE> bookmarks cho \<PDF>. +% Xem \hyperlink{bookmark-vn}{chi tiết}. + +% \item 16/06/2006: công bố phiên bản chÃnh thức má»›i của trang web \<VNTEX> + +% \item 05/06/2006: công bố phiên bản thá» nghiệm má»›i của trang web +% \<VNTEX>, cùng vá»›i má»™t số gói má»›i: \hyperlink{more-extsizes}{more-extsizes} +% và \hyperlink{makeindex-vn}{makeindex-vn}. + +% \item 03/06/2006: sá»a lá»—i các táºp \<FD> cho font \<VNR>. Xem +% \hyperlink{cap-nhat-vnr-fd}{chi tiết}. + +% \item 26/05/2006: công bố phiên bản \<TRUETYPE> của bá»™ font \<URWVN>. Xem +% \href{fonts/urwvn-ttf}{chi tiết}. + +% \item 20/09/2005: công bố \<VNTEX>-3.02 + +% \item 20/09/2005: công bố \href{fonts/samples}{mẫu font} +% cho \<VNTEX> + +% \item 01/12/2004: \<CONTEXT> đã +% \href{http://vnoss.org/forum/viewtopic.php?id=506}{há»— trợ tiếng Việt} + +% \end{itemize} + +{\huge\centering\htmlheader\par} +%\vspace*{10pt} +\begin{center} + Hà n Thế Thà nh +\end{center} + +\section{Giá»›i thiệu} +% \subsection{\<VNTEX>, \<LATEX>, \<CONTEXT>,\<...> là gì váºy?} +% If you are new to \<TEX>, see \url{http://en.wikipedia.org/wiki/TeX} for a +% basic explanation of \<TEX> and related programs. The \<TUG> (\<TEX> Users + % roup) homepage at \url{http://tug.org} also contains useful introductory +% material to \<TEX>. + +\subsection{\<VNTEX> là gì?} +\<VNTEX> là má»™t gói chứa các há»— trợ cần thiết cho việc sá» dụng tiếng Việt +vá»›i \<TEX>. Trang web nà y chứa các thông tin vá» gói \<VNTEX> và các vấn Ä‘á» +liên quan đến tiếng Việt trong \<TEX>. Chắc hẳn khi tìm đến vá»›i \<VNTEX> +bạn đã Ãt nhiá»u biết đến thế giá»›i \<TEX>, và bạn cần \<VNTEX> cho việc dùng +tiếng Việt vá»›i \<TEX>. + +Nếu bạn chÆ°a từng sá» dụng \<TEX>, có lẽ trang web nà y không +thÃch hợp lắm cho việc bắt đầu tìm hiểu vá» \<TEX>; bạn có thể +tham khảo má»™t số địa chỉ sau: +\begin{enumerate} +\item Tiếng Việt: +\begin{itemize} +\item \href{http://forum.vnoss.org/viewforum.php?id=10}{Diá»…n Ä‘Ã n \<VNOSS>} +\item \href{http://viettug.org}{ViệtTUG} +\item \href{http://vi.wikipedia.org/wiki/TeX}{Äịnh nghÄ©a \<TEX> tại +wikipedia bằng tiếng Việt} +\end{itemize} +\item Tiếng Anh: +\begin{itemize} +\item \href{http://tug.org}{TUG} +\item \href{http://en.wikipedia.org/wiki/TeX}{Äịnh nghÄ©a \<TEX> tại +wikipedia bằng tiếng Anh} +\end{itemize} +\end{enumerate} + +Còn nếu bạn Ä‘ang tìm câu trả lá»i cho má»™t vấn Ä‘á» trong \<TEX> nhÆ°ng không +liên quan đến tiếng Việt (và dụ là m sao để gõ má»™t công thức hay chèn má»™t +hình ảnh và o văn bản) thì bạn có thể tìm hiểu tại các diá»…n Ä‘Ã n hay +Ä‘á»c các tà i liệu trong mục \hyperlink{tro-giup}{Tà i liệu}. + +Gói \<VNTEX> chứa các thà nh phần sau: +\begin{itemize} +\item các font tiếng Việt, +\item há»— trợ tiếng Việt cho \<LATEX> (input encoding + font encoding) +\item má»™t số (Ãt) tà i liệu và và dụ, cùng vá»›i các mẫu font há»— trợ tiếng +Việt +\end{itemize} + +\<VNTEX> được xây dá»±ng tuân theo các qui Æ°á»›c chung của cá»™ng đồng ngÆ°á»i dùng +\<TEX>. Việc nà y nhằm hạn chế bá»›t các xung Ä‘á»™t có thể xảy ra khi dùng +\<VNTEX> vá»›i các ngôn ngữ hay các gói khác, cÅ©ng nhÆ° giúp việc tÃch hợp +\<VNTEX> và o các hệ thống \<TEX> thuáºn lợi hÆ¡n. + +\<VNTEX> đã được tÃch hợp và o má»™t số hệ thống \<TEX> thông dụng nhÆ° +\<TEXLIVE>, \<TETEX> và \<MIKTEX>. + +\subsection{Tóm tắt lịch sá» phát triển} +\begin{itemize} +\item 01/2000 -- phát hà nh phiên bản đầu tiên của \<VNTEX> (chÆ°a được đánh số). +Phiên bản nà y chÆ°a có các font \<T1>. + +\item 08/2002 -- phát hà nh phiên bản 1.2 của \<VNTEX>. Bản nà y đã chứa dạng +\<T1> của các font \<VNR> (được tạo ra tá»± Ä‘á»™ng bằng \<TEXTRACE>, chất lượng +tạm dùng được). Các font \<PS> thông dụng cÅ©ng được há»— trợ tiếng Việt qua +cÆ¡ chế ``virtual font'' (dấu khá xấu do dùng các ký tá»± có sẵn để vẽ). + +\item 03/2003 -- phát hà nh phiên bản 2.0 của \<VNTEX>. Phiên bản nà y đã +chứa định dạng \<T1> của các font \<VNR>, dá»±a trên các font \<T1> \<CMR> do +\<BLUESKY> thá»±c hiện. Các font \<URWVN> cÅ©ng được phát hà nh trong phiên bản +nà y. Chi tiết vá» việc tạo ra các font nà y có thể xem tại +\href{http://www.tug.org/TUGboat/Articles/tb24-1/thanh.pdf}{đây}. Phiên bản +\<VNTEX> nà y sau đó đã được Ä‘Æ°a và o \<TETEX>, \<MIKTEX> và \<TEXLIVE>. + +\item 09/2005 -- phát hà nh phiên bản 3.02 của \<VNTEX>. +\end{itemize} + +\subsection{Tác giả} +Phần lá»›n \<VNTEX> do \<THANH> viết, phần há»— trợ cho \<LATEX> do Werner +Lemberg viết. Ngoà i ra còn có sá»± đóng góp của nhiá»u ngÆ°á»i khác (xin xem +tiếp ở mục sau). + +\subsection{Những ngÆ°á»i tham gia đóng góp cho \<VNTEX>} +Những ngÆ°á»i trong danh sách dÆ°á»›i đây (theo thứ tá»± ABC) đã tham gia đóng +góp cho sá»± phát triển của \<VNTEX> dÆ°á»›i các hình thức khác nhau: + +Huỳnh Kỳ Anh, +Nguyá»…n Äại Quý, +Nguyá»…n Phi Hùng, +Nguyá»…n Tân Khoa, +Reinhard Kotucha, +Thái Phú Khánh Hòa, +Ulrich Dirr, +Vladimir Volovich. + +Nếu bạn thấy cần thêm ai và o danh sách nà y xin vui lòng góp ý +cho chúng tôi. + +\subsection{Quản lý} +Hiện nay gói \<VNTEX> do \<THANH>, Werner Lemberg và Reinhard Kotucha quản +lý. + +\subsection{Giấy phép và bản quyá»n} +Các font \<URWVN> và Bitstream được phân phối theo giấy phép +\<GPL>, các thứ còn lại theo giấy phép \<LPPL> ($\ge$\,1.3). + +Vui lòng xem \href{http://www.gnu.org/licenses/gpl.txt}{\<GPL>} và +\href{http://www.latex-project.org/lppl.txt}{\<LPPL>} nếu cần biết thêm chi tiết. + +\subsection{Vá» trang web nà y} +Trang web nà y do \<THANH> và \<THAIHOA> xây dá»±ng và quản lý, cùng vá»›i +sá»± đóng góp của Tôn Nữ Thục Anh. Riêng phần +\href{http://vntex.sf.net/download}{download} do Reinhard Kotucha quản +lý. Má»i ý kiến đóng góp xin gởi đến |hanthethanh| hoặc |h2vnteam| tại +|gmail| chấm |com|. + +\section{Cà i đặt và cáºp nháºt} +\subsection{Cà i đặt} +Phiên bản chÃnh thức má»›i nhất của \<VNTEX> được công bố tại +\href{http://vntex.sf.net/download/vntex}{đây}, có hÆ°á»›ng dẫn cà i đặt kèm theo. Tuy nhiên +bạn nên kiểm tra kỹ xem hệ thống \<TEX> bạn Ä‘ang sá» dụng đã có sẵn +\<VNTEX> chÆ°a. Nếu bạn dùng \<UNIX> thì nên dùng \<TEXLIVE> +($\ge$\,2005), còn nếu dùng \<WINDOWS> thì nên dùng \<MIKTEX> +($\ge$\,2.5). Là m nhÆ° váºy bạn sẽ có sẵn \<VNTEX> mà không cần phải tá»± +cà i đặt. LÆ°u ý là bản \<VNTEX> có trong \<TETEX>-3.0 có má»™t số trục +trặc khi dùng mã \<UTF8>; nếu bạn dùng \<TETEX> thì nên tá»± cà i đặt +thêm \<VNTEX> phiên bản $\ge$\,3.02, hoặc chuyển sang dùng \<TEXLIVE>. + +Ngoà i ra, để sá» dụng được \<VNTEX> bạn cần phải có má»™t trình soạn thảo để +gõ và hiển thị được tiếng Việt. Việc cà i đặt những thứ nà y phụ thuá»™c và o +từng hệ thống nên chúng tôi không mô tả chi tiết ở đây được. Chúng tôi chỉ +có và i gợi ý cho ngÆ°á»i má»›i là m quen: +\begin{itemize} +\item Nếu bạn dùng \<WINDOWS>, hãy chá»n: +\begin{itemize} +\item hệ thống \<TEX>: \<MIKTEX> +\item bá»™ gõ tiếng Việt: \<UNIKEY> +\item trình soạn thảo: \<TEXMAKER> hoặc \<WINSHELL> +\end{itemize} + +\item Nếu bạn dùng \<UNIX>, hãy chá»n: +\begin{itemize} +\item hệ thống \<TEX>: \<TEXLIVE> +\item bá»™ gõ tiếng Việt: \<XUNIKEY> hoặc \<XVNKB> +\item trình soạn thảo: \<TEXMAKER> hoặc \<KILE> +\end{itemize} +\end{itemize} + +HÆ°á»›ng dẫn cà i đặt \<VNTEX> cụ thể cho từng hệ thống hiện chÆ°a có. Nếu bạn +biết có tà i liệu nà o viết vá» vấn Ä‘á» nà y, hoặc bạn muốn viết hÆ°á»›ng dẫn cà i +đặt \<VNTEX> cho 1 hệ thống cụ thể, xin vui lòng liên hệ vá»›i chúng tôi. + +\subsection{Cáºp nháºt} +\hypertarget{cap-nhat}{} +Äây là nÆ¡i công bố các gói sá»a lá»—i cho bản \<VNTEX> đã chÃnh thức công bố, +hoặc những thà nh phần má»›i của \<VNTEX> chÆ°a được tÃch hợp và o bản chÃnh +thức. Những thứ công bố ở đây sẽ được Ä‘Æ°a và o phiên bản \<VNTEX> kế tiếp. + +\begin{description} +\item[Bản sá»a lá»—i cho các táºp \<FD> của bá»™ font \<VNR>:] + \hypertarget{cap-nhat-vnr-fd}{} sá»a má»™t số lá»—i trong các táºp \<FD> + của font \<VNR>. Tải gói + \href{http://vntex.sf.net/download/vntex-updates/vntex-update-20060603.zip}{nà y} + vá», sau đó bung nén và ghi đè các táºp nà y lên các táºp \<FD> của + \<VNTEX>. +\end{description} + + +\section{Tà i liệu} +\hypertarget{tai-lieu}{} +Äây là nÆ¡i thu tháºp các tà i liệu tiếng Việt vá» \<TEX> và các chủ Ä‘á» liên +quan. Äang được cáºp nháºt và sắp xếp dần. + +\subsection{Tà i liệu viết cho \<VNTEX>} +\hypertarget{tai-lieu-vntex}{} +Bao gồm các tà i liệu vá» các chủ Ä‘á» liên quan trá»±c tiếp đến \<VNTEX>. +\begin{description} +\item [HÆ°á»›ng dẫn sá» dụng font vá»›i \<VNTEX>:] +Tà i liệu hÆ°á»›ng dẫn sá» dụng font vá»›i \<VNTEX> do \<THANH> và \<THAIHOA> +viết. Xem: +\href{http://vntex.sf.net/doc/vn-fonts.html}{\<HTML>}, +\href{http://vntex.sf.net/doc/vn-fonts.pdf}{\<PDF>}, +\href{http://vntex.sf.net/doc/vn-fonts-src.zip}{\<SRC>}. + +\item [Dịch ``Free Math Font Survey'' vá»›i \<MIKTEX>:] +Tà i liệu mô tả các bÆ°á»›c cần thiết để dịch bản tiếng Việt của tà i liệu +\href{http://www.tug.org/tex-archive/info/Free_Math_Font_Survey/survey.html} +{Free Math Font Survey} vá»›i \<MIKTEX>-2.5. Xem: +\href{http://vntex.sf.net/doc/survey-vn-miktex.html}{\<HTML>}, +\href{http://vntex.sf.net/doc/survey-vn-miktex.pdf}{\<PDF>}. +\end{description} + + +\subsection{Tà i liệu viết cho \<LATEX>} +Bao gồm các tà i liệu được viết cho \<LATEX> và các vấn Ä‘á» liên quan, được +dịch từ tiếng Anh. + +\subsubsection{Các tà i liệu hÆ°á»›ng dẫn sá» dụng \<LATEX>} +\begin{description} +\item[Giá»›i thiệu ngắn vá» \<LATEX>2e:] +Tà i liệu ``Giá»›i thiệu ngắn vá» \<LATEX>2e'' (A not so short +introduction to \<LATEX>) của Tobias Oetiker +do Nguyá»…n Tân Khoa dịch. Tải vá»: +\href{http://vntex.sf.net/doc/lshort-vn.pdf}{\<PDF>}, +\href{http://vntex.sf.net/doc/lshort-vn-src.zip}{\<SRC>}. + +\item[Giáo trình \<LATEX>:] +Tà i liệu ``Giáo trình \<LATEX>'' (A course of \<LATEX>) của Gary +L.~Gray do Nguyá»…n Phi Hùng dịch. Tải vá»: +\href{http://vntex.sf.net/doc/latex-course-vn.pdf}{\<PDF>}, +\href{http://vntex.sf.net/doc/latex-course-vn-src.zip}{\<SRC>}. + +\item[HÆ°á»›ng dẫn viết luáºn án bằng \<LATEX>:] +Tà i liệu hÆ°á»›ng dẫn thiết kế luáºn án tốt nghiệp bằng \<LATEX> được biên soạn bởi by +Dr.~Nicola Talbot và do \<THAIHOA> dịch. Có thể tải vá» từ +\href{http://theoval.cmp.uea.ac.uk/~nlct/latex/thesis_viet/index.html}{đây}. +\end{description} + +% \subsubsection{Các tà i liệu hÆ°á»›ng dẫn sá» dụng font vá»›i \<LATEX>2e} +% \begin{description} +% \item[ +% \end{description} + +\subsection{Tà i liệu cho má»™t số công cụ liên quan} +\begin{description} +\item[HÆ°á»›ng dẫn sá» dụng \<TEXMAKER>] +\<TEXMAKER> là má»™t chÆ°Æ¡ng trình soạn thảo \<TEX> chạy trên \<UNIX>/\<LINUX> +và \<WINDOWS>, há»— trợ \<UNICODE> và thÃch hợp vá»›i ngÆ°á»i dùng má»›i bắt đầu. HÆ°á»›ng dẫn +sá» dụng \<TEXMAKER> do \<THAIHOA> dịch. Tải vá»: +\href{http://vntex.sf.net/doc/texmaker-vn.pdf}{\<PDF>}. + +\item[HÆ°á»›ng dẫn sá» dụng \<LATEXPIX>] +\<LATEXPIX> má»™t công cụ dùng để vẽ hình cho \<LATEX>. Phần má»m nà y +thÃch hợp cho những ai má»›i bắt đầu vá»›i \<LATEX>. +Tà i liệu hÆ°á»›ng dẫn sá» dụng do \<THAIHOA> dịch. Tải vá»: +\href{http://vntex.sf.net/doc/LaTeXPiX-vn.pdf}{\<PDF>}, hoặc bản \<PDF> +\href{http://members.home.nl/nickvanbeurden/LaTeXPiX_vietnamese.pdf}{gốc}. +\end{description} + + +\section{Vấn Ä‘á» liên quan} +\hypertarget{van-de-lien-quan}{} +\subsection{Sá» dụng tiếng Việt vá»›i \<CONTEXT>} +\<CONTEXT> đã há»— trợ tiếng Việt. Xem +\href{http://forum.vnoss.org/viewtopic.php?id=506}{tại đây} để biết thêm chi tiết + +\hypertarget{more-extsizes}{} +\subsection{Sá» dụng gói \texttt{extsizes} vá»›i \<VNTEX>} +Äể sá» dụng gói |extsizes| vá»›i \<VNTEX>, trÆ°á»›c tiên cần phải cáºp nháºt các +táºp \<FD> cho các font \<VNR>. Xem thêm +\href{http://vntex.sf.net/download/vntex-updates}{chi tiết}. + +Äể sá» dụng được gói |extsizes| vá»›i các cỡ chữ khác nhÆ° 13pt và 13.5pt, +tải và cà i đặt gói +\href{http://vntex.sf.net/download/vntex-support/more-extsizes.zip}{more-extsizes} +do \<THAIHOA> viết. Và dụ: + +\begin{verbatim} +\documentclass[13pt]{extarticle} +\usepackage[utf8]{vietnam} +\usepackage{type1cm} + +\begin{document} +Văn bản nà y dùng cỡ chữ 13pt. +\end{document} +\end{verbatim} + +LÆ°u ý \emph{phải} dùng gói |type1cm| nếu văn bản có chứa các công thức +toán. + +Các cỡ chữ được gói |more-extsizes| há»— trợ thêm: 13, 13p5, 15 và 16. + +\hypertarget{makeindex-vn}{} +\subsection{Sá» dụng \<MAKEINDEX> vá»›i \<VNTEX>} +\<MAKEINDEX> là má»™t chÆ°Æ¡ng trình sắp xếp chỉ mục cho +\<LATEX>. \<MAKEINDEX> không há»— trợ tiếng Việt nên để dùng +\<MAKEINDEX> vá»›i \<VNTEX> ta cần má»™t chút ``mẹo''. + +Nếu bạn dùng \<UNIX>/\<LINUX>, hãy tải gói +\href{http://vntex.sf.net/download/vntex-support/makeindex-vn.zip}{makeindex-vn + cho \<UNIX>/\<LINUX>}. NgÆ°á»i dùng \<WINDOWS> có thể sá» dụng gói +\href{http://vntex.sf.net/download/vntex-support/vnindexwin.zip}{makeindex-vn + cho \<WINDOWS>} Sau khi tải vá» hãy bung nén và xem hÆ°á»›ng dẫn Ä‘i kèm +để biết cách sá» dụng. + +Các ký tá»± Việt được sắp xếp theo qui tắc mô tả tại +\href{http://www.vietlex.com/vietnamese/quytacABC.html}{đây}. + +% HÆ°á»›ng dẫn chi tiết cho \<WINDOWS> hiện chÆ°a có. Nếu bạn muốn viết phần nà y +% chúng tôi rất hoan nghênh. + +\subsection{Chuyển đổi từ \<LATEX> sang \<HTML>} +TrÆ°á»›c đây \<VNTEX> có chứa há»— trợ cho \<TEX4HT>, sau đó các há»— trợ nà y đã +được Ä‘Æ°a và o bản phân phối chÃnh thức của \<TEX4HT> nên đã được xóa khá»i +\<VNTEX>. + +Äể chuyển từ \<LATEX> sang \<HTML> bạn có thể dùng lệnh sau: +\begin{verbatim} +htlatex filename.tex "html,uni-html4,charset=utf-8" " -cunihtf -utf8" +\end{verbatim} + +Bạn phải có bản \<TEX4HT> tÆ°Æ¡ng đối má»›i, Ãt nhất là nhÆ° bản \<TEX4HT> trong +\<TEXLIVE>2005. File \<LATEX> có thể dùng má»™t trong các bảng mã mà +\<VNTEX> há»— trợ (và dụ \<VISCII> hay \<UTF8>). \<TEX4HT> sẽ tá»± Ä‘á»™ng ghi kết +quả dÆ°á»›i mã \<UTF8>. + +Trang web nà y cÅ©ng được viết bằng \<LATEX> và chuyển sang \<HTML> bằng +\<TEX4HT>. + +\hypertarget{bookmark-vn}{} +\subsection{Bookmark cho \<PDF> và tiếng Việt} +Gói |hyperref| cho phép tạo \<UNICODE> bookmark cho \<PDF>, tuy nhiên má»™t +số ký tá»± Việt chÆ°a được há»— trợ. Äể khắc phục ta là m nhÆ° sau: +\begin{itemize} +\item tải vá» gói + \href{http://vntex.sf.net/download/vntex-support/puenc-vn.zip}{puenc-vn} + +\item bung nén và chép táºp |puenc.def| đè lên táºp |puenc.def| của + |hyperref| (hoặc bạn có thể chép táºp nà y và o thÆ° mục chứa văn bản + của bạn) + +\item dùng gói |hyperref| trong văn bản \<LATEX> của bạn theo và dụ sau: + +\begin{verbatim} +\documentclass{article} +\usepackage[unicode]{hyperref} +\usepackage[utf8]{vietnam} +\begin{document} +\section{Tiếng Việt} +\end{document} +\end{verbatim} + +(lÆ°u ý để bookmark hiển thị đúng bạn phải dịch văn bản \<LATEX> của bạn Ãt +nhất là 2 lần) +\end{itemize} + +\<UNICODE> bookmark không ``portable'' -- bạn phải dùng \<AR> phiên +bản $\ge$\,5.0 má»›i xem được đầy đủ các ký tá»±. + +Nếu bạn không dùng \<UNICODE> bookmark thì \<PDF> của bạn sẽ portable hÆ¡n +và bookmark sẽ hiển thị tốt vá»›i Ä‘a số trình duyệt \<PDF>. Tuy nhiên má»™t +số ký tá»± Việt không được há»— trợ trong bảng mã dùng cho \<PDF> bookmark +(PD1), do đó các ký tá»± nà y sẽ bị mất khi tạo bookmark. Bạn có thể hạn chế Ä‘iá»u +nà y bằng cách thay thế các ký tá»± Việt bằng các ký tá»± ``gần giống'' trong +bảng mã PD1 (và dụ `ắ' sẽ được thay thế bằng `á') theo cách sau: + +\begin{verbatim} +\documentclass{article} +\usepackage{hyperref} +\usepackage[utf8]{vietnam} +\input{pd1supp.def} +\begin{document} +\section{Tiếng Việt} +\end{document} +\end{verbatim} + +\hypertarget{cmap-vn}{} +\subsection{Tạo ``searchable'' \<PDF> vá»›i tiếng Việt} +Äể có thể tìm kiếm hay cắt/dán tiếng Việt vá»›i các file \<PDF>, bạn có thể +dùng gói |cmap| của Vladimir Volovich nhÆ° sau: + +\begin{verbatim} +\documentclass{article} +\usepackage{cmap} +\usepackage[utf8]{vietnam} +\begin{document} +Tiếng Việt +\end{document} +\end{verbatim} + +LÆ°u ý phải nạp (load) gói |cmap| trÆ°á»›c khi nạp các gói khác. Nếu bạn quên +Ä‘iá»u nà y thì |cmap| sẽ ghi ra má»™t số cảnh báo (warning) và file \<PDF> của +bạn có thể sẽ không ``searchable'' (không thể tìm kiếm hoặc cắt/dán). + +Má»™t số hạn chế: gói |cmap| chỉ dùng vá»›i \<PDFTEX> và không có tác dụng đối +vá»›i ``virtual font''. Äiá»u nà y có nghÄ©a là bạn phải dùng \<PDFTEX> để dịch +văn bản, và các Ä‘oạn text dùng font smallcap (chá»n bằng lệnh |\textsc|) sẽ +không searchable. + +\section{Trợ giúp} +\hypertarget{tro-giup}{} +DÆ°á»›i đây là má»™t số địa chỉ bạn có thể tham khảo khi gặp má»™t vấn +Ä‘á» nà o đó vá»›i \<VNTEX> (để nhanh chóng có được câu trả lá»i, xin vui lòng +dà nh Ãt phút để Ä‘á»c tà i liệu +\href{http://forum.vnoss.org/pub/smart-question-vi.html}{Cách đặt má»™t câu +há»i thông minh} nếu bạn chÆ°a Ä‘á»c). + +\begin{itemize} +\item \<VNOSS> có diá»…n dà n dà nh cho +\href{http://forum.vnoss.org/viewforum.php?id=10}{\<TEX>/\<LATEX>}. Ở đây +bạn có thể há»i vá» \<VNTEX>, \<CONTEXT> và các vấn Ä‘á» liên quan đến tiếng +Việt trong \<TEX>. + +\item Trang web \href{http://viettug.org/}{ViệtTUG} do Huỳnh Kỳ Anh quản +lý, chứa nhiá»u thông tin hữu Ãch cho ngÆ°á»i muốn há»c sá» dụng \<LATEX>. + +\item Mailing list của \<VNTEX> có tại +\href{http://lists.sourceforge.net/lists/listinfo/vntex-users}{đây} +\end{itemize} + + +\end{document} diff --git a/Master/texmf-dist/source/generic/vntex/doc/vntex-print.tex b/Master/texmf-dist/source/generic/vntex/doc/vntex-print.tex new file mode 100755 index 00000000000..3d06beb6864 --- /dev/null +++ b/Master/texmf-dist/source/generic/vntex/doc/vntex-print.tex @@ -0,0 +1,4 @@ +\RequirePackage[monochrome,dvipsnames]{color} +\def\printversion{} +\input{vntex.tex} + diff --git a/Master/texmf-dist/source/generic/vntex/doc/vntex.tex b/Master/texmf-dist/source/generic/vntex/doc/vntex.tex new file mode 100755 index 00000000000..5d3bd1e68ba --- /dev/null +++ b/Master/texmf-dist/source/generic/vntex/doc/vntex.tex @@ -0,0 +1,853 @@ +% vntex-@VERSION@ +% +% Copyright 2003-2005 Han The Thanh <HanTheThanh@gmail.com>. +% +% Authors: Han The Thanh <HanTheThanh@gmx.net> and +% Reinhard Kotucha <Reinhard.Kotucha@web.de> +% +% This file is part of vntex. +% +% 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 +% +% http://www.latex-project.org/lppl.txt +% +% The current maintainers are Werner Lemberg, Han The Thanh, and +% Reinhard Kotucha. + +\documentclass[a4paper,11pt]{article} +% \InputIfFileExists{vntexdoc-conf.tex}{}{} +% \makeatletter +% \@ifundefined{vntexdoc-amsldoc-vi} +% {\message{***undef***}} +% {\message{***def***}} +% \stop + +\usepackage{amsmath,amsfonts,amssymb} +\usepackage[utf8]{inputenc} +\usepackage[T1,T2A,T5]{fontenc} +\usepackage[russian,vietnam]{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{fancyvrb}\DefineShortVerb{\|} +%\usepackage{showframe} +%\usepackage{mparhack} + +\RequirePackage[dvipsnames]{color} + +\newif\ifprint +\ifdefined\printversion + \printtrue +\else + \printfalse +\fi + +\def\arraystretch{1.25} + +\raggedbottom + +\def\vi#1{\foreignlanguage{vietnam}{#1}} + +\makeatletter +\let\ifundefined\@ifundefined + +\renewcommand\@seccntformat[1]{\llap{\@nameuse{the#1}\hspace{1em}}} + +\renewcommand\section{\@startsection {section}{1}{\z@}% + {-3.5ex \@plus -1ex \@minus -.2ex}% + {0.3ex \@plus.2ex}% + {\normalfont\Large\bfseries + \rightskip\z@ plus3em + \spaceskip.3333em + \xspaceskip.5em\color[named]{BrickRed}}} + +\renewcommand\subsection{\@startsection{subsection}{2}{\z@}% + {.25ex\@plus -1ex \@minus -.2ex}% + {0.2ex \@plus .2ex}% + {\normalfont\large\bfseries + \rightskip\z@ plus3em + \spaceskip.3333em + \xspaceskip.5em\color[named]{BrickRed}}} + +\renewcommand\subsubsection{\@startsection{subsubsection}{3}{\z@}% + {1.25ex\@plus -1ex \@minus -.2ex}% + {0.1ex}% + {\normalfont\normalsize\bfseries + \rightskip\z@ plus2em + \spaceskip.3333em + \xspaceskip.5em + \color[named]{BrickRed}}} + +\renewcommand\paragraph{\@startsection{paragraph}{4}{\z@}% + {\parskip}% + {-1em}% + {\normalfont\normalsize\bfseries\color[named]{BrickRed}}} +\renewcommand\subparagraph{\@startsection{subparagraph}{5}{\parindent}% + {\parskip}% + {-1em}% + {\normalfont\normalsize\bfseries\color[named]{BrickRed}}} +\makeatother + + + +%%% Colors + +\definecolor{labelitemicolor}{rgb}{0,.5,0} +\definecolor{labelitemiicolor}{rgb}{.75,0,0} +\definecolor{labelitemiiicolor}{rgb}{0,0,.6} + +\def\labelitemi{\color{labelitemicolor}{$\blacktriangleright$}} +\def\labelitemii{\color{labelitemiicolor}{{\large$\bullet$}}} +\def\labelitemiii{\color{labelitemiiicolor} + {{\raisebox{.3ex}{\mbox{\scriptsize$\blacksquare$}}}}} + +\def\bibcolor#1{{\color[named]{MidnightBlue}#1}} +%\def\bibcolor#1{{\color[cmyk]{.8,.8,0,.4}#1}} + +\def\headcolor#1{{\color[named]{BrickRed}#1}} + +\def\hrefcolor#1{{\color[named]{Fuchsia}#1}} +%\def\hrefcolor#1{{\color[cmyk]{.3,1,0,.6}#1}} +\def\xbibcolor#1{{\color[named]{Fuchsia}#1}} +%\def\xbibcolor#1{{\color[cmyk]{.3,1,0,.6}#1}} + +%\def\codecolor{\color[named]{OliveGreen}} +\def\codecolor{\color[cmyk]{.65,0,.65,.7}} + +\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}}}} + +\def\indenturl{\leavevmode\texttt{\phantom{xx}}} +\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}}} + +%%% 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\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}}} +\def\xbibfilenoauthor#1#2{\href{http://#1}{\xbibcolor{#2}}} + +\def\extbibfile#1#2#3{\textit{#1}, #2,\\\href{http://#3}{\fontfamily{cmvtt}\selectfont{\xbibcolor{http://#3}}}} + +\def\xbibfileprint#1{\hspace{\fill}\ifx\printversion\undefined\href{http://#1}{[\bibcolor{print~version}]}\fi} + +%%%\reversemarginpar + +\makeatletter +\let\docpath\@namedef +%\InputIfFileExists{vntexdoc-conf.tex}{}{} + +\makeatletter +\let\docpath\@nameuse +\makeatother + +%%% Verbatim + +\newenvironment{code}{\codecolor}{} +\newenvironment{verbcode}{\codecolor\begin{verbatim}}{\end{verbatim}} +\def\code{\ifvmode~~~\fi\codecolor} %%% \setbox0 \wd0 + +\CustomVerbatimEnvironment{Code}{Verbatim} + {commandchars=\|\(\),formatcom=\codecolor} +\def\texcomment#1{\textrm{\textcolor{black}{#1}}} +\def\sometext#1{\textcolor{black}{\textrm + {$\langle$\ldots\textit{#1}\ldots$\rangle$}}} + +\AtBeginDocument{\def\abstractname{\headcolor{\textbf{\normalsize + Abstract}}}} + +\advance\oddsidemargin by -.5cm +%\advance\marginparwidth 1cm +\evensidemargin=\oddsidemargin +\advance\textwidth by 2cm +\advance\topmargin by -2cm +\advance\textheight by 4cm +\advance\textheight by 2pt + +\usepackage[colorlinks, urlcolor=black, filecolor=black]{hyperref} +\hypersetup{pdfnewwindow=true} +\begin{document} +%\vrule +%\vspace*{0cm} +\leavevmode{\centering\Huge\textbf{\headcolor{Vn\TeX\ --- Typesetting + Vietnamese}}\par} +\vspace{3mm} +{\centering\Large Hà n Thế Thà nh~~~~Reinhard Kotucha\par} +\vspace{1cm} + +\begin{abstract} +\parskip=1ex \parindent=0pt \noindent +Vn\TeX\ is an extension to Donald Knuth's \TeX\ typesetting system which +provides support for typesetting Vietnamese. + +The primary site of Vn\TeX\ is {\normalsize\http{vntex.sf.net}}. +\end{abstract} + +\section{Where to get Help} +The current maintainers of Vn\TeX\ are: +\begin{itemize} +\item Hà n Thế Thà nh \mailto{HanTheThanh@gmail.com} +\item Reinhard Kotucha \mailto{Reinhard.Kotucha@web.de} +\item Werner Lemberg \mailto{WL@gnu.org} +\end{itemize} + +There is a mailing list (very low traffic) for questions about +Vn\TeX\ and typesetting Vietnamese. To subscribe to the list, visit + +\http{lists.sourceforge.net/lists/listinfo/vntex-users} + +\section{Related Documents} +The following files are part of the Vn\TeX\ +distribution\ifx\printversion\undefined\footnote{The print versions + should be used with monochrome printers. A print version of this + file is \href{vntex-print.pdf}{\bibcolor{here}}.}\fi +\begin{itemize} +%\href{}{\bibcolor{here}}} +%%%%\item \href{file:vntex-man.pdf}{VnTeX Manual} +\item \bibfile{Hà n Thế Thà nh}{vntex-man.pdf}{Há»— trợ tiếng Việt cho \TeX} + \ifx\printversion\undefined\bibfileprint{vntex-man-print.pdf}\fi +\item \bibfile{Hà n Thế Thà nh} {vn-min.pdf}{Minimal steps to typeset + Vietnamese} \bibfileprint{vn-min-print.pdf} +\item \bibfile{Hà n Thế Thà nh và Thái Phú Khánh Hòa} {vn-fonts.pdf} + {Dùng font vá»›i Vn\TeX} \bibfileprint{vn-fonts-print.pdf} +\end{itemize} +The following files are not part of Vn\TeX\ but might be part of the +\TeX\ distribution you are using. +% \begin{itemize} +% \item \ifundefined{vntexdoc-amsldoc-vi} +% {\xbibfile{The American Mathematical Society}{\CTANbase/amslatex/vietnamese/amsldoc-vi.pdf} +% {HÆ°á»›ng dẫn sá» dụng gói \pkg{amsmath}}.} +% {\bibfile{The American Mathematical Society}{\docpath{vntexdoc-amsldoc-vi}}{HÆ°á»›ng dẫn sá» dụng gói +% \pkg{amsmath}}} +% Translated by Huỳnh Kỳ Anh. +% \ifundefined{vntexdoc-amsldoc-vi} +% {\xbibfileprint{\CTANbase/amslatex/vietnamese/amsldoc-print-vi.pdf}} +% {\bibfileprint{\docpath{vntexdoc-amsldoc-print-vi}}} +% \item \ifundefined{vntexdoc-lshort-vi} +% {\xbibfile{H.~Partl, E.~Schlegl, I.~Hyna, T.~Oetiker} +% {\CTANbase/lshort/vietnamese/lshort-vi.pdf}{Má»™t tà i liệu ngắn gá»n +% giá»›i thiệu vá» \LaTeXe}.} +% {\bibfile{H.~Partl, E.~Schlegl, I.~Hyna, T.~Oetiker} +% {\docpath{vnzexdoc-lshort-vi}} {Má»™t tà i liệu ngắn gá»n +% giá»›i thiệu vá» \LaTeXe}.} +% Translated by Nguyá»…n Tân Khoa. + +% \item \bibfile{Wolfgang May, Andreas +% Schlechte}{\texmfdocvi/ntheorem-vn/ntheorem-doc-vn.pdf} {Mở rá»™ng +% môi trÆ°á»ng định lý}. Translated by Huỳnh Kỳ Anh. +%\end{itemize} + +\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} + +\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} + +\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} +\end{itemize} + + +\section{Typesetting Vietnamese} + +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. + +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 +understand letters, they only understand numbers. The table which +assigns letters to numbers is called \emph{input encoding}. + +\marginnote{input encoding}A popular input encoding system used in +Vietnam is VISCII. The problem is that only 256 characters can be +used at the same time. It's sufficient for typesetting Vietnamese, +however, it's not well suited for multilingual texts. A better +approach had been provided by the Unicode Consortium: UTF-8. This is +a very efficient encoding system which supports all writing systems of +the world. You can have Vietnamese, Arabic, Korean, Ethiopian, +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). + +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. + +\marginnote{font encoding}There is a similar issue with fonts. A font +is a collection of \emph{glyphs}. A glyph is the graphical +representation of a character. Graphical representations of the +character \texttt{a} might be `a', `\textit{a}', or `\textbf{a}', for +example. Fonts never contain characters; they contain only glyphs, +sometimes more than a single glyph for a given character. A font +usually contains more than 256 glyphs, but \TeX\ can only access 256 +characters at the same time. The table which maps characters to glyphs +is called a \emph{font encoding}. + +However, if you are using \LaTeX, a name is assigned to each character +read from the keyboard. This way it can deal with an arbitrary number +of characters internally. You can specify more than one font encoding +and \LaTeX\ switches between them automatically. In most cases it's +sufficient to know that font encoding |T1| supports Western European +languages and |T5| supports Vientamese. + +\marginnote{input method}But how to enter all the characters if you +have only an American keyboard? You have to select an \emph{input + method}. An input method allows you to access characters which are +not supported by your keyboard. If you select VIQR as an input +method, you can write ``\verb/Ha` No^.i/'' on your keyboard but you +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. + +\marginnote{editors}It's not easy to propose a particular editor. If +you are using a reasonably powerful editor for writing your own +programs, then use it for \TeX\ too. + +Editors which are supposed to work on all operating systems are +\xbibfilenoauthor{www.vim.org}{\pkg{vim}}, +\xbibfilenoauthor{gnu.org/software/emacs}{\pkg{Emacs}}, +\xbibfilenoauthor{www.xm1math.net/texmaker}{\pkg{\TeX{}Maker}}, and +\xbibfilenoauthor{tug.org/texworks}{\pkg{\TeX{}works}}. +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}}. + +If you are on Mac\,OS\,X, +\xbibfilenoauthor{www.uoregon.edu/~koch/texshop}{\pkg{\TeX{}shop}} is +a good choice. \pkg{\TeX{}shop} is aimed at beginners but it is +extremely powerful though. It provides a very fast PDF viewer and if +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. + + +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} + +The idea of \LaTeX\ is to treat content and layout separately. If you +never used \LaTeX\ before, please read {\xbibfilenoauthor + {\CTANbase/lshort/vietnamese/lshort-vi.pdf}{Má»™t tà i liệu ngắn gá»n + giá»›i thiệu vá» \LaTeXe}} first. + +\subsubsection{Using \pkg{vietnam} or \pkg{vntex}} + +There are two packages, \pkg{vietnam} and \pkg{vntex}. They are quite +similar, the only difference is that the default input encoding is VISCII +in \pkg{vietnam} and UTF-8 in \pkg{vntex}. However, both packages +allow you to specify any supported input encoding. The following +encoding systems are supported: + +\begin{tabular}{ll}\hline + \code{|viscii|} & use VISCII input encoding\\ + \code{|mviscii|} & use MVISCII input encoding\\ + \code{|tcvn|} & use TCVN input encoding\\ + \code{|vps|} & use VPS input encoding\\ + \code{|utf8|} & use UTF-8 input encoding (\LaTeX)\\ + \code{|utf8x|} & use UTF-8 input encoding (ucs package)\\ + \code{|noinputenc|} & do not load the inputenc package (use of TCX is assumed)\\\hline +\end{tabular} + +Examples: %\par\kern -2pt % avoid and unpleasant page break +\begin{Code} + \documentclass{report} + \usepackage{vietnam} % |texcomment(use VISCII input encoding) + \begin{document} + |sometext(text in VISCII encoding) + \end{document} +\end{Code} + +\begin{Code} + \documentclass{report} + \usepackage{vntex} % |texcomment(use UTF-8 input encoding) + \begin{document} + |sometext(text in UTF-8 encoding) + \end{document} +\end{Code} + +\begin{Code} + \documentclass{report} + \usepackage[tcvn]{vntex} % |texcomment(use TCVN input encoding) + \begin{document} + |sometext(text in TCVN encoding) + \end{document} +\end{Code} + + +Both packages, \pkg{vietnam} and \pkg{vntex}, have the following +additional options: + +\begin{tabular}{ll}\hline + \code{|nocaptions|} & do not define Vietnamese captions\\ + \code{|varioref|} & load the \pkg{varioref-vi} package\\ + \code{|cmap|} & load the \pkg{cmap} package\\\hline +\end{tabular} + +If the option {\code|nocaptions|} is set, then captions +are typeset in English. On the other hand, if you are using the +\pkg{varioref} package, you might want to set +the {\code|varioref|} option in order to get +``\h{\ohorn} trang li\`\ecircumflex{}n sau'' instead of ``on the +following page'', for example. + +The \pkg{cmap} packages makes the PDF file searchable. + +\newpage +\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 +preferred encoding for multilingual documents. + +\begin{Code} + \documentclass{report} + \usepackage[T2A,T5]{fontenc} + \usepackage[utf8]{inputenc} + \usepackage[russian,vietnam]{babel} + \begin{document} + Tiếng Việt, + \selectlanguage{russian}% + |selectlanguage(russian)руÑÑкий Ñзык, + \selectlanguage{vietnam}% + |selectlanguage(vietnam)tiếng Việt. + \end{document} +\end{Code} + +Note that last optional argument passed to \pkg{babel} is the language +which is active at the beginning of your document. + +The result of the example above is:~~ +{\fboxsep5pt + \fbox{\fontfamily{lmr}\large + Tiếng Việt, + \selectlanguage{russian}% + руÑÑкий Ñзык, + \selectlanguage{vietnam}% + tiếng Việt.}} + +\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 +chacters in hexadecimal notation, like |^^DF|. But there is an +extension called \pkg{TCX}. If you activate \pkg{TCX}, a translation +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. + +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} + \begin{document} + |sometext(text in VISCII encoding) + \end{document} +\end{Code} + +The very first line says that the option {\code|-translate-file=viscii-t5|} +is passed to \TeX\ when compiling the document. It has the same effect +as if you run + + {\code|latex -translate-file=viscii-t5 foo.tex|} + +on the command line. Using TCVN is similar. + +%\newpage + +\subsubsection{Creating HTML from \LaTeX\ sources} + +In order to create HTML documents from La\TeX\ sources, run + + {\code|tex4ht "html,uni-html4,charset=utf8"|} \textit{yourfile.tex} + +on the command line. You can't use \pkg{TCX} with \pkg{tex4ht}. + +\subsection{Typesetting with plain TeX} + +Unfortunately, there is no package for UTF-8 input encoding in plain +TeX yet. + +\subsubsection{\pkg{plainenc} and \pkg{plnfss}} + +\pkg{plnfss} provides a \LaTeX-like interface for font selection. + +\begin{Code} + \input t5code + \input plnfss + \input plainenc + \fontencoding{T5} + \inputencoding{viscii} % |texcomment(or any other encoding mentioned) + % |texcomment(above except |texttt(utf8)) + \setfontencoding{T5} + \selectfont + |sometext(text in VISCII encoding) + \bye +\end{Code} + +\pkg{plainenc} and \pkg{plnfss} are not part of the Vn\TeX\ +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 + +\http{vntex.sf.net/download/vntex-support/plnfss.zip} + +\subsubsection{Using \pkg{TCX}} + +\pkg{TCX} files can be used as described in the \LaTeX\ section. + +\begin{Code} + %& -translate-file=viscii-t5 + \input t5code + \input plnfss + \setfontencoding{T5} + \selectfont + |sometext(text in VISCII encoding) + \bye +\end{Code} + +\subsection{Using \pkg{texinfo}} +TCX is required: +\begin{Code} + %& -translate-file=viscii-t5 + \def\fontprefix{vn} + \input t5code.tex + \input texinfo + |sometext(text in VISCII encoding) +\end{Code} + +There are some test files for Vn\TeX\ in |texmf*/source/latex/vntex/tests/|. +Please read the file \pkg{README} in this directory. + + +\section{Vietnamese Fonts} + +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. + +\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: + +\indenturl\http{vntex.sourceforge.net/download/vntex/vntex-nonfree.zip}\\ +\indenturl\http{vntex.sourceforge.net/download/vntex/vntex-nonfree.tar.bz2} + +If you are using \pkg{TeX Live}, intallation is very simple. Just run + +{\code|getnonfreefonts --help|} + +on the command line in order to get more information. + +\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. + + \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. + +\marginnote{font samples}There are sample files for 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. + +\http{vntex.sf.net/fonts/samples} + +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} + +\subsection{Selecting Fonts in \LaTeX} + +We describe how to use fonts with \LaTeX\ first. A description of +\pkg{plnfss} (plain TeX) is given below. + +To use Latin Modern instead of VNR, simply +\begin{Code} + \usepackage{lmodern} + \usepackage[viscii]{vietnam} +\end{Code} + +For Antikwa Toru\'nska, do +\begin{Code} + \usepackage{anttor} + \usepackage[viscii]{vietnam} +\end{Code} + +\ldots or use \pkg{inputenc} and \pkg{babel} instead of \pkg{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 a good choice. + +\begin{tabular}{lll}\hline +Command & PostScript Name & Font Family Name\\\hline +{\code|\renewcommand\sfdefault{uag}|} & |VnURWGothicL| & AvantGarde\\ +{\code|\renewcommand\rmdefault{ubk}|} & |VnURWBookmanL| & Bookman\\ +{\code|\renewcommand\ttdefault{ucr}|} & |VnNimbusMonL| & Courier\\ +{\code|\renewcommand\sfdefault{uhv}|} & |VnNimbusSanL| & Helvetica\\ +{\code|\renewcommand\rmdefault{unc}|} & |VnCenturySchL| & New Century Schoolbook\\ +{\code|\usepackage{mathpazo}|} & |VnURWPalladioL| & Palatino\\ +{\code|\usepackage{mathptm}|} & |VnNimbusRomNo9L| & Times\\\hline +\end{tabular} + +\marginnote{small caps}There is also a real small caps font for +|VnURWPalladioL|, made by Ralf Stubner and extended by Hà n Thế Thà nh. +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 them, put the following macro definition +into the preamble of your document: + +{\code|\newcommand{\textfplsc}[1]{\bgroup\usefont{T5}{fpl}{m}{sc}#1\egroup}|} + +You can use it like this: + + {\code||\sometext{some text} + \code|\textfplsc{|\sometext{some text in small caps}\code|}| + \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. + +\marginnote{math fonts}If you have to typeset math formulas, be aware +that not all fonts support math. The following fonts support math +very well: + +\begin{tabular}{ll}\hline + Font & Command \\\hline + Computer Modern & do nothing \\ + Latin Modern & {\code|\usepackage{lmodern}|} \\ + Palatino & {\code|\usepackage{mathpazo}|} \\ + Times & {\code|\usepackage{mathptm}|} \\\hline +\end{tabular} + +There are many others too, please consult: + + \http{ctan.org/tex-archive/info/Free\_Math\_Font\_Survey/vn/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 + with the base font you are using. Be very careful when using + \textsf{sans-serif} fonts in math formulas. It's very + painful if there is no significant difference between ``\textsf{l}'' + and ``\textsf{I}''. Do you see any difference at all? The first + one is a lowercase ``\texttt{L}'', the second one is an uppercase + ``\texttt{i}''. + + +\clearpage + +\marginnote{MS core fonts}If you are using Windows, you also can use +the fonts provided by Microsoft: + +\begin{tabular}{lll}\hline +Command & PostScript Name & Font Family Name\\\hline + {\code|\renewcommand\sfdefault{ma1}|} & |ArialMT| & Arial \\ + {\code|\renewcommand\ttdefault{mcr}|} & |CourierNewPSMT| & Courier \\ + {\code|\renewcommand\rmdefault{lpr}|} & |PalatinoLinotype| & Palatino \\ + {\code|\renewcommand\rmdefault{mns}|} & |TimesNewRomanPSMT| & Times New Roman \\ + {\code|\renewcommand\sfdefault{jth}|} & |Tahoma| & Tahoma \\ + {\code|\renewcommand\sfdefault{jvn}|} & |Verdana| & Verdana \\\hline +\end{tabular} + +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/fonts/samples} + +Unless someone insists that you use these fonts, you can use + +\begin{tabular}{lll}\hline + |VnNimbusMonL| & instead of |CourierNewPSMT| & Courier\\ + |VnNimbusSanL| & instead of |ArialMT| & Helvetica/Arial\\ + |VnNimbusRomNo9L| & instead of |TimesNewRomanPSMT| & Times/Times New Roman\\ + |VnURWPalladioL| & instead of |PalatinoLinotype| & Palatino\\\hline +\end{tabular} + + +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} + +you have to select fonts like this: +\begin{Code} + \setrmdefault{...} + \setsfdefault{...} + \setttdefault{...} +\end{Code} + +See the \pkg{plnfss} documentation for more details. + +\section{Licenses} + +The URW and Bitstream Type1 fonts are copyrighted under the GNU GPL, +\texttt{.map} files are public domain, \pkg{varioref-vi.sty} is under +LGPL, \pkg{Vntopia} is under the Adobe/TUG Utopia license agreement, +all other files are under LPPL, version 1.3 or newer. + +\begin{itemize} +\item \http{www.gnu.org/licenses/gpl.txt} +\item \http{www.gnu.org/licenses/lgpl.txt} +\item \http{www.latex-project.org/lppl.txt} +\item \http{tug.org/fonts/utopia/LICENSE-utopia.txt} +\end{itemize} +\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. + +\pkg{plnfss} had been removed from Vn\TeX\ because it supports many other +languages as well. You can download it from + + \http{ctan.tug.org/tex-archive/macros/plain/plnfss} + + +\section{Known Problems} + +\begin{itemize} +\item In order to use \pkg{amsart.cls} (and other AMS La\TeX\ document + classes) with Unicode you must add the following lines immediately + before {\code|\begin{document}|}: +\begin{Code} + \def\firstofone#1{#1} + \let\uppercase\firstofone + \let\MakeUppercase\firstofone +\end{Code} + +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} + + \item If 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{itemize} + +\end{document} +__ +Everything below the line above is ignored. + +Local Variables: +coding: utf-8 +End: + +%%% initemxf --edit-config-file updmap + |