From dff87f690111f82e4e367b08248cb0a31d3bdbbf Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Tue, 2 Feb 2021 22:14:17 +0000 Subject: quran-ur (2feb21) git-svn-id: svn://tug.org/texlive/trunk@57597 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/quran-ur/README | 23 +++ .../texmf-dist/doc/latex/quran-ur/quran-ur-doc.pdf | Bin 0 -> 96280 bytes .../texmf-dist/doc/latex/quran-ur/quran-ur-doc.tex | 192 +++++++++++++++++++++ .../doc/latex/quran-ur/quran-ur-test.pdf | Bin 0 -> 47390 bytes .../doc/latex/quran-ur/quran-ur-test.tex | 44 +++++ Master/texmf-dist/doc/latex/quran-ur/quran.png | Bin 0 -> 8846 bytes 6 files changed, 259 insertions(+) create mode 100644 Master/texmf-dist/doc/latex/quran-ur/README create mode 100644 Master/texmf-dist/doc/latex/quran-ur/quran-ur-doc.pdf create mode 100644 Master/texmf-dist/doc/latex/quran-ur/quran-ur-doc.tex create mode 100644 Master/texmf-dist/doc/latex/quran-ur/quran-ur-test.pdf create mode 100644 Master/texmf-dist/doc/latex/quran-ur/quran-ur-test.tex create mode 100644 Master/texmf-dist/doc/latex/quran-ur/quran.png (limited to 'Master/texmf-dist/doc/latex/quran-ur') 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 Binary files /dev/null and b/Master/texmf-dist/doc/latex/quran-ur/quran-ur-doc.pdf 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 Binary files /dev/null and b/Master/texmf-dist/doc/latex/quran-ur/quran-ur-test.pdf 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 Binary files /dev/null and b/Master/texmf-dist/doc/latex/quran-ur/quran.png differ -- cgit v1.2.3