diff options
author | Karl Berry <karl@freefriends.org> | 2008-07-31 00:32:53 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2008-07-31 00:32:53 +0000 |
commit | 3ebec47ec1910a7135f38c5f31b996882af238e4 (patch) | |
tree | e720f68daa2693630a8fe76a75bcdcb92a40333f /Master/texmf-dist/doc/xelatex/polyglossia/polyglossia.tex | |
parent | 0afeedcaa724ef694a1e475f019ddb0472184acc (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.tex | 55 |
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)} |