summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/xelatex/polyglossia/polyglossia.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2008-07-31 00:32:53 +0000
committerKarl Berry <karl@freefriends.org>2008-07-31 00:32:53 +0000
commit3ebec47ec1910a7135f38c5f31b996882af238e4 (patch)
treee720f68daa2693630a8fe76a75bcdcb92a40333f /Master/texmf-dist/doc/xelatex/polyglossia/polyglossia.tex
parent0afeedcaa724ef694a1e475f019ddb0472184acc (diff)
polyglossia update (30jul08)
git-svn-id: svn://tug.org/texlive/trunk@9918 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/xelatex/polyglossia/polyglossia.tex')
-rw-r--r--Master/texmf-dist/doc/xelatex/polyglossia/polyglossia.tex55
1 files changed, 49 insertions, 6 deletions
diff --git a/Master/texmf-dist/doc/xelatex/polyglossia/polyglossia.tex b/Master/texmf-dist/doc/xelatex/polyglossia/polyglossia.tex
index 0d7b7666648..b541c11b4eb 100644
--- a/Master/texmf-dist/doc/xelatex/polyglossia/polyglossia.tex
+++ b/Master/texmf-dist/doc/xelatex/polyglossia/polyglossia.tex
@@ -185,7 +185,8 @@ that are explained in section \ref{specific} below.
\begin{table}[h]\centering
\label{tab:lang}
\begin{tabular}{lllll}\hline
-albanian & czech & \TR{german} & \TR{magyar}& slovak \\
+albanian & croatian & galician & \TR{lsorbian} &\TR{serbian} \\
+amharic\footnotemark & czech & \TR{german} & \TR{magyar}& slovak \\
\TR{arabic}& danish & \TR{greek} & norsk & slovenian\\
bahasai & divehi & \TR{hebrew} & nynorsk & spanish \\
bahasam & dutch & hindi & polish & swedish \\
@@ -195,11 +196,12 @@ breton & estonian & irish &\TR{russian}& turkish \\
bulgarian&\TR{farsi} & italian & samin & ukrainian \\
catalan & finnish & latin & sanskrit &\TR{usorbian} \\
coptic & french & latvian & scottish & welsh \\
-croatian & galician & \TR{lsorbian} &\TR{serbian}& \\
\hline
\end{tabular}
\caption{Languages currently supported in \pkg{polyglossia}}
\end{table}
+\footnotetext{ New in version 1.0.1. This should be considered an experimental attempt to
+port the package \pkg{ethiop}. Feedbacks are welcome.}
Some options are convenient shortcuts for loading languages with
specific options:
@@ -220,6 +222,9 @@ Another option (turned off by default) is ‘nolocalmarks’, which
prevents the redefinition of the internal \LaTeX\ macros
\cmd\markboth\ and \cmd\markright.
+There is also the option ‘quiet’ which turns off most info messages and some of the warnings
+issued by \LaTeX, \pkg{fontspec} and \pkg{polyglossia}.
+
\section{Language-switching commands}
Whenever a language definition file \file{gloss-⟨lang⟩.ldf} is loaded,
@@ -300,11 +305,32 @@ defined there are also accessible.\footnote{ %
to experiment with it, rename it into \file{hyphen.cfg}, copy it to
\texttt{…/tex/xelatex/polyglossia/} and rebuild the xelatex format.}
+
+\section{Font setup}
+
+With polyglossia it is possible to associate a specific font with any script or language
+that occurs in the document. That font should always be defined as
+\cmd\⟨script⟩font\ or \cmd\⟨language⟩font.
+For instance, if the default roman font defined by \cmd\setromanfont\
+does not support Greek, then one can define the font used to display Greek with:\\
+\centerline{ \cmd\newfontfamily\cmd{\greekfont[⟨options⟩]\{⟨font⟩\}}. }
+See the \pkg{fontspec} documentation for more information.
+
+Whenever a new language is activated, \pkg{polyglossia} will first check whether
+a font has been defined for that language or – for languages in non-Latin scripts –
+for the script it uses. If it is not defined, it will use the currently active font
+and will attempt to turn on the appropriate OpenType tags for the script
+and language used, in case these are available in the font, by means of \pkg{fontspec}’s
+\cmd\addfontfeature. If the current font does not appear to support the script
+of that language, an error message is displayed.
+
\section{Language-specific options and commands}\label{specific}
This section gives a list of all languages for which options and end-user commands are defined.
The default value of each option is given in italic.
+%\subsection{amharic}
+
\subsection{arabic}
\textbf{Options}:
\begin{itemize}
@@ -327,7 +353,7 @@ The default value of each option is given in italic.
\subsection{english}
\textbf{Options}:
\begin{itemize}
- \item \TB{variant} = \textit{american} (= us), british (= uk), australian or newzealand
+ \item \TB{variant} = \textit{american} (= us), usmax (same as ‘american’ but with additional hyphenation patterns), british (= uk), australian or newzealand
\item \TB{ordinalmonthday} = true/\textit{false} (true by default only when variant = british)
\end{itemize}
@@ -352,7 +378,13 @@ The default value of each option is given in italic.
\subsection{german}
\textbf{Options}:
\begin{itemize}
- \item \TB{spelling} = \textit{new} or old
+ \item \TB{spelling} = \textit{new} (= 1996) or old (= 1901):
+ indicates whether hyphenation patterns for traditional (1901) or reformed
+ (1996) orthography should be used. The latter is the default.
+ \item \TB{latesthyphen} = \textit{false} or true: if this option is set to true,
+ the latest (experimental) hyphenation patterns ‘(n)german-x-latest’
+ will be loaded instead of ‘german’ or ‘ngerman’. NB: This is based on
+ the file \texttt{language.dat} that comes with \TeX Live 2008.
\end{itemize}
\subsection{greek}
@@ -413,8 +445,9 @@ The default value of each option is given in italic.
\subsection{syriac}
\textbf{Options}:
\begin{itemize}
- \item \TB{numerals} = \textit{western} (i.e., 1234567890) or eastern
- (for which the Oriental Arabic numerals are used: \textarabic{١٢٣٤٥٦٧٨٩٠}).
+ \item \TB{numerals} = \textit{western} (i.e., 1234567890), eastern
+ (for which the Oriental Arabic numerals are used: \textarabic{١٢٣٤٥٦٧٨٩٠}),
+ or abjad (new in version 1.0.1).
\end{itemize}
\textbf{Commands}:
\begin{itemize}
@@ -460,6 +493,16 @@ Support is also provided for Syriac abjad numerals, which can be generated
with \Cmd\abjadsyriac.
Example: ¦\abjadsyriac{463}¦ yields {\syriacfont\abjadsyriac{463}}.
+\section{Mappings for Arabic, Farsi and Thai numerals}
+
+Three fontmappings are provided with polyglossia to allow the automatic
+conversion of the standard Western numerals (0123456789) in their Arabic,
+Farsi, or Thai forms. To activate them, one should use the fontspec option
+Mapping=arabicdigits (or farsidigits or thaidigits).
+For instance if \cmd\syriacfont\ is defined with the option ¦Mapping=arabicdigits¦,
+then by typing ¦\textsyriac{2008}¦ one obtains \textsyriac{٢٠٠٨}.
+
+
\section{Calendars}
\subsection{Hebrew calendar (hebrewcal.sty)}