123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110 |
- \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 \uc{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 \uc{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}
|