summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/xelatex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2016-02-09 22:17:41 +0000
committerKarl Berry <karl@freefriends.org>2016-02-09 22:17:41 +0000
commit0029bd312c7e5b75a104aaf48180eba9f2e784e2 (patch)
tree5e7ed2221f67eaaa9fc7ee306fc73a9dffec8f58 /Master/texmf-dist/doc/xelatex
parente76a00e3f270f03d9a4e79f87888b11149b92102 (diff)
quran (9feb16)
git-svn-id: svn://tug.org/texlive/trunk@39643 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/xelatex')
-rw-r--r--Master/texmf-dist/doc/xelatex/quran/README16
-rw-r--r--Master/texmf-dist/doc/xelatex/quran/quran-doc.pdfbin53151 -> 62708 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/quran/quran-doc.tex103
-rw-r--r--Master/texmf-dist/doc/xelatex/quran/quran-test.pdfbin50207 -> 0 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/quran/quran-test.tex80
5 files changed, 83 insertions, 116 deletions
diff --git a/Master/texmf-dist/doc/xelatex/quran/README b/Master/texmf-dist/doc/xelatex/quran/README
index aa32a931ccb..beb0f06147b 100644
--- a/Master/texmf-dist/doc/xelatex/quran/README
+++ b/Master/texmf-dist/doc/xelatex/quran/README
@@ -1,23 +1,19 @@
_____________________
The quran package
-v0.941
+v1.05
The package is prepared for typesetting the Holy Quran. This work is inspired
-by lipsum and ptext packages provides several macros for typesetting the whole or
-any part of The Holy Quran based on its popular divisions.
-
-The package only works with `xelatex' format and should be
-loaded before `bidi' package.
+by lipsum and ptext packages, provides several macros for typesetting the whole or
+any parts of The Holy Quran based on its popular divisions.
For more information, please see the documentation.
-
-Current version release date: 2015/07/11
+Current version release date: 2016/02/09
___________________
-Seiied-Mohammad-Javad Razvian, Ali Ramzi
+Seiied-Mohammad-Javad Razvian
javadr@gmail.com
-Copyright © 2015
+Copyright © 2015-2016
It may be distributed and/or modified under the LaTeX Project Public License,
version 1.3c or higher (your choice). The latest version of
this license is at: http://www.latex-project.org/lppl.txt
diff --git a/Master/texmf-dist/doc/xelatex/quran/quran-doc.pdf b/Master/texmf-dist/doc/xelatex/quran/quran-doc.pdf
index fcd276a958a..6c6ba3609a5 100644
--- a/Master/texmf-dist/doc/xelatex/quran/quran-doc.pdf
+++ b/Master/texmf-dist/doc/xelatex/quran/quran-doc.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/quran/quran-doc.tex b/Master/texmf-dist/doc/xelatex/quran/quran-doc.tex
index 03b506389cb..14a89bf892d 100644
--- a/Master/texmf-dist/doc/xelatex/quran/quran-doc.tex
+++ b/Master/texmf-dist/doc/xelatex/quran/quran-doc.tex
@@ -1,61 +1,106 @@
\documentclass{ltxdoc}
+%\usepackage{pgffor}
+\usepackage{forloop}
+\usepackage{pgf}
+\usepackage{pgfcalendar}
\usepackage{framed}
\usepackage{holtxdoc}
\usepackage{url}
+\usepackage{quran}
\begin{document}
\title{The \xpackage{quran} Package\footnote{to one who has devoted his life to Quran}}
-\author{Seiied Mohammad Javad Razavian, Ali Ramzi\\\xemail{javadr,ali.ramzi@gmail.com}}
+\author{Seiied Mohammad Javad Razavian\\\xemail{javadr@gmail.com}}
-\date{July 11, 2015}
+\date{Feb 9, 2016}
\maketitle
\begin{framed}
This manual is incomplete and the package is under development. \par
-\centerline{ver 0.941}
+\centerline{ver 1.05}
\end{framed}
\tableofcontents
\section{Introduction}
This package is prepared for typesetting the Holy Quran. This work is inspired by \xpackage{lipsum} and
-\xpackage{ptext} packages provides several macros for
-typesetting the whole or part of Quran based on its popular division.
+\xpackage{ptext} packages, provides several macros for
+typesetting the whole or any parts of the Holy Quran based on its popular division.
\section{Loading Package}
You can load the package in the ordinary way
\cs{usepackage[option]\{quran\}}.
-Like the other pakages that use \xpackage{bidi}, it should be loaded just before \xpackage{bidi}.
+%Like the other pakages that use \xpackage{bidi}, it should be loaded just before \xpackage{bidi}.
\section{Typesetting The Holy Quran}
-For typesetting any part or whole of The Holy Quran there are several macros that do this.
+For typesetting any parts or whole of The Holy Quran there are several macros in the package.
\subsection{Surah/Sovar}
\begin{declcs}{quransurah}\oarg{m}
\end{declcs}
-This macro can typeset any Surah of Quran. As you know there are 114 Sovar, so \textit{m} must be a integer between
-1 to 114.
+This macro can typeset any Surah of Quran. As you know there are 114 Sovar, so \textit{m} could
+be an integer between 1 to 114. The macro also could accept the transliteration of surah's name,
+e.g. both of \cs{quransurah[1]} and \cs{quransurah[Al-Fatiha]} have the same effect. For using
+surah's name instead of their order see table~\ref{tab1}.
+\marginpar{\cs{quransurah[1]}}\marginpar{\cs{quransurah[Al-Fatiha]}}
+
+\newcounter{ct}
+\def\mycell#1{
+ \surahname[\value{#1}]
+ \addtocounter{#1}{38}
+}
+\begin{table}[!htbp]
+ \centering
+ \fontsize{8}{10}\selectfont
+ \begin{tabular}{|*{3}{c|l|}}
+ \hline
+ order & surahname & order & surahname & order & surahname \\
+ \hline\hline%
+ \forloop{ct}{1}{\value{ct} < 38}{%
+ \thect & \mycell{ct} & \thect & \mycell{ct} & \thect & \mycell{ct} \\
+ \addtocounter{ct}{-114}
+ }%
+ \thect & \mycell{ct} & \thect & \mycell{ct} & \thect & \mycell{ct}\\%
+ \hline
+ \end{tabular}
+ \protect\caption{Surah's name trasliteration.}\label{tab1}
+\end{table}
\begin{declcs}{quransurah}\oarg{m-n}
\end{declcs}
This acts like above but can typeset \textit{m}$^{th}$ Surah to \textit{n}$^{th}$ one.
+\begin{declcs}{quransurah}\oarg{m{-}{-}n}
+\end{declcs}
+In this case m and n are tranliterations of surah's names, e.g. \cs{quransurah[An-Nasr--An-Nas]}.
+\marginpar{\cs{quransurah[An-Nasr--An-Nas]}}
+
+\begin{declcs}{quransurah}
+\end{declcs}
Using \cs{quransurah} without its optional argument typeset the default Surah--Al-Ikhlas.
-To change the default Surah use \cs{setsurahdefault\{m\}}
+To change the default Surah use \cs{setsurahdefault\{m\}}, again m must be between 1 and 114;
+package's default is 112.
+\marginpar{\cs{setsurahdefault}}
\subsection{Ayah/Ayat}
\begin{declcs}{quranayah}\oarg{l}\oarg{n}
\end{declcs}
The above macro typeset the \textit{n}$^{th}$ Ayah of \textit{l}$^{th}$ Surah.
-If you just typeset the first Ayah of any Surah, then the Basmalah will not be printed and in writing the way
-we've choosen for typesetting just the first Ayah is acceptable. In this case if you need Basmalah, then
-you can use the \cs{Basmalah} macro before.
+If you just typeset the first Ayah of any Surah, then the Basmalah will not be printed.
+In this case if you need Basmalah, then you can use the \cs{Basmalah} macro before.
+\marginpar{\cs{Basmalah}}
\begin{declcs}{quranayah}\oarg{l}\oarg{m-n}
\end{declcs}
This macro typeset the \textit{m}$^{th}$ to \textit{n}$^{th}$ Ayat of l$^{th}$ Surah.
-\textit{l} must be an integer less than or equal to 114. \textit{n} is diffirent by every Surah.
+\par
+\addvspace{4.5ex plus 1ex}%
+\vskip -\parskip
+\noindent\textit{l} could be an integer less than or equal to 114. It also could be
+the transliteration of l$^{th}$ Surah's name, see table~\ref{tab1}.
+\textit{n} is diffirent by every Surah and it relies on the number of the Surah's verses.
+\textit{m} should be between 1 and a number less than \textit{n}.
\subsection{Page/Pages}
\begin{declcs}{quranpage}\oarg{n}
@@ -65,12 +110,12 @@ Typeset the \textit{n}$^{th}$ page of Quran and the macro below typeset \textit{
\begin{declcs}{quranpage}\oarg{m-n}
\end{declcs}
-The numbers should be between $1$ to $604$, based of Uthmani.
+The numbers should be between $1$ to $604$, based on Uthmani text.
\subsection{Juz/Ajza}
\begin{declcs}{quranjuz}\oarg{n}
\end{declcs}
-Using above macro typeset the \textit{n}$^{th}$ juz of Quran and below macro typeset m$^{th}$ to n$^{th}$ juzzes of Quran.
+Above macro typesets the \textit{n}$^{th}$ juz of Quran and below macro typesets m$^{th}$ to n$^{th}$ juzzes of Quran.
\begin{declcs}{quranjuz}\oarg{m-n}
\end{declcs}
The numbers should be between $1$ to $30$.
@@ -85,17 +130,17 @@ Following macros typeset hizb/ahzab of Quran.
\end{declcs}
\subsection{Quarter/Quarters}
-Eash hizb of Quran is devided into four quarters, making eight quarters per juz.
+Eash hizb of Quran is devided into four quarters, making eight quarters per juz, called maqra.
There are 240 of these quarters (of hizb) in the Quran. These maqra are often used as sections for revision when memorizing the Quran.\footnote{\url{https://en.wikipedia.org/wiki/Juz'}}
\begin{declcs}{quranquarter}\oarg{n}
\end{declcs}
\begin{declcs}{quranquarter}\oarg{m-n}
\end{declcs}
-Using above macros typeset the \textit{n}$^{th}$ or m$^{th}$ to n$^{th}$ quarter(s) of Quran.
+Above macros typeset the \textit{n}$^{th}$ or m$^{th}$ to n$^{th}$ quarter(s) of Quran.
\subsection{Ruku/Rukus}
-``The term ruk\= uʿ --- roughly translated to ``passage", ``pericope" or ``stanza" --- is also used to denote a group of thematically related verses in the Qur'an. Longer suras (chapters) in the Qur'an are usually divided into several rukūʿs, so that the reciters could identify when to make ruk\= u in Salat without breaking an ongoing topic in the Quranic text."\footnote{\url{https://en.wikipedia.org/wiki/Ruku}}
+``The term ruk\= uʿ --- roughly translated to ``passage", ``pericope" or ``stanza" --- is also used to denote a group of thematically related verses in the Qur'an. Longer suras (chapters) in the Qur'an are usually divided into several ruk\= us, so that the reciters could identify when to make ruk\= u in Salat without breaking an ongoing topic in the Quranic text."\footnote{\url{https://en.wikipedia.org/wiki/Ruku}}
The following macros can typeset rukus of The Holy Quran the way the above macros act.
@@ -106,9 +151,9 @@ The following macros can typeset rukus of The Holy Quran the way the above macro
The numbers should be between $1$ to $556$.
\subsection{Manzil/Manazil}
-``For the convenience of people who wish to read the Qur'an in a week the text may be divided into 7 portions, each portion is known as Manzil.[1]
+``For the convenience of people who wish to read the Qur'an in a week the text may be divided into 7 portions, each portion is known as Manzil.
-The following division to 7 equal portions is by Hamza Al-Zayyat (d.156/772):[1]
+The following division to 7 equal portions is by Hamza Al-Zayyat (d.156/772):
\begin{enumerate}
\item Al-Fatihah (chapter 1) through An-Nisa' (chapter 4) consisting of 4 surahs.
\item Al-Ma'ida (chapter 5) through At-Tawba (chapter 9) consisting of 5 surahs.
@@ -132,14 +177,17 @@ are $6236$ Ayat in Quran. This macro can typeset a specific Ayah or any range of
\begin{declcs}{qurantext}\oarg{n}
\end{declcs}
-Typeset the \textit{n}$^{th}$ Ayah of Quran.
+Typesets the \textit{n}$^{th}$ Ayah of Quran.
\begin{declcs}{qurantext}\oarg{m-n}
\end{declcs}
-Typeset any range of Ayat from the \textit{m}$^{th}$ to \textit{n}$^{th}$ Ayah.
+Typesets any range of Ayat from the \textit{m}$^{th}$ to \textit{n}$^{th}$ Ayah.
Using \cs{qurantext} without its optional argument typeset [1-7] --Al-Hamd. To
change the default text use \cs{setqurantextdefault\{m-n\}}
+\marginpar{\cs{qurantext}}
+\marginpar{\cs{setqurantextdefault\{m-n\}}}
+
\subsection{Whole of The Holy Quran}
The following macros can typeset whole of The Holy Quran:
@@ -157,8 +205,11 @@ The following macros can typeset whole of The Holy Quran:
\subsection{Name of Surah}
\begin{declcs}{surahname}\oarg{m}
\end{declcs}
-This macro returns the arabic name of \textit{m}$^{th}$ Surah in RTL mode, and returns the
-english name in LTR mode.
+This macro returns the tranliteration of \textit{m}$^{th}$ Surah.
+
+\begin{declcs}{surahname*}\oarg{m}
+\end{declcs}
+This macro returns the arabic name of \textit{m}$^{th}$ Surah.
\subsection{Basmalah}
\begin{declcs}{basmalah}
@@ -175,7 +226,7 @@ has a starred version that omit the \cs{par} macro in typesetting the text of Qu
In some cases maybe user wants to typeset the Ayat without their following numbers that can be seen in printed version of The Holy Quran. The \texttt{nonumber}\marginpar{nonumber}
option tells the package that print no number after ayah.
-But sometimes we want to typeset just some Ayat without it, so there is a \cs{ChangeAyahNumber} macro
+But sometimes we want to typeset just some Ayat without theirs, so there is a \cs{ToggleAyahNumber} macro
that can cause numbers will be omitted. With \texttt{nonumber} option this macro acts vice versa, it mean it
causes that Ayat number will be printed.
diff --git a/Master/texmf-dist/doc/xelatex/quran/quran-test.pdf b/Master/texmf-dist/doc/xelatex/quran/quran-test.pdf
deleted file mode 100644
index f4ecc0ee6d1..00000000000
--- a/Master/texmf-dist/doc/xelatex/quran/quran-test.pdf
+++ /dev/null
Binary files differ
diff --git a/Master/texmf-dist/doc/xelatex/quran/quran-test.tex b/Master/texmf-dist/doc/xelatex/quran/quran-test.tex
deleted file mode 100644
index 4b2d9bb209a..00000000000
--- a/Master/texmf-dist/doc/xelatex/quran/quran-test.tex
+++ /dev/null
@@ -1,80 +0,0 @@
-%This document wants to the explain the quran package with some examples.
-\documentclass{article}
-
-\usepackage{forloop}
-\usepackage{quran}
-%The xepersian package automatically load bidi, and I've loaded it because I want to set a font that supports Arabic letters
-\usepackage{xepersian}
-
-% This macro set the main text font for non-latin letter, and it can scale font.
-\settextfont[Scale=1.1]{Scheherazade}
-
-\def\surna[#1]{\centerline{\hss\surahname[#1]\hss\lr{\surahname[#1]}\hss}}
-\def\test#1{
- \par
- \surna[#1]
- \quransurah*[#1]
- \bigskip
-}
-
-\begin{document}
-
-% For typesetting بِسمِ اللَّهِ الرَّحمٰنِ الرَّحيمِ use below macro
-%\centerline{\basmalah}
-
-\quransurah[108] % Surah Al-Kauther
-
-%%\surna[110]\quransurah*[110] % Surah Al-Nasr
-
-%The below typeset 104th surah through 113th surah.
-%%\quransurah*[104-113]
-
-\makeatletter
-\surna[\qt@surah@default]\quransurah* % Surah Al-Ikhlas
-\makeatother
-
-\quranayah[33][33]
-\quranayah*[76][1-22]
-
-%%You can typeset whole of Holy Quran with below commands.
-%%\newcounter{ct}
-%%\forloop{ct}{1}{\value{ct} < 115} {\test{\value{ct}}}
-
-%%You can typeset whole of Holy Quran with below commands.
-%%\newcounter{jz}
-%%\forloop{jz}{1}{\value{jz} < 31} {\quranjuz[\value{jz}]}
-
-%%\quranjuz*[28-30]
-
-%\quranpage*[256]
-%\quranpage*[3-4]
-
-%%You can typeset whole of Holy Quran with below commands, just replace 8 with 605.
-\newcounter{pg}
-\forloop{pg}{1}{\value{pg} < 8} {
-\hfill صفحة \arabic{pg} \par
-\quranpage*[\value{pg}]\vfill}
-
-%\quranhizb*[117-120]
-
-%\quranquarter*[1-4]
-%\quranquarter*[239-240]
-
-%\quranruku[313]
-%\quranruku[556]
-
-%\quranmanzil*[2]
-
-
-%%\surna[1]\qurantext % Surah Al-Hamd
-
-%%\surna[1]\qurantext* % Surah Al-Hamd
-
-%%\surna[114]\qurantext[6231-6236] % Surah Al-Nas
-
-%%\surna[114]\qurantext*[6231-6236] % Surah Al-Nas
-
-%%%\surna[2]\qurantext*[8-293] % Surah Al-Baqara
-
-%\qurantext[1-6236] % The whole of Holy Quran
-\end{document}