summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/quran-ur
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2021-02-02 22:14:17 +0000
committerKarl Berry <karl@freefriends.org>2021-02-02 22:14:17 +0000
commitdff87f690111f82e4e367b08248cb0a31d3bdbbf (patch)
tree84d8069bb9f6dcc0fe5ac732ab3835ca738e1959 /Master/texmf-dist/doc/latex/quran-ur
parent4c5f7de7e2bd10fad49a980de674f1299f89dda5 (diff)
quran-ur (2feb21)
git-svn-id: svn://tug.org/texlive/trunk@57597 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/quran-ur')
-rw-r--r--Master/texmf-dist/doc/latex/quran-ur/README23
-rw-r--r--Master/texmf-dist/doc/latex/quran-ur/quran-ur-doc.pdfbin0 -> 96280 bytes
-rw-r--r--Master/texmf-dist/doc/latex/quran-ur/quran-ur-doc.tex192
-rw-r--r--Master/texmf-dist/doc/latex/quran-ur/quran-ur-test.pdfbin0 -> 47390 bytes
-rw-r--r--Master/texmf-dist/doc/latex/quran-ur/quran-ur-test.tex44
-rw-r--r--Master/texmf-dist/doc/latex/quran-ur/quran.pngbin0 -> 8846 bytes
6 files changed, 259 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/quran-ur/README b/Master/texmf-dist/doc/latex/quran-ur/README
new file mode 100644
index 00000000000..e670bf0d0f0
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/quran-ur/README
@@ -0,0 +1,23 @@
+_____________________
+The quran-ur package
+v0.21
+
+The package is prepared for typesetting some of Urdu translations of the Holy Quran.
+The supported translations are done by `Abul A'ala Maududi', 'Ahmed Raza Khan',
+'Ahmed Ali', 'Fateh Muhammad Jalandhry', 'Tahir ul Qadri', 'Syed Zeeshan Haider Jawadi',
+'Muhammad Junagarhi', and 'Muhammad Hussain Najafi'.
+
+For more information, please see the documentation.
+
+Current version release date: 2021/02/02
+___________________
+Seiied-Mohammad-Javad Razvian
+javadr@gmail.com
+
+Copyright © 2019-2021
+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
+
+This work is “author-maintained” (as per LPPL maintenance status)
+by Seiied-Mohammad-Javad Razavian.
diff --git a/Master/texmf-dist/doc/latex/quran-ur/quran-ur-doc.pdf b/Master/texmf-dist/doc/latex/quran-ur/quran-ur-doc.pdf
new file mode 100644
index 00000000000..8696b7ed7e2
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/quran-ur/quran-ur-doc.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/quran-ur/quran-ur-doc.tex b/Master/texmf-dist/doc/latex/quran-ur/quran-ur-doc.tex
new file mode 100644
index 00000000000..b949161e736
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/quran-ur/quran-ur-doc.tex
@@ -0,0 +1,192 @@
+\documentclass[a4paper]{ltxdoc}
+
+\usepackage{holtxdoc}
+\usepackage{url}
+\usepackage{booktabs}
+\usepackage{listings}
+\usepackage{tikz}
+\hypersetup{%
+ plainpages=false,%
+ bookmarksnumbered,%
+ pdftitle={The quran-ur Package},%
+ pdfkeywords={quran-ur, surah, ayah, juz, hizb, ruku, manzil},%
+ pdfauthor={Seiied-Mohammad-Javad Razavian},%
+ baseurl={http://mirrors.ctan.org/macros/unicodetex/latex/quran-ur/doc/quran-ur-doc.pdf},%
+}
+\usepackage[all]{quran-ur}
+% because of definition of \XeTeX and \XeLaTeX symbols in bidi,
+% I should undef these macro that are also defined in holtxdoc package.
+\makeatletter
+\bidi@undef\XeTeX
+\bidi@undef\XeLaTeX
+\makeatother
+\usepackage{arabxetex}
+%\makeatletter
+%\bidi@BeforeBeginEnvironment{declcs}{\vspace*{-4mm}}
+%\makeatother
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\def\boxcs#1{\leftline{\fbox{\mcs{#1}}}}
+\def\mcs#1{\lr{\texttt{\textbackslash{}#1}}}
+\def\tt#1{\lr{\texttt{#1}}}
+\lstdefinestyle{BashInputStyle}{
+ language=bash,
+ basicstyle=\footnotesize\sffamily,
+ frame=tb,
+ columns=fullflexible,
+ backgroundcolor=\color{gray!10},
+}
+
+% Define box and box title style
+\tikzstyle{mybox} = [draw=black, fill=gray!20, very thick,
+ rectangle, rounded corners, inner sep=10pt, inner ysep=20pt]
+\tikzstyle{fancytitle} =[fill=gray, text=white]
+
+\def\mx#1#2{\mybox{#1}{#2}{.45\textwidth}}
+\def\mxf#1#2{\mybox{#1}{#2}{\textwidth}}
+
+\def\mybox#1#2#3{
+\begin{tikzpicture}
+\node [mybox] (box){%
+ \begin{minipage}[t]{#3}
+ #2
+ \end{minipage}
+};
+\node[fancytitle, anchor=west, right=10pt] at (box.north west) {\small \cs{#1}};
+\node (hole) [anchor=north east, left=5pt ] at (box.north east) { \tikz\fill[very thick,white] (0,0) circle (12pt); };
+\node[ ] at (hole.center) {\includegraphics[width=.05\textwidth]{quran.png}};
+\end{tikzpicture}%
+}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\title{\includegraphics[scale=.3]{quran.png}\\
+The \xpackage{quran-ur} Package\footnote{To one having devoted his life to the Holy Quran}}
+\author{Seiied Mohammad Javad Razavian\\\xemail{javadr@gmail.com}}
+
+\date{\quranurdate, Version \quranurversion\footnote{First release: May 9th, 2019}}
+
+\begin{document}
+\maketitle
+
+\tableofcontents
+%\newpage
+
+\vfill
+\section{Introduction}
+The \xpackage{quran} package provides several macros for
+typesetting the whole or any parts of the Holy Quran based on its popular divisions.
+That package also develops
+commands for some translations of the Holy Quran including German, Engilsh, and Persian.
+Some people asked me to include the other translations into the \xpackage{quran} package,
+but because of some technical issues I decided to create new packages for other translations.
+One of these variations is \xpackage{quran-ur} including all Urdu translations of the Holy Quran
+provided by \url{tanzil.net}, i.e.
+\emph{``Abul A'ala Maududi''}, \emph{``Ahmed Raza Khan''},
+\emph{``Ahmed Ali''}, \emph{``Fateh Muhammad Jalandhry''},
+\emph{``Tahir ul Qadri''}, \emph{``Syed Zeeshan Haider Jawadi''},
+\emph{``Muhammad Junagarhi''}, and \emph{``Muhammad Hussain Najafi.''}
+
+
+\newpage
+\section{Loading The Package}
+The package will be loaded in the ordinary way
+\cs{usepackage[option]\{quran-ur\}}.
+After loading the package, it writes some information about itself to the
+terminal and to the log file, too. The information is something like:
+
+\begin{lstlisting}[style=BashInputStyle, language=tex, escapechar={|}]
+Package: quran-ur |\quranurdate| v|\quranurversion|
+Urdu translations extension to the quran package.
+\end{lstlisting}
+
+
+\section{Options of The Package}\label{sec:qurantypesetting}
+There are eight options by the names of \xoption{ahmedali}, \xoption{jalandhry}, \xoption{jawadi},
+\xoption{junagarhi}, \xoption{kanzuliman}, \xoption{maududi}, \xoption{najafi}, and \xoption{qadri}.
+%\marginpar{\ttfamily ahmedali\smallskip}\marginpar{\ttfamily jalandhry\smallskip}
+%\marginpar{\ttfamily jawadi}\marginpar{\ttfamily junagarhi\smallskip}
+%\marginpar{\ttfamily kanzuliman}\marginpar{\ttfamily maududi\smallskip}
+%\marginpar{\ttfamily najafi}\marginpar{\ttfamily qadri\smallskip}
+%\marginpar{\ttfamily all\smallskip}
+If you pass any combinations of these options, the package will be enabled to typeset these translations in the way that the \xpackage{quran} package does.
+There is also \xoption{all} option which loads all Urdu translations provided by the \xpackage{quran-ur} package.
+The package loads \xoption{jalandhry} option by default.
+
+This package is completely built on top of the \xpackage{quran} package, therefore you can pass every options
+defined in that package to the \xpackage{quran-ur} package.
+
+\section{Differences between \xpackage{quran} and \xpackage{quran-ur}}
+At first glance, \xpackage{quran-ur} offers all functionalities of \xpackage{quran}. Therefore in this case
+both are the same except that \xpackage{quran-ur} adds eight other Urdu translations, namely
+`ahmedali', `jalandhry', `jawadi', `junagarhi', `kanzuliman', `maududi', `najafi', and `qadri'.
+All Urdu translations provided by the package are shown in table~\ref{tab:urtrans}.
+
+\begin{table}[!htbp]
+\centering
+\begin{tabular}{|c|l|c|}
+ \toprule
+ order & \multicolumn{1}{c|}{translator} & option's name \\\midrule
+ 1 & Ahmed Ali & ahmedali \\
+ 2 & Fateh Muhammad Jalandhry & jalandhry \\
+ 3 & Syed Zeeshan Haider Jawadi & jawadi \\
+ 4 & Muhammad Junagarhi & junagarhi \\
+ 5 & Ahmed Raza Khan & kanzuliman \\
+ 6 & Abul A'ala Maududi & maududi \\
+ 7 & Muhammad Hussain Najafi & najafi \\
+ 8 & Tahir ul Qadri & qadri \\
+ \bottomrule
+\end{tabular}
+ \caption{Urdu translations used in the package and their option's names}
+ \label{tab:urtrans}
+\end{table}
+
+\subsection{How to Change the Current Urdu Translation}
+ The \xpackage{quran-ur} package uses jalandhry's translation by default.
+ The following macro could be used to change the default Urdu translation.
+ \begin{declcs}{urSetTrans}\marg{index}
+ \end{declcs}
+ The \meta{index} could be an integer or a name; both ``order'' and ``option's name''
+ shown in Table~\ref{tab:urtrans} are applicable. Both \cs{urSetTrans\{3\}} and \cs{urSetTrans\{jawadi\}}, for example,
+ have the same effect.
+
+\subsection{How to Get the Name of Current Urdu Translation}
+ \begin{declcs}{urGetTrans}
+ \end{declcs}
+ The above macro returns the name of current Urdu translation, i.e. one of
+ `ahmedali', `jalandhry', `jawadi', `junagarhi', `kanzuliman', `maududi', `najafi', and `qadri'.
+
+\subsection{How to Typeset the Urdu Translation}
+ It's completely similar to the \xpackage{quran} package with extra \texttt{ur} at the end of macro's name.
+ All the following macros are usable.
+
+\begin{multicols}{2}
+ \begin{itemize}
+ \item \cs{quransurahur}
+ \item \cs{quranayahur}
+ \item \cs{quranpageur}
+ \item \cs{quranjuzur}
+ \item \cs{quranhizbur}
+ \item \cs{quranquarterur}
+ \item \cs{quranrukuur}
+ \item \cs{quranmanzilur}
+ \item \cs{qurantextur}
+ \end{itemize}
+\end{multicols}
+
+\def\printsurah#1{\centerline{\mxf{urSetTrans\{#1\}\textbackslash{}quransurahur*}
+{\setLTR\urSetTrans{#1}\begin{arab}\quransurahur*\end{arab}}}}
+
+ \centerline{\mxf{quransurah*}
+ {\begin{arab}\small\quransurah*\end{arab}}}
+ \printsurah{ahmedali}
+ \printsurah{jalandhry}
+ \printsurah{jawadi}
+ \printsurah{junagarhi}
+ \printsurah{kanzuliman}
+ \printsurah{maududi}
+ \printsurah{najafi}
+ \printsurah{qadri}
+
+\end{document}
+
diff --git a/Master/texmf-dist/doc/latex/quran-ur/quran-ur-test.pdf b/Master/texmf-dist/doc/latex/quran-ur/quran-ur-test.pdf
new file mode 100644
index 00000000000..b963df7a4bd
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/quran-ur/quran-ur-test.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/quran-ur/quran-ur-test.tex b/Master/texmf-dist/doc/latex/quran-ur/quran-ur-test.tex
new file mode 100644
index 00000000000..d98d371642a
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/quran-ur/quran-ur-test.tex
@@ -0,0 +1,44 @@
+\documentclass{article}
+\usepackage[margin=2cm]{geometry}
+\usepackage{arabxetex} % for typesetting Arabic text in Rigth−To−Left direction
+\usepackage[all, trans={fa}]{quran-ur} % trans={fa} option would be sent to quran package
+
+\newcommand{\compare}[1]{%
+ \def\setTr##1{\par\urSetTrans{##1}\fbox{\makebox[2cm]{\urGetTrans}}}
+ \noindent\hrulefill{\string #1}\hrulefill
+ \setTr{ahmedali} #1
+ \setTr{jalandhry} #1
+ \setTr{jawadi} #1
+ \setTr{junagarhi} #1
+ \setTr{kanzuliman} #1
+ \setTr{maududi} #1
+ \setTr{najafi} #1
+ \setTr{qadri} #1
+\par
+}
+\newcommand{\mybox}[2]{\noindent%
+\begin{minipage}{.48\textwidth}
+#1
+#2\par
+\end{minipage}}
+
+\newcommand{\myURbox}[1]{\mybox{#1}{\hrulefill\fbox{\makebox[2cm]{\urGetTrans}}}}
+\newcommand{\IkhlasBox}[1]{\myURbox{\urSetTrans{#1}\quranayahur[Al-Ikhlas][1-4]}}
+
+\begin{document}
+\begin{arab}[utf]
+\mybox{\quranayah[Al-Ikhlas][1-4]}{\hrulefill\fbox{\makebox[2cm]{Al-Ikhlas}}} \hfill
+\mybox{\quranayahfa[Al-Ikhlas][1-4]}{\hrulefill\fbox{\makebox[2cm]{Persian}}}
+
+\smallskip\IkhlasBox{1}\hfill\IkhlasBox{2}\\
+\smallskip\IkhlasBox{3}\hfill\IkhlasBox{4}\\
+\smallskip\IkhlasBox{5}\hfill\IkhlasBox{6}\\
+\smallskip\IkhlasBox{7}\hfill\IkhlasBox{8}\\
+\smallskip
+
+\compare{\quransurahur*}
+\compare{\quranayahur[1][1]}
+\ToggleBasmalah
+\compare{\quranpageur*[2]}
+\end{arab}
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/quran-ur/quran.png b/Master/texmf-dist/doc/latex/quran-ur/quran.png
new file mode 100644
index 00000000000..f4339119f88
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/quran-ur/quran.png
Binary files differ