summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/xelatex/polyglossia
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
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')
-rw-r--r--Master/texmf-dist/doc/xelatex/polyglossia/README19
-rw-r--r--Master/texmf-dist/doc/xelatex/polyglossia/examples.pdfbin121286 -> 147321 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/polyglossia/examples.tex18
-rw-r--r--Master/texmf-dist/doc/xelatex/polyglossia/polyglossia.pdfbin164988 -> 176539 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/polyglossia/polyglossia.tex55
5 files changed, 75 insertions, 17 deletions
diff --git a/Master/texmf-dist/doc/xelatex/polyglossia/README b/Master/texmf-dist/doc/xelatex/polyglossia/README
index a9e6f0f2302..31c2bddbadd 100644
--- a/Master/texmf-dist/doc/xelatex/polyglossia/README
+++ b/Master/texmf-dist/doc/xelatex/polyglossia/README
@@ -1,14 +1,14 @@
¦----------------------------------------------¦
¦ ¦
- ¦ THE POLYGLOSSIA PACKAGE v1.0 ¦
+ ¦ THE POLYGLOSSIA PACKAGE v1.0.1 ¦
¦ ¦
¦ Modern multilingual typesetting with XeLaTeX ¦
¦ ¦
¦----------------------------------------------¦
This package for provides a complete Babel replacement for users of XeLaTeX.
-The initial version includes support for 54 different languages.
+This version includes support for 55 different languages.
Polyglossia makes it possible to automate the following tasks:
@@ -23,7 +23,7 @@ Polyglossia makes it possible to automate the following tasks:
* Adapting the formatting of dates (for non-gregorian calendars via external
packages bundled with polyglossia: currently the hebrew, islamic and farsi
calendars are supported).
-* For languages that have their own numeration system, modifyinf the formatting
+* For languages that have their own numeration system, modifying the formatting
of numbers appropriately.
* Ensuring the proper directionality if the document contains languages
written from right to left (via the package bidi, available separately).
@@ -41,6 +41,19 @@ Alternatively if you have the file polyglossia.ins run
xetex polyglossia.ins
and follow the instructions displayed.
+CHANGES
+
+1.0.1
+ * Improved documentation (added sections on font setup and numeration mappings)
+ * Improvements and bugfixes for English and German
+ * Bugfix in gloss-syriac.ldf (spurious space after \textsyriac{...})
+ * Extended the scope of \syriacabjad
+ * Added gloss-amharic.ldf (ported from ethiop.ldf in the package ethiop)
+
+1.0
+ * Initial release on CTAN
+
+
------------------------------
François Charette, July 2008
<firmicus ατ gmx δοτ net>
diff --git a/Master/texmf-dist/doc/xelatex/polyglossia/examples.pdf b/Master/texmf-dist/doc/xelatex/polyglossia/examples.pdf
index 345d0426fb2..1a7e6a1ad6d 100644
--- a/Master/texmf-dist/doc/xelatex/polyglossia/examples.pdf
+++ b/Master/texmf-dist/doc/xelatex/polyglossia/examples.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/polyglossia/examples.tex b/Master/texmf-dist/doc/xelatex/polyglossia/examples.tex
index dca35f8da87..129f05bd1e9 100644
--- a/Master/texmf-dist/doc/xelatex/polyglossia/examples.tex
+++ b/Master/texmf-dist/doc/xelatex/polyglossia/examples.tex
@@ -1,17 +1,12 @@
\documentclass[a4paper]{article}
\usepackage[no-math]{fontspec}
-% makes fontspec very quiet!
-%\makeatletter
-%\renewcommand\zf@PackageWarning[1]{\relax}
-%\renewcommand\zf@PackageInfo[1]{\relax}%
-%\makeatother
\usepackage{xltxtra,url}
-\usepackage[quiet]{polyglossia}
+\usepackage{polyglossia}
\setdefaultlanguage{french}
\setotherlanguage[variant=british,ordinalmonthday=false]{english}
\setotherlanguage[variant=poly]{greek}
\setotherlanguage[numerals=thai]{thai}
-\setotherlanguages{german,latin,russian,turkish,polish,latvian,sanskrit,ukrainian,arabic,farsi,syriac,divehi,hebrew}
+\setotherlanguages{german,latin,russian,turkish,polish,latvian,sanskrit,ukrainian,arabic,farsi,syriac,divehi,hebrew,amharic,tigriya}
\setromanfont{Linux Libertine}
\defaultfontfeatures{Scale=MatchLowercase,RawFeature={+locl}}
\setmonofont{Inconsolata}
@@ -23,6 +18,7 @@
\newfontfamily\sanskritfont[Script=Devanagari]{Sanskrit 2003}
\newfontfamily\thaifont[ExternalLocation="/mnt/data/fonts/thai/",Script=Thai]{Norasi.ttf}%{Arial Unicode MS}
\newfontfamily\thaanafont[Script=Thaana,WordSpace=2]{TITUS Cyberbit Basic}
+\newfontfamily\ethiopicfont[Script=Ethiopic]{Abyssinica SIL}
\parskip 1.33\baselineskip
\newcommand\showhyphmin{\fbox{\the\lefthyphenmin\ \the\righthyphenmin}}
\begin{document}
@@ -36,7 +32,7 @@
(\today)
\end{english}
-\begin{german}
+\begin{german}[spelling=new,latesthyphen=true]
\textbf{Die deutsche Sprache}\footnote{ From \url{http://de.wikipedia.org/wiki/Deutsche_Sprache}} (auch das Deutsche) gehört zum westlichen Zweig der germanischen Sprachen und ist eine der meistgesprochenen europäischen Sprachen weltweit, und gilt so als Weltsprache.\\
(\today)
\end{german}
@@ -132,4 +128,10 @@ Quamquam sermone nativo fungi desinit, cumque nostris diebus perpauci Latine loq
%\fontspec[Script=Georgian]{DejaVu Serif}
%ქართული ენა არის საქართველოს სახელმწიფო ენა (აფხაზეთის ავტონომიურ რესპ\-უბლიკაში მის პარალელურად სახელმწიფო ენად აღიარებულია აგრეთვე აფხაზური ენა). ქართულ ენაზე 7 მილიონზე მეტი ადამიანი ლაპარაკობს.
%
+
+\begin{amharic}
+\textbf{አማርኛ} የኢትዮጵያ መደበኛ ቋንቋ ነው። ከሴማዊ ቋንቋዎች እንደ ዕብራይስጥ ወይም ዓረብኛ አንዱ ነው። እንዲያውም 27 ሚሊዮን ያህል ተናጋሪዎች እያሉት፣ አማርኛ ከአረብኛ ቀጥሎ ትልቁ ሴማዊ ቋንቋ ነው። የሚጻፈውም በግዕዝ ፊደል ነው። አማርኛ ክዓረብኛና ከዕብራይስጥ ያለው መሰረታዊ ልዩነት አንደላቲን ከግራ ወደ ቀኝ መጻፉ ነው። \\
+(\today)
+\end{amharic}
+
\end{document}
diff --git a/Master/texmf-dist/doc/xelatex/polyglossia/polyglossia.pdf b/Master/texmf-dist/doc/xelatex/polyglossia/polyglossia.pdf
index 078817148c7..be87abfa8a4 100644
--- a/Master/texmf-dist/doc/xelatex/polyglossia/polyglossia.pdf
+++ b/Master/texmf-dist/doc/xelatex/polyglossia/polyglossia.pdf
Binary files differ
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)}