summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2022-11-29 21:10:53 +0000
committerKarl Berry <karl@freefriends.org>2022-11-29 21:10:53 +0000
commit0113d35094ec2b9667d9ed9a9d1d1cc45337d67d (patch)
tree0193419adf227972bb4acc157eacfb9ded4463cb /Master/texmf-dist/doc/latex
parent8bcb0bdbed8e8df6a76b01d3adf580afb27c1a76 (diff)
polyglossia (29nov22)
git-svn-id: svn://tug.org/texlive/trunk@65144 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r--Master/texmf-dist/doc/latex/polyglossia/README.md4
-rw-r--r--Master/texmf-dist/doc/latex/polyglossia/example-arabic.pdfbin70945 -> 71145 bytes
-rw-r--r--Master/texmf-dist/doc/latex/polyglossia/example-chinese.pdfbin0 -> 42484 bytes
-rw-r--r--Master/texmf-dist/doc/latex/polyglossia/example-chinese.tex61
-rw-r--r--Master/texmf-dist/doc/latex/polyglossia/example-japanese.pdfbin0 -> 22842 bytes
-rw-r--r--Master/texmf-dist/doc/latex/polyglossia/example-japanese.tex33
-rw-r--r--Master/texmf-dist/doc/latex/polyglossia/example-korean.pdfbin20154 -> 20189 bytes
-rw-r--r--Master/texmf-dist/doc/latex/polyglossia/example-thai.pdfbin13490 -> 13710 bytes
-rw-r--r--Master/texmf-dist/doc/latex/polyglossia/examples.pdfbin148339 -> 148718 bytes
-rw-r--r--Master/texmf-dist/doc/latex/polyglossia/polyglossia.pdfbin354667 -> 352430 bytes
-rw-r--r--Master/texmf-dist/doc/latex/polyglossia/polyglossia.tex537
11 files changed, 403 insertions, 232 deletions
diff --git a/Master/texmf-dist/doc/latex/polyglossia/README.md b/Master/texmf-dist/doc/latex/polyglossia/README.md
index a1535f3c206..42a811d93a3 100644
--- a/Master/texmf-dist/doc/latex/polyglossia/README.md
+++ b/Master/texmf-dist/doc/latex/polyglossia/README.md
@@ -1,8 +1,8 @@
-# THE POLYGLOSSIA PACKAGE v1.58
+# THE POLYGLOSSIA PACKAGE v1.59
## Multilingual typesetting with XeLaTeX and LuaLaTeX
This package provides an alternative to Babel for users of XeLaTeX and LuaLaTeX.
-This version includes support for over 70 different languages, some of which in
+This version includes support for over 80 different languages, some of which in
different regional or national varieties, or using a different writing system.
Polyglossia makes it possible to automate the following tasks:
diff --git a/Master/texmf-dist/doc/latex/polyglossia/example-arabic.pdf b/Master/texmf-dist/doc/latex/polyglossia/example-arabic.pdf
index 13b4ef59d18..00a647cefe8 100644
--- a/Master/texmf-dist/doc/latex/polyglossia/example-arabic.pdf
+++ b/Master/texmf-dist/doc/latex/polyglossia/example-arabic.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/polyglossia/example-chinese.pdf b/Master/texmf-dist/doc/latex/polyglossia/example-chinese.pdf
new file mode 100644
index 00000000000..f46817a3c7c
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/polyglossia/example-chinese.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/polyglossia/example-chinese.tex b/Master/texmf-dist/doc/latex/polyglossia/example-chinese.tex
new file mode 100644
index 00000000000..57b6e4ba1b0
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/polyglossia/example-chinese.tex
@@ -0,0 +1,61 @@
+\documentclass{article}
+\usepackage{fontspec}
+\usepackage{polyglossia}
+\setdefaultlanguage{chinese}
+\setotherlanguage{english}
+% Package noto, notoCJKsc
+\setmainfont{Noto Serif CJK SC}[Script=CJK]
+\newfontfamily\chinesefont{Noto Serif CJK SC}[Script=CJK]
+% Package arphic-ttf
+%\setmainfont{bkai00mp.ttf}[Script=CJK]% ZenKai-Medium
+%\setmainfont{bsmi00lp.ttf}[Script=CJK]% ShanHeiSun-Light
+%\setmainfont{gbsn00lp.ttf}[Script=CJK]% BousungEG-Light-GB
+%\setmainfont{gkai00mp.ttf}[Script=CJK]% GBZenKai-Medium
+\begin{document}
+\XeTeXlinebreaklocale "zh"
+\XeTeXlinebreakskip=0em plus 0.1em minus 0.01em
+\parindent0em
+
+\begin{center}
+ \abstractname
+\end{center}
+\begin{english}
+All human beings are born free and equal in dignity and rights.
+They are endowed with reason and conscience and should act towards one another in a spirit of brotherhood.
+\footnote{%
+ This is a footnote.}
+
+This is today: \today
+\end{english}
+
+\section{第一条 (简体中文, Simplified Chinese)}
+
+人人生而自由、在尊严和权利上一律平等。他们赋有理性和良心、并应以兄弟关系的精神相对待。
+
+\today
+
+localnumeral: \localnumeral{1863}, chinesenumeral: \chinesenumeral{1863}
+
+\renewfontfamily\chinesefont{Noto Serif CJK TC}[Script=CJK]
+\begin{chinese}[variant=traditional,numerals=chinese]
+
+\section{第一條 (繁體中文, Traditional Chinese)}
+
+人人生而自由、在尊嚴和權利上一律平等。他們賦有理性和良心、並應以兄弟關係的精神相對待。
+
+\today
+
+localnumeral: \localnumeral{1863}, chinesenumeral: \chinesenumeral{1863}
+
+\end{chinese}
+
+\section{numeral}
+\begin{english}
+
+numerals=arabic: \textchinese[numerals=arabic]{\localnumeral{1863}, \chinesenumeral{1863}}
+
+numerals=chinese: \textchinese[numerals=chinese]{\localnumeral{1863}, \chinesenumeral{1863}}
+
+\end{english}
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/polyglossia/example-japanese.pdf b/Master/texmf-dist/doc/latex/polyglossia/example-japanese.pdf
new file mode 100644
index 00000000000..92e7734be42
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/polyglossia/example-japanese.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/polyglossia/example-japanese.tex b/Master/texmf-dist/doc/latex/polyglossia/example-japanese.tex
new file mode 100644
index 00000000000..e446d245d96
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/polyglossia/example-japanese.tex
@@ -0,0 +1,33 @@
+\documentclass{article}
+\usepackage{fontspec}
+\usepackage{polyglossia}
+\setdefaultlanguage{japanese}
+\setotherlanguage{english}
+\setmainfont{Noto Serif CJK JP}[Script=CJK]
+\newfontfamily\japanesefont{Noto Serif CJK JP}[Script=CJK]
+\begin{document}
+\XeTeXlinebreaklocale "ja"
+\XeTeXlinebreakskip=0em plus 0.1em minus 0.01em
+\parindent0em
+
+\begin{center}
+ \abstractname
+\end{center}
+\begin{english}
+All human beings are born free and equal in dignity and rights.
+They are endowed with reason and conscience and should act towards one another in a spirit of brotherhood.
+\footnote{%
+ This is a footnote.}
+
+This is today: \today
+\end{english}
+
+\section{第一条}
+
+すべての人間は、生まれながらにして自由であり、かつ、尊厳と権利とについて平等である。人間は、理性と良心とを授けられており、互いに同胞の精神をもって行動しなければならない。
+
+\today
+
+localnumeral: \localnumeral{1863}
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/polyglossia/example-korean.pdf b/Master/texmf-dist/doc/latex/polyglossia/example-korean.pdf
index 2060dcbf8a5..a32a5520665 100644
--- a/Master/texmf-dist/doc/latex/polyglossia/example-korean.pdf
+++ b/Master/texmf-dist/doc/latex/polyglossia/example-korean.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/polyglossia/example-thai.pdf b/Master/texmf-dist/doc/latex/polyglossia/example-thai.pdf
index a8bc7e0d746..9f8677a27d1 100644
--- a/Master/texmf-dist/doc/latex/polyglossia/example-thai.pdf
+++ b/Master/texmf-dist/doc/latex/polyglossia/example-thai.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/polyglossia/examples.pdf b/Master/texmf-dist/doc/latex/polyglossia/examples.pdf
index 03f86c5f8ef..1e6c5a9a0d5 100644
--- a/Master/texmf-dist/doc/latex/polyglossia/examples.pdf
+++ b/Master/texmf-dist/doc/latex/polyglossia/examples.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/polyglossia/polyglossia.pdf b/Master/texmf-dist/doc/latex/polyglossia/polyglossia.pdf
index 7aa9a9dd175..e953bfc7aa6 100644
--- a/Master/texmf-dist/doc/latex/polyglossia/polyglossia.pdf
+++ b/Master/texmf-dist/doc/latex/polyglossia/polyglossia.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/polyglossia/polyglossia.tex b/Master/texmf-dist/doc/latex/polyglossia/polyglossia.tex
index 4db00f29b33..eaad6bbccfd 100644
--- a/Master/texmf-dist/doc/latex/polyglossia/polyglossia.tex
+++ b/Master/texmf-dist/doc/latex/polyglossia/polyglossia.tex
@@ -21,14 +21,25 @@
pdfauthor={F Charette, A Reutenauer, B Roucariès, J Spitzmüller},
pdfkeywords={xetex, xelatex, luatex, lualatex, multilingual, babel, hyphenation}
]{hyperref}
+\usepackage{array}
\usepackage{metalogo}
\let\XeTeX\undefined
\let\XeLaTeX\undefined
\usepackage[babelshorthands]{polyglossia}
\usepackage{farsical}
+%
+% Languages we need in the documentation. See below for fonts
\setmainlanguage[variant=british,ordinalmonthday=false]{english}
-\setotherlanguages{arabic,armenian,hebrew,syriac,greek,russian,serbian,catalan,georgian}
-\usepackage[protrusion]{microtype}
+\setotherlanguages{arabic,armenian,hebrew,syriac,greek,russian,serbian,catalan,georgian,chinese}
+\usepackage[protrusion,nopatch=footnote]{microtype}
+\renewcommand\MacroFont{\footnotesize\color{xpgblue}\ttfamily}
+% Customizable version of \DescribeMacro (e.g. if macro is too long)
+\newcommand*\DescribeMacroCust[2]{%
+ \let\origMacroFont\MacroFont%
+ \renewcommand\MacroFont{\footnotesize\color{xpgblue}\ttfamily#1}%
+ \DescribeMacro{#2}%
+ \let\MacroFont\origMacroFont%
+}
\newcommand*\Cmd[1]{\cmd{#1}\DescribeMacro{#1}\xspace}
\newcommand*\pkg[1]{\textsf{\color{xpgblue}#1}}
\newcommand*\file[1]{\texttt{\color{xpgblue}#1}}
@@ -46,7 +57,9 @@
\def\Ie{\textit{I.e.,}\xspace}
\def\etc{\@ifnextchar.{\textit{etc}}{\textit{etc.}\@\xspace}}
+%
%% Commands for documenting options
+%
\newcommand*\xpgoption[1]{\textcolor{xpgblue}{\ttfamily\bfseries #1}}
\newcommand*\xpgvalue[1]{\texttt{#1}}
\newcommand*\xpgpresetvalue[1]{\texttt{\textit{#1}}}
@@ -101,15 +114,34 @@
\vskip 0pt plus #1\pagebreak[3]\vskip 0pt plus -#1\relax}
\pretocmd{\subsection}{\condbreak{2\baselineskip}}{}{}
+%
+% Fonts
+% We try to use fonts that are shipped with TeXLive
+% (see #478)
+%
%% fontspec declarations:
-\setmainfont{Linux Libertine O}[Numbers=OldStyle]
-\setsansfont{Linux Biolinum O}
-\setmonofont[Scale=MatchLowercase]{DejaVu Sans Mono}
-\newfontfamily\arabicfont[Script=Arabic]{Amiri}
-\newfontfamily\armenianfont[Script=Armenian]{DejaVu Sans}
+% Main font: Package libertine (Linux Libertine and Biolinum Mono)
+\usepackage[osf]{libertine}
+% Monospace: Package dejavu-otf
+\setmonofont[Scale=MatchLowercase]{DejaVuSansMono}
+% Libertine includes Hebrew, but we load it separately since
+% osf is not supported with this script and we want to avoid the
+% respective warnings
+\newfontfamily\hebrewfont[Script=Hebrew]{Linux Libertine O}
+% Package dejavu-otf
+\newfontfamily\armenianfont[Script=Armenian,Scale=MatchLowercase]{DejaVuSans}
+\newfontfamily\georgianfont[Scale=MatchLowercase]{DejaVuSerif}
+% Package amiri
+\newfontfamily\arabicfont[Script=Arabic]{Amiri-Regular}
+% No Syriac otf/ttf font seems available on CTAN
+% This one, from the Syriac Institute, is included on Linux
+% in the x11-fonts set and can be downloaded from
+% https://bethmardutho.org/meltho/ (Meltho Fonts Package)
\newfontfamily\syriacfont[Script=Syriac]{Serto Jerusalem}
-\newfontfamily\hebrewfont[Script=Hebrew]{Ezra SIL}
-\newfontfamily\georgianfont{DejaVu Serif}
+% Our decorative title: package gfscomplutum
+\newfontfamily\xpgtitlefont[Scale=1.4, LetterSpace=30]{GFSPolyglot.otf}
+% Package noto, notoCJKsc
+\newfontfamily\chinesefont{Noto Serif CJK SC}[Script=CJK]
\linespread{1.05}
\frenchspacing
@@ -124,7 +156,7 @@
\hyphenation{Kha-li-ghi Reu-ten-auer new-zea-land}
\GetFileInfo{polyglossia.sty}
-\title{\textcolor{lightblue}{\Huge\fontspec[LetterSpace=40]{GFS Ambrosia} Πολυγλωσσια}
+\title{{\textgreek{\xpgtitlefont\color{lightblue}\MakeUppercase{Πολυγλωσσία}}}
\\[16pt]
\color{xpgblue}Polyglossia: Modern multilingual typesetting with \XeLaTeX\ and \LuaLaTeX}
\author{\TA{François Charette} \and \TA{Arthur Reutenauer}\thanks{Current maintainer}
@@ -222,29 +254,29 @@ that are explained in section \ref{specific} below.
\begin{table}[ht]\centering
\caption{\label{tab:lang}Languages currently supported in \pkg{polyglossia}}
-% Produced with tools/insert-language-list.rb -- JS, 2019-11-01
-% Edited by hand -- JS, 2019-11-01
+% Produced with tools/insert-language-list.rb -- JS, 2022-11-23
+% Edited by hand -- JS, 2022-11-23
\begin{tabular}{lllll}
-\toprule
-\TX{afrikaans} & danish & \TX{hungarian} & \TX{marathi} & \TX{slovenian} \\
-albanian & divehi & icelandic & \TX{mongolian} & \TX{sorbian} \\
-amharic & \TX{dutch} & interlingua & nko & \TX{spanish} \\
-\TX{arabic} & \TX{english} & \TX{italian} & \TX{norwegian} & swedish \\
-\TX{armenian} & \TX{esperanto} & japanese & occitan & \TX{syriac} \\
-asturian & estonian & kannada & \TX{persian} & tamil \\
-basque & \TX{finnish} & khmer & piedmontese & telugu \\
-\TX{belarusian} & \TX{french} & \TX{korean} & \TX{polish} & \TX{thai} \\
-\TX{bengali} & friulian & \TX{kurdish} & \TX{portuguese} & \TX{tibetan} \\
-bosnian & \TX{gaelic} & \TX{lao} & romanian & turkish \\
-breton & galician & \TX{latin} & romansh & turkmen \\
-bulgarian & \TX{georgian} & latvian & \TX{russian} & \TX{ukrainian} \\
-\TX{catalan} & \TX{german} & lithuanian & \TX{sami} & urdu \\
-coptic & \TX{greek} & macedonian & \TX{sanskrit} & \TX{uyghur} \\
-\TX{croatian} & \TX{hebrew} & \TX{malay} & \TX{serbian} & vietnamese \\
-\TX{czech} & \TX{hindi} & malayalam & \TX{slovak} & \TX{welsh} \\
-\bottomrule
+ \toprule
+ \TX{afrikaans} & danish & icelandic & nko & \TX{spanish} \\
+ albanian & divehi & interlingua & \TX{norwegian}& swedish \\
+ amharic & \TX{dutch} & \TX{italian} & occitan & \TX{syriac} \\
+ \TX{arabic} & \TX{english} & japanese & \TX{persian} & tamil \\
+ \TX{armenian} & \TX{esperanto}& kannada & piedmontese & telugu \\
+ asturian & estonian & khmer & \TX{polish} & \TX{thai} \\
+ basque & \TX{finnish} & \TX{korean} &\TX{portuguese}& \TX{tibetan} \\
+ \TX{belarusian} & \TX{french} & \TX{kurdish} & \TX{punjabi} & turkish \\
+ \TX{bengali} & friulian & \TX{lao} & romanian & turkmen \\
+ bosnian & \TX{gaelic} & \TX{latin} & romansh & \TX{ukrainian}\\
+ breton & galician & latvian & \TX{russian} & urdu \\
+ bulgarian & \TX{georgian} & lithuanian & \TX{sami} & \TX{uyghur} \\
+ \TX{catalan} & \TX{german} & macedonian & \TX{sanskrit} & vietnamese \\
+ \TX{chinese} & \TX{greek} & \TX{malay} & \TX{serbian} & \TX{welsh} \\
+ coptic & \TX{hebrew} & malayalam & \TX{slovak} & \\
+ \TX{croatian} & \TX{hindi} & \TX{marathi} & \TX{slovenian}& \\
+ \TX{czech} & \TX{hungarian}& \TX{mongolian}& \TX{sorbian} & \\
+ \bottomrule
\end{tabular}
-
\end{table}
\paragraph{Version Notes} The support for Amharic\new{1.0.1} should be considered an experimental attempt to
@@ -355,171 +387,175 @@ language switching commands\slash environments documented in section~\ref{sec:ba
Table~\ref{tab:BCP47-polyglossia} lists the currently supported tags.
\bgroup\small\addfontfeatures{Numbers={Monospaced,Lining}}
-\begin{longtable}[c]{lll}
- \caption{\label{tab:BCP47-polyglossia}BCP47-polyglossia language name matching}\\
+\begin{longtable}[c]{ll>{\raggedright}p{6cm}}
+ \caption{\label{tab:BCP47-polyglossia}BCP47-polyglossia language name matching}\tabularnewline
\toprule
- \textbf{BCP-47 tag} & \textbf{Polyglossia name} & \textbf{Polyglossia options}\\
+ \textbf{BCP-47 tag} & \textbf{Polyglossia name} & \textbf{Polyglossia options}\tabularnewline
\midrule
\endfirsthead
- \caption[]{BCP47-polyglossia language name matching (\emph{continued})}\\
+ \caption[]{BCP47-polyglossia language name matching (\emph{continued})}\tabularnewline
\toprule
- \textbf{BCP-47 tag} & \textbf{Polyglossia name} & \textbf{Polyglossia options}\\
+ \textbf{BCP-47 tag} & \textbf{Polyglossia name} & \textbf{Polyglossia options}\tabularnewline
\midrule
\endhead
- aeb & arabic & locale=tunisia \\
- af & afrikaans & \\
- afb & arabic & locale=default \\
- am & amharic & \\
- apd & arabic & locale=default \\
- ar & arabic & \\
- ar-IQ & arabic & locale=mashriq \\
- ar-JO & arabic & locale=mashriq \\
- ar-LB & arabic & locale=mashriq \\
- ar-MR & arabic & locale=mauritania \\
- ar-PS & arabic & locale=mashriq \\
- ar-SY & arabic & locale=mashriq \\
- ar-YE & arabic & locale=default \\
- arq & arabic & locale=algeria \\
- ary & arabic & locale=morocco \\
- arz & arabic & locale=default \\
- ast & asturian & \\
- ayl & arabic & locale=libya \\
- be & belarusian & \\
- be-tarask & belarusian & spelling=classic \\
- bg & bulgarian & \\
- bn & bengali & \\
- bo & tibetan & \\
- br & breton & \\
- bs & bosnian & \\
- ca & catalan & \\
- ckb & kurdish & variant=sorani [\emph{default}] \\
- ckb-Arab & kurdish & variant=sorani, script=Arabic [\emph{default}] \\
- ckb-Latn & kurdish & variant=sorani, script=Latin \\
- cop & coptic & \\
- cy & welsh & \\
- cz & czech & \\
- da & danish & \\
- de & german & \\
- de-AT & german & variant=austrian, spelling=new \\
- de-AT-1901 & german & variant=austrian, spelling=old \\
- de-AT-1996 & german & variant=austrian, spelling=new \\
- de-CH & german & variant=swiss, spelling=new \\
- de-CH-1901 & german & variant=swiss, spelling=old \\
- de-CH-1996 & german & variant=swiss, spelling=new \\
- de-DE & german & variant=german, spelling=new \\
- de-DE-1901 & german & variant=german, spelling=old \\
- de-DE-1996 & german & variant=german, spelling=new [\emph{default}] \\
- de-Latf & german & script=blackletter \\
- de-Latf-AT & german & variant=austrian, spelling=new, script=blackletter \\
- de-Latf-AT-1901 & german & variant=austrian, spelling=old, script=blackletter \\
- de-Latf-AT-1996 & german & variant=austrian, spelling=new, script=blackletter \\
- de-Latf-CH & german & variant=swiss, spelling=new, script=blackletter \\
- de-Latf-CH-1901 & german & variant=swiss, spelling=old, script=blackletter \\
- de-Latf-CH-1996 & german & variant=swiss, spelling=new, script=blackletter \\
- de-Latf-DE & german & variant=german, spelling=new, script=blackletter \\
- de-Latf-DE-1901 & german & variant=german, spelling=old, script=blackletter \\
- de-Latf-DE-1996 & german & variant=german, spelling=new, script=blackletter \\
- dsb & sorbian & variant=lower \\
- dv & divehi & \\
- el & greek & \\
- el-monoton & greek & variant=monotonic [\emph{default}] \\
- el-polyton & greek & varant=polytonic \\
- en & english & \\
- en-AU & english & variant=australian \\
- en-CA & english & variant=canadian \\
- en-GB & english & variant=british \\
- en-NZ & english & variant=newzealand \\
- en-US & english & variant=us [\emph{default}] \\
- eo & esperanto & \\
- es & spanish & \\
- es-ES & spanish & variant=spanish [\emph{default}] \\
- es-MX & spanish & variant=mexican \\
- et & estonian & \\
- eu & basque & \\
- fa & persian & \\
- fi & finnish & \\
- fr & french & \\
- fr-CA & french & variant=canadian \\
- fr-CH & french & variant=swiss \\
- fr-FR & french & variant=french [\emph{default}] \\
- fur & friulian & \\
- ga & gaelic & variant=irish [\emph{default}] \\
- gd & gaelic & variant=scottish \\
- gl & galician & \\
- grc & greek & variant=ancient \\
- he & hebrew & \\
- hi & hindi & \\
- hr & croatian & \\
- hsb & sorbian & variant=upper [\emph{default}] \\
- hu & hungarian & \\
- hy & armenian & \\
- ia & interlingua & \\
- id & malay & variant=indonesian \\
- is & icelandic & \\
- it & italian & \\
- ja & japanese & \\
- ka & georgian & \\
- km & khmer & \\
- kmr & kurdish & variant=kurmanji \\
- kmr-Arab & kurdish & variant=kurmanji, script=Arabic \\
- kmr-Latn & kurdish & variant=kurmanji, script=Latin \\
- kn & kannada & \\
- ko & korean & \\
- ku & kurdish & \\
- ku-Arab & kurdish & script=Arabic \\
- ku-Latn & kurdish & script=Latin \\
- la & latin & \\
- la-x-classic & latin & variant=classic \\
- la-x-ecclesia & latin & variant=ecclesiastic \\
- la-x-medieval & latin & variant=medieval \\
- lo & lao & \\
- lt & lithuanian & \\
- lv & latvian & \\
- mk & macedonian & \\
- ml & malayalam & \\
- mn & mongolian & \\
- mr & marathi & \\
- nb & norwegian & variant=bokmal \\
- nko & nko & \\
- nl & dutch & \\
- nn & norwegian & variant=nynorsk [\emph{default}] \\
- oc & occitan & \\
- pl & polish & \\
- pms & piedmontese & \\
- pt & portuguese & \\
- pt-BR & portuguese & variant=brazilian \\
- pt-PT & portuguese & variant=portuguese [\emph{default}] \\
- rm & romansh & \\
- ro & romanian & \\
- ru & russian & \\
- ru-luna1918 & russian & spelling=modern [\emph{default}] \\
- ru-petr1708 & russian & spelling=old \\
- sa & sanskrit & \\
- sa-Beng & sanskrit & script=Bengali \\
- sa-Deva & sanskrit & script=Devanagari [\emph{default}] \\
- sa-Gujr & sanskrit & script=Gujarati \\
- sa-Knda & sanskrit & script=Kannada \\
- sa-Mlym & sanskrit & script=Malayalam \\
- sa-Telu & sanskrit & script=Telugu \\
- se & sami & \\
- sk & slovak & \\
- sl & slovenian & \\
- sq & albanian & \\
- sr & serbian & \\
- sr-Cyrl & serbian & script=Cyrillic \\
- sr-Latn & serbian & script=Latin [\emph{default}] \\
- sv & swedish & \\
- syr & syriac & \\
- ta & tamil & \\
- te & telugu & \\
- th & thai & \\
- tk & turkmen & \\
- tr & turkish & \\
- ug & uyghur & \\
- uk & ukrainian & \\
- ur & urdu & \\
- vi & vietnamese & \\
- zsm & malay & variant=malaysian [\emph{default}] \\
+ aeb & arabic & locale=tunisia \tabularnewline
+ af & afrikaans & \tabularnewline
+ afb & arabic & locale=default \tabularnewline
+ am & amharic & \tabularnewline
+ apd & arabic & locale=default \tabularnewline
+ ar & arabic & \tabularnewline
+ ar-IQ & arabic & locale=mashriq \tabularnewline
+ ar-JO & arabic & locale=mashriq \tabularnewline
+ ar-LB & arabic & locale=mashriq \tabularnewline
+ ar-MR & arabic & locale=mauritania \tabularnewline
+ ar-PS & arabic & locale=mashriq \tabularnewline
+ ar-SY & arabic & locale=mashriq \tabularnewline
+ ar-YE & arabic & locale=default \tabularnewline
+ arq & arabic & locale=algeria \tabularnewline
+ ary & arabic & locale=morocco \tabularnewline
+ arz & arabic & locale=default \tabularnewline
+ ast & asturian & \tabularnewline
+ ayl & arabic & locale=libya \tabularnewline
+ be & belarusian & \tabularnewline
+ be-tarask & belarusian & spelling=classic \tabularnewline
+ bg & bulgarian & \tabularnewline
+ bn & bengali & \tabularnewline
+ bo & tibetan & \tabularnewline
+ br & breton & \tabularnewline
+ bs & bosnian & \tabularnewline
+ ca & catalan & \tabularnewline
+ ckb & kurdish & variant=sorani [\emph{default}] \tabularnewline
+ ckb-Arab & kurdish & variant=sorani, script=Arabic [\emph{default}] \tabularnewline
+ ckb-Latn & kurdish & variant=sorani, script=Latin \tabularnewline
+ cop & coptic & \tabularnewline
+ cy & welsh & \tabularnewline
+ cz & czech & \tabularnewline
+ da & danish & \tabularnewline
+ de & german & \tabularnewline
+ de-AT & german & variant=austrian, spelling=new \tabularnewline
+ de-AT-1901 & german & variant=austrian, spelling=old \tabularnewline
+ de-AT-1996 & german & variant=austrian, spelling=new \tabularnewline
+ de-CH & german & variant=swiss, spelling=new \tabularnewline
+ de-CH-1901 & german & variant=swiss, spelling=old \tabularnewline
+ de-CH-1996 & german & variant=swiss, spelling=new \tabularnewline
+ de-DE & german & variant=german, spelling=new \tabularnewline
+ de-DE-1901 & german & variant=german, spelling=old \tabularnewline
+ de-DE-1996 & german & variant=german, spelling=new [\emph{default}] \tabularnewline
+ de-Latf & german & script=blackletter \tabularnewline
+ de-Latf-AT & german & variant=austrian, spelling=new, script=blackletter \tabularnewline
+ de-Latf-AT-1901 & german & variant=austrian, spelling=old, script=blackletter \tabularnewline
+ de-Latf-AT-1996 & german & variant=austrian, spelling=new, script=blackletter \tabularnewline
+ de-Latf-CH & german & variant=swiss, spelling=new, script=blackletter \tabularnewline
+ de-Latf-CH-1901 & german & variant=swiss, spelling=old, script=blackletter \tabularnewline
+ de-Latf-CH-1996 & german & variant=swiss, spelling=new, script=blackletter \tabularnewline
+ de-Latf-DE & german & variant=german, spelling=new, script=blackletter \tabularnewline
+ de-Latf-DE-1901 & german & variant=german, spelling=old, script=blackletter \tabularnewline
+ de-Latf-DE-1996 & german & variant=german, spelling=new, script=blackletter \tabularnewline
+ dsb & sorbian & variant=lower \tabularnewline
+ dv & divehi & \tabularnewline
+ el & greek & \tabularnewline
+ el-monoton & greek & variant=monotonic [\emph{default}] \tabularnewline
+ el-polyton & greek & varant=polytonic \tabularnewline
+ en & english & \tabularnewline
+ en-AU & english & variant=australian \tabularnewline
+ en-CA & english & variant=canadian \tabularnewline
+ en-GB & english & variant=british \tabularnewline
+ en-NZ & english & variant=newzealand \tabularnewline
+ en-US & english & variant=us [\emph{default}] \tabularnewline
+ eo & esperanto & \tabularnewline
+ es & spanish & \tabularnewline
+ es-ES & spanish & variant=spanish [\emph{default}] \tabularnewline
+ es-MX & spanish & variant=mexican \tabularnewline
+ et & estonian & \tabularnewline
+ eu & basque & \tabularnewline
+ fa & persian & \tabularnewline
+ fi & finnish & \tabularnewline
+ fr & french & \tabularnewline
+ fr-CA & french & variant=canadian \tabularnewline
+ fr-CH & french & variant=swiss \tabularnewline
+ fr-FR & french & variant=french [\emph{default}] \tabularnewline
+ fur & friulian & \tabularnewline
+ ga & gaelic & variant=irish [\emph{default}] \tabularnewline
+ gd & gaelic & variant=scottish \tabularnewline
+ gl & galician & \tabularnewline
+ grc & greek & variant=ancient \tabularnewline
+ he & hebrew & \tabularnewline
+ hi & hindi & \tabularnewline
+ hr & croatian & \tabularnewline
+ hsb & sorbian & variant=upper [\emph{default}] \tabularnewline
+ hu & hungarian & \tabularnewline
+ hy & armenian & \tabularnewline
+ ia & interlingua & \tabularnewline
+ id & malay & variant=indonesian \tabularnewline
+ is & icelandic & \tabularnewline
+ it & italian & \tabularnewline
+ ja & japanese & \tabularnewline
+ ka & georgian & \tabularnewline
+ km & khmer & \tabularnewline
+ kmr & kurdish & variant=kurmanji \tabularnewline
+ kmr-Arab & kurdish & variant=kurmanji, script=Arabic \tabularnewline
+ kmr-Latn & kurdish & variant=kurmanji, script=Latin \tabularnewline
+ kn & kannada & \tabularnewline
+ ko & korean & \tabularnewline
+ ku & kurdish & \tabularnewline
+ ku-Arab & kurdish & script=Arabic \tabularnewline
+ ku-Latn & kurdish & script=Latin \tabularnewline
+ la & latin & \tabularnewline
+ la-x-classic & latin & variant=classic \tabularnewline
+ la-x-ecclesia & latin & variant=ecclesiastic \tabularnewline
+ la-x-medieval & latin & variant=medieval \tabularnewline
+ lo & lao & \tabularnewline
+ lt & lithuanian & \tabularnewline
+ lv & latvian & \tabularnewline
+ mk & macedonian & \tabularnewline
+ ml & malayalam & \tabularnewline
+ mn & mongolian & \tabularnewline
+ mr & marathi & \tabularnewline
+ nb & norwegian & variant=bokmal \tabularnewline
+ nko & nko & \tabularnewline
+ nl & dutch & \tabularnewline
+ nn & norwegian & variant=nynorsk [\emph{default}] \tabularnewline
+ oc & occitan & \tabularnewline
+ pa & punjabi & numerals=gurmukhi \tabularnewline
+ pl & polish & \tabularnewline
+ pms & piedmontese & \tabularnewline
+ pt & portuguese & \tabularnewline
+ pt-BR & portuguese & variant=brazilian \tabularnewline
+ pt-PT & portuguese & variant=portuguese [\emph{default}] \tabularnewline
+ rm & romansh & \tabularnewline
+ ro & romanian & \tabularnewline
+ ru & russian & \tabularnewline
+ ru-luna1918 & russian & spelling=modern [\emph{default}] \tabularnewline
+ ru-petr1708 & russian & spelling=old \tabularnewline
+ sa & sanskrit & \tabularnewline
+ sa-Beng & sanskrit & script=Bengali \tabularnewline
+ sa-Deva & sanskrit & script=Devanagari [\emph{default}] \tabularnewline
+ sa-Gujr & sanskrit & script=Gujarati \tabularnewline
+ sa-Knda & sanskrit & script=Kannada \tabularnewline
+ sa-Mlym & sanskrit & script=Malayalam \tabularnewline
+ sa-Telu & sanskrit & script=Telugu \tabularnewline
+ se & sami & \tabularnewline
+ sk & slovak & \tabularnewline
+ sl & slovenian & \tabularnewline
+ sq & albanian & \tabularnewline
+ sr & serbian & \tabularnewline
+ sr-Cyrl & serbian & script=Cyrillic \tabularnewline
+ sr-Latn & serbian & script=Latin [\emph{default}] \tabularnewline
+ sv & swedish & \tabularnewline
+ syr & syriac & \tabularnewline
+ ta & tamil & \tabularnewline
+ te & telugu & \tabularnewline
+ th & thai & \tabularnewline
+ tk & turkmen & \tabularnewline
+ tr & turkish & \tabularnewline
+ ug & uyghur & \tabularnewline
+ uk & ukrainian & \tabularnewline
+ ur & urdu & \tabularnewline
+ vi & vietnamese & \tabularnewline
+ zh & chinese & \tabularnewline
+ zh-CN & chinese & variant=simplified [\emph{default}] \tabularnewline
+ zh-TW & chinese & variant=traditional \tabularnewline
+ zsm & malay & variant=malaysian [\emph{default}] \tabularnewline
\bottomrule
\end{longtable}
\egroup
@@ -530,8 +566,8 @@ Table~\ref{tab:BCP47-polyglossia} lists the currently supported tags.
\begin{itemize}
\item \xpgboolkeyfalse[1.1.1]{babelshorthands}
- Globally activates \pkg{babel} shorthands whenever available. Currently
- shorthands are implemented for Afrikaans, Belarusian, Catalan, Croatian,
+ Globally activates \pkg{babel} shorthands whenever available. Such shorthands are
+ implemented currently for Afrikaans, Belarusian, Catalan, Croatian,
Czech, Dutch, Finnish, Georgian, German, Italian, Latin, Mongolian,
Russian, Slovak, and Ukrainian. Please refer to the respective language descriptions
(sec.~\ref{specific}) for details.
@@ -649,7 +685,7 @@ ought to be mentioned here.
this selects the global font setup and the numbering definitions for the default language.
\item \DescribeMacro{\resetdefaultlanguage}\cmd{\resetdefaultlanguage\oarg{options}\marg{lang}} (experimental):
- completely switches the default language
+ Switches the default language
to another one in the middle of a document: \textit{this may have adverse effects}!
\item \Cmd\normalfontlatin: in an environment where \cmd\normalfont\ has been redefined
@@ -665,8 +701,8 @@ ought to be mentioned here.
\subsection{Setting up alias commands}
-By means of the macro
-\displaycmd{\setlanguagealias\oarg{options}\marg{language}\marg{alias}}{\setlanguagealias}\new{1.46}
+By means of the macro\new{1.46}
+\displaycmd{\setlanguagealias\oarg{options}\marg{language}\marg{alias}}{\setlanguagealias}
you can define alias commands for specific language (variants). \Eg
\begin{quote}
@@ -728,7 +764,7 @@ which override the hyphenation patterns for specified words. The command takes a
list of words where hyphenation points are marked by a dash (if no dash is used, the respective word is not
hyphenated at all):
\begin{quote}
-\begin{minipage}{\textwidth}
+\begin{minipage}{.7\textwidth}
\begin{verbatim}
\hyphenation{%
po-ly-glos-sia
@@ -759,7 +795,7 @@ To change this value, \pkg{polyglossia} provides the command\new{1.50}
where \meta{lang} is to be replaced with the respective language name or alias, \meta{options}
can be used to delimit the modification to a particular variety (\eg via \texttt{variant} or \texttt{spelling}),
\meta{l} with the left threshold value (\eg \texttt{3}), and \meta{r} with the right
-threshold value (\eg \verb|\setlanghyphenmins[spelling=old]{german}{4}{4}|).
+one (\eg \verb|\setlanghyphenmins[spelling=old]{german}{4}{4}|).
This setting can be changed repeatedly in the preamble and the document body.
It applies to all subsequent text in the respective language (variety), but only after the
next language switch.
@@ -810,13 +846,12 @@ and that passing \xpgvalue{babelshorthands} (without value) is equivalent to pas
\paragraph*{Options:}
\begin{itemize}
\item \xpgchoicekey{calendar}{\xpgpresetvalue{gregorian} or \xpgvalue{islamic} (= \xpgvalue{hijri})}
- \item \xpgchoicekey{locale}{\xpgpresetvalue{default}\footnote{ %
- For Egypt, Sudan, Yemen and the Gulf states.},
- \xpgvalue{mashriq}\footnote{ %
- For Iraq, Syria, Jordan, Lebanon and Palestine.},
- \xpgvalue{libya}, \xpgvalue{algeria}, \xpgvalue{tunisia}, \xpgvalue{morocco}, \xpgvalue{mauritania}}
+ \item \xpgchoicekey{locale}{\xpgpresetvalue{default}, \xpgvalue{mashriq}, \xpgvalue{libya},
+ \xpgvalue{algeria}, \xpgvalue{tunisia}, \xpgvalue{morocco}, \xpgvalue{mauritania}}
This setting influences the spelling of the month names for the Gregorian calendar,
- as well as the form of the numerals (unless overriden by the following option).
+ as well as the form of the numerals (unless overridden by the following option). Recommended settings are
+ \xpgvalue{default} for Egypt, Sudan, Yemen and the Gulf states, and \xpgvalue{mashriq} for Iraq, Syria,
+ Jordan, Lebanon and Palestine.
\item \xpgchoicekey{numerals}{\xpgpresetvalue{mashriq} or \xpgvalue{maghrib}}
The latter is the default when \xpgvalue{locale=algeria}, \xpgvalue{tunisia}, or \xpgvalue{morocco}.
\item \xpgboolkeyfalse[1.50]{abjadalph}
@@ -908,7 +943,7 @@ and that passing \xpgvalue{babelshorthands} (without value) is equivalent to pas
\subsection[bengali]{bengali\new{1.2.0}}\label{bengali}
\paragraph*{Options:}
\begin{itemize}
- \item \xpgchoicekey{numerals}{\xpgvalue{Western}, \xpgvalue{Bengali}, or \xpgpresetvalue{Devanagari}}
+ \item \xpgchoicekey{numerals}{\xpgvalue{western}, \xpgvalue{bengali}, or \xpgpresetvalue{devanagari}}
\item \xpgboolkeyfalse{changecounternumbering}
Use specified numerals for headings and page numbers.
\end{itemize}
@@ -926,6 +961,18 @@ and that passing \xpgvalue{babelshorthands} (without value) is equivalent to pas
similar to \pkg{babel} (the glyph U+00B7 MIDDLE DOT is used as a geminating sign).
\end{itemize}
+\subsection[chinese]{chinese\new{1.59}}\label{chinese}
+\paragraph*{Options:}
+ \begin{itemize}
+ \item \xpgchoicekey{variant}{\xpgpresetvalue{simplified} (= \xpgvalue{cn}), or \xpgvalue{traditional} (= \xpgvalue{tw})}
+ \item \xpgchoicekey{numerals}{\xpgpresetvalue{arabic} or \xpgvalue{chinese}}
+ Uses either Arabic numerals or Chinese ideographic numbering.
+ \end{itemize}
+\paragraph*{Commands:}
+ \begin{itemize}
+ \item \Cmd\chinesenumeral (see section \ref{abjad}).
+ \end{itemize}
+
\subsection{croatian}\label{croatian}
\paragraph*{Options:}
\begin{itemize}
@@ -1278,7 +1325,7 @@ and that passing \xpgvalue{babelshorthands} (without value) is equivalent to pas
\subsection[hindi]{hindi\new{1.2.0}}\label{hindi}
\paragraph*{Options:}
\begin{itemize}
- \item \xpgchoicekey{numerals}{\xpgvalue{Western} or \xpgpresetvalue{Devanagari}}
+ \item \xpgchoicekey{numerals}{\xpgvalue{western} or \xpgpresetvalue{devanagari}}
\end{itemize}
\subsection{hungarian}\label{hungarian}
@@ -1431,7 +1478,7 @@ and that passing \xpgvalue{babelshorthands} (without value) is equivalent to pas
\item \xpgchoicekey[1.46]{hyphenation}{\xpgvalue{classic}, \xpgvalue{modern}, or \xpgvalue{liturgical}}
There are three different sets of hyphenation patterns for Latin. Separate
documention for them is available on the
- Internet.\footnote{\url{https://github.com/gregorio-project/hyphen-la/blob/master/doc/README.md\#hyphenation-styles}}
+ Internet.\footnote{Refer to \url{https://github.com/gregorio-project/hyphen-la/blob/master/doc/README.md\#hyphenation-styles}}
Each of the four variants mentioned above has its default set of hyphenation
patterns as indicated by table \ref{tab:latin-hyphenation}. Use the
¦hyphenation¦ option if the default style does not fit your needs.
@@ -1551,7 +1598,7 @@ and that passing \xpgvalue{babelshorthands} (without value) is equivalent to pas
\subsection{marathi}\label{marathi}
\paragraph*{Options:}
\begin{itemize}
- \item \xpgchoicekey{numerals}{\xpgpresetvalue{Devanagari} or \xpgvalue{Western}}
+ \item \xpgchoicekey{numerals}{\xpgpresetvalue{devanagari} or \xpgvalue{western}}
\end{itemize}
\subsection[mongolian]{mongolian\new{1.45}}\label{mongolian}
@@ -1634,7 +1681,6 @@ Currently, only the Khalkha variety in Cyrillic script is supported.
\item \Cmd\aemph (see section \ref{arabic}).
\end{itemize}
-
\subsection{polish}\label{polish}
\paragraph*{Options:}
@@ -1706,6 +1752,12 @@ Currently, only the Khalkha variety in Cyrillic script is supported.
Set this option to ¦false¦ to disable the feature.
\end{itemize}
+\subsection[punjabi]{punjabi\new{1.59}}\label{punjabi}
+\paragraph*{Options:}
+\begin{itemize}
+ \item \xpgchoicekey{numerals}{\xpgvalue{western} or \xpgpresetvalue{gurmukhi}}
+\end{itemize}
+
\subsection{russian}\label{russian}
\paragraph*{Options:}
\begin{itemize}
@@ -1790,9 +1842,9 @@ Currently support for Sami is limited to Northern Sami.
\paragraph*{Options:}
\begin{itemize}
\item \xpgchoicekey[1.0.2]{script}{\xpgpresetvalue{Devanagari}, \xpgvalue{Gujarati},
- \xpgvalue{Malayalam}, \xpgvalue{Bengali}, \xpgvalue{Kannada}, \xpgvalue{Telugu}, or \xpgvalue{Latin}}
- The value is passed to \pkg{fontspec} in cases where the respective
- \cmd{\⟨script⟩font} is not defined. This can be useful if you typeset Sanskrit
+ \xpgvalue{Malayalam}, \xpgvalue{Bengali}, \xpgvalue{Kannada}, \xpgvalue{Telugu}, \xpgvalue{Latin}}
+ The value is passed to \pkg{fontspec} should the respective
+ \cmd{\⟨script⟩font} not be defined. This can be useful if you typeset Sanskrit
texts in scripts other than Devanagari.
\item \xpgchoicekey[1.45]{numerals}{\xpgpresetvalue{Devanagari} or \xpgvalue{Western}}
\end{itemize}
@@ -2127,7 +2179,7 @@ by \cmd\makeatletter\ and \cmd\makeatother\ due to the ¦@¦ in the macro names.
Finally, as soon as the language has been switched (either inline or as a block), \pkg{polyglossia}
executes the (by default empty) hook
\begin{itemize}
- \item \Cmd{\polyglossia@language@switched}
+ \item \cmd{\polyglossia@language@switched}\DescribeMacroCust{\scriptsize}{\polyglossia@language@switched}
\end{itemize}
to which you can append arbitrary code (via \cmd\gappto) that should be executed if (a particular)
language is being activated. This is done before any of the above
@@ -2198,6 +2250,7 @@ Currently, the following macros are provided:
\item \Cmd\bengalidigits
\item \Cmd\devanagaridigits
\item \Cmd\farsidigits
+ \item \Cmd\gurmukhidigits
\item \Cmd\kannadadigits
\item \Cmd\khmerdigits
\item \Cmd\laodigits
@@ -2242,6 +2295,11 @@ The following macros are provided:
with ¦numerals=cyrillic-trad¦ ¦\belarusiannumeral{19}¦ results in \textrussian[numerals=cyrillic-trad]{\russiannumeral{19}},\\
with ¦numerals=cyrillic-alph¦ ¦\belarusiannumeral{19}¦ results in \textrussian[numerals=cyrillic-alph]{\russiannumeral{19}}.
+ \item \Cmd\chinesenumeral produces Chinese numbering which, depending on the ¦numerals¦ option in the Chinese language selection,
+ produces is either Arabic digit or Chinese ideographic output.\\
+ Example: With ¦numerals=arabic¦ ¦\chinesenumeral{753}¦ yields \textchinese[numerals=arabic]{\chinesenumeral{753}},
+ with ¦numerals=chinese¦ ¦\chinesenumeral{753}¦ results in \textchinese[numerals=chinese]{\chinesenumeral{753}}.
+
\item \Cmd\georgiannumeral produces Georgian alphabetic numbering.\\
Example: ¦\georgiannumeral{1863}¦ yields \textgeorgian{\georgiannumeral{1863}}.
@@ -2249,9 +2307,10 @@ The following macros are provided:
Example: ¦\greeknumeral{1863}¦ yields \textgreek{\greeknumeral{1863}},
¦\Greeknumeral{1863}¦ results in \textgreek{\Greeknumeral{1863}}.
- \item \Cmd\hebrewnumeral, \Cmd\Hebrewnumeral and \Cmd\Hebrewnumeralfinal generate variants of Hebrew alphanumeric numerals.
- The commands behave exactly as they do in \pkg{babel}: \cmd\hebrewnumeral\ outputs the numbers without any decoration,
- \cmd\Hebrewnumeral\ adds \textit{gereshayim} before the last letter, \cmd\Hebrewnumeralfinal\ uses in addition the final forms of Hebrew letters.
+ \item \Cmd\hebrewnumeral, \Cmd\Hebrewnumeral and \Cmd\Hebrewnumeralfinal produce variants of Hebrew alphanumeric numerals.
+ The commands behave identical as in \pkg{babel}: \cmd\hebrewnumeral\ outputs the numbers without any decoration at all,
+ \cmd\Hebrewnumeral\ adds \textit{gereshayim} before the last letter, and \cmd\Hebrewnumeralfinal\ uses in addition the final
+ forms of Hebrew letters.
Examples:
¦\hebrewnumeral{1750}¦ yields \texthebrew{\hebrewnumeral{1750}},
¦\Hebrewnumeral{1750}¦ yields \texthebrew{\Hebrewnumeral{1750}},
@@ -2263,6 +2322,9 @@ The following macros are provided:
Example: With ¦numerals=latin¦ ¦\mongoliannumeral{19}¦ yields \textrussian{\russiannumeral{19}},
with ¦numerals=cyrillic-trad¦ ¦\mongoliannumeral{19}¦ results in \textrussian[numerals=cyrillic-trad]{\russiannumeral{19}},\\
with ¦numerals=cyrillic-alph¦ ¦\mongoliannumeral{19}¦ results in \textrussian[numerals=cyrillic-alph]{\russiannumeral{19}}.
+
+ \item \Cmd\punjabinumeral produces Punjabi numbering, depending on the ¦numerals¦ option in the Punjabi language selection, this
+ is either Gurmukhi or Arabic (Western).
\item \Cmd\russiannumeral produces Russian numbering, with uppercased variant (for alphanumerical variant) via \Cmd\Russiannumeral.
Depending on the ¦numerals¦ option in the Russian language selection, this is either Arabic digit or Cyrillic
@@ -2377,7 +2439,7 @@ Example: today is \Jalalitoday.
\section{Auxiliary commands}
-The macro \displaycmd{\charifavailable\marg{char code}\marg{substitution}}{\charifavailable}\new{1.47} checks whether
+The macro\new{1.47} \displaycmd{\charifavailable\marg{char code}\marg{substitution}}{\charifavailable} checks whether
the character with the specified \meta{char code} (\ie unicode utf-16 code without preceding ¦0x¦) exists in
the current font. If so, the character is printed, if not, the \meta{substitution} is printed.
@@ -2424,18 +2486,33 @@ In order to get such information, \pkg{polyglossia} provides the following macro
\displaycmd{\iflanguageloaded\marg{lang}\marg{true}\marg{false}}{\iflanguageloaded}
where \texttt{\meta{lang}} is a \pkg{polyglossia} language name, by
\displaycmd{\ifbabellanguageloaded\marg{lang}\marg{true}\marg{false}}{\ifbabellanguageloaded}
-where \texttt{\meta{lang}} is a \pkg{babel} language name (see table~\ref{tab:bbllang} on p.~\pageref{tab:bbllang}), or by
-\displaycmd{\iflanguageidloaded\marg{type}\marg{id}\marg{true}\marg{false}}{\iflanguageidloaded}\new{1.47}
+where \texttt{\meta{lang}} is a \pkg{babel} language name (see table~\ref{tab:bbllang} on p.~\pageref{tab:bbllang}), or by\new{1.47}
+\displaycmd{\iflanguageidloaded\marg{type}\marg{id}\marg{true}\marg{false}}{\iflanguageidloaded}
where \meta{type} is a supported language id type (such as ¦bcp-47¦) and \meta{id} is a language id
(such as ¦en-US¦; see table~\ref{tab:BCP47-polyglossia} on p.~\pageref{tab:BCP47-polyglossia}).
\bigskip
-\noindent Finally, if you want to know whether a specific language option has been set, you can use
-\displaycmd{\iflanguageoption\marg{lang}\marg{opt. key}\marg{opt. value}\marg{true}\marg{false}}{\iflanguageoption}\new{1.47}
+\noindent Finally, if you want to know whether a specific language option has been set, you can use\new{1.47}
+\displaycmd{\iflanguageoption\marg{lang}\marg{key}\marg{value}\marg{true}\marg{false}}{\iflanguageoption}
\section{Revision history}
\bgroup\footnotesize
+\subsection*{1.59 (2022/11/29)}
+
+\subsubsection*{Bug fixes}
+\begin{itemize}
+ \item Do not error, but warn, after language change due to non-updated aux file (\TXI{565}).
+ \item Fix catcode issue for Latin (\TXI{566}).
+ \item Improve error message with missing fonts (\TXI{571})
+\end{itemize}
+
+\subsubsection*{New features}
+\begin{itemize}
+\item Add support for (simplified and traditional) Chinese (\TXI{65}, provided by \TA{Takuji Tanaka}).
+\item Add support for Punjabi (\TXP{572}), provided by \TA{Arvinder Singh}.
+\end{itemize}
+
\subsection*{1.58 (2022/10/26)}
\subsubsection*{Bug fixes}
@@ -2658,7 +2735,7 @@ where \meta{type} is a supported language id type (such as ¦bcp-47¦) and \meta
\subsubsection*{Build fixes}
\begin{itemize}
-\item Fix a bug in the dtx build script which was the reason for an utterly
+\item Fix an embarrassing bug in the dtx build script which was the reason for an utterly
incomplete ¦polyglossia.dtx¦ file (\TXI{420}).
\end{itemize}
@@ -2779,7 +2856,7 @@ where \meta{type} is a supported language id type (such as ¦bcp-47¦) and \meta
always use the latest German hyphens.
\item The command ¦\setlanguagealias*¦ (introduced in v1.46) does no longer define
dedicated alias environments.
-\item The babelnames for Latin variants have been corrected to ¦classiclatin¦, ¦ecclesiasticlatin¦
+\item The babelnames for Latin variants are now changed to ¦classiclatin¦, ¦ecclesiasticlatin¦
and ¦medievallatin¦. This is how the hyphenation patterns and \pkg{babel} ¦\extras¦ are named, even
though the variants can currently be selected in \pkg{babel} only via appended ``dot modifier''.
\item In accordance with the respective \pkg{l3kernel} change, ¦\str_lower_case:n¦ has been renamed to
@@ -2799,7 +2876,7 @@ where \meta{type} is a supported language id type (such as ¦bcp-47¦) and \meta
\item Swap section headings in Hungarian (\TXI{344}). New option \xpgoption{swapstrings} provides control
over this.
\item Introduce macro ¦\setlanguagealias¦ and ¦\setlanguagealias*¦.
-\item Introduce language switching command ¦\textlang{lang}{...}¦ (equivalent to ¦\text<lang>¦,
+\item Introduce language switching command ¦\textlang{lang}{...}¦ (these are equivalent to ¦\text<lang>¦,
but also available with ¦\setlanguagealias*¦ which does not define ¦\text<alias>¦).
\item Add support for Afrikaans.
\item Add support for Belarusian.
@@ -2847,7 +2924,7 @@ where \meta{type} is a supported language id type (such as ¦bcp-47¦) and \meta
\begin{itemize}
\item Introduce a framework for external packages to access language variants. This fixes,
among other things, long-standing problems in the interaction of \pkg{biblatex} and \pkg{polyglossia}.
-\item Add new macros ¦\languagevariant¦, ¦\mainlanguagevariant¦, ¦\babelname¦ and ¦\mainbabelname¦
+\item Add new macros ¦\languagevariant¦ and ¦\mainlanguagevariant¦ as well as ¦\babelname¦ and ¦\mainbabelname¦
for package authors to access language information.
\item Add new test ¦\iflanguageloaded{<language>}{<true>}{<false>}¦ where <language>
can be a \pkg{polyglossia} or \pkg{babel} language name.
@@ -3173,12 +3250,12 @@ where \meta{type} is a supported language id type (such as ¦bcp-47¦) and \meta
\subsection*{1.2.0 (2010/07/15)}
\begin{itemize}
\item Adapted for \pkg{fontspec} 2.0 (will not work with earlier versions!)
- \item New implementation of a ¦\PolyglossiaSetup¦ interface
+ \item Implementation of a ¦\PolyglossiaSetup¦ interface
that simplifies writing ¦gloss-*.ldf¦ files
\item Many internal enhancements and refactoring
(including a patch by \TA{Dirk Ulrich})
\item Improved automatic font setup when ¦\<lang>font¦ is not defined
- \item New environment otherlanguage* (env. equivalent of ¦\foreignlanguage¦
+ \item New environment \texttt{otherlanguage*} (equivalent to ¦\foreignlanguage¦
(\TA{Enrico Gregorio})
\item Bugfix to prevent bogus expansion of ¦\{rm,sf,tt}family¦ even in aux files (\TA{Enrico Gregorio})
\item New gloss files for Armenian, Bengali, Occitan, Bengali, Lao,
@@ -3191,7 +3268,7 @@ where \meta{type} is a supported language id type (such as ¦bcp-47¦) and \meta
others)
\item Corrected captions for Bahasai, Lithuanian, Russian, Croatian
\item Add option \xpgoption{indentfirst=true} for Spanish, Croatian and other languages
- (NB: \xpgoption{indentfirst} was previously named \xpgoption{frenchindent})
+ (\xpgoption{indentfirst} was previously named \xpgoption{frenchindent})
\item New option \xpgoption{script} for German: Setting \xpgoption{script=fraktur} modifies the
captions for typesetting in Fraktur.
\item New command ¦\aemph¦ for Arabic, Farsi, Urdu, etc. to mark emphasis through
@@ -3208,7 +3285,7 @@ where \meta{type} is a supported language id type (such as ¦bcp-47¦) and \meta
signs (Par exemple : les grands « espaces » du Canada !) are
now replaced by the appropriate non-breaking spaces, as in \pkg{babel}.
\item Bugfix for font switching mechanism within Latin script
- (pending a complete re-implementation in v1.2):
+ (pending a complete re-implemen\-tation in v1.2):
the font shape and series are no longer reset when switching language.
\item New macros for non-Western decimal digits
(instead of fontmappings)
@@ -3335,8 +3412,8 @@ In alphabetical order: \TA{Ignas Anikevicius}, \TA{Sina Ahmadi}, \TA{Wouter Bols
\TA{Khaled Hosny}, \TA{Najib Idrissi}, user \TA{julroy67}, \TA{Dohyun Kim}, \TA{Phil Kime}, \TA{Mike Kroutikov},
\TA{Ivan Kokan}, \TA{Caleb Maclennan}, \TA{Gyula Magyarkuti}, \TA{José Mancera}, \TA{Miquel Ortega}, \TA{Yevgen Pogribnyi},
\TA{Will Robertson}, \TA{Maïeul Rouquette}, \TA{Elie Roux}, \TA{Hugo Roy}, \TA{Guy Rutenberg}, \TA{Marcin Serwin},
-\TA{Philipp Stephani}, \TA{Niranjan Tambe}, \TA{Osman Tursun}, \TA{Keno Wehr}, \TA{Dominik Wujastyk}, \TA{Sertaç Ö. Yıldız},
-\TA{Maksim Zholudev}, \TA{Yan Zhou}, and \TA{Stefan Zlatinov}.
+\TA{Arvinder Singh}, \TA{Philipp Stephani}, \TA{Niranjan Tambe}, \TA{Takuji Tanaka}, \TA{Osman Tursun}, \TA{Keno Wehr},
+\TA{Dominik Wujastyk}, \TA{Sertaç Ö. Yıldız}, \TA{Maksim Zholudev}, \TA{Yan Zhou}, and \TA{Stefan Zlatinov}.
Their respective contributions can be identified from the contributor statistics on
\href{https://github.com/reutenauer/polyglossia/graphs/contributors}{GitHub}.