aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRobert Alessi <alessi@robertalessi.net>2017-10-23 21:06:29 +0200
committerRobert Alessi <alessi@robertalessi.net>2017-10-23 21:06:29 +0200
commitf6dc234891521680e933285190e3e9ecda204204 (patch)
treeb0078ab37e32bfd76fb0330b1a6a78a4db964c4d
parentc454a3f2ce30b8fc0658e26aa5bac698fd647290 (diff)
downloadarabluatex-f6dc234891521680e933285190e3e9ecda204204.tar.gz
documenting the features to be included in v1.9.2
-rw-r--r--arabluatex.dtx70
1 files changed, 60 insertions, 10 deletions
diff --git a/arabluatex.dtx b/arabluatex.dtx
index 2e503be..c38feaf 100644
--- a/arabluatex.dtx
+++ b/arabluatex.dtx
@@ -1173,13 +1173,16 @@ vowels (see §~3).
1173% \arb[voc]{mas'alaTuN} \arb[trans]{mas'alaTuN}, |'as'alu| 1173% \arb[voc]{mas'alaTuN} \arb[trans]{mas'alaTuN}, |'as'alu|
1174% \arb[voc]{'as'alu} \arb[trans]{'as'alu}, |yatasA'alUna| 1174% \arb[voc]{'as'alu} \arb[trans]{'as'alu}, |yatasA'alUna|
1175% \arb[voc]{yatasA'alUna}\linebreak \arb[trans]{yatasA'alUna}, 1175% \arb[voc]{yatasA'alUna}\linebreak \arb[trans]{yatasA'alUna},
1176% |murU'aTuN| \arb[voc]{murU'aTuN} \arb[trans]{murU'aTuN}, 1176% |murU'aTuN| \arb[voc]{murU'aTuN}, |taw'amuN|
1177% |ta'xIruN| \arb[fullvoc]{ta'xIruN} \arb[trans]{ta'xIruN}, 1177% \arb[fullvoc]{taw'amuN} \arb[trans]{taw'amuN},
1178% |ta'ax|\allowbreak|xara| \arb[voc]{ta'axxara} 1178% \arb[trans]{murU'aTuN}, |ta'xIruN| \arb[fullvoc]{ta'xIruN}
1179% \arb[trans]{ta'axxara}, |ji'tu-ka| \arb[voc]{ji'tu-ka} 1179% \arb[trans]{ta'xIruN}, |ta'ax|\allowbreak|xara|
1180% \arb[trans]{ji'tu-ka}, |qA'iluN| \arb[voc]{qA'iluN} 1180% \arb[voc]{ta'axxara} \arb[trans]{ta'axxara}, |ji'tu-ka|
1181% \arb[trans]{qA'iluN}, |.hIna'i_diN| \arb[trans]{.hIna'i_diN} 1181% \arb[voc]{ji'tu-ka} \arb[trans]{ji'tu-ka}, |qA'iluN|
1182% \arb[voc]{.hIna'i_diN}. 1182% \arb[voc]{qA'iluN} \arb[trans]{qA'iluN}, |.hIna'i_diN|
1183% \arb[trans]{.hIna'i_diN} \arb[voc]{.hIna'i_diN}, |hay'aTuN|
1184% \arb[voc]{hay'aTuN} \arb[trans]{hay\-'aTuN}, |hay'AtuN|
1185% \arb[voc]{hay'AtuN} \arb[trans]{hay'AtuN}.
1183% 1186%
1184% From \textcite[i. 14 B]{Wright}:--- All consonants, whatsoever, 1187% From \textcite[i. 14 B]{Wright}:--- All consonants, whatsoever,
1185% not even \arb[trans]{'alif} \emph{hèmzatum} excepted, admit of 1188% not even \arb[trans]{'alif} \emph{hèmzatum} excepted, admit of
@@ -1219,7 +1222,8 @@ vowels (see §~3).
1219% \arb[voc]{al-^say'-u} \arb[trans]{al-^say'-u}, |'a^syA'-u| 1222% \arb[voc]{al-^say'-u} \arb[trans]{al-^say'-u}, |'a^syA'-u|
1220% \arb[voc]{'a^syA'-u} \arb[trans]{'a^syA'-u}, |'a^syA'-a| 1223% \arb[voc]{'a^syA'-u} \arb[trans]{'a^syA'-u}, |'a^syA'-a|
1221% \arb[voc]{'a^syA'-a} \arb[trans]{'a^syA'-a}, |.zim'aN| 1224% \arb[voc]{'a^syA'-a} \arb[trans]{'a^syA'-a}, |.zim'aN|
1222% \arb[voc]{.zim'aN} \arb[trans]{.zim'aN}. 1225% \arb[voc]{.zim'aN} \arb[trans]{.zim'aN}, |radI'aN|
1226% \arb[voc]{radI'aN} \arb[trans]{radI'aN}.
1223% 1227%
1224% \label{ref:taxfif-hamzah} 1228% \label{ref:taxfif-hamzah}
1225% \textbf{\arb[trans]{ta_hfIf-u 'l-hamzaT-i}}: if the 1229% \textbf{\arb[trans]{ta_hfIf-u 'l-hamzaT-i}}: if the
@@ -1232,6 +1236,34 @@ vowels (see §~3).
1232% of encoding such sequences, see \vpageref{ref:initial-hamza} 1236% of encoding such sequences, see \vpageref{ref:initial-hamza}
1233% (\arb[trans]{hamzaT} followed by \arb[novoc]{U} and \arb[novoc]{I}) 1237% (\arb[trans]{hamzaT} followed by \arb[novoc]{U} and \arb[novoc]{I})
1234% and the \arb[trans]{maddaT} \vpageref{ref:madda}. 1238% and the \arb[trans]{maddaT} \vpageref{ref:madda}.
1239%
1240% Imperatives of verbs that have the \arb[trans]{hamzaT} as the
1241% first radical are other cases of \arb[trans]{ta_hfIf-u
1242% 'l-hamzaT-i}: |i'sir| \arb[fullvoc]{i'sir} \arb[trans]{i'sir},
1243% |i'_dan| \arb[fullvoc]{i'_dan} \arb[trans]{i'_dan}, |u'mul|
1244% \arb[fullvoc]{u'mul} \arb[trans]{u'mul}. \package{arabluatex}
1245% also provides ways of encoding those words when the initial
1246% \arb[trans]{'alif} comes into \arb[trans]{wa.sl}, so as to make
1247% the \arb[trans]{'alif wa.sl} fall away when preceded by
1248% \arb[voc]{wa} or \arb[voc]{fa}: |wa-'sir| \arb[fullvoc]{wa-'sir}
1249% \arb[trans]{wa-'sir}, |fa-'_dan| \arb[fullvoc]{fa-'_dan}
1250% \arb[trans]{fa-'_dan}, |fa-'ti| \arb[fullvoc]{fa-'ti}
1251% \arb[trans]{fa-'ti}, |wa-'tamirUA| \arb[fullvoc]{wa-'tamirUA}
1252% \arb[trans]{wa-'tamirUA}; or be retained outside the imperative,
1253% as in |fa-i'tazarat| \arb[fullvoc]{fa-i'tazarat}
1254% \arb[trans]{fa-i'tazarat}, |ba`da| |i'tilAfiN| \arb[fullvoc]{ba`da
1255% i'tilAfiN} \arb[trans]{ba`da i'tilAfiN}.
1256%
1257% \textbf{The strange spelling of \arb[trans]{mi'aTuN}}: |mi'aTuN|
1258% \arb[voc]{mi'aTuN} \arb[trans]{mi'aTuN}, \linebreak |mi'atAni|
1259% \arb[voc]{mi'atAni} \arb[trans]{mi'atAni}, |mi'atayni|
1260% \arb[voc]{mi'atayni} \arb[trans]{mi'atayni}, |mi'Una|
1261% \arb[voc]{mi'Una} \arb[trans]{mi'Una}, |mi'AtuN|
1262% \arb[voc]{mi'AtuN} \arb[trans]{mi'AtuN}, |mi'aN_A|
1263% \arb[voc]{mi'aN_A} \arb[trans]{mi'aN_A}. Of course, the
1264% \enquote*{pipe} character may be used to prevent this rule from
1265% being applied (see \vref{sec:pipe}): \verb+mi'a|TuN+
1266% \arb[voc]{mi'a|TuN} \arb[trans]{mi'a|TuN}.
1235% \end{quote} 1267% \end{quote}
1236% 1268%
1237% \paragraph{\arb[trans]{maddaT}} \label{ref:madda}At the beginning of 1269% \paragraph{\arb[trans]{maddaT}} \label{ref:madda}At the beginning of
@@ -2000,9 +2032,17 @@ word that \cs{arbnull} is applied to.
2000% \begin{quote} 2032% \begin{quote}
2001% |\abjad{45}:| |kitAbu-hu| |\aemph{fI| |'l-`AdAt-i}| 2033% |\abjad{45}:| |kitAbu-hu| |\aemph{fI| |'l-`AdAt-i}|
2002% \arb[voc]{\abjad{45}: kitAbu-hu \aemph{fI 'l-`AdAt-i}} 2034% \arb[voc]{\abjad{45}: kitAbu-hu \aemph{fI 'l-`AdAt-i}}
2003% \arb[trans]{\abjad{45}: kitAbu-hu fI 'l-\cap{`AdAt-i}}. 2035% \arb[trans]{\abjad{45}: kitAbu-hu \aemph{fI 'l-\cap{`AdAt-i}}}.
2004% \end{quote} 2036% \end{quote}
2037%
2038% \begin{quoting}
2039% \textsc{Rem.} As the above example shows, \package{arabluatex}
2040% places the horizontal stroke \emph{under} the emphasized words in
2041% any of the transliteration modes.
2005% 2042%
2043% \DescribeMacro{\aemph*}\NEWfeature{v1.9.2}
2044% \end{quoting}
2045%
2006% \section{Arabic poetry} 2046% \section{Arabic poetry}
2007% \label{sec:poetry} 2047% \label{sec:poetry}
2008% \NEWfeature{v1.6} \package{arabluatex} provides a special 2048% \NEWfeature{v1.6} \package{arabluatex} provides a special
@@ -2552,6 +2592,14 @@ muhaddamaTaN mi'_danatu-hu}: \arb[trans]{ra'aytu
2552% 'l-nAs-a kAffaT-aN min mu_hA.tabati-hi 'a.had-uN bi-sayyidi-nA}. 2592% 'l-nAs-a kAffaT-aN min mu_hA.tabati-hi 'a.had-uN bi-sayyidi-nA}.
2553% \end{quoting} 2593% \end{quoting}
2554% 2594%
2595% \paragraph{Uncertain short vowels}
2596% In some printed books, it may happen that more than one short vowel
2597% be placed on a consonant in cases where the vocalization is
2598% uncertain or ambiguous, like so: \arb[voc]{fa`uaila}. In
2599% transliteration, the uncertain vowels go between slashes and are
2600% separated by commas: |fa`uaila| \arb[voc]{fa`uaila}
2601% \arb[trans]{fa`uaila}.
2602%
2555% \subsection{Examples} 2603% \subsection{Examples}
2556% \label{sec:examples-translit} 2604% \label{sec:examples-translit}
2557% Here follows in transliteration the story of 2605% Here follows in transliteration the story of
@@ -3358,7 +3406,9 @@ wa-ya.sIru ta.hta 'l-jild-i
3358% \end{macrocode} 3406% \end{macrocode}
3359% \end{macro} 3407% \end{macro}
3360% \begin{macro}{\aemph} Arabic emphasis. Needs to be redefined as 3408% \begin{macro}{\aemph} Arabic emphasis. Needs to be redefined as
3361% well. The function is actually coded in Lua. 3409% well. The function is actually coded in
3410% Lua. \changes{v1.9.2}{2017/10/24}{\cs{aemph*} Starred version
3411% which always puts the stroke over its argument}
3362% \begin{macrocode} 3412% \begin{macrocode}
3363\AtBeginDocument{\ifdef{\aemph}% 3413\AtBeginDocument{\ifdef{\aemph}%
3364 {\RenewDocumentCommand{\aemph}{s m}{% 3414 {\RenewDocumentCommand{\aemph}{s m}{%