Use Harfbuzz rendered by default with LuaTeX · reutenauer/polyglossia@8f47604 (original) (raw)
`@@ -67,6 +67,12 @@
`
67
67
`\xpgvalue{=} \meta{code} (default value: \texttt{#3})\par%
`
68
68
`}
`
69
69
``
``
70
`+
% arguments: #1 version number, #2 key name, #3 value type, #4 default value
`
``
71
`+
\NewDocumentCommand\xpgoptkey{ommo}{%
`
``
72
`+
\xpgoption{#2}\IfValueT{#1}{\new{#1}}
`
``
73
`+
\xpgvalue{=} \meta{#3} (default value: \texttt{#4})\par%
`
``
74
`+
}
`
``
75
+
70
76
`%% Sidenotes << copied from fontspec.dtx
`
71
77
`\newcommand\new[1]{%
`
72
78
`\edef\thisversion{v#1}%
`
141
147
`\section{Introduction}
`
142
148
``
143
149
`\pkg{Polyglossia} is a package for facilitating multilingual typesetting with
`
144
``
`-
\XeLaTeX\ and (with some exceptions) \LuaLaTeX. Basically, it
`
``
150
`+
\XeLaTeX\ and \LuaLaTeX. Basically, it
`
145
151
`can be used as an alternative to \pkg{babel} for performing the following
`
146
152
`tasks automatically:
`
147
153
``
`@@ -540,11 +546,19 @@ \subsection{Global options}
`
540
546
` option \xpgoption{nolocalmarks} which used to switch off the previous default, and
`
541
547
` now equals the default, is still available.
`
542
548
``
543
``
`-
\item \xpgoption{quiet} turns off most info messages and some of the warnings issued
`
544
``
`-
by \LaTeX, \pkg{fontspec} and \pkg{polyglossia}.
`
``
549
`+
\item \xpgoptkey[1.50]{luatexrenderer}{renderer}[Harfbuzz] determines which font renderer is used
`
``
550
`+
with \LuaTeX\ output. The correct font renderer is essential particularly for non-Latin scripts.
`
``
551
`+
By default, \pkg{polyglossia} uses the \xpgvalue{Harfbuzz} renderer that has been introduced to
`
``
552
`+
\LuaTeX\ in 2019 (\TeX Live 2020), as this gives the best results generally. If you want to use
`
``
553
`+
a different renderer, you can specify this here (or individually for specific fonts via the optional
`
``
554
`+
argument of the font selection commands). Please refer to the \pkg{fontspec} manual for supported
`
``
555
`+
values and for details on how to change the renderer for individual fonts.\
`
``
556
`+
\xpgoption{luatexrenderer=none} disables \pkg{polyglossia}'s automatic renderer setting.
`
``
557
+
``
558
`+
\item \xpgboolkeytrue{verbose} determines whether info messages and (some of the) warnings issued
`
``
559
`+
by \LaTeX, \pkg{fontspec} and \pkg{polyglossia} are output.
`
545
560
`\end{itemize}
`
546
561
``
547
``
`-
\pagebreak
`
548
562
`\section{Language-switching commands}\label{languageswitching}
`
549
563
``
550
564
`\subsection{Recommended commands}\label{sec:langcmds}
`