From 042bd26db0f11705e7d308f7a82c20d63233dada Mon Sep 17 00:00:00 2001 From: Robert Alessi Date: Tue, 24 Oct 2017 12:49:53 +0200 Subject: a few additional remarks in the documentation; updated to v1.9.2 --- arabluatex.dtx | 52 ++++++++++++++++++++++++++++++++++++++-------------- samples/al-Jahiz.tex | 2 +- 2 files changed, 39 insertions(+), 15 deletions(-) diff --git a/arabluatex.dtx b/arabluatex.dtx index 24e7e1f..5e4cf33 100644 --- a/arabluatex.dtx +++ b/arabluatex.dtx @@ -27,7 +27,7 @@ %\NeedsTeXFormat{LaTeX2e}[1999/12/01] %\ProvidesPackage{arabluatex} %<*package-info> - [2017/07/28 v1.9.1 An ArabTeX-like interface for LuaLaTeX] + [2017/10/24 v1.9.2 An ArabTeX-like interface for LuaLaTeX] % % %<*driver> @@ -155,7 +155,7 @@ \defaultfontfeatures{RawFeature={+liga}} \setmainfont{Old Standard}[SmallCapsFont={Latin Modern Roman Caps}, RawFeature={+mark;+ccmp;+ss05;+ss06}] -\usepackage{arabluatex}[2017/07/28] +\usepackage{arabluatex}[2017/10/24] \usepackage[nopar]{quran} \usepackage{varioref} \usepackage{hyperxmp} @@ -227,7 +227,7 @@ % % \fi % -% \CheckSum{0} +% \CheckSum{707} % % \CharacterTable % {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z @@ -558,6 +558,22 @@ % \item The euphonic \arb[trans]{ta^sdId} is generated (see % \vpageref{ref:euphonic-tashdid}). % \item In |fullvoc| mode, the \arb[trans]{sukUn} is expressed. +% \item In such words as \arb{^say'aN}, \arb{.zim'aN} and the like, +% the \arb[trans]{hamzaT} alone is not written over the letter +% \arb[trans]{yA'} with no diacritical points below as in +% \arb{sayy"'aN}, \arb{.zimy"'aN}, but over a horizontal stroke +% placed in the continuation of the preceding letter. % +% \iffalse +%<*example> +% \fi +\begin{arabluacode}[text only] +Please note that only few Arabic fonts provide such contrivances. In +case this feature is not supported by some Arabic font, it is +advisable to use \cs{SetArbEasy}. +\end{arabluacode} +% \iffalse +% +% \fi % \end{compactitem} % % \DescribeMacro{\SetArbEasy} \NEWfeature{v1.4.4} @@ -793,7 +809,7 @@ vowels (see ยง~3). % \arb[novoc]{h} & \dmg{h} & \loc{h} & \brill{h} & |h| \\ % \arb[novoc]{w} & \dmg{w} & \loc{w} & \brill{w} & |w| \\ % \arb[novoc]{y} & \dmg{y} & \loc{y} & \brill{y} & |y|\footnote{For -% the letter \arb[novoc]{.y} with no diacritical point below, see +% the letter \arb[novoc]{.y} with no diacritical points below, see % \emph{Rem{.} b.} below.} \\ % \arb[novoc]{T} & \dmg{aT} & \loc{aT} & \brill{aT} & |T| \\ % \bottomrule @@ -2036,11 +2052,16 @@ word that \cs{arbnull} is applied to. % \end{quote} % % \begin{quoting} -% \textsc{Rem.} As the above example shows, \package{arabluatex} -% places the horizontal stroke \emph{under} the emphasized words in -% any of the transliteration modes. -% -% \DescribeMacro{\aemph*}\NEWfeature{v1.9.2} +% \textsc{Rem.}~\emph{a.} As the above example shows, +% \package{arabluatex} places the horizontal stroke \emph{under} the +% emphasized words in any of the transliteration modes. +% +% \textsc{Rem.}~\emph{b.} \NEWfeature{v1.9.2}\DescribeMacro{\aemph*} +% \cs{aemph*} is also provided should one wish to always have the +% horizontal stroke printed over the emphasized words, like so: +% |\abjad{45}:| |kitAbu-hu| |\aemph*{fI| |'l-`AdAt-i}| +% \arb[voc]{\abjad{45}: kitAbu-hu \aemph*{fI 'l-`AdAt-i}} +% \arb[trans]{\abjad{45}: kitAbu-hu \aemph*{fI 'l-\cap{`AdAt-i}}}. % \end{quoting} % % \section{Arabic poetry} @@ -3329,7 +3350,7 @@ wa-ya.sIru ta.hta 'l-jild-i % \begin{macrocode} \NeedsTeXFormat{LaTeX2e} \ProvidesPackage{arabluatex}% -[2017/07/28 v1.9.1 An ArabTeX-like interface for LuaLaTeX] +[2017/10/24 v1.9.2 An ArabTeX-like interface for LuaLaTeX] \RequirePackage{ifluatex} % \end{macrocode} % \package{arabluatex} requires \LuaLaTeX\ of course. Issue a warning @@ -3433,9 +3454,11 @@ wa-ya.sIru ta.hta 'l-jild-i % \end{macrocode} % \end{macro} % \begin{macro}{\aemph} Arabic emphasis. Needs to be redefined as -% well. The function is actually coded in -% Lua. \changes{v1.9.2}{2017/10/24}{\cs{aemph*} Starred version -% which always puts the stroke over its argument} +% well. The function is actually coded in Lua. +% \begin{macro}{\aemph*} The \enquote*{starred} version of this +% command alway puts the stroke over its argument. +% \changes{v1.9.2}{2017/10/24}{Starred version which always puts the +% stroke over its argument} % \begin{macrocode} \AtBeginDocument{\ifdef{\aemph}% {\RenewDocumentCommand{\aemph}{s m}{% @@ -3447,6 +3470,8 @@ wa-ya.sIru ta.hta 'l-jild-i $\overline{\text{#2}}$} {\luadirect{tex.sprint(aemph(\luastringN{#2}))}}}}} % \end{macrocode} +% \end{macro} +% \end{macro} % \begin{macro}{\SetInputScheme} % \changes{v1.4}{2016/07/05}{\cs{SetInputScheme} may be used to % process other input schemes such as \enquote*{Buckwalter}} @@ -3459,7 +3484,6 @@ wa-ya.sIru ta.hta 'l-jild-i \NewDocumentCommand{\SetInputScheme}{m}{\def\al@input@scheme{#1}} % \end{macrocode} % \end{macro} -% \end{macro} % \begin{macro}{\SetArbEasy} % \changes{v1.2}{2016/05/09}{New \cs{SetArbEasy}/\cs{SetArbDflt} for % \enquote*{modern} or \enquote*{classic} Arabic styles.} diff --git a/samples/al-Jahiz.tex b/samples/al-Jahiz.tex index 3fa94b6..7089be5 100644 --- a/samples/al-Jahiz.tex +++ b/samples/al-Jahiz.tex @@ -147,7 +147,7 @@ on p.~\pageref{source})} \maketitle \vspace{-1in} -\label{source} +\phantomsection\label{source} Here follows the exact source code that has been used to produce the above presented outputs. Discretionary hyphens (\mintinline{latex}|\-|) may have been inserted at some points to -- cgit v1.2.3