From 6024de648c5e4b1bcb3630cecc307ca55db9ae8e Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 15 Nov 2019 21:41:34 +0000 Subject: polyglossia (15nov19) git-svn-id: svn://tug.org/texlive/trunk@52808 c570f23f-e606-0410-a88d-b1316a301751 --- .../source/latex/polyglossia/polyglossia.dtx | 5089 +++++++++++++++----- 1 file changed, 3980 insertions(+), 1109 deletions(-) (limited to 'Master/texmf-dist/source/latex/polyglossia') diff --git a/Master/texmf-dist/source/latex/polyglossia/polyglossia.dtx b/Master/texmf-dist/source/latex/polyglossia/polyglossia.dtx index ee43f033825..fe48e7e23e5 100644 --- a/Master/texmf-dist/source/latex/polyglossia/polyglossia.dtx +++ b/Master/texmf-dist/source/latex/polyglossia/polyglossia.dtx @@ -11,7 +11,7 @@ ¦----------------------------------------------¦ ¦ ¦ - ¦ THE POLYGLOSSIA PACKAGE v1.45 ¦ + ¦ THE POLYGLOSSIA PACKAGE v1.46 ¦ ¦ ¦ ¦ Modern multilingual typesetting ¦ ¦ with XeLaTeX and LuaLaTeX ¦ @@ -20,8 +20,8 @@ This package provides an alternative to Babel for users of XeLaTeX and LuaLaTeX (with a few languages incompletely supported for the latter). This version -includes support for 75 different languages, some of which in different regional, -national or scriptal varieties. +includes support for 79 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: @@ -44,23 +44,19 @@ Polyglossia makes it possible to automate the following tasks: LICENSE -Copyright (c) 2008-2010 François Charette, 2013 Élie Roux, 2011-2019 Arthur Reutenauer +Copyright (c) 2008-2010 François Charette, 2013 Élie Roux, 2011-2019 Arthur Reutenauer, +Copyright (c) 2019 Bastien Roucariès, 2019 Jürgen Spitzmüller -Polyglossia is placed under the terms of the LaTeX Project Public Licence -(LPPL), either version 1.3, or, at your option, any later version. See -LICENCE.txt for the text of the LPPL v1.3c, or -http://www.latex-project.org/lppl.txt for the latest version. - -This work has the LPPL maintenance status ‘maintained’. The current maintainer is -Arthur Reutenauer. +Except where otherwise noted, Polyglossia is placed under the terms of the MIT licence +(https://opensource.org/licenses/MIT). BUGS If you run into a bug, or suspect you do, or you have a request or comment, please use the GitHub issue tracker: http://github.com/reutenauer/polyglossia/issues -This is more efficient than contacting me by email as it allows me to track the -issues and follow progress. +This is more efficient than contacting the maintainer by email as it allows me +to track the issues and follow progress. % %<*internal> \fi @@ -104,18 +100,29 @@ issues and follow progress. \endpostamble \let\MetaPrefix\DoubleperCent \askforoverwritefalse +\generate{\file{gloss-acadien.ldf}{\from{polyglossia.dtx}{gloss-acadien.ldf}}} +\generate{\file{gloss-afrikaans.ldf}{\from{polyglossia.dtx}{gloss-afrikaans.ldf}}} \generate{\file{gloss-albanian.ldf}{\from{polyglossia.dtx}{gloss-albanian.ldf}}} +\generate{\file{gloss-american.ldf}{\from{polyglossia.dtx}{gloss-american.ldf}}} \generate{\file{gloss-amharic.ldf}{\from{polyglossia.dtx}{gloss-amharic.ldf}}} \generate{\file{gloss-arabic.ldf}{\from{polyglossia.dtx}{gloss-arabic.ldf}}} \generate{\file{gloss-armenian.ldf}{\from{polyglossia.dtx}{gloss-armenian.ldf}}} \generate{\file{gloss-asturian.ldf}{\from{polyglossia.dtx}{gloss-asturian.ldf}}} +\generate{\file{gloss-australian.ldf}{\from{polyglossia.dtx}{gloss-australian.ldf}}} +\generate{\file{gloss-austrian.ldf}{\from{polyglossia.dtx}{gloss-austrian.ldf}}} +\generate{\file{gloss-bahasa.ldf}{\from{polyglossia.dtx}{gloss-bahasa.ldf}}} \generate{\file{gloss-bahasai.ldf}{\from{polyglossia.dtx}{gloss-bahasai.ldf}}} \generate{\file{gloss-bahasam.ldf}{\from{polyglossia.dtx}{gloss-bahasam.ldf}}} \generate{\file{gloss-basque.ldf}{\from{polyglossia.dtx}{gloss-basque.ldf}}} +\generate{\file{gloss-belarusian.ldf}{\from{polyglossia.dtx}{gloss-belarusian.ldf}}} \generate{\file{gloss-bengali.ldf}{\from{polyglossia.dtx}{gloss-bengali.ldf}}} +\generate{\file{gloss-bosnian.ldf}{\from{polyglossia.dtx}{gloss-bosnian.ldf}}} \generate{\file{gloss-brazil.ldf}{\from{polyglossia.dtx}{gloss-brazil.ldf}}} \generate{\file{gloss-breton.ldf}{\from{polyglossia.dtx}{gloss-breton.ldf}}} +\generate{\file{gloss-british.ldf}{\from{polyglossia.dtx}{gloss-british.ldf}}} \generate{\file{gloss-bulgarian.ldf}{\from{polyglossia.dtx}{gloss-bulgarian.ldf}}} +\generate{\file{gloss-canadian.ldf}{\from{polyglossia.dtx}{gloss-canadian.ldf}}} +\generate{\file{gloss-canadien.ldf}{\from{polyglossia.dtx}{gloss-canadien.ldf}}} \generate{\file{gloss-catalan.ldf}{\from{polyglossia.dtx}{gloss-catalan.ldf}}} \generate{\file{gloss-coptic.ldf}{\from{polyglossia.dtx}{gloss-coptic.ldf}}} \generate{\file{gloss-croatian.ldf}{\from{polyglossia.dtx}{gloss-croatian.ldf}}} @@ -133,7 +140,9 @@ issues and follow progress. \generate{\file{gloss-friulian.ldf}{\from{polyglossia.dtx}{gloss-friulian.ldf}}} \generate{\file{gloss-gaelic.ldf}{\from{polyglossia.dtx}{gloss-gaelic.ldf}}} \generate{\file{gloss-galician.ldf}{\from{polyglossia.dtx}{gloss-galician.ldf}}} +\generate{\file{gloss-georgian.ldf}{\from{polyglossia.dtx}{gloss-georgian.ldf}}} \generate{\file{gloss-german.ldf}{\from{polyglossia.dtx}{gloss-german.ldf}}} +\generate{\file{gloss-germanb.ldf}{\from{polyglossia.dtx}{gloss-germanb.ldf}}} \generate{\file{gloss-greek.ldf}{\from{polyglossia.dtx}{gloss-greek.ldf}}} \generate{\file{gloss-hebrew.ldf}{\from{polyglossia.dtx}{gloss-hebrew.ldf}}} \generate{\file{gloss-hindi.ldf}{\from{polyglossia.dtx}{gloss-hindi.ldf}}} @@ -150,8 +159,12 @@ issues and follow progress. \generate{\file{gloss-lao.ldf}{\from{polyglossia.dtx}{gloss-lao.ldf}}} \generate{\file{gloss-latex.ldf}{\from{polyglossia.dtx}{gloss-latex.ldf}}} \generate{\file{gloss-latin.ldf}{\from{polyglossia.dtx}{gloss-latin.ldf}}} +\generate{\file{gloss-latinclassic.ldf}{\from{polyglossia.dtx}{gloss-latinclassic.ldf}}} +\generate{\file{gloss-latinecclesiastic.ldf}{\from{polyglossia.dtx}{gloss-latinecclesiastic.ldf}}} +\generate{\file{gloss-latinmedieval.ldf}{\from{polyglossia.dtx}{gloss-latinmedieval.ldf}}} \generate{\file{gloss-latvian.ldf}{\from{polyglossia.dtx}{gloss-latvian.ldf}}} \generate{\file{gloss-lithuanian.ldf}{\from{polyglossia.dtx}{gloss-lithuanian.ldf}}} +\generate{\file{gloss-lowersorbian.ldf}{\from{polyglossia.dtx}{gloss-lowersorbian.ldf}}} \generate{\file{gloss-lsorbian.ldf}{\from{polyglossia.dtx}{gloss-lsorbian.ldf}}} \generate{\file{gloss-macedonian.ldf}{\from{polyglossia.dtx}{gloss-macedonian.ldf}}} \generate{\file{gloss-magyar.ldf}{\from{polyglossia.dtx}{gloss-magyar.ldf}}} @@ -159,14 +172,19 @@ issues and follow progress. \generate{\file{gloss-malayalam.ldf}{\from{polyglossia.dtx}{gloss-malayalam.ldf}}} \generate{\file{gloss-marathi.ldf}{\from{polyglossia.dtx}{gloss-marathi.ldf}}} \generate{\file{gloss-mongolian.ldf}{\from{polyglossia.dtx}{gloss-mongolian.ldf}}} +\generate{\file{gloss-naustrian.ldf}{\from{polyglossia.dtx}{gloss-naustrian.ldf}}} +\generate{\file{gloss-newzealand.ldf}{\from{polyglossia.dtx}{gloss-newzealand.ldf}}} +\generate{\file{gloss-ngerman.ldf}{\from{polyglossia.dtx}{gloss-ngerman.ldf}}} \generate{\file{gloss-nko.ldf}{\from{polyglossia.dtx}{gloss-nko.ldf}}} \generate{\file{gloss-norsk.ldf}{\from{polyglossia.dtx}{gloss-norsk.ldf}}} \generate{\file{gloss-norwegian.ldf}{\from{polyglossia.dtx}{gloss-norwegian.ldf}}} +\generate{\file{gloss-nswissgerman.ldf}{\from{polyglossia.dtx}{gloss-nswissgerman.ldf}}} \generate{\file{gloss-nynorsk.ldf}{\from{polyglossia.dtx}{gloss-nynorsk.ldf}}} \generate{\file{gloss-occitan.ldf}{\from{polyglossia.dtx}{gloss-occitan.ldf}}} \generate{\file{gloss-persian.ldf}{\from{polyglossia.dtx}{gloss-persian.ldf}}} \generate{\file{gloss-piedmontese.ldf}{\from{polyglossia.dtx}{gloss-piedmontese.ldf}}} \generate{\file{gloss-polish.ldf}{\from{polyglossia.dtx}{gloss-polish.ldf}}} +\generate{\file{gloss-polutonikogreek.ldf}{\from{polyglossia.dtx}{gloss-polutonikogreek.ldf}}} \generate{\file{gloss-portuges.ldf}{\from{polyglossia.dtx}{gloss-portuges.ldf}}} \generate{\file{gloss-portuguese.ldf}{\from{polyglossia.dtx}{gloss-portuguese.ldf}}} \generate{\file{gloss-romanian.ldf}{\from{polyglossia.dtx}{gloss-romanian.ldf}}} @@ -177,11 +195,15 @@ issues and follow progress. \generate{\file{gloss-sanskrit.ldf}{\from{polyglossia.dtx}{gloss-sanskrit.ldf}}} \generate{\file{gloss-scottish.ldf}{\from{polyglossia.dtx}{gloss-scottish.ldf}}} \generate{\file{gloss-serbian.ldf}{\from{polyglossia.dtx}{gloss-serbian.ldf}}} +\generate{\file{gloss-serbianc.ldf}{\from{polyglossia.dtx}{gloss-serbianc.ldf}}} \generate{\file{gloss-slovak.ldf}{\from{polyglossia.dtx}{gloss-slovak.ldf}}} +\generate{\file{gloss-slovene.ldf}{\from{polyglossia.dtx}{gloss-slovene.ldf}}} \generate{\file{gloss-slovenian.ldf}{\from{polyglossia.dtx}{gloss-slovenian.ldf}}} \generate{\file{gloss-sorbian.ldf}{\from{polyglossia.dtx}{gloss-sorbian.ldf}}} \generate{\file{gloss-spanish.ldf}{\from{polyglossia.dtx}{gloss-spanish.ldf}}} +\generate{\file{gloss-spanishmx.ldf}{\from{polyglossia.dtx}{gloss-spanishmx.ldf}}} \generate{\file{gloss-swedish.ldf}{\from{polyglossia.dtx}{gloss-swedish.ldf}}} +\generate{\file{gloss-swissgerman.ldf}{\from{polyglossia.dtx}{gloss-swissgerman.ldf}}} \generate{\file{gloss-syriac.ldf}{\from{polyglossia.dtx}{gloss-syriac.ldf}}} \generate{\file{gloss-tamil.ldf}{\from{polyglossia.dtx}{gloss-tamil.ldf}}} \generate{\file{gloss-telugu.ldf}{\from{polyglossia.dtx}{gloss-telugu.ldf}}} @@ -190,6 +212,7 @@ issues and follow progress. \generate{\file{gloss-turkish.ldf}{\from{polyglossia.dtx}{gloss-turkish.ldf}}} \generate{\file{gloss-turkmen.ldf}{\from{polyglossia.dtx}{gloss-turkmen.ldf}}} \generate{\file{gloss-ukrainian.ldf}{\from{polyglossia.dtx}{gloss-ukrainian.ldf}}} +\generate{\file{gloss-uppersorbian.ldf}{\from{polyglossia.dtx}{gloss-uppersorbian.ldf}}} \generate{\file{gloss-urdu.ldf}{\from{polyglossia.dtx}{gloss-urdu.ldf}}} \generate{\file{gloss-usorbian.ldf}{\from{polyglossia.dtx}{gloss-usorbian.ldf}}} \generate{\file{gloss-vietnamese.ldf}{\from{polyglossia.dtx}{gloss-vietnamese.ldf}}} @@ -200,8 +223,11 @@ issues and follow progress. \generate{\file{farsidigits.map}{\from{polyglossia.dtx}{farsidigits.map}}} \generate{\file{thaidigits.map}{\from{polyglossia.dtx}{thaidigits.map}}} \def\MetaPrefix{-- } -\generate{\file{polyglossia-frpt.lua}{\from{polyglossia.dtx}{polyglossia-frpt.lua}}} +\generate{\file{polyglossia-french.lua}{\from{polyglossia.dtx}{polyglossia-french.lua}}} \generate{\file{polyglossia-korean.lua}{\from{polyglossia.dtx}{polyglossia-korean.lua}}} +\generate{\file{polyglossia-latin.lua}{\from{polyglossia.dtx}{polyglossia-latin.lua}}} +\generate{\file{polyglossia-punct.lua}{\from{polyglossia.dtx}{polyglossia-punct.lua}}} +\generate{\file{polyglossia-sanskrit.lua}{\from{polyglossia.dtx}{polyglossia-sanskrit.lua}}} \generate{\file{polyglossia-tibt.lua}{\from{polyglossia.dtx}{polyglossia-tibt.lua}}} \generate{\file{polyglossia.lua}{\from{polyglossia.dtx}{polyglossia.lua}}} \let\MetaPrefix\DoubleperCent @@ -225,6 +251,7 @@ issues and follow progress. \usepackage{color} \usepackage{xspace,fancyvrb,booktabs} \usepackage[neverdecrease]{paralist} +\usepackage[format=hang,labelfont=bf,labelsep=period]{caption} \definecolor{myblue}{rgb}{0.02,0.04,0.48} \definecolor{lightblue}{rgb}{0.61,.8,.8} \definecolor{myred}{rgb}{0.65,0.04,0.07} @@ -247,7 +274,7 @@ issues and follow progress. \usepackage[babelshorthands]{polyglossia} \usepackage{farsical} \setmainlanguage[variant=british,ordinalmonthday=false]{english} -\setotherlanguages{arabic,armenian,hebrew,syriac,greek,russian,serbian,catalan} +\setotherlanguages{arabic,armenian,hebrew,syriac,greek,russian,serbian,catalan,georgian} \usepackage[protrusion]{microtype} \newcommand*\Cmd[1]{\cmd{#1}\DescribeMacro{#1}\xspace} \newcommand*\pkg[1]{\textsf{\color{myblue}#1}} @@ -298,6 +325,7 @@ issues and follow progress. \newfontfamily\armenianfont[Script=Armenian]{DejaVu Sans} \newfontfamily\syriacfont[Script=Syriac]{Serto Jerusalem} \newfontfamily\hebrewfont[Script=Hebrew]{Ezra SIL} +\newfontfamily\georgianfont{DejaVu Serif} \linespread{1.05} \frenchspacing @@ -334,6 +362,8 @@ issues and follow progress. % \maketitle % \tableofcontents % +% \condbreak{4\baselineskip} +% % % \DeleteShortVerb{\|} % \MakeShortVerb{\¦} @@ -364,8 +394,8 @@ issues and follow progress. % calendars are supported). % \item For languages that have their own numbering system, modifying the formatting % of numbers appropriately (this also includes redefining the alphabetic sequence -% for non-Latin alphabets).\footnote{ % -% For the Arabic script this is now done by the bundled package \pkg{arabicnumbers}.} +% for non-Latin alphabets).\footnote{% +% This is done by bundled sub-packages such as \pkg{arabicnumbers}.} % \item Ensuring proper directionality if the document contains languages % that are written from right to left (via the package \pkg{bidi}, % available separately). @@ -414,48 +444,47 @@ issues and follow progress. % \subsection{Supported languages} % % Table~\ref{tab:lang} lists all languages currently supported. -% Those in red have specific options and/or commands +% Those in \TR{red} have specific options and/or commands % that are explained in section \ref{specific} below. % % \begin{table}[ht]\centering -% \label{tab:lang} -% ^^A Produced with tools/insert-language-list.rb -- JS, 2019-10-18 -% ^^A Edited by hand -- JS, 2019-10-18 +% \caption{\label{tab:lang}Languages currently supported in \pkg{polyglossia}} +% ^^A Produced with tools/insert-language-list.rb -- JS, 2019-11-01 +% ^^A Edited by hand -- JS, 2019-11-01 % \begin{tabular}{lllll} % \toprule -% albanian & \TX{dutch} & interlingua & \TX{mongolian} & \TX{slovenian}\\ -% amharic & \TX{english} & \TX{italian} & nko & \TX{sorbian}\\ -% \TX{arabic} & \TX{esperanto} & japanese & \TX{norwegian} & spanish\\ -% \TX{armenian}& estonian & kannada & occitan & swedish\\ -% asturian & \TX{finnish} & khmer & \TX{persian} & \TX{syriac}\\ -% basque & \TX{french} & \TX{korean} & piedmontese & tamil\\ -% \TX{bengali} & friulian & \TX{kurdish} & polish & telugu\\ -% breton & \TX{gaelic} & \TX{lao} & \TX{portuguese} & \TX{thai}\\ -% bulgarian & galician & \TX{latin} & romanian & \TX{tibetan}\\ -% \TX{catalan} & \TX{german} & latvian & romansh & turkish\\ -% coptic & \TX{greek} & lithuanian & \TX{russian} & turkmen\\ -% croatian & \TX{hebrew} & macedonian & \TX{sami} & \TX{ukrainian}\\ -% \TX{czech} & \TX{hindi} & \TX{malay} & \TX{sanskrit} & urdu\\ -% danish & \TX{hungarian} & malayalam & \TX{serbian} & vietnamese\\ -% divehi & icelandic & marathi & slovak & \TX{welsh}\\ +% \TX{afrikaans} & danish & \TX{hungarian} & 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} & 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} & vietnamese \\ +% croatian & \TX{hebrew} & \TX{malay} & \TX{serbian} & \TX{welsh} \\ +% \TX{czech} & \TX{hindi} & malayalam & \TX{slovak} & \\ % \bottomrule % \end{tabular} % -% -% \caption{Languages currently supported in \pkg{polyglossia}} % \end{table} % % \paragraph{Version Notes} The support for Amharic\new{v1.0.1} should be considered an experimental attempt to -% port the package \pkg{ethiop}.\footnote{Feedback is welcome.} +% port the package \pkg{ethiop}; feedback is welcome. % Version 1.1.1\new{v1.1.1} added support for Asturian, %\footnote{ Provided by Kevin Godby and Xuacu Saturio.}, % Lithuanian, %\footnote{ Provided by Kevin Godby and Paulius Sladkevičius.}, % and Urdu. %\footnote{ Provided by Kamal Abdali.} % ^^A -% Version 1.2\new{v1.2.0} adds support for Armenian, Occitan, Bengali, +% Version 1.2\new{v1.2.0} introduced Armenian, Occitan, Bengali, % Lao, Malayalam, Marathi, Tamil, Telugu, and Turkmen.\footnote{% % See acknowledgements at the end for due credit to the various contributors.} -% Version 1.43\new{v1.43} silently introduced basic support for Japanese. This -% is considered experimental, and feedback is appreciated. +% Version 1.43\new{v1.43} brought basic support for Japanese (this +% is considered experimental, feedback is appreciated). % In version 1.45\new{v1.45}, support for Kurdish and Mongolian as well as some new % variants (Canadian French and English) have been added. Furthermore, for consistency reasons, some language have % been renamed (\emph{farsi}\textrightarrow\emph{persian}, \emph{friulan}\textrightarrow\emph{friulian}, @@ -465,67 +494,83 @@ issues and follow progress. % \emph{lsorbian}\slash\emph{usorbian}\textrightarrow\emph{sorbian}, % \emph{irish}\slash\emph{scottish}\textrightarrow\emph{gaelic}, % \emph{norsk}\slash\emph{nynorsk}\textrightarrow\emph{norwegian}). The old names are still supported for backwards -% compatibility reasons, but they might not give access to newer language features. +% compatibility reasons. +% Version 1.46\new{v1.46} introduces support for Afrikaans, Belarusian, Bosnian and Georgian. % % -% \subsection{Relation to Babel languages} +% \subsection{Relation to and use of Babel language names} % % If you are familiar with the \pkg{babel} package, you will note that \pkg{polyglossia}'s language naming % slightly differs. Whereas \pkg{babel} has a unique name for each language variety (\eg\emph{american} and \emph{british}), -% \pkg{polyglossia} differentiates language varieties via language options. +% \pkg{polyglossia} differentiates language varieties via language options (\eg \emph{english}, ¦variant=american¦). % -% Furthermore, \pkg{babel} uses sometimes abbreviations for language names (\eg\emph{bahasam} for Bahasa Malayu) as well +% Furthermore, \pkg{babel} sometimes uses abbreviated language names (\eg\emph{bahasam} for Bahasa Malayu) as well % as endonyms, \ie language names coming from the designated languages (such as \emph{bahasa}, \emph{canadien} or \emph{magyar}). % As opposed to this, \pkg{polyglossia} always uses spelled-out (lower-cased) English language names. -% -% Table~\ref{tab:bbllang} lists the language names that differ in both packages. \pkg{Babel} names marked in red can also be used -% in \pkg{polyglossia} as an alias.\footnote{This is for historical reasons, since earlier versions of \pkg{polyglossia} used -% those names as well. Note, however, that you need to use the matching language switching commands, then, as -% well, \eg \cmd\textportuges\ with \emph{portuges} (rather than \cmd\textportuguese).} +% Please refer to table~\ref{tab:bbllang} for the differing language names in both packages. % % \begin{table} -% \label{tab:bbllang} +% \caption{\label{tab:bbllang}Babel-polyglossia language name matching} +% +% \begin{minipage}[t]{1\columnwidth} +% \small\centering % \begin{tabular}{lll} % \toprule % \textbf{Babel name} & \textbf{Polyglossia name} & \textbf{Polyglossia options}\tabularnewline % \midrule -% acadien & french & variant=acadian \\ -% american & english & \emph{(default)} \\ -% australian & english & variant=australian \\ -% austrian & german & variant=austrian, spelling=old \\ -% bahasa & malay & \emph{(default)} \\ -% \TR{bahasam} & malay & variant=malaysian \\ -% \TR{brazil} & portuguese & variant=brazilian \\ -% british & english & variant=british \\ -% canadian & english & variant=canadian \\ -% canadien & french & variant=canadian \\ -% \TR{farsi} & persian & \\ -% \TR{friulan} & friulian & \\ -% german & german & spelling=old \\ -% \TR{irish} & gaelic & variant=irish \\ -% kurmanji & kurdish & variant=kurmanji \\ -% lowersorbian & sorbian & variant=lower \\ -% \TR{magyar} & hungarian & \\ -% naustrian & german & variant=austrian \\ -% newzealand & english & variant=newzealand \\ -% ngerman & german & \emph{(default)} \\ -% \TR{norsk} & norwegian & variant=bokmal \\ -% nswissgerman & german & variant=swiss \\ -% \TR{nynorsk} & norwegian & \emph{(default)} \\ -% polutonikogreek & greek & variant=polytonic \\ -% \TR{portuges} & portuguese & \emph{(default)} \\ -% \TR{samin} & sami & \\ -% \TR{scottish} & gaelic & variant=scottish \\ -% serbianc & serbian & script=Cyrillic \\ -% slovene & slovenian & \\ -% swissgerman & german & variant=swiss, spelling=old \\ -% uppersorbian & sorbian & variant=upper \\ +% acadien & french & variant=acadian \\ +% american & english & variant=american [\emph{default}] \\ +% australian & english & variant=australian \\ +% austrian & german & variant=austrian, spelling=old \\ +% bahasa & malay & variant=indonesian [\emph{default}] \\ +% bahasam & malay & variant=malaysian \\ +% brazil & portuguese & variant=brazilian \\ +% british & english & variant=british \\ +% canadian & english & variant=canadian \\ +% canadien & french & variant=canadian \\ +% farsi & persian & \\ +% friulan & friulian & \\ +% german\footnote{Due to the name conflict only available in \pkg{polyglossia} as \emph{germanb} (which is a \pkg{babel} synonym).} +% & german & spelling=old \\ +% irish & gaelic & variant=irish [\emph{default}] \\ +% kurmanji & kurdish & variant=kurmanji \\ +% latin.classic\footnote{Available in \pkg{polyglossia} as \emph{latinclassic} (as dots are invalid in command names).} +% & latin & variant=classic \\ +% latin.ecclesiastic\footnote{Available in \pkg{polyglossia} as \emph{latinecclesiastic} (as dots are invalid in command names).} +% & latin & variant=ecclesiastic \\ +% latin.medieval\footnote{Available in \pkg{polyglossia} as \emph{latinmedieval} (as dots are invalid in command names).} +% & latin & variant=medieval \\ +% lowersorbian & sorbian & variant=lower \\ +% magyar & hungarian & \\ +% naustrian & german & variant=austrian \\ +% newzealand & english & variant=newzealand \\ +% ngerman & german & variant=german [\emph{default}] \\ +% norsk & norwegian & variant=bokmal \\ +% nswissgerman & german & variant=swiss \\ +% nynorsk & norwegian & variant=nynorsk [\emph{default}] \\ +% polutonikogreek & greek & variant=polytonic \\ +% portuges & portuguese & variant=portuguese [\emph{default}] \\ +% samin & sami & \\ +% scottish & gaelic & variant=scottish \\ +% serbianc & serbian & script=Cyrillic \\ +% slovene & slovenian & \\ +% spanishmx & spanish & variant=mexican \\ +% swissgerman & german & variant=swiss, spelling=old \\ +% uppersorbian & sorbian & variant=upper \\ % \bottomrule % \end{tabular} +% \end{minipage} % -% \caption{Babel-polyglossia language name matching} % \end{table} % +% For convenience reasons, \pkg{polyglossia} also supports the use of babel names\new{v1.46} (for the few justified +% exceptions, please refer to the notes in table~\ref{tab:bbllang}). +% The babel names listed in table~\ref{tab:bbllang} can be used instead of the corresponding polyglossia +% name\slash options in \cmd\setdefaultlanguage\ and \cmd\setotherlanguage\ as well as in the \pkg{polyglossia} and +% \pkg{babel} language switching commands\slash environments documented in section~\ref{sec:langcmds} and +% \ref{sec:babelcmds} (\eg \cmd\textaustrian\ is synonymous to \cmd{\textgerman[variant=austrian,spelling=old]}). +% However, unless you have special reasons, we strongly encourage you to use the \pkg{polyglossia} names. +% % % \subsection{Global options} % @@ -533,65 +578,75 @@ issues and follow progress. % % \begin{itemize} % \item \TB{babelshorthands}\new{v1.1.1} globally activates \pkg{babel} -% shorthands whenever available. Currently shorthands are implemented for -% Catalan, Czech, Dutch, Finnish, German, Italian, Mongolian, and Russian. -% Please refer to the respective language descriptions (sec.~\ref{specific}) for details. -% -% \item \TB{localmarks} redefines the internal \LaTeX\ macros \cmd\markboth\ and \cmd\markright. -% In earlier versions of \pkg{polyglossia},\new{v1.2.0} this option was set by default, but we -% now realize that it causes more problems than it helps, so it is now off by default. -% For backwards-compatibility, the option \TB{nolocalmarks} which used to switch off the previous -% default, and now does nothing, is still available. -% -% \item \TB{quiet} turns off most info messages and some of the warnings issued by \LaTeX, -% \pkg{fontspec} and \pkg{polyglossia}. +% shorthands whenever available. Currently shorthands are implemented for +% Afrikaans, Belarusian, Catalan, Czech, Dutch, Finnish, Georgian, German, +% Italian, Latin, Mongolian, Russian, and Slovak. Please refer to the respective +% language descriptions (sec.~\ref{specific}) for details. +% +% \item \TB{localmarks} redefines the internal \LaTeX\ macros \cmd\markboth\ and +% \cmd\markright. In earlier versions of \pkg{polyglossia},\new{v1.2.0} this +% option was set by default, but we now realize that it causes more problems +% than it helps, so it is now off by default. For backwards-compatibility, the +% option \TB{nolocalmarks} which used to switch off the previous default, and +% now does nothing, is still available. +% +% \item \TB{quiet} turns off most info messages and some of the warnings issued +% by \LaTeX, \pkg{fontspec} and \pkg{polyglossia}. % \end{itemize} % % \section{Language-switching commands}\label{languageswitching} % -% \subsection{Recommended commands} +% \subsection{Recommended commands}\label{sec:langcmds} % For each activated language the command % \cmd{\text⟨lang⟩[⟨options⟩]\{…\}} \DescribeMacro{\text⟨lang⟩} +% (as well as the synonymous \DescribeMacro{\textlang}% +% \cmd{\textlang[⟨options⟩]\{⟨lang⟩\}\{…\}}\new{1.46}) % becomes available for short insertions of text in that language. -% For example ¦\textrussian{\today}¦ yields \textrussian{\today} -% This command switches to the correct hyphenation patterns, it activates +% For example ¦\textrussian{\today}¦ and ¦\textlang{russian}{\today}¦ yield \textrussian{\today} +% The commands switch to the correct hyphenation patterns, they activate % some extra features for the selected language (such as extra spacing before -% punctuation in French), and it translates the date when using ¦\today¦. -% It does not, however, translate so-called \textit{caption strings}, i.\,e. +% punctuation in French), and they translate the date when using ¦\today¦. +% They do not, however, translate so-called \textit{caption strings},\ie % ``chapter'', ``figure'' etc., to the local language (these remain in the main % language). % % The\DescribeEnv{⟨lang⟩}\ environment ¦⟨lang⟩¦, which is also available for any activated language, -% is meant for longer passages of text. It behaves slightly different than the \cmd{\text⟨lang⟩\{…\}} -% command: It does everything the latter does, but additionally, the caption strings are translated -% as well, and the language is also passed to auxiliary files, the table of contents and the lists of -% figures/tables. -% Like the command, the environment provides the possibility of setting language options locally. +% is meant for longer passages of text. It behaves slightly different than the \cmd{\text⟨lang⟩} and +% \cmd\textlang\ commands: It does everything the latter do, but additionally, the caption strings +% are translated as well, and the language is also passed to auxiliary files, the table of contents +% and the lists of figures/tables. +% Like the commands, the environment provides the possibility of setting language options locally. % For instance the following allows us to quote the beginning % of Homer’s \textit{Iliad}: % % \begin{Verbatim}[formatcom=\color{myblue}] -% \begin{greek}[variant=ancient] -% μῆνιν ἄειδε θεὰ Πηληϊάδεω Ἀχιλῆος οὐλομένην, ἣ μυρί' Ἀχαιοῖς ἄλγε' -% ἔθηκε, πολλὰς δ' ἰφθίμους ψυχὰς Ἄϊδι προί̈αψεν ἡρώων, αὐτοὺς δὲ ἑλώρια -% τεῦχε κύνεσσιν οἰωνοῖσί τε πᾶσι, Διὸς δ' ἐτελείετο βουλή, ἐξ οὗ δὴ τὰ -% πρῶτα διαστήτην ἐρίσαντε Ἀτρεί̈δης τε ἄναξ ἀνδρῶν καὶ δῖος Ἀχιλλεύς. -% \end{greek} +% \begin{quote} +% \begin{greek}[variant=ancient] +% μῆνιν ἄειδε θεὰ Πηληϊάδεω Ἀχιλῆος οὐλομένην, ἣ μυρί' Ἀχαιοῖς +% ἄλγε' ἔθηκε, πολλὰς δ' ἰφθίμους ψυχὰς Ἄϊδι προί̈αψεν ἡρώων, +% αὐτοὺς δὲ ἑλώρια τεῦχε κύνεσσιν οἰωνοῖσί τε πᾶσι, Διὸς δ' +% ἐτελείετο βουλή, ἐξ οὗ δὴ τὰ πρῶτα διαστήτην ἐρίσαντε Ἀτρεί̈δης +% τε ἄναξ ἀνδρῶν καὶ δῖος Ἀχιλλεύς. +% \end{greek} +% \end{quote} % \end{Verbatim} % +% \vspace{-.5\baselineskip} +% +% \begin{quote} % \begin{greek}[variant=ancient] % μῆνιν ἄειδε θεὰ Πηληϊάδεω Ἀχιλῆος οὐλομένην, ἣ μυρί' Ἀχαιοῖς ἄλγε' ἔθηκε, % πολλὰς δ' ἰφθίμους ψυχὰς Ἄϊδι προί̈αψεν ἡρώων, αὐτοὺς δὲ ἑλώρια τεῦχε κύνεσσιν % οἰωνοῖσί τε πᾶσι, Διὸς δ' ἐτελείετο βουλή, ἐξ οὗ δὴ τὰ πρῶτα διαστήτην ἐρίσαντε % Ἀτρεί̈δης τε ἄναξ ἀνδρῶν καὶ δῖος Ἀχιλλεύς. % \end{greek} -% \bigskip +% \end{quote} % % \noindent\DescribeEnv{Arabic} Note that for Arabic one cannot use the environment ¦arabic¦, % as \cmd\arabic\ is defined internally by \LaTeX. In this case % we need to use the environment ¦Arabic¦ instead. % -% \subsection{Babel commands} +% \subsection{Babel commands}\label{sec:babelcmds} % Some macros defined in \pkg{babel}’s \file{hyphen.cfg} (and thus usually % compiled into the \XeLaTeX\ and \LuaLaTeX\ format) are redefined, but keep a % similar behaviour. @@ -605,7 +660,7 @@ issues and follow progress. % ¦\selectlanguage{⟨lang⟩}¦ and the ¦otherlanguage¦ environment are identical to the % the ¦⟨lang⟩¦ environment, except that ¦\selectlanguage{⟨lang⟩}¦ % does not need to be explicitly closed. The command ¦\foreinlanguage{⟨lang⟩}{…}¦ and the ¦otherlanguage*¦ -% environment are identical with the use of the ¦\text⟨lang⟩¦ command, with the one +% environment are identical with the use of the ¦\text⟨lang⟩¦ or ¦\textlang¦ command, with the one % notable exception that they do not translate the date with ¦\today¦. % % Since the \XeLaTeX\ and \LuaLaTeX\ format incorporate \pkg{babel}’s \file{hyphen.cfg}, @@ -614,12 +669,13 @@ issues and follow progress. % % \subsection{Other commands} % The following commands are probably of lesser interest to the end user, but -% ought to be mentioned here. +% ought to be mentioned here.\footnote{Note that these commands require polyglossia +% language names; they do not support language\slash babel aliases.} % \begin{itemize} -% \item \Cmd\selectbackgroundlanguage: this selects the global font setup and -% the numbering definitions for the default language. +% \item \DescribeMacro{\selectbackgroundlanguage}\cmd{\selectbackgroundlanguage\{⟨lang⟩\}}: +% this selects the global font setup and the numbering definitions for the default language. % -% \item \Cmd\resetdefaultlanguage\ (experimental): +% \item \DescribeMacro{\resetdefaultlanguage}\cmd{\resetdefaultlanguage[⟨options⟩]\{⟨lang⟩\}} (experimental): % completely switches the default language % to another one in the middle of a document: \textit{this may have adverse effects}! % @@ -630,9 +686,34 @@ issues and follow progress. % % \item \Cmd\latinalph: Representation of counter as a lower-case letter: 1 = a, 2 = b, etc. % -% \item \Cmd\latinAlph: Representation of counter as a uper-case letter: 1 = A, 2 = B, etc. +% \item \Cmd\latinAlph: Representation of counter as a upper-case letter: 1 = A, 2 = B, etc. % \end{itemize} % +% +% \subsection{Setting up alias commands} +% +% By means of the macro +% \displaycmd{\setlanguagealias[⟨options⟩]\{⟨language⟩\}\{⟨alias⟩\}}{\setlanguagealias}\new{v1.46} +% you can define alias commands for specific language (variants). \Eg +% +% \begin{quote} +% \begin{verbatim} +% \setlanguagealias[variant=austrian]{german}{deAT} +% \end{verbatim} +% \end{quote} +% ^^A +% will define a command \cmd{\textdeAT} as well as an environment ¦{deAT}¦ which will link towards +% the command \cmd{\textgerman[variant=austrian]} and the environment ¦{german}[variant=austrian]¦, +% respectively. The aliases can also be used in the language switching commands described in +% section~\ref{sec:langcmds} and \ref{sec:babelcmds}. +% Note, though, that the usual restrictions for command names apply, so something such as +% ¦de-AT¦ or ¦de_AT¦ will not work since ¦-¦ and ¦_¦ are not allowed in command names. +% +% For the latter case, and for the case where an alias would clash with an existing \cmd{\text⟨...⟩} +% command (\eg ¦\textit¦), a starred version \Cmd{\setlanguagealias*} is provided which does not define +% a \cmd{\text⟨alias⟩} command (but which will set up the alias for everything else, including +% \cmd{\textlang\{⟨alias⟩\}}). +% % \section{Font setup} % % With polyglossia it is possible to associate a specific font with any script or language @@ -641,11 +722,12 @@ issues and follow progress. % For instance, if the default font defined by \cmd\setmainfont\ % does not support Greek, then one can define the font used to display Greek with:\\ % \centerline{ \cmd\newfontfamily\cmd{\greekfont[Script=Greek,⟨…⟩]\{⟨font⟩\}}. } -% Note that polyglossia will use the font thus defined as is. -% for instance if ¦\arabicfont¦ is explicitly defined, then one should take care of -% including the option ¦Script=Arabic¦ in that definition. -% See the \pkg{fontspec} documentation for more information. -% If a specific sans or monospace font is needed for a particular script or language, +% Note that polyglossia will use the font defined as is, so assure to do all necessary settings +% (please refer to the \pkg{fontspec} documentation for details). +% For instance, if ¦\arabicfont¦ is explicitly defined, then the option ¦Script=Arabic¦ should +% be included in that definition. +% +% If a specific sans serif or monospace (`teletype') font is needed for a particular script or language, % it can be defined by means of \new{v1.2.0} % ¦\⟨script⟩fontsf¦\ or ¦\⟨language⟩fontsf¦ and ¦\⟨script⟩fonttt¦\ or ¦\⟨language⟩fonttt¦, respectively. % @@ -674,7 +756,7 @@ issues and follow progress. % \end{Verbatim} % ^^A % These exceptions, however, apply to all languages. In addition to this, \pkg{polyglossia} provides -% the command\new{v.1.45} +% the command\new{v1.45} % \displaycmd{\pghyphenation[⟨options⟩]\{⟨lang⟩\}\{⟨exceptions⟩\}}{\pghyphenation} % which can be used to define exceptions that only apply to a specific language or language variant, % respectively. @@ -695,6 +777,24 @@ issues and follow progress. % % ^^A\subsection{amharic}\label{amharic} % +% \subsection{afrikaans}\label{afikaans} +% \paragraph*{Options:} +% \begin{itemize} +% \item \TB{babelshorthands} = \textit{false} or true. \new{v1.1.1} +% if this is turned on, the following shorthands defined for fine-tuning hyphenation and +% micro-typography of Afrikaans words are activated: +% \begin{shorthands} +% \item[¦"-¦] adds a hyphenation point that does still allow for hyphenation at the points preset +% in the hyphenation patterns (as opposed to ¦\-¦ in default \TeX). +% \item[\texttt{"\textasciitilde}] for a hyphen sign without a breakpoint. Useful for +% cases where the hyphen should stick at the following syllable. +% \item[¦"|¦] disables a ligature at this position. +% \item[¦""¦] allows for a line break at this position (without hyphenation sign). +% \item[¦"/¦] a slash that allows for a subsequent line break. As opposed to ¦\slash¦, +% hyphenation at the breakpoints preset in the hyphenation patterns is still allowed. +% \end{shorthands} +% \end{itemize} +% % \subsection{arabic}\label{arabic} % \paragraph*{Options:} % \begin{itemize} @@ -726,6 +826,42 @@ issues and follow progress. % \item \TB{numerals}\new{v1.45} = armenian or \textit{arabic} % \end{itemize} % +% \subsection[belarusian]{belarusian\new{v1.46}}\label{belarusian} +% +% \paragraph*{Options:} +% \begin{itemize} +% \item \TB{babelshorthands} = \textit{false} or true. +% If this is turned on, the following shorthands are activated: +% \begin{shorthands} +% \item[¦"-¦] adds a hyphenation point that does still allow for hyphenation at the points preset +% in the hyphenation patterns (as opposed to ¦\-¦). +% \item[\texttt{"\textasciitilde}] for a hyphen sign without a breakpoint. Useful for +% cases where the hyphen should stick at the following syllable. +% \item[¦"|¦] disables a ligature at this position. +% \item[¦""¦] allows for a line break at this position (without hyphenation sign). +% \item[¦"---¦] Cyrillic emdash in plain text. +% \item[¦"--~¦] Cyrillic emdash in compound names (surnames). +% \item[¦"--*¦] Cyrillic emdash for denoting direct speech. +% \item[¦",¦] thinspace for initials with a breakpoint in following surname. +% \item[¦"‘¦] for German left double quotes (looks like ,,). +% \item[¦"’¦] for German right double quotes (looks like “). +% \item[¦"<¦] for French left double quotes (looks like <<). +% \item[¦">¦] for French right double quotes (looks like >>). +% \end{shorthands} +% \item \TB{numerals} = \textit{arabic} or cyrillic. Uses either Arabic numerals or Cyrillic +% alphanumerical numbering. +% \item \TB{spelling} = \textit{modern} or classic (=~tarask). With ¦spelling=classic¦, captions and dates +% adhere to the Taraškievica (or Belarusian classical) orthography rather than the standard orthography. +% \end{itemize} +% ^^A +% \paragraph*{Commands:} +% \begin{itemize} +% \item \Cmd\Asbuk: produces uppercased Cyrillic alphanumerals, for +% environments such as ¦enumerate¦. The command takes a counter as argument, +% \eg ¦\textbelarusian{\Asbuk{page}}¦ produces \textrussian{\Asbuk{page}}. +% \item \Cmd\asbuk: same in lowercase +% \end{itemize} +% % \subsection[bengali]{bengali\new{v1.2.0}}\label{bengali} % \paragraph*{Options:} % \begin{itemize} @@ -756,25 +892,25 @@ issues and follow progress. % \begin{shorthands} % \item[¦"=¦] for an explicit hyphen sign which is repeated at the beginning % of the next line when hyphenated, as common in Czech typesetting -% (also see option ¦splithyphens¦). +% (only needed with ¦splithyphens=false¦). % \item[¦"‘¦] for Czech left double quotes (looks like ,,). % \item[¦"’¦] for Czech right double quotes (looks like “). % \item[¦">¦] for Czech left double guillemets (looks like >>). % \item[¦"<¦] for Czech right double guillemets (looks like <<). % \end{shorthands} -% \item \TB{splithyphens} = \textit{false} or true. \new{v1.45} +% \item \TB{splithyphens} = false or \textit{true}.\new{v1.45} % According to Czech typesetting conventions, if a word with a hard hyphen (such as \emph{je-li}) % is hyphenated at this hyphen, a second hyphenation character is to be inserted at the beginning -% of the line that follows the hyphenation (\emph{je-/-li}).\\ -% If this option is true, this is done automatically (so the shorthand ¦"=¦ is not needed). -% Note, however, that the option is only available for \XeTeX. If you are using \LuaTeX, -% load the \pkg{luavlna} package to the same effect. -% \item \TB{vlna} = \textit{false} or true. \new{v1.45} +% of the line that follows the hyphenation (\emph{je-/-li}). +% By default, this is done automatically\new{v1.46} (if you are using \LuaTeX, the \pkg{luavlna} package is +% loaded to achieve this). +% Set this option to ¦false¦ to disable the feature. +% \item \TB{vlna} = false or \textit{true}. \new{v1.45} % According to Czech typesetting conventions, single-letter words (non-syllable prepositions) -% must not occur at line ends.\\ -% If this option is true, this is taken care of. Note, however, that the option -% is only available for \XeTeX. If you are using \LuaTeX, load the \pkg{luavlna} package -% to the same effect. +% must not occur at line ends. +% \pkg{Polyglossia} takes care of this automatically by default\new{v1.46} (if you are using \LuaTeX, the +% \pkg{luavlna} package is loaded to achieve this). +% Set this option to ¦false¦ to disable the feature. % \end{itemize} % % \subsection{dutch}\label{dutch} @@ -835,14 +971,31 @@ issues and follow progress. % \begin{itemize} % \item\TB{variant} = \textit{french} or canadian (=~acadian).\new{v1.45} % Currently, the three variants do not differ; they are supported for compatibility with \pkg{babel} (where they do not differ either). -% \item \TB{autospacing} = true or \textit{false} (default value = true). One of the most distinct features of French typography is the addition +% \item \TB{autospacing} = \textit{true} or false. One of the most distinct features of French typography is the addition % of extra spacing around punctuation and quotation marks (guillemets). By default, polyglossia adds these spaces automatically, so you don't need % to enter them. This options allows you to switch this feature off globally. -% \item \TB{autospaceguillemets}\footnote{Up to version 1.44, the option was called \textit{automaticspacesaroundguillemets}. For backards compatibility reasons, the more verbose old option is still supported.} = true or \textit{false} (default value = true). If you only want to disable the automatic addition of spacing after opening and before closing guillemets (and not at punctuation), set this to \textit{false}. Note -% that the more general option \textit{autospacing} overrides this. +% \item \TB{thincolonspace}\new{v1.46} = true or \textit{false}. Normally, a +% full (non-breaking) interword space is inserted before a colon. Use this +% option if you prefer a thinner space as used before \texttt{;}, \texttt{!}, +% and \texttt{?}. +% \item \TB{autospaceguillemets}\footnote{Up to version 1.44, the option was +% called \textit{automaticspacesaroundguillemets}. For backards compatibility +% reasons, the more verbose old option is still supported.} = \textit{true} +% or false. If you only want to disable the automatic addition of spacing +% after opening and before closing guillemets (and not at punctuation), set +% this to \textit{false}. Note that the more general option +% \textit{autospacing} overrides this. % \item \TB{autospacetypewriter}\footnote{Babel's syntax \textit{OriginalTypewriter} is also supported.}\new{1.45} = true or \textit{false} (default value = true). By default, automatic spacing is disabled in typewriter font. If this is enabled, spacing in typewriter context is the same as with roman and sans serif font, depending on the \textit{autospacing} and \textit{autospaceguillemets} settings (note that this was the default up to v.~1.44). % \item \TB{frenchfootnote} = true or \textit{false} (default value = true). If \textit{true}, footnotes start with a non-superscripted number followed by a dot, as common in French typography. Note that this might interfere with the specific footnote handling of classes or packages. % Also note that this option is only functional (by design) if French is the main language. +% \item \TB{frenchitemlabels}\new{v.1.46} = true or \textit{false} (default value = true). If \textit{true}, itemize item labels use em-dashes throughout, +% as common in French typography. +% Note that this option is only functional (by design) if French is the main language. Also, it might interfere with list packages such as \pkg{enumitem}. +% \item \TB{itemlabels}\new{v.1.46} = ¦⟨cmd⟩¦ (default value = ¦\textemdash¦). If \emph{frenchitemlabels} is true, you can customize here the used item label of all levels. +% \item \TB{itemlabeli}\new{v.1.46} = ¦⟨cmd⟩¦ (default value = ¦\textemdash¦). If \emph{frenchitemlabels} is true, you can customize here the used item label of the first level. +% \item \TB{itemlabelii}\new{v.1.46} = ¦⟨cmd⟩¦ (default value = ¦\textemdash¦). If \emph{frenchitemlabels} is true, you can customize here the used item label of the second level. +% \item \TB{itemlabeliii}\new{v.1.46} = ¦⟨cmd⟩¦ (default value = ¦\textemdash¦). If \emph{frenchitemlabels} is true, you can customize here the used item label of the third level. +% \item \TB{itemlabeliv}\new{v.1.46} = ¦⟨cmd⟩¦ (default value = ¦\textemdash¦). If \emph{frenchitemlabels} is true, you can customize here the used item label of the fourth level. % \end{itemize} % \paragraph*{Commands:} % \begin{itemize} @@ -856,6 +1009,34 @@ issues and follow progress. % \item \TB{variant} = \textit{irish} or scottish % \end{itemize} % +% \subsection[georgian]{georgian\new{v1.46}}\label{georgian} +% +% \paragraph*{Options:} +% \begin{itemize} +% \item \TB{babelshorthands} = \textit{false} or true. +% If this is turned on, the following shorthands are activated: +% \begin{shorthands} +% \item[¦"-¦] adds a hyphenation point that does still allow for hyphenation at the points preset +% in the hyphenation patterns (as opposed to ¦\-¦). +% \item[\texttt{"\textasciitilde}] for a hyphen sign without a breakpoint. Useful for +% cases where the hyphen should stick at the following syllable. +% \item[¦"|¦] disables a ligature at this position. +% \item[¦""¦] allows for a line break at this position (without hyphenation sign). +% \item[¦"---¦] Cyrillic emdash in plain text. +% \item[¦"--~¦] Cyrillic emdash in compound names (surnames). +% \item[¦"--*¦] Cyrillic emdash for denoting direct speech. +% \item[¦",¦] thinspace for initials with a breakpoint in following surname. +% \item[¦"‘¦] for German left double quotes (looks like ,,). +% \item[¦"’¦] for German right double quotes (looks like “). +% \item[¦"<¦] for French left double quotes (looks like <<). +% \item[¦">¦] for French right double quotes (looks like >>). +% \end{shorthands} +% \item \TB{numerals} = \textit{arabic} or georgian. Uses either Arabic numerals or Georgian +% alphanumerical numbering. +% \item \TB{oldmonthnames} = \textit{true} or false (default: false). Uses traditional Georgian +% month names. +% \end{itemize} +% % \subsection{german}\label{german} % \paragraph*{Options:} % \begin{itemize} @@ -897,8 +1078,9 @@ issues and follow progress. % \item[¦"<¦] for French left double quotes («) % \item[¦">¦] for French right double quotes (»). % \end{shorthands} -% \item\TB{script} = \textit{latin} or fraktur.\new{v1.2.0} -% Setting script=fraktur modifies the captions for typesetting German in Fraktur. +% \item\TB{script} = \textit{latin} or blackletter\new{v1.46} (=~fraktur\new{v1.2.0}). +% Setting ¦script=blackletter¦ adapts the captions for typesetting German in blackletter type (using the long s (ſ) +% where appropriate). % \end{itemize} % % \subsection{greek}\label{greek} @@ -939,6 +1121,27 @@ issues and follow progress. % \end{itemize} % % \subsection{hungarian}\label{hungarian} +% \paragraph*{Options:} +% \begin{itemize} +% \item \TB{swapstrings} = \textit{all}, captions, headings, headers, hheaders or none\new{v1.46} +% +% In Hungarian, some caption strings need to be in a different order than in other languages +% (\eg \emph{1. fejezet} instead of \emph{Chapter 1}). By default, \pkg{polyglossia} tries hard to +% provide the correct order for different classes and packages (standard classes, \pkg{KOMA-script}, +% \pkg{memoir}, and \pkg{titlesec} package should work, as well as \pkg{fancyhdr} and \pkg{caption}). +% However, since the definition of these strings is not standardized, the redefinitions might not work +% and even interfere badly if you use specific classes or packages that redefine the respective strings +% themselves. In this case, you can disable some or all changes. +% The possibilities are: +% \begin{itemize} +% \item ¦all¦: Redefine figure and table captions, part and chapter headings, and running headers (=~default setting) +% \item ¦captions¦: Redefine figure and table captions only +% \item ¦headings¦: Redefine part and chapter headings only +% \item ¦headers¦: Redefine running headers only +% \item ¦hheaders¦: Redefine part and chapter headings as well as running headers +% \item ¦none¦: Do not redefine anything +% \end{itemize} +% \end{itemize} % \paragraph*{Commands:} % \begin{itemize} % \item \Cmd\ontoday\ (= \Cmd\ondatehungarian): special form of \cmd\today\ which produces a slightly different @@ -973,7 +1176,6 @@ issues and follow progress. % \end{itemize} % % \subsection[kurdish]{kurdish\new{v1.45}}\label{kurdish} -% Kurdish support includes Sorani Kurdish and Kurmanji Kurdish, both in either Arabic or Latin script. % % \paragraph*{Options:} % \begin{itemize} @@ -982,9 +1184,10 @@ issues and follow progress. % \item \TB{numerals} = western or eastern. Defaults are ¦western¦ for Latin and ¦eastern¦ for Arabic script, depending on the selection above. % \item \TB{abjadjimnotail} = \textit{false} or true. % Set this to true if you want the \textit{abjad} form of the number three to be \textarabic{ج‍} – as in the manuscript tradition – instead of the modern usage \textarabic{ج}. -% \item \TB{locale} (not yet implemented) -% \item \TB{calendar} (not yet implemented) +% ^^A \item \TB{locale} (not yet implemented) +% ^^A \item \TB{calendar} (not yet implemented) % \end{itemize} +% \condbreak{2\baselineskip} % \paragraph*{Commands:} % \begin{itemize} % \item \Cmd\ontoday: special form of \cmd\today\ which produces a slightly different @@ -1001,9 +1204,152 @@ issues and follow progress. % % \subsection{latin}\label{latin} % \paragraph*{Options:} -% \begin{itemize} -% \item \TB{variant} = classic, medieval or \textit{modern} -% \end{itemize} +% \begin{itemize} +% \item \TB{variant} = classic, medieval, \emph{modern}, or ecclesiastic\new{v.1.46} +% +% These variants refer to different spelling conventions. The ¦classic¦ +% and the ¦medieval¦ variant do not use the letters \emph{U} and +% \emph{v}, but only \emph{V} and \emph{u}. This concerns predefined terms like +% month names as well as the behaviour of the \cmd\MakeUppercase\ and the +% \cmd\MakeLowercase\ command. The ¦medieval¦ and the +% ¦ecclesiastic¦ variant use the ligatures \emph{\ae} and \emph{\oe}. +% See table \ref{tab:latin-spelling} for examples. +% +% Furthermore, the \texttt{ecclesiastic} variant takes care for a punctuation +% spacing similar to French, but with smaller spaces, as provided for +% PDF\TeX\ by the \pkg{ecclesiastic} package. +% \begin{table} +% \centering +% \caption{\label{tab:latin-spelling}Spelling differences between the Latin +% language variants.\newline The capitalization of month names and the use of +% \emph{i/j} may be affected by the \texttt{capitalizemonth} and the +% \texttt{usej} option.} +% \begin{tabular}{llll} +% \toprule +% \textbf{classic} & \textbf{medieval} & \textbf{modern} & \textbf{ecclesiastic} \\ +% \midrule +% Ianuarii & Ianuarii & Ianuarii & ianuarii \\ +% Nouembris & Nouembris & Novembris & novembris \\ +% Praefatio & Præfatio & Praefatio & Præfatio \\ +% \addlinespace\multicolumn{4}{@{}l}{\cmd{\MakeUppercase\{Iulius\}} yields:} \\ +% IVLIVS & IVLIVS & IULIUS & IULIUS \\ +% \bottomrule +% \end{tabular} +% \end{table} +% \item \TB{hyphenation}\new{v.1.46} = classic, modern, or 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}} +% 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. +% Note that the liturgical hyphenation patterns are the default of none of the +% language variants. To use them, you have to say +% ¦hyphenation=liturgical¦ in any case. +% \begin{table} +% \caption{\label{tab:latin-hyphenation}Latin default hyphenation styles} +% \centering +% \begin{tabular}{ll} +% \toprule +% \textbf{Language variant} & \textbf{Default hyphenation style} \\ +% \midrule +% classic & classic \\ +% medieval & modern \\ +% modern & modern \\ +% ecclesiastic & modern \\ +% \bottomrule +% \end{tabular} +% \end{table} +% \item \TB{ecclesiasticfootnotes}\new{v.1.46} = true or \emph{false} +% +% Use footnotes as provided by the \pkg{ecclesiastic} package, which typesets +% footnotes with ordinary instead of superior numbers and without indentation. +% As many ecclesiastic documents and liturgical books use footnotes that are +% very similar to the ordinary \LaTeX\ ones, we do not use this footnote style +% as default even for the ¦ecclesiastic¦ variant. +% +% Note that this option is only possible if Latin is the main language of your +% document. +% \item \TB{usej}\new{v.1.46} = true or \emph{false} +% +% Use \emph{J/j} in predefined terms. The letter \emph{j} is not of ancient +% origin. In early modern times, it was used to distinguish the consonantic +% \emph{i} from the vocalic~\emph{i}. Nowadays, the use of \emph{j} has +% disappeared from most Latin publications. So ¦false¦ is the default +% value for all four language variants. Use this option if you prefer +% \emph{Januarii} and \emph{Maji} to \emph{Ianuarii} and \emph{Maii}. +% \item \TB{capitalizemonth}\new{v.1.46} = true or false +% +% Capitalize the month name when printing dates (using the \cmd\today\ +% command). Traditionally, month names are capitalized. However, in recent +% liturgical books they are lowercase. So ¦true¦ is the default value for +% the variants ¦classic¦, ¦medieval¦, and ¦modern¦, +% whereas ¦false¦ is the default value for the ¦ecclesiastic¦ +% variant. +% \item \TB{babelshorthands} = true or \emph{false} +% +% Enable the following shorthands inherited from \pkg{babel-latin} and the +% \pkg{ecclesiastic} package. +% \begin{shorthands} +% \item[¦"<¦] for « (left guillemet) +% \item[¦">¦] for » (right guillemet) +% \item[¦"¦] If no other shorthand applies, ¦"¦ before any letter +% character defines an optional break point allowing further break points +% within the same word (as opposed to the \cmd\- command). +% \item[¦"|¦] the same as ¦"¦, but also possible before non-letter +% characters +% \item[¦'a¦] for á (a with acute), also available for é, í, ó, ú, ý, ǽ, and +% \'œ +% \item[¦'A¦] for Á (A with acute), also available for É, Í, Ó, Ú, \'V, Ý, Ǽ, +% and \'Œ +% \end{shorthands} +% The following shorthands are only available for the ¦medieval¦ and the +% ¦ecclesiastic¦ variant. +% \begin{shorthands} +% \item[¦"ae¦] for æ (ae ligature), also available for œ +% \item[¦"Ae¦] for Æ (AE ligature), also available for Œ +% \item[¦"AE¦] for Æ (AE ligature), also available for Œ +% \item[¦'ae¦] for ǽ (ae ligature with acute), also available for \'œ +% \item[¦'Ae¦] for Ǽ (AE ligature with acute), also available for \'Œ +% \item[¦'AE¦] for Ǽ (AE ligature with acute), also available for \'Œ +% \end{shorthands} +% \item \TB{prosodicshorthands}\new{v.1.46} = true or \emph{false} +% +% Enable shorthands for prosodic marks (macrons and breves) very similiar to +% those provided by \pkg{babel-latin} using the ¦withprosodicmarks¦ +% modifier. +% +% Note that the active ¦=¦ character used for macrons will cause problems with +% commands using \texttt{key=value} interfaces, \eg +% ¦\includegraphics[scale=2]{...}¦. Use \cmd{\shorthandoff\{=\}} before +% such commands (and \cmd{\shorthandon\{=\}} thereafter) within every +% environment with prosodic shorthands enabled. +% +% The following shorthands are available. +% \begin{shorthands} +% \item[¦=a¦] for ā (a with macron), also available for ē, ī, ō, ū, and ȳ +% \item[¦=A¦] for Ā (A with macron), also available for Ē, Ī, Ō, Ū, V̄, and Ȳ. +% Note that a macron above the letter V is only displayed if your font +% supports the Unicode character ¦0304¦ (\emph{combining macron}). +% \item[¦=ae¦] for a͞e (ae diphthong with macron), also available for a͞u, e͞u, +% and o͞e. Note that macrons above diphthongs are only displayed if your font +% supports the Unicode character ¦035E¦ (\emph{combining double +% macron}). +% \item[¦=Ae¦] for A͞e (Ae diphthong with macron), also available for A͞u, E͞u, +% and O͞e. +% \item[¦=AE¦] for A͞E (AE diphthong with macron), also available for A͞U, E͞U, +% and O͞E. +% \item[¦\textasciicircum a¦] for ă (a with breve), also available for ĕ, ĭ, +% ŏ, ŭ, and y̆. Note that a breve above the letter y is only displayed if +% your font supports the Unicode character ¦0306¦ (\emph{combining +% breve}). +% \item[¦\textasciicircum A¦] Ă (A with breve), also available for Ĕ, Ĭ, Ŏ, +% Ŭ, V̆, and Y̆. Note that breves above the letters V and Y are only displayed +% if your font supports the Unicode character ¦0306¦ (\emph{combining +% breve}). +% \end{shorthands} +% \end{itemize} % % \subsection{malay}\label{malay} % \paragraph*{Options:} @@ -1043,7 +1389,7 @@ issues and follow progress. % \begin{itemize} % \item \Cmd\Asbuk: produces uppercased Cyrillic alphanumerals, for % environments such as ¦enumerate¦. The command takes a counter as argument, -% \eg ¦\textrussian{\Asbuk{page}}¦ produces \textrussian{\Asbuk{page}}. +% \eg ¦\textmongolian{\Asbuk{page}}¦ produces \textrussian{\Asbuk{page}}. % \item \Cmd\asbuk: same in lowercase % \end{itemize} % @@ -1059,8 +1405,8 @@ issues and follow progress. % \item \TB{numerals} = western or \textit{eastern} % \item \TB{abjadjimnotail} = \textit{false} or true. \new{v1.0.3} % Set this to true if you want the \textit{abjad} form of the number three to be \textarabic{ج‍} – as in the manuscript tradition – instead of the modern usage \textarabic{ج}. -% \item \TB{locale} (not yet implemented) -% \item \TB{calendar} (not yet implemented) +% ^^A \item \TB{locale} (not yet implemented) +% ^^A \item \TB{calendar} (not yet implemented) % \end{itemize} % \paragraph*{Commands:} % \begin{itemize} @@ -1096,6 +1442,9 @@ issues and follow progress. % ^^A \item[¦"<¦] for French left double quotes (looks like <<). % ^^A \item[¦">¦] for French right double quotes (looks like >>). % \end{shorthands} +% \item \TB{indentfirst}\new{v1.46} = \textit{true} or false. By default, all paragraphs are indented in Russian, +% also those after a chapter or section heading. If this option is false, the latter paragraphs +% are not indented, as normal in \LaTeX. % \item \TB{spelling} = \textit{modern} or old (for captions and date only, not for hyphenation) % \item \TB{numerals} = \textit{arabic} or cyrillic. Uses either Arabic numerals or Cyrillic % alphanumerical numbering. @@ -1115,17 +1464,17 @@ issues and follow progress. % \subsection{sanskrit}\label{sanskrit} % \paragraph*{Options:} % \begin{itemize} -% \item \TB{Script} = \textit{Devanagari}\new{v1.0.2}, Gujarati, Malayalam, Bengali, Kannada, +% \item \TB{script} = \textit{Devanagari}\new{v1.0.2}, Gujarati, Malayalam, Bengali, Kannada, % Telugu or Latin. -% The value is passed to \pkg{fontspec} in cases where the respective ¦\