arabluatex (28apr17)

git-svn-id: svn://tug.org/texlive/trunk@44102 c570f23f-e606-0410-a88d-b1316a301751

5 files changed, 284 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/lualatex/arabluatex/arabluatex.pdf b/Master/texmf-dist/doc/lualatex/arabluatex/arabluatex.pdf
index 7ff290245cb..724908d8034 100644
--- a/Master/texmf-dist/doc/lualatex/arabluatex/arabluatex.pdf
+++ b/Master/texmf-dist/doc/lualatex/arabluatex/arabluatex.pdf
diff --git a/Master/texmf-dist/doc/lualatex/arabluatex/samples/al-Jahiz.pdf b/Master/texmf-dist/doc/lualatex/arabluatex/samples/al-Jahiz.pdf
new file mode 100644
index 00000000000..76137b2564a
--- /dev/null
+++ b/Master/texmf-dist/doc/lualatex/arabluatex/samples/al-Jahiz.pdf
diff --git a/Master/texmf-dist/doc/lualatex/arabluatex/samples/al-Jahiz.tex b/Master/texmf-dist/doc/lualatex/arabluatex/samples/al-Jahiz.tex
new file mode 100644
index 00000000000..3fa94b6515f
--- /dev/null
+++ b/Master/texmf-dist/doc/lualatex/arabluatex/samples/al-Jahiz.tex
@@ -0,0 +1,175 @@
+% 
+% This file is public domain
+% To compile this document, do:
+% 'lualatex --shell-escape al-Jahiz'
+%
+\documentclass[fontsize=12pt, paper=letter, DIV=classic]{scrartcl}
+\usepackage{fontspec}
+\setmainfont{Old Standard}
+\usepackage{filecontents}
+
+\usepackage{xcolor}
+\usepackage[outputdir=TMP]{minted}
+\definecolor{bg}{rgb}{0.95,0.95,0.95}
+\usepackage{ccicons}
+
+\usepackage{lineno}
+\usepackage{setspace}
+\onehalfspacing
+
+\usepackage{csquotes}
+\DeclareQuoteStyle{arabic}
+{\rmfamily\textquotedblright}{\rmfamily\textquotedblleft}
+{\rmfamily\textquoteright}{\rmfamily\textquoteleft}
+
+\usepackage[fullvoc]{arabluatex}
+\SetArbEasy
+
+\PassOptionsToPackage{pdfa}{hyperref}
+\usepackage{hyperxmp}
+\usepackage{hyperref}
+\hypersetup{colorlinks, linkcolor=blue, pdfauthor={Robert Alessi}}
+
+\begin{document}
+\begin{filecontents*}{dajaja.tex}
+\begin{linenumbers*}
+  \begin{arab}
+    kAna \cap{'a}bU 'l-\cap{h}u_dayli 'ahd_A 'il_A \cap{m}uwaysiN
+    dajAjaTaN. wa-kAnat dajAjatu-hu 'llatI 'ahdA-hA dUna mA kAna
+    yuttaxa_du li-\cap{m}uwaysiN. wa-l_akinna-hu bi-karami-hi
+    wa-bi-.husni _hu\-luqi-hi 'a.zhara 'l-ta`ajjuba min simani-hA
+    wa-.tIbi la.hmi-hA. wa-kAna <\cap{'a}bU 'l-\cap{h}u_dayli>
+    yu`rafu bi-'l-'imsAki 'l-^sadIdi. fa-qAla: \enquote{wa-kayfa
+      ra'ayta yA \cap{'a}bA \cap{`i}mrAna tilka 'l-dajA\-jaTa?}
+    qAla: \enquote{kAnat `ajabaN mina 'l-`ajabi!}  fa-yaqUlu:
+    \enquote{wa-tadrI mA jinsu-hA? wa-tadrI mA sinnu-hA?  fa-'inna
+      'l-dajAjaTa 'inna-mA ta.tIbu bi-'l-jinsi wa-'l-sinni. wa-tadrI
+      bi-'ayyi ^say'iN kunnA nusamminu-hA? wa-fI 'ayyi makAniN kunnA
+      na`lifu-hA?}  fa-lA yazAlu fI h_a_dA wa-'l-'A_haru ya.d.haku
+    .da.hkaN na`rifu-hu na.hnu wa-lA ya`rifu-hu \cap{'a}bU
+    'l-\cap{h}u_dayli.
+  \end{arab}
+
+\begin{arab}
+  wa-kAna \cap{'a}bU 'l-\cap{h}u_dayli 'aslama 'l-nAsi .sadraN
+  wa-'awsa`a-hum _huluqaN wa-'ashala-hum suhUlaTaN. fa-'in _dakarUA
+  dajAjaTaN, qAla: \enquote{'ayna kAnat yA \cap{'a}bA \cap{`i}mrAna
+    min tilka 'l-dajA\-jaTi?} fa-'in _dakarUA ba.t.taTaN 'aw `anAqaN
+  'aw jazUraN 'aw baqaraTaN, qAla: \enquote{fa-'ayna kAnat h_a_dihi
+    'l-jazUru fI 'l-juzuri min tilka 'l-dajAjaTi fI 'l-dajAji!}
+  wa-'ini istasmana \cap{'a}bU 'l-\cap{h}u_dayli ^say'aN mina
+  'l-.tayri wa-'l-bahA'imi, qAla: \enquote{lA wa-'l-l_ahi wa-lA tilka
+    'l-dajAjaTu!}  wa-'in _dakarUA `u_dUbaTa 'l-^sa.hmi, qAla:
+  \enquote{`u_dUbaTu 'l-^sa.hmi fI 'l-baqari wa-'l-ba.t.ti wa-bu.tUni
+    'l-samaki wa-'l-dajAji, wa-lA siyyamA _d_alika 'l-jinsu mina
+    'l-dajAji.} wa-'in _dakarUA mIlAda ^say'iN 'aw qudUma
+  'insAniN, qAla: \enquote{kAna _d_alika ba`da 'an 'ahdaytu-hA la-ka
+    bi-sanaTiN, wa-mA kAna bayna qudUmi fulAniN wa-bayna 'l-ba`_taTi
+    bi-tilka 'l-dajAjaTi 'illA yawmuN.}  wa-kAnat ma_ta\-laN fI
+  kulli ^say'iN wa-tArI_haN fI kulli ^say'iN.
+\end{arab}
+\end{linenumbers*}
+
+\bigskip
+
+\begin{arab}
+  \cap{al-jA.hi.zu}, \aemph{\cap{k}itAbu 'l-\cap{b}u_halA'i}
+\end{arab}
+\end{filecontents*}
+
+\title{\large\arb{dajAjaTu \cap{'a}bI 'l-\cap{h}u_dayli
+    'l-\cap{`a}llAfi}}
+\author{}
+\date{}
+
+\titlehead{\textbf{\textsf{arabluatex sample file}} --- \cczero\ This
+  file is public domain.\\
+  \textsf{arabluatex} mode: \texttt{fullvoc} with
+  \texttt{\textbackslash SetArbEasy}\\
+  Full vocalization, the \arb[trans]{sukUn} and the
+  \arb[trans]{wa.slaT} are expressed, the \arb[trans]{ta^sdId} is
+  generated, but the \enquote*{classic} \arb[trans]{maddaT} is
+  discarded (see source code on p.~\pageref{source}).}
+\maketitle
+\vspace{-1in}
+\doublespacing
+\setquotestyle{arabic}
+\input{dajaja}
+
+\makeatletter
+\def\al@mode{trans}
+\makeatother
+\SetTranslitConvention{dmg}
+\titlehead{\textsf{arabluatex} mode: \texttt{trans} with
+  \texttt{\textbackslash SetTranslitConvention\{dmg\}} and
+  \texttt{\textbackslash SetArbEasy}\\
+\emph{Deutsche Morgenländische Gesellschaft} (see source code on
+p.~\pageref{source})}
+\onehalfspacing
+\maketitle
+\vspace{-1in}
+\setquotestyle{english}
+\input{dajaja}
+
+\makeatletter
+\def\al@mode{trans}
+\makeatother
+\SetTranslitConvention{loc}
+\titlehead{\textsf{arabluatex} mode: \texttt{trans} with
+  \texttt{\textbackslash SetTranslitConvention\{loc\}}\\
+\emph{Library of Congress} (see source code on p.~\pageref{source})}
+\maketitle
+\vspace{-1in}
+\setquotestyle{english}
+\input{dajaja}
+
+\makeatletter
+\def\al@mode{trans}
+\makeatother
+\SetTranslitConvention{arabica}
+\titlehead{\textsf{arabluatex} mode: \texttt{trans} with
+  \texttt{\textbackslash SetTranslitConvention\{arabica\}}\\
+\emph{Journal of Arabic and Islamic Studies} (Arabica, see source code
+on p.~\pageref{source})}
+\maketitle
+\vspace{-1in}
+\setquotestyle{english}
+\input{dajaja}
+
+\makeatletter
+\def\al@mode{voc}
+\makeatother
+\singlespacing
+\SetTranslitConvention{dmg}
+\titlehead{}
+\title{\large Source code}
+\subtitle{}
+\maketitle
+\vspace{-1in}
+
+\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
+prevent lines from overflowing into the right margin.
+
+\medskip
+
+\noindent\textbf{\texttt{preamble:}}
+\begin{minted}[linenos, bgcolor=bg]{latex}
+\usepackage{csquotes} % recommended for inline quotations
+\DeclareQuoteStyle{arabic} % then \setquotestyle{arabic} or
+                           % \setquotestyle{english} may be used
+  {\rmfamily\textquotedblright}{\rmfamily\textquotedblleft}
+  {\rmfamily\textquoteright}{\rmfamily\textquoteleft}
+
+\usepackage[fullvoc]{arabluatex} % 'voc', 'fullvoc', 'novoc' or 'trans'
+\SetTranslitConvention{dmg} % 'dmg', 'loc' or 'arabica'
+\SetArbEasy % ie. discard 'classic' maddah
+
+\title{\arb{dajAjaTu \cap{'a}bI 'l-\cap{h}u_dayli 'l-\cap{`a}llAfi}}
+\end{minted}
+\textbf{\texttt{document:}}
+\inputminted[linenos, firstnumber=last, bgcolor=bg]{latex}{TMP/dajaja.tex}
+
+\end{document}
diff --git a/Master/texmf-dist/doc/lualatex/arabluatex/samples/template-01.pdf b/Master/texmf-dist/doc/lualatex/arabluatex/samples/template-01.pdf
new file mode 100644
index 00000000000..818e75b0c11
--- /dev/null
+++ b/Master/texmf-dist/doc/lualatex/arabluatex/samples/template-01.pdf
diff --git a/Master/texmf-dist/doc/lualatex/arabluatex/samples/template-01.tex b/Master/texmf-dist/doc/lualatex/arabluatex/samples/template-01.tex
new file mode 100644
index 00000000000..3d5f27dde9b
--- /dev/null
+++ b/Master/texmf-dist/doc/lualatex/arabluatex/samples/template-01.tex
@@ -0,0 +1,109 @@
+\documentclass[paper=letter, DIV=classic, headings=small]{scrartcl}
+
+\usepackage{ccicons}
+\usepackage{paralist}
+
+\usepackage{arabluatex}
+
+\usepackage{hyperref}
+\hypersetup{colorlinks, linkcolor=blue, breaklinks}
+
+\subject{\textsf{arabluatex} sample files}
+\title{The Basics}
+\author{Robert Alessi\thanks{\cczero\ This file is public domain.}}
+
+\begin{document}
+\maketitle
+
+\begin{abstract}
+  This file demonstrates the basic features of \texttt{arabluatex}.
+\end{abstract}
+
+\section{The less, the better}
+\label{sec:less-better}
+\textsf{arabluatex} is loaded by one single line in the preamble:
+\begin{verbatim}
+\usepackage{arabluatex}
+\end{verbatim}
+That said, there are two subsequent requirements:
+\begin{compactenum}
+\item An Arabic font: \textsf{arabluatex} tries to load the
+  \textsf{Amiri} Arabic font which is already part of
+  \textsf{texlive}.
+\item A Roman font that has all the characters that are needed for
+  the transliteration of the Arabic.
+\end{compactenum}
+
+Once these requirements are met, one may insert Arabic words in
+left-to-right paragraphs like so: \verb|\arb{da_hala mubtasimaN}|,
+\arb{da_hala mubtasimaN}. Or insert running paragraphs of Arabic text
+inside the \verb|arab| environment, like so:---
+\begin{verbatim}
+\begin{arab}
+  'at_A .sadIquN 'il_A ju.hA ya.tlubu min-hu .himAra-hu li-yarkaba-hu
+  fI safraTiN qa.sIraTiN fa-qAla la-hu: sawfa 'u`Idu-hu 'ilay-ka fI
+  'l-masA'-i wa-'adfa`u la-ka 'ujraTaN. fa-qAla ju.hA: 'anA 'AsifuN
+  jiddaN 'annI lA 'asta.tI`u 'an 'u.haqqiqa la-ka ra.gbata-ka
+  fa-'l-.himAr-u laysa hunA 'l-yawm-a.  wa-qabla 'an yutimma ju.hA
+  kalAma-hu bada'a 'l-.himAr-u yanhaqu fI 'i.s.tabli-hi. fa-qAla la-hu
+  .sadIqu-hu: 'innI 'asma`u .himAra-ka yA ju.hA yanhaqu. fa-qAla la-hu
+  ju.hA: .garIbuN 'amru-ka yA .sadIqI 'a-tu.saddiqu 'l-.himAr-a
+  wa-tuka_d_diba-nI?
+\end{arab}
+\end{verbatim}
+\begin{arab}
+  'at_A .sadIquN 'il_A ju.hA ya.tlubu min-hu .himAra-hu li-yarkaba-hu
+  fI safraTiN qa.sIraTiN fa-qAla la-hu: sawfa 'u`Idu-hu 'ilay-ka fI
+  'l-masA'-i wa-'adfa`u la-ka 'ujraTaN. fa-qAla ju.hA: 'anA 'AsifuN
+  jiddaN 'annI lA 'asta.tI`u 'an 'u.haqqiqa la-ka ra.gbata-ka
+  fa-'l-.himAr-u laysa hunA 'l-yawm-a.  wa-qabla 'an yutimma ju.hA
+  kalAma-hu bada'a 'l-.himAr-u yanhaqu fI 'i.s.tabli-hi. fa-qAla la-hu
+  .sadIqu-hu: 'innI 'asma`u .himAra-ka yA ju.hA yanhaqu. fa-qAla la-hu
+  ju.hA: .garIbuN 'amru-ka yA .sadIqI 'a-tu.saddiqu 'l-.himAr-a
+  wa-tuka_d_diba-nI?
+\end{arab}
+
+\section{Options}
+\label{sec:options}
+\textsf{arabluatex} may be loaded with four mutually exclusive options:---
+\begin{compactdesc}
+\item[voc] To have every short vowel written. This option is loaded by
+  default.
+\item[fullvoc] To have the \arb[trans]{sukUn} and the
+  \arb[trans]{wa.slaT} expressed in addition to what \verb|voc|
+  already does.
+\item[novoc] To have all the diacritics discarded.
+\item[trans] To have the Arabic transliterated into one of the
+  accepted standards.
+\end{compactdesc}
+\begin{verbatim}
+% <preamble>
+\usepackage{arabluatex} % this loads 'voc' by default
+\usepackage[voc]{arabluatex}
+\usepackage[fullvoc]{arabluatex}
+\usepackage[novoc]{arabluatex}
+\usepackage[trans]{arabluatex}
+\end{verbatim}
+
+At any point of the document, any mode can be set locally, like so:---
+\begin{verbatim}
+English paragraph: To have the \arb[trans]{sukUn} and the
+  \arb[trans]{wa.slaT} expressed...
+
+\begin{arab}[trans] % Arabic paragraph
+  'at_A .sadIquN 'il_A \cap{j}u.hA ya.tlubu min-hu .himAra-hu
+  li-yarkaba-hu fI safraTiN qa.sIraTiN fa-qAla la-hu: sawfa 'u`Idu-hu
+  'ilay-ka fI 'l-masA'-i wa-'adfa`u la-ka 'ujraTaN.
+\end{arab}
+\end{verbatim}
+
+English paragraph: To have the \arb[trans]{sukUn} and the
+  \arb[trans]{wa.slaT} expressed...
+
+\begin{arab}[trans] % Arabic paragraph
+  'at_A .sadIquN 'il_A \cap{j}u.hA ya.tlubu min-hu .himAra-hu
+  li-yarkaba-hu fI safraTiN qa.sIraTiN fa-qAla la-hu: sawfa 'u`Idu-hu
+  'ilay-ka fI 'l-masA'-i wa-'adfa`u la-ka 'ujraTaN.
+\end{arab}
+
+\end{document}