aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRobert Alessi <alessi@robertalessi.net>2017-03-30 21:14:31 +0200
committerRobert Alessi <alessi@robertalessi.net>2017-03-30 21:14:31 +0200
commit845c3458bb2c36273e77eb7ba1abc43d91bbf02c (patch)
tree08b584fda2fe450e074b10baf830ab88101b0add
parentbb3e0c4488db36c2d0a81dc39e90c37bc7adf389 (diff)
downloadarabluatex-845c3458bb2c36273e77eb7ba1abc43d91bbf02c.tar.gz
arabica: updated documentation
-rw-r--r--arabluatex.dtx319
1 files changed, 174 insertions, 145 deletions
diff --git a/arabluatex.dtx b/arabluatex.dtx
index 941387b..30e1af6 100644
--- a/arabluatex.dtx
+++ b/arabluatex.dtx
@@ -27,7 +27,7 @@
27%<package-info>\NeedsTeXFormat{LaTeX2e}[1999/12/01] 27%<package-info>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
28%<package-info>\ProvidesPackage{arabluatex} 28%<package-info>\ProvidesPackage{arabluatex}
29%<*package-info> 29%<*package-info>
30 [2017/03/18 v1.7.3 An ArabTeX-like interface for LuaLaTeX] 30 [2017/03/30 v1.8 An ArabTeX-like interface for LuaLaTeX]
31%</package-info> 31%</package-info>
32% 32%
33%<*driver> 33%<*driver>
@@ -145,7 +145,7 @@
145\defaultfontfeatures{RawFeature={+liga}} 145\defaultfontfeatures{RawFeature={+liga}}
146\setmainfont{Old Standard}[SmallCapsFont={Latin Modern Roman Caps}, 146\setmainfont{Old Standard}[SmallCapsFont={Latin Modern Roman Caps},
147 RawFeature={+mark;+ccmp;+ss05;+ss06}] 147 RawFeature={+mark;+ccmp;+ss05;+ss06}]
148\usepackage{arabluatex}[2017/03/18] 148\usepackage{arabluatex}[2017/03/30]
149\usepackage[nopar]{quran} 149\usepackage[nopar]{quran}
150\usepackage{varioref} 150\usepackage{varioref}
151\usepackage{hyperxmp} 151\usepackage{hyperxmp}
@@ -511,12 +511,13 @@
511% 511%
512% \DescribeOption{trans} \\ \label{ref:describe-trans}This mode 512% \DescribeOption{trans} \\ \label{ref:describe-trans}This mode
513% transliterates the Arab\TeX\ input into one of the accepted 513% transliterates the Arab\TeX\ input into one of the accepted
514% standards. At present, two standards are supported (see below 514% standards. At present, three standards are supported (see below
515% \vref{sec:transliteration} for more details): 515% \vref{sec:transliteration} for more details):
516% \begin{compactdesc} 516% \begin{compactdesc}
517% \item[dmg] \emph{Deutsche Morgenländische Gesellschaft}, which is 517% \item[dmg] \emph{Deutsche Morgenländische Gesellschaft}, which is
518% selected by default; 518% selected by default;
519% \item[loc] \emph{Library of Congress}. 519% \item[loc] \emph{Library of Congress};
520% \item[arabica] \emph{Arabica}.
520% \end{compactdesc} 521% \end{compactdesc}
521% More standards will be included in future releases of 522% More standards will be included in future releases of
522% \package{arabluatex}. 523% \package{arabluatex}.
@@ -730,51 +731,54 @@ vowels (see §~3).
730% \newcommand{\loc}[1]{% 731% \newcommand{\loc}[1]{%
731% \SetTranslitConvention{loc}% 732% \SetTranslitConvention{loc}%
732% \arb[trans]{#1}\SetTranslitConvention{dmg}} 733% \arb[trans]{#1}\SetTranslitConvention{dmg}}
733% \begin{longtable}{llll} 734% \newcommand{\brill}[1]{%
735% \SetTranslitConvention{arabica}%
736% \arb[trans]{#1}\SetTranslitConvention{dmg}}
737% \begin{longtable}{lllll}
734% \captionlistentry{Arab\TeX\ consonants}\\[-1em] 738% \captionlistentry{Arab\TeX\ consonants}\\[-1em]
735% \toprule 739% \toprule
736% Letter & \multicolumn{2}{l}{Transliteration\footnotemark} 740% Letter & \multicolumn{3}{l}{Transliteration\footnotemark}
737% & Arab\TeX\ notation \\ 741% & Arab\TeX\ notation \\
738% & \texttt{dmg} & \texttt{loc} & \\ \midrule 742% & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & \\ \midrule
739% \endfirsthead 743% \endfirsthead
740% \toprule 744% \toprule
741% Letter & \multicolumn{2}{l}{Transliteration} 745% Letter & \multicolumn{3}{l}{Transliteration}
742% & Arab\TeX\ notation \\ 746% & Arab\TeX\ notation \\
743% & \texttt{dmg} & \texttt{loc} & \\ \midrule 747% & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & \\ \midrule
744% \endhead \footnotetext{See below \vref{sec:transliteration}.} 748% \endhead \footnotetext{See below \vref{sec:transliteration}.}
745% \label{tab:arabtex-consonants} 749% \label{tab:arabtex-consonants}
746% \arb[novoc]{a}\footnote{For \arb[trans]{'alif} as a consonant, see 750% \arb[novoc]{a}\footnote{For \arb[trans]{'alif} as a consonant, see
747% \textcite[i. 16 D]{Wright}. The \arb[trans]{hamzaT} itself is 751% \textcite[i. 16 D]{Wright}. The \arb[trans]{hamzaT} itself is
748% encoded \texttt{<'>}. See below \vref{ref:hamza}.} & \dmg{a} & 752% encoded \texttt{<'>}. See below \vref{ref:hamza}.} & \dmg{a} &
749% \loc{a} & \verb|a| \\ 753% \loc{a} & \brill{a} & \verb|a| \\
750% \arb[novoc]{b} & \dmg{b} & \loc{b} & |b| \\ 754% \arb[novoc]{b} & \dmg{b} & \loc{b} & \brill{b} & |b| \\
751% \arb[novoc]{t} & \dmg{t} & \loc{t} & |t| \\ 755% \arb[novoc]{t} & \dmg{t} & \loc{t} & \brill{t} & |t| \\
752% \arb[novoc]{_t} & \dmg{_t} & \loc{_t} & |_t| \\ 756% \arb[novoc]{_t} & \dmg{_t} & \loc{_t} & \brill{_t} & |_t| \\
753% \arb[novoc]{j} & \dmg{j} & \loc{j} & |^g| or |j| \\ 757% \arb[novoc]{j} & \dmg{j} & \loc{j} & \brill{j} & |^g| or |j| \\
754% \arb[novoc]{.h} & \dmg{.h} & \loc{.h} & |.h| \\ 758% \arb[novoc]{.h} & \dmg{.h} & \loc{.h} & \brill{.h} & |.h| \\
755% \arb[novoc]{x} & \dmg{x} & \loc{x} & |_h| or |x|\\ 759% \arb[novoc]{x} & \dmg{x} & \loc{x} & \brill{x} & |_h| or |x|\\
756% \arb[novoc]{d} & \dmg{d} & \loc{d} & |d| \\ 760% \arb[novoc]{d} & \dmg{d} & \loc{d} & \brill{d} & |d| \\
757% \arb[novoc]{_d} & \dmg{_d} & \loc{_d} & |_d| \\ 761% \arb[novoc]{_d} & \dmg{_d} & \loc{_d} & \brill{_d} & |_d| \\
758% \arb[novoc]{r} & \dmg{r} & \loc{r} & |r| \\ 762% \arb[novoc]{r} & \dmg{r} & \loc{r} & \brill{r} & |r| \\
759% \arb[novoc]{z} & \dmg{z} & \loc{z} & |z| \\ 763% \arb[novoc]{z} & \dmg{z} & \loc{z} & \brill{z} & |z| \\
760% \arb[novoc]{s} & \dmg{s} & \loc{s} & |s| \\ 764% \arb[novoc]{s} & \dmg{s} & \loc{s} & \brill{s} & |s| \\
761% \arb[novoc]{^s} & \dmg{^s} & \loc{^s} & |^s| \\ 765% \arb[novoc]{^s} & \dmg{^s} & \loc{^s} & \brill{^s} & |^s| \\
762% \arb[novoc]{.s} & \dmg{.s} & \loc{.s} & |.s| \\ 766% \arb[novoc]{.s} & \dmg{.s} & \loc{.s} & \brill{.s} & |.s| \\
763% \arb[novoc]{.d} & \dmg{.d} & \loc{.d} & |.d| \\ 767% \arb[novoc]{.d} & \dmg{.d} & \loc{.d} & \brill{.d} & |.d| \\
764% \arb[novoc]{.t} & \dmg{.t} & \loc{.t} & |.t| \\ 768% \arb[novoc]{.t} & \dmg{.t} & \loc{.t} & \brill{.t} & |.t| \\
765% \arb[novoc]{.z} & \dmg{.z} & \loc{.z} & |.z| \\ 769% \arb[novoc]{.z} & \dmg{.z} & \loc{.z} & \brill{.z} & |.z| \\
766% \arb[novoc]{`} & \dmg{`} & \loc{`} & |`| \\ 770% \arb[novoc]{`} & \dmg{`} & \loc{`} & \brill{`} & |`| \\
767% \arb[novoc]{.g} & \dmg{.g} & \loc{.g} & |.g| \\ 771% \arb[novoc]{.g} & \dmg{.g} & \loc{.g} & \brill{.g} & |.g| \\
768% \arb[novoc]{f} & \dmg{f} & \loc{f} & |f| \\ 772% \arb[novoc]{f} & \dmg{f} & \loc{f} & \brill{f} & |f| \\
769% \arb[novoc]{q} & \dmg{q} & \loc{q} & |q| \\ 773% \arb[novoc]{q} & \dmg{q} & \loc{q} & \brill{q} & |q| \\
770% \arb[novoc]{k} & \dmg{k} & \loc{k} & |k| \\ 774% \arb[novoc]{k} & \dmg{k} & \loc{k} & \brill{k} & |k| \\
771% \arb[novoc]{l} & \dmg{l} & \loc{l} & |l| \\ 775% \arb[novoc]{l} & \dmg{l} & \loc{l} & \brill{l} & |l| \\
772% \arb[novoc]{m} & \dmg{m} & \loc{m} & |m| \\ 776% \arb[novoc]{m} & \dmg{m} & \loc{m} & \brill{m} & |m| \\
773% \arb[novoc]{n} & \dmg{n} & \loc{n} & |n| \\ 777% \arb[novoc]{n} & \dmg{n} & \loc{n} & \brill{n} & |n| \\
774% \arb[novoc]{h} & \dmg{h} & \loc{h} & |h| \\ 778% \arb[novoc]{h} & \dmg{h} & \loc{h} & \brill{h} & |h| \\
775% \arb[novoc]{w} & \dmg{w} & \loc{w} & |w| \\ 779% \arb[novoc]{w} & \dmg{w} & \loc{w} & \brill{w} & |w| \\
776% \arb[novoc]{y} & \dmg{y} & \loc{y} & |y| \\ 780% \arb[novoc]{y} & \dmg{y} & \loc{y} & \brill{y} & |y| \\
777% \arb[novoc]{T} & \dmg{aT} & \loc{aT} & |T| \\ 781% \arb[novoc]{T} & \dmg{aT} & \loc{aT} & \brill{aT} & |T| \\
778% \bottomrule 782% \bottomrule
779% \caption*{\Cref*{tab:arabtex-consonants}: Standard Arab\TeX\ (consonants)} 783% \caption*{\Cref*{tab:arabtex-consonants}: Standard Arab\TeX\ (consonants)}
780% \end{longtable} 784% \end{longtable}
@@ -784,27 +788,27 @@ vowels (see §~3).
784% \Cref{tab:arabtex-long-vowels} gives the Arab\TeX\ equivalents for 788% \Cref{tab:arabtex-long-vowels} gives the Arab\TeX\ equivalents for
785% the Arabic long vowels. 789% the Arabic long vowels.
786% 790%
787% \begin{longtable}{llll} 791% \begin{longtable}{lllll}
788% \captionlistentry{Arab\TeX\ long vowels}\\[-1em] 792% \captionlistentry{Arab\TeX\ long vowels}\\[-1em]
789% \toprule 793% \toprule
790% Letter & \multicolumn{2}{l}{Transliteration\footnotemark} 794% Letter & \multicolumn{3}{l}{Transliteration\footnotemark}
791% & Arab\TeX\ notation \\ 795% & Arab\TeX\ notation \\
792% & \texttt{dmg} & \texttt{loc} & \\ \midrule 796% & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & \\ \midrule
793% \endfirsthead 797% \endfirsthead
794% \toprule 798% \toprule
795% Letter & \multicolumn{2}{l}{Transliteration} 799% Letter & \multicolumn{3}{l}{Transliteration}
796% & Arab\TeX\ notation \\ 800% & Arab\TeX\ notation \\
797% & \texttt{dmg} & \texttt{loc} & \\ \midrule 801% & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & \\ \midrule
798% \endhead \footnotetext{See below \vref{sec:transliteration}.} 802% \endhead \footnotetext{See below \vref{sec:transliteration}.}
799% \label{tab:arabtex-long-vowels} 803% \label{tab:arabtex-long-vowels}
800% \arb[novoc]{A} & \dmg{A} & \loc{A} & \verb|A| \\ 804% \arb[novoc]{A} & \dmg{A} & \loc{A} & \brill{A} & \verb|A| \\
801% \arb[novoc]{U} & \dmg{U} & \loc{U} & \verb|U| \\ 805% \arb[novoc]{U} & \dmg{U} & \loc{U} & \brill{U} & \verb|U| \\
802% \arb[novoc]{I} & \dmg{I} & \loc{I} & \verb|I| \\ 806% \arb[novoc]{I} & \dmg{I} & \loc{I} & \brill{I} & \verb|I| \\
803% \arb[novoc]{_A}\footnote{$=$ \arb[trans]{al-'alif-u 'l-maq.sUraT-u}.} 807% \arb[novoc]{_A}\footnote{$=$ \arb[trans]{al-'alif-u 'l-maq.sUraT-u}.}
804% & \dmg{_A} & \loc{_A} & \verb|_A| or \verb|Y| \\ 808% & \dmg{_A} & \loc{_A} & \brill{_A} & \verb|_A| or \verb|Y| \\
805% \arb[novoc]{B_a} & \dmg{B_a} & \loc{B_a} & \verb|_a| \\ 809% \arb[novoc]{B_a} & \dmg{B_a} & \loc{B_a} & \brill{B_a} & \verb|_a| \\
806% \arb[novoc]{B_u} & \dmg{B_u} & \loc{B_u} & \verb|_u| \\ 810% \arb[novoc]{B_u} & \dmg{B_u} & \loc{B_u} & \brill{B_u} & \verb|_u| \\
807% \arb[novoc]{B_i} & \dmg{B_i} & \loc{B_i} & \verb|_i| \\ 811% \arb[novoc]{B_i} & \dmg{B_i} & \loc{B_i} & \brill{B_i} & \verb|_i| \\
808% \bottomrule 812% \bottomrule
809% \caption*{\Cref*{tab:arabtex-long-vowels}: Standard Arab\TeX\ (long vowels)} 813% \caption*{\Cref*{tab:arabtex-long-vowels}: Standard Arab\TeX\ (long vowels)}
810% \end{longtable} 814% \end{longtable}
@@ -834,25 +838,25 @@ vowels (see §~3).
834% \Cref{tab:arabtex-short-vowels} gives the Arab\TeX\ equivalents for 838% \Cref{tab:arabtex-short-vowels} gives the Arab\TeX\ equivalents for
835% the Arabic short vowels. 839% the Arabic short vowels.
836% 840%
837% \begin{longtable}{llll} 841% \begin{longtable}{lllll}
838% \captionlistentry{Arab\TeX\ short vowels}\\[-1em] 842% \captionlistentry{Arab\TeX\ short vowels}\\[-1em]
839% \toprule 843% \toprule
840% Letter & \multicolumn{2}{l}{Transliteration\footnotemark} 844% Letter & \multicolumn{3}{l}{Transliteration\footnotemark}
841% & Arab\TeX\ notation \\ 845% & Arab\TeX\ notation \\
842% & \texttt{dmg} & \texttt{loc} & \\ \midrule 846% & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & \\ \midrule
843% \endfirsthead 847% \endfirsthead
844% \toprule 848% \toprule
845% Letter & \multicolumn{2}{l}{Transliteration} 849% Letter & \multicolumn{3}{l}{Transliteration}
846% & Arab\TeX\ notation \\ 850% & Arab\TeX\ notation \\
847% & \texttt{dmg} & \texttt{loc} & \\ \midrule 851% & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & \\ \midrule
848% \endhead \footnotetext{See below \vref{sec:transliteration}.} 852% \endhead \footnotetext{See below \vref{sec:transliteration}.}
849% \label{tab:arabtex-short-vowels} 853% \label{tab:arabtex-short-vowels}
850% \arb[voc]{Ba} & \dmg{Ba} & \loc{Ba} & \verb|a| \\ 854% \arb[voc]{Ba} & \dmg{Ba} & \loc{Ba} & \brill{Ba} & \verb|a| \\
851% \arb[voc]{Bu} & \dmg{Bu} & \loc{Bu} & \verb|u| \\ 855% \arb[voc]{Bu} & \dmg{Bu} & \loc{Bu} & \brill{Bu} & \verb|u| \\
852% \arb[voc]{Bi} & \dmg{Bi} & \loc{Bi} & \verb|i| \\ 856% \arb[voc]{Bi} & \dmg{Bi} & \loc{Bi} & \brill{Bi} & \verb|i| \\
853% \arb[voc]{BaN} & \dmg{BaN} & \loc{BaN} & \verb|aN| \\ 857% \arb[voc]{BaN} & \dmg{BaN} & \loc{BaN} & \brill{BaN} & \verb|aN| \\
854% \arb[voc]{BuN} & \dmg{BuN} & \loc{BuN} & \verb|uN| \\ 858% \arb[voc]{BuN} & \dmg{BuN} & \loc{BuN} & \brill{BuN} & \verb|uN| \\
855% \arb[voc]{BiN} & \dmg{BiN} & \loc{BiN} & \verb|iN| \\ 859% \arb[voc]{BiN} & \dmg{BiN} & \loc{BiN} & \brill{BiN} & \verb|iN| \\
856% \bottomrule 860% \bottomrule
857% \caption*{\Cref*{tab:arabtex-short-vowels}: Standard Arab\TeX\ (short vowels)} 861% \caption*{\Cref*{tab:arabtex-short-vowels}: Standard Arab\TeX\ (short vowels)}
858% \end{longtable} 862% \end{longtable}
@@ -1630,26 +1634,26 @@ vowels (see §~3).
1630% context. \Cref{tab:quoted-hamza} gives the equivalents for all the 1634% context. \Cref{tab:quoted-hamza} gives the equivalents for all the
1631% possible carriers the \arb[trans]{hamzaT} may take. 1635% possible carriers the \arb[trans]{hamzaT} may take.
1632% 1636%
1633% \begin{longtable}{llll} 1637% \begin{longtable}{lllll}
1634% \captionlistentry{\enquote{Quoted} \arb[trans]{hamzaT}}\\[-1em] 1638% \captionlistentry{\enquote{Quoted} \arb[trans]{hamzaT}}\\[-1em]
1635% \toprule 1639% \toprule
1636% Letter & \multicolumn{2}{l}{Transliteration\footnotemark} 1640% Letter & \multicolumn{3}{l}{Transliteration\footnotemark}
1637% & Arab\TeX\ notation \\ 1641% & Arab\TeX\ notation \\
1638% & \texttt{dmg} & \texttt{loc} & \\ \midrule 1642% & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & \\ \midrule
1639% \endfirsthead 1643% \endfirsthead
1640% \toprule 1644% \toprule
1641% Letter & \multicolumn{2}{l}{Transliteration} 1645% Letter & \multicolumn{3}{l}{Transliteration}
1642% & Arab\TeX\ notation \\ 1646% & Arab\TeX\ notation \\
1643% & \texttt{dmg} & \texttt{loc} & \\ \midrule 1647% & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & \\ \midrule
1644% \endhead \footnotetext{See below \vref{sec:transliteration}.} 1648% \endhead \footnotetext{See below \vref{sec:transliteration}.}
1645% \label{tab:quoted-hamza} 1649% \label{tab:quoted-hamza}
1646% \arb[novoc]{|"'} & \dmg{|"'} & \loc{|"'} & \verb+|"'+ \\ 1650% \arb[novoc]{|"'} & \dmg{|"'} & \loc{|"'} & \brill{|"'} & \verb+|"'+ \\
1647% \arb[novoc]{A"'} & \dmg{A"'} & \loc{A"'} & \verb|A"'| \\ 1651% \arb[novoc]{A"'} & \dmg{A"'} & \loc{A"'} & \brill{A"'} & \verb|A"'| \\
1648% \arb[novoc]{a"'} & \dmg{a"'} & \loc{a"'} & \verb|a"'| \\ 1652% \arb[novoc]{a"'} & \dmg{a"'} & \loc{a"'} & \brill{a"'} & \verb|a"'| \\
1649% \arb[novoc]{u"'} & \dmg{u"'} & \loc{u"'} & \verb|u"'| \\ 1653% \arb[novoc]{u"'} & \dmg{u"'} & \loc{u"'} & \brill{u"'} & \verb|u"'| \\
1650% \arb[novoc]{w"'} & \dmg{w"'} & \loc{w"'} & \verb|w"'| \\ 1654% \arb[novoc]{w"'} & \dmg{w"'} & \loc{w"'} & \brill{w"'} & \verb|w"'| \\
1651% \arb[novoc]{i"'} & \dmg{i"'} & \loc{i"'} & \verb|i"'| \\ 1655% \arb[novoc]{i"'} & \dmg{i"'} & \loc{i"'} & \brill{i"'} & \verb|i"'| \\
1652% \arb[novoc]{y"'} & \dmg{y"'} & \loc{y"'} & \verb|y"'| \\ 1656% \arb[novoc]{y"'} & \dmg{y"'} & \loc{y"'} & \brill{y"'} & \verb|y"'| \\
1653% \bottomrule 1657% \bottomrule
1654% \caption*{\Cref*{tab:quoted-hamza}: \enquote{Quoted} \arb[trans]{hamzaT}} 1658% \caption*{\Cref*{tab:quoted-hamza}: \enquote{Quoted} \arb[trans]{hamzaT}}
1655% \end{longtable} 1659% \end{longtable}
@@ -1843,27 +1847,27 @@ word that \cs{arbnull} is applied to.
1843% proposed and gradually included as \package{arabluatex} will mature. 1847% proposed and gradually included as \package{arabluatex} will mature.
1844% 1848%
1845% For the time being, the following is included:--- 1849% For the time being, the following is included:---
1846% \begin{longtable}{llll} 1850% \begin{longtable}{lllll}
1847% \captionlistentry{Additional Arabic codings}\\[-1em] 1851% \captionlistentry{Additional Arabic codings}\\[-1em]
1848% \toprule 1852% \toprule
1849% Letter & \multicolumn{2}{l}{Transliteration\footnotemark} 1853% Letter & \multicolumn{3}{l}{Transliteration\footnotemark}
1850% & Arab\TeX\ notation \\ 1854% & Arab\TeX\ notation \\
1851% & \texttt{dmg} & \texttt{loc} & \\ \midrule 1855% & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & \\ \midrule
1852% \endfirsthead 1856% \endfirsthead
1853% \toprule 1857% \toprule
1854% Letter & \multicolumn{2}{l}{Transliteration} 1858% Letter & \multicolumn{3}{l}{Transliteration}
1855% & Arab\TeX\ notation \\ 1859% & Arab\TeX\ notation \\
1856% & \texttt{dmg} & \texttt{loc} & \\ \midrule 1860% & \texttt{dmg} & \texttt{loc} & \texttt{arabica} \\ \midrule
1857% \endhead \footnotetext{See below \vref{sec:transliteration}.} 1861% \endhead \footnotetext{See below \vref{sec:transliteration}.}
1858% \label{tab:additional-arabic-codings} 1862% \label{tab:additional-arabic-codings}
1859% \arb[novoc]{.b} & \dmg{.b} & \loc{.b} & |.b| \\ 1863% \arb[novoc]{.b} & \dmg{.b} & \loc{.b} & \brill{.b} & |.b| \\
1860% \arb[novoc]{^d} & \dmg{^d} & \loc{^d} & |^d| \\ 1864% \arb[novoc]{^d} & \dmg{^d} & \loc{^d} & \brill{^d} & |^d| \\
1861% \arb[novoc]{.f} & \dmg{.f} & \loc{.f} & |.f| \\ 1865% \arb[novoc]{.f} & \dmg{.f} & \loc{.f} & \brill{.f} & |.f| \\
1862% \arb[novoc]{.q} & \dmg{.q} & \loc{.q} & |.q| \\ 1866% \arb[novoc]{.q} & \dmg{.q} & \loc{.q} & \brill{.q} & |.q| \\
1863% \arb[novoc]{.k} & \dmg{.k} & \loc{.k} & |.k| \\ 1867% \arb[novoc]{.k} & \dmg{.k} & \loc{.k} & \brill{.k} & |.k| \\
1864% \arb[novoc]{.n} & \dmg{.n} & \loc{.n} & |.n| \\ 1868% \arb[novoc]{.n} & \dmg{.n} & \loc{.n} & \brill{.n} & |.n| \\
1865% \arb[novoc]{((} & \dmg{((} & \loc{((} & |((| \\ 1869% \arb[novoc]{((} & \dmg{((} & \loc{((} & \brill{((} & |((| \\
1866% \arb[novoc]{))} & \dmg{))} & \loc{))} & |))| \\ 1870% \arb[novoc]{))} & \dmg{))} & \loc{))} & \brill{))} & |))| \\
1867% \bottomrule 1871% \bottomrule
1868% \caption*{\Cref*{tab:additional-arabic-codings}: Additional Arabic 1872% \caption*{\Cref*{tab:additional-arabic-codings}: Additional Arabic
1869% codings} 1873% codings}
@@ -2228,8 +2232,8 @@ word that \cs{arbnull} is applied to.
2228% the \enquote{transliteration mode} may be selected globally or locally. 2232% the \enquote{transliteration mode} may be selected globally or locally.
2229% 2233%
2230% This mode transliterates the Arab\TeX\ input into one of the 2234% This mode transliterates the Arab\TeX\ input into one of the
2231% accepted standards. As said above \vpageref{ref:describe-trans}, two 2235% accepted standards. As said above \vpageref{ref:describe-trans},
2232% standards are supported at present: 2236% three standards are supported at present:
2233% \begin{compactdesc} 2237% \begin{compactdesc}
2234% \item[dmg] \emph{Deutsche Morgenländische Gesellschaft}, which was 2238% \item[dmg] \emph{Deutsche Morgenländische Gesellschaft}, which was
2235% adopted by the International Convention of Orientalist Scholars in 2239% adopted by the International Convention of Orientalist Scholars in
@@ -2238,10 +2242,17 @@ word that \cs{arbnull} is applied to.
2238% \item[loc] \emph{Library of Congress}: this standard is part of a 2242% \item[loc] \emph{Library of Congress}: this standard is part of a
2239% large set of standards for romanization of non-roman scripts 2243% large set of standards for romanization of non-roman scripts
2240% adopted by the American Library Association and the Library of 2244% adopted by the American Library Association and the Library of
2241% Congress.\footnote{See 2245% Congress;\footnote{See
2242% \url{http://www.loc.gov/catdir/cpso/roman.html} for the 2246% \url{http://www.loc.gov/catdir/cpso/roman.html} for the
2243% \href{http://www.loc.gov/catdir/cpso/romanization/arabic.pdf}{source 2247% \href{http://www.loc.gov/catdir/cpso/romanization/arabic.pdf}{source
2244% document concerning Arabic language}.} 2248% document concerning Arabic language}.}
2249% \item[arabica] \NEWfeature{v1.8}
2250% \changes{v1.8}{2017/03/30}{\texttt{arabica} is now supported as a
2251% standard of transliteration} \emph{Journal of Arabic and Islamic
2252% Studies}/\emph{Revue d'études arabes et islamiques}: this standard
2253% is most widely used by scholars in the field of Arabic
2254% studies.\footnote{See
2255% \url{http://www.brill.nl/files/brill.nl/specific/authors_instructions/ARAB.pdf}.}
2245% \end{compactdesc} 2256% \end{compactdesc}
2246% More standards will be included in future releases of 2257% More standards will be included in future releases of
2247% \package{arabluatex}. 2258% \package{arabluatex}.
@@ -2250,9 +2261,9 @@ word that \cs{arbnull} is applied to.
2250% transliteration mode, which is set to |dmg| by default, may be 2261% transliteration mode, which is set to |dmg| by default, may be
2251% changed at any point of the document by the 2262% changed at any point of the document by the
2252% \cs{SetTranslitConvention}\marg{mode} command , where \meta{mode} 2263% \cs{SetTranslitConvention}\marg{mode} command , where \meta{mode}
2253% may be either |dmg| or |loc|. This command is also accepted in the 2264% may be either |dmg|, |loc| or |arabica|. This command is also
2254% preamble should one wish to set the transliteration mode globally, 2265% accepted in the preamble should one wish to set the transliteration
2255% eg.:---% 2266% mode globally, eg.:---%
2256% \iffalse 2267% \iffalse
2257%<*example> 2268%<*example>
2258% \fi 2269% \fi
@@ -2470,6 +2481,22 @@ muhaddamaTaN mi'_danatu-hu}: \arb[trans]{ra'aytu
2470% \end{arab} 2481% \end{arab}
2471% \SetTranslitConvention{dmg} 2482% \SetTranslitConvention{dmg}
2472% 2483%
2484% \SetTranslitConvention{arabica}
2485% \begin{arab}[trans]
2486% \LR{\textbf{\emph{\enquote*{arabica}} standard}:} 'at_A .sadIquN
2487% 'il_A \cap{ju.hA} ya.tlubu min-hu .himAra-hu li-yarkaba-hu fI
2488% safraTiN qa.sIraTiN fa-qAla la-hu: \enquote{sawfa 'u`Idu-hu
2489% 'ilay-ka fI 'l-masA'-i wa-'adfa`u la-ka 'ujraTaN.} fa-qAla
2490% \cap{ju.hA}: \enquote{'anA 'AsifuN jiddaN 'annI lA 'asta.tI`u 'an
2491% 'u.haqqiqa la-ka ra.gbata-ka fa-'l-.himAr-u laysa hunA 'l-yawm-a.}
2492% wa-qabla 'an yutimma \cap{ju.hA} kalAma-hu bada'a 'l-.himAr-u
2493% yanhaqu fI 'i.s.tabli-hi. fa-qAla la-hu .sadIqu-hu: \enquote{'innI
2494% 'asma`u .himAra-ka yA \cap{ju.hA} yanhaqu.} fa-qAla la-hu
2495% \cap{ju.hA}: \enquote{.garIbuN 'amru-ka yA .sadIqI 'a-tu.saddiqu
2496% 'l-.himAr-a wa-tuka_d_diba-nI?}
2497% \end{arab}
2498% \SetTranslitConvention{dmg}
2499%
2473% \section{Buckwalter input scheme} 2500% \section{Buckwalter input scheme}
2474% \label{sec:buckwalter-scheme} 2501% \label{sec:buckwalter-scheme}
2475% \NEWfeature{v1.4} Even though \package{arabluatex} is primarily 2502% \NEWfeature{v1.4} Even though \package{arabluatex} is primarily
@@ -2520,71 +2547,73 @@ muhaddamaTaN mi'_danatu-hu}: \arb[trans]{ra'aytu
2520% characters that are defined in \vref{tab:additional-arabic-codings} 2547% characters that are defined in \vref{tab:additional-arabic-codings}
2521% are also available. 2548% are also available.
2522% 2549%
2523% \begin{longtable}{lllll} 2550% \begin{longtable}{llllll}
2524% \captionlistentry{Buckwalter scheme}\\[-1em] 2551% \captionlistentry{Buckwalter scheme}\\[-1em]
2525% \toprule 2552% \toprule
2526% Letter & \multicolumn{2}{l}{Transliteration\footnotemark} 2553% Letter & \multicolumn{3}{l}{Transliteration\footnotemark}
2527% & \multicolumn{2}{l}{Buckwalter notation} \\ 2554% & \multicolumn{2}{l}{Buckwalter notation} \\
2528% & \texttt{dmg} & \texttt{loc} & |base/xml| & |safe| \\ \midrule 2555% & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & |base/xml| &
2556% |safe| \\ \midrule
2529% \endfirsthead 2557% \endfirsthead
2530% \toprule 2558% \toprule
2531% Letter & \multicolumn{2}{l}{Transliteration} 2559% Letter & \multicolumn{3}{l}{Transliteration}
2532% & \multicolumn{2}{l}{Buckwalter notation} \\ 2560% & \multicolumn{2}{l}{Buckwalter notation} \\
2533% & \texttt{dmg} & \texttt{loc} & |base/xml| & |safe| \\ \midrule 2561% & \texttt{dmg} & \texttt{loc} & \texttt{arabica} & |base/xml| &
2562% |safe| \\ \midrule
2534% \endhead \footnotetext{See \vref{sec:transliteration}.} 2563% \endhead \footnotetext{See \vref{sec:transliteration}.}
2535% \label{tab:buckwalter-scheme} 2564% \label{tab:buckwalter-scheme}
2536% \arb[novoc]{a} & \dmg{a} & \loc{a} & |A| & |A| \\ 2565% \arb[novoc]{a} & \dmg{a} & \loc{a} & \brill{a} & |A| & |A| \\
2537% \arb[novoc]{b} & \dmg{b} & \loc{b} & |b| & |b| \\ 2566% \arb[novoc]{b} & \dmg{b} & \loc{b} & \brill{b} & |b| & |b| \\
2538% \arb[novoc]{t} & \dmg{t} & \loc{t} & |t| & |t| \\ 2567% \arb[novoc]{t} & \dmg{t} & \loc{t} & \brill{t} & |t| & |t| \\
2539% \arb[novoc]{_t} & \dmg{_t} & \loc{_t} & |v| & |v| \\ 2568% \arb[novoc]{_t} & \dmg{_t} & \loc{_t} & \brill{_t} & |v| & |v| \\
2540% \arb[novoc]{j} & \dmg{j} & \loc{j} & |j| & |j| \\ 2569% \arb[novoc]{j} & \dmg{j} & \loc{j} & \brill{j} & |j| & |j| \\
2541% \arb[novoc]{.h} & \dmg{.h} & \loc{.h} & |H| & |H| \\ 2570% \arb[novoc]{.h} & \dmg{.h} & \loc{.h} & \brill{.h} & |H| & |H| \\
2542% \arb[novoc]{x} & \dmg{x} & \loc{x} & |x| & |x| \\ 2571% \arb[novoc]{x} & \dmg{x} & \loc{x} & \brill{x} & |x| & |x| \\
2543% \arb[novoc]{d} & \dmg{d} & \loc{d} & |d| & |d| \\ 2572% \arb[novoc]{d} & \dmg{d} & \loc{d} & \brill{d} & |d| & |d| \\
2544% \arb[novoc]{_d} & \dmg{_d} & \loc{_d} & |*| & |V| \\ 2573% \arb[novoc]{_d} & \dmg{_d} & \loc{_d} & \brill{_d} & |*| & |V| \\
2545% \arb[novoc]{r} & \dmg{r} & \loc{r} & |r| & |r| \\ 2574% \arb[novoc]{r} & \dmg{r} & \loc{r} & \brill{r} & |r| & |r| \\
2546% \arb[novoc]{z} & \dmg{z} & \loc{z} & |z| & |z| \\ 2575% \arb[novoc]{z} & \dmg{z} & \loc{z} & \brill{z} & |z| & |z| \\
2547% \arb[novoc]{s} & \dmg{s} & \loc{s} & |s| & |s| \\ 2576% \arb[novoc]{s} & \dmg{s} & \loc{s} & \brill{s} & |s| & |s| \\
2548% \arb[novoc]{^s} & \dmg{^s} & \loc{^s} & |$| & |c| \\ 2577% \arb[novoc]{^s} & \dmg{^s} & \loc{^s} & \brill{^s} & |$| & |c| \\
2549% \arb[novoc]{.s} & \dmg{.s} & \loc{.s} & |S| & |S| \\ 2578% \arb[novoc]{.s} & \dmg{.s} & \loc{.s} & \brill{.s} & |S| & |S| \\
2550% \arb[novoc]{.d} & \dmg{.d} & \loc{.d} & |D| & |D| \\ 2579% \arb[novoc]{.d} & \dmg{.d} & \loc{.d} & \brill{.d} & |D| & |D| \\
2551% \arb[novoc]{.t} & \dmg{.t} & \loc{.t} & |T| & |T| \\ 2580% \arb[novoc]{.t} & \dmg{.t} & \loc{.t} & \brill{.t} & |T| & |T| \\
2552% \arb[novoc]{.z} & \dmg{.z} & \loc{.z} & |Z| & |Z| \\ 2581% \arb[novoc]{.z} & \dmg{.z} & \loc{.z} & \brill{.z} & |Z| & |Z| \\
2553% \arb[novoc]{`} & \dmg{`} & \loc{`} & |E| & |E| \\ 2582% \arb[novoc]{`} & \dmg{`} & \loc{`} & \brill{`} & |E| & |E| \\
2554% \arb[novoc]{.g} & \dmg{.g} & \loc{.g} & |g| & |g| \\ 2583% \arb[novoc]{.g} & \dmg{.g} & \loc{.g} & \brill{.g} & |g| & |g| \\
2555% \arb[novoc]{f} & \dmg{f} & \loc{f} & |f| & |f| \\ 2584% \arb[novoc]{f} & \dmg{f} & \loc{f} & \brill{f} & |f| & |f| \\
2556% \arb[novoc]{q} & \dmg{q} & \loc{q} & |q| & |q| \\ 2585% \arb[novoc]{q} & \dmg{q} & \loc{q} & \brill{q} & |q| & |q| \\
2557% \arb[novoc]{k} & \dmg{k} & \loc{k} & |k| & |k| \\ 2586% \arb[novoc]{k} & \dmg{k} & \loc{k} & \brill{k} & |k| & |k| \\
2558% \arb[novoc]{l} & \dmg{l} & \loc{l} & |l| & |l| \\ 2587% \arb[novoc]{l} & \dmg{l} & \loc{l} & \brill{l} & |l| & |l| \\
2559% \arb[novoc]{m} & \dmg{m} & \loc{m} & |m| & |m| \\ 2588% \arb[novoc]{m} & \dmg{m} & \loc{m} & \brill{m} & |m| & |m| \\
2560% \arb[novoc]{n} & \dmg{n} & \loc{n} & |n| & |n| \\ 2589% \arb[novoc]{n} & \dmg{n} & \loc{n} & \brill{n} & |n| & |n| \\
2561% \arb[novoc]{h} & \dmg{h} & \loc{h} & |h| & |h| \\ 2590% \arb[novoc]{h} & \dmg{h} & \loc{h} & \brill{h} & |h| & |h| \\
2562% \arb[novoc]{w} & \dmg{w} & \loc{w} & |w| & |w| \\ 2591% \arb[novoc]{w} & \dmg{w} & \loc{w} & \brill{w} & |w| & |w| \\
2563% \arb[novoc]{y} & \dmg{y} & \loc{y} & |y| & |y| \\ 2592% \arb[novoc]{y} & \dmg{y} & \loc{y} & \brill{y} & |y| & |y| \\
2564% \arb[novoc]{Y} & \dmg{Y} & \loc{Y} & |Y| & |Y| \\ 2593% \arb[novoc]{Y} & \dmg{Y} & \loc{Y} & \brill{Y} & |Y| & |Y| \\
2565% \arb[novoc]{T} & \dmg{aT} & \loc{aT} & |p| & |p| \\ 2594% \arb[novoc]{T} & \dmg{aT} & \loc{aT} & \brill{aT} & |p| & |p| \\
2566% \midrule 2595% \midrule
2567% \arb[novoc]{|"'} & \dmg{|"'} & \loc{|"'} & \verb|'| & |C| \\ 2596% \arb[novoc]{|"'} & \dmg{|"'} & \loc{|"'} & \brill{|"'} & \verb|'| & |C| \\
2568% \arb[novoc]{A"'} & \dmg{A"'} & \loc{A"'} & \verb+|+ & |M| \\ 2597% \arb[novoc]{A"'} & \dmg{A"'} & \loc{A"'} & \brill{A"'} & \verb+|+ & |M| \\
2569% \arb[novoc]{a"'} & \dmg{a"'} & \loc{a"'} & \verb|>| & |O| \\ 2598% \arb[novoc]{a"'} & \dmg{a"'} & \loc{a"'} & \brill{a"'} & \verb|>| & |O| \\
2570% \arb[novoc]{w"'} & \dmg{w"'} & \loc{w"'} & \verb|&| & |W| \\ 2599% \arb[novoc]{w"'} & \dmg{w"'} & \loc{w"'} & \brill{w"'} & \verb|&| & |W| \\
2571% \arb[novoc]{i"'} & \dmg{i"'} & \loc{i"'} & \verb|<| & |I| \\ 2600% \arb[novoc]{i"'} & \dmg{i"'} & \loc{i"'} & \brill{i"'} & \verb|<| & |I| \\
2572% \arb[novoc]{y"'} & \dmg{y"'} & \loc{y"'} & \verb|]| & |Q| \\ 2601% \arb[novoc]{y"'} & \dmg{y"'} & \loc{y"'} & \brill{y"'} & \verb|]| & |Q| \\
2573% \midrule 2602% \midrule
2574% \arb[novoc]{BB} & --- & --- & \verb|~| & |~| \\ 2603% \arb[novoc]{BB} & --- & --- & --- & \verb|~| & |~| \\
2575% \arb[novoc]{"a} & ' & ' & |[| & |L| \\ 2604% \arb[novoc]{"a} & ' & ' & --- & |[| & |L| \\
2576% \midrule 2605% \midrule
2577% \arb[voc]{Ba} & \dmg{Ba} & \loc{Ba} & \verb|a| & |a| \\ 2606% \arb[voc]{Ba} & \dmg{Ba} & \loc{Ba} & \brill{Ba} & \verb|a| & |a| \\
2578% \arb[voc]{Bu} & \dmg{Bu} & \loc{Bu} & \verb|u| & |u| \\ 2607% \arb[voc]{Bu} & \dmg{Bu} & \loc{Bu} & \brill{Bu} & \verb|u| & |u| \\
2579% \arb[voc]{Bi} & \dmg{Bi} & \loc{Bi} & \verb|i| & |i| \\ 2608% \arb[voc]{Bi} & \dmg{Bi} & \loc{Bi} & \brill{Bi} & \verb|i| & |i| \\
2580% \arb[voc]{BaN} & \dmg{BaN} & \loc{BaN} & \verb|F| & |F| \\ 2609% \arb[voc]{BaN} & \dmg{BaN} & \loc{BaN} & \brill{BaN} & \verb|F| & |F| \\
2581% \arb[voc]{BuN} & \dmg{BuN} & \loc{BuN} & \verb|N| & |N| \\ 2610% \arb[voc]{BuN} & \dmg{BuN} & \loc{BuN} & \brill{BuN} & \verb|N| & |N| \\
2582% \arb[voc]{BiN} & \dmg{BiN} & \loc{BiN} & \verb|K| & |K| \\ 2611% \arb[voc]{BiN} & \dmg{BiN} & \loc{BiN} & \brill{BiN} & \verb|K| & |K| \\
2583% \arb[voc]{B"} & --- & --- & \verb|o| & |o| \\ 2612% \arb[voc]{B"} & --- & --- & --- & \verb|o| & |o| \\
2584% \midrule 2613% \midrule
2585% \arb[novoc]{B_a} & \dmg{B_a} & \loc{B_a} & |`| & |e| \\ 2614% \arb[novoc]{B_a} & \dmg{B_a} & \loc{B_a} & \brill{B_a} & |`| & |e| \\
2586% \midrule 2615% \midrule
2587% \arb[novoc]{--} (\arb[trans]{ta.twIl}) & --- & --- & |_| & |_| \\ 2616% \arb[novoc]{--} (\arb[trans]{ta.twIl}) & --- & --- & --- & |_| & |_| \\
2588% \bottomrule 2617% \bottomrule
2589% \caption*{\Cref*{tab:buckwalter-scheme}: Buckwalter scheme} 2618% \caption*{\Cref*{tab:buckwalter-scheme}: Buckwalter scheme}
2590% \end{longtable} 2619% \end{longtable}
@@ -3055,7 +3084,7 @@ wa-ya.sIru ta.hta 'l-jild-i
3055% \begin{macrocode} 3084% \begin{macrocode}
3056\NeedsTeXFormat{LaTeX2e} 3085\NeedsTeXFormat{LaTeX2e}
3057\ProvidesPackage{arabluatex}% 3086\ProvidesPackage{arabluatex}%
3058[2017/03/18 v1.7.3 An ArabTeX-like interface for LuaLaTeX] 3087[2017/03/30 v1.8 An ArabTeX-like interface for LuaLaTeX]
3059\RequirePackage{ifluatex} 3088\RequirePackage{ifluatex}
3060% \end{macrocode} 3089% \end{macrocode}
3061% \package{arabluatex} requires \LuaLaTeX\ of course. Issue a warning 3090% \package{arabluatex} requires \LuaLaTeX\ of course. Issue a warning