From be4ce1c71af4bb0d1800ac225bf0cfecf0d5274b Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 9 Nov 2023 22:24:36 +0000 Subject: quran-en (4nov23) git-svn-id: svn://tug.org/texlive/trunk@68790 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/xelatex/quran-en/README | 26 +++ .../doc/xelatex/quran-en/quran-en-doc.pdf | Bin 0 -> 88109 bytes .../doc/xelatex/quran-en/quran-en-doc.tex | 190 +++++++++++++++++++++ .../doc/xelatex/quran-en/quran-en-test.pdf | Bin 0 -> 51637 bytes .../doc/xelatex/quran-en/quran-en-test.tex | 46 +++++ Master/texmf-dist/doc/xelatex/quran-en/quran.png | Bin 0 -> 8846 bytes 6 files changed, 262 insertions(+) create mode 100644 Master/texmf-dist/doc/xelatex/quran-en/README create mode 100644 Master/texmf-dist/doc/xelatex/quran-en/quran-en-doc.pdf create mode 100644 Master/texmf-dist/doc/xelatex/quran-en/quran-en-doc.tex create mode 100644 Master/texmf-dist/doc/xelatex/quran-en/quran-en-test.pdf create mode 100644 Master/texmf-dist/doc/xelatex/quran-en/quran-en-test.tex create mode 100644 Master/texmf-dist/doc/xelatex/quran-en/quran.png (limited to 'Master/texmf-dist/doc/xelatex') diff --git a/Master/texmf-dist/doc/xelatex/quran-en/README b/Master/texmf-dist/doc/xelatex/quran-en/README new file mode 100644 index 00000000000..2c6bdf8e3b1 --- /dev/null +++ b/Master/texmf-dist/doc/xelatex/quran-en/README @@ -0,0 +1,26 @@ +_____________________ +The quran-en package +v0.1 + +The package is prepared for typesetting some of English translations of the Holy Quran. +The supported translations are done by `Ahmed Ali`, `Ahmed Raza Khan`, `A. J. Arberry`, +`Abdul Majid Daryabadi`, `Muhammad Taqi-ud-Din al-Hilali and Muhammad Muhsin Khan`, +`Talal Itani`, `Abul Ala Maududi`, `Safi-ur-Rahman al-Mubarakpuri`, `Ali Quli Qarai`, +`Mohammed Marmaduke William Pickthall`, `Hasan al-Fatih Qaribullah and Ahmad Darwish`, +`Saheeh International`, `Muhammad Sarwar`, `Mohammad Habib Shakir`, `Wahiduddin Khan`, +and `Abdullah Yusuf Ali`. + +For more information, please see the documentation. + +Current version release date: 2023/11/04 +___________________ +Seiied-Mohammad-Javad Razvian +javadr@gmail.com + +Copyright © 2023 +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/xelatex/quran-en/quran-en-doc.pdf b/Master/texmf-dist/doc/xelatex/quran-en/quran-en-doc.pdf new file mode 100644 index 00000000000..cc28474b376 Binary files /dev/null and b/Master/texmf-dist/doc/xelatex/quran-en/quran-en-doc.pdf differ diff --git a/Master/texmf-dist/doc/xelatex/quran-en/quran-en-doc.tex b/Master/texmf-dist/doc/xelatex/quran-en/quran-en-doc.tex new file mode 100644 index 00000000000..ebba447bac2 --- /dev/null +++ b/Master/texmf-dist/doc/xelatex/quran-en/quran-en-doc.tex @@ -0,0 +1,190 @@ +\documentclass[a4paper]{ltxdoc} + +\usepackage{holtxdoc} +\usepackage{url} +\usepackage{booktabs} +\usepackage{listings} +\usepackage{tikz} +\hypersetup{% + plainpages=false,% + bookmarksnumbered,% + pdftitle={The quran-en Package},% + pdfkeywords={quran-en, surah, ayah, juz, hizb, ruku, manzil},% + pdfauthor={Seiied-Mohammad-Javad Razavian},% + baseurl={http://mirrors.ctan.org/macros/xetex/latex/quran-en/doc/quran-en-doc.pdf},% +} +\usepackage[all]{quran-en} +% 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-en} Package\footnote{To one having devoted his life to the holy Quran}\\ +} +\author{Seiied Mohammad Javad Razavian\\\xemail{javadr@gmail.com}} + +\date{\quranendate, Version \quranenversion\footnote{First release: November 4th, 2023}} + +\begin{document} +\maketitle + +\tableofcontents +%\newpage + +\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-en} including several English translations of the holy Quran +provided by \url{tanzil.net}, i.e. \emph{``ahmedali''}, \emph{``ahmedraza''}, \emph{``arberry''}, \emph{``daryabadi''}, \emph{``hilali''}, \emph{``itani''}, \emph{``maududi''}, \emph{``mubarakpuri''}, \emph{``pickthall''}, \emph{``qarai''}, \emph{``qaribullah''}, \emph{``sahih''}, \emph{``sarwar''}, \emph{``shakir''}, \emph{``wahiduddin''}, and \emph{``yusufali''}. + + +\section{Loading The Package} +The package will be loaded in the ordinary way +\cs{usepackage[option]\{quran-en\}}. +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{quote} +\begin{lstlisting}[style=BashInputStyle, language=tex, escapechar={|}] +Package: quran-id |\quranendate| v|\quranenversion| +English translation extension to the quran package. +\end{lstlisting} +\end{quote} + + +\section{Options of The Package}\label{sec:qurantypesetting} +There are several options by the names of \xoption{ahmedali}, \xoption{ahmedraza}, \xoption{arberry}, \xoption{daryabadi}, \xoption{hilali}, \xoption{itani}, \xoption{maududi}, \xoption{mubarakpuri}, \xoption{pickthall}, \xoption{qarai}, \xoption{qaribullah}, \xoption{sahih}, \xoption{sarwar}, \xoption{shakir}, \xoption{wahiduddin}, and \xoption{yusufali}.% +% +\foreach\x in {ahmedali,ahmedraza,arberry,daryabadi,hilali,itani,maududi,mubarakpuri,pickthall,qarai,qaribullah,sahih,sarwar,shakir,wahiduddin,yusufali,all}{% +\marginpar{\xoption{\x}\smallskip}% +} +% +If you pass any combinations of these options, you will be enabled to typeset these translations in a way +that the \xpackage{quran} package does. +There is also \xoption{all} option which loads all English translations provided by the \xpackage{quran-en} package. +The package loads \xoption{ahmedali} 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-en} package. + +\section{Differences between \xpackage{quran} and \xpackage{quran-en}} +At first glance, \xpackage{quran-en} offers all functionalities of \xpackage{quran}. Therefore, +both packages are the same in this manner except one difference. The \xpackage{quran-en} extends the \xpackage{quran} +by adding 16 other English translations, namely `ahmedali', `ahmedraza', `arberry', `daryabadi', `hilali', `itani', `maududi', `mubarakpuri', `pickthall', `qarai', `qaribullah', `sahih', `sarwar', `shakir', `wahiduddin', and `yusufali'. All English translations +provided by the package are shown in table~\ref{tab:idtrans}. + +\begin{table}[!htbp] +\centering +\begin{tabular}{|c|l|c|} + \toprule + order & \multicolumn{1}{c|}{translator} & option's name \\\midrule + 1 & Ahmed Ali & ahmedali \\ + 2 & Ahmed Raza Khan & ahmedraza \\ + 3 & A. J. Arberry & arberry \\ + 4 & Abdul Majid Daryabadi & daryabadi \\ + 5 & Muhammad Taqi-ud-Din al-Hilali and Muhammad Muhsin Khan & hilali \\ + 6 & Talal Itani & itani \\ + 7 & Abul Ala Maududi & maududi \\ + 8 & Safi-ur-Rahman al-Mubarakpuri & mubarakpuri \\ + 9 & Mohammed Marmaduke William Pickthall & pickthall \\ + 10 & Ali Quli Qarai & qarai \\ + 11 & Hasan al-Fatih Qaribullah and Ahmad Darwish & qaribullah \\ + 12 & Saheeh International & sahih \\ + 13 & Muhammad Sarwar & sarwar \\ + 14 & Mohammad Habib Shakir & shakir \\ + 15 & Wahiduddin Khan & wahiduddin \\ + 16 & Abdullah Yusuf Ali & yusufali \\ + \bottomrule +\end{tabular} + \caption{English translations used in the package and their option's names} + \label{tab:idtrans} +\end{table} + +\subsection{How to Change the Current English Translation} + The \xpackage{quran-en} package uses ahmedali's translation by default. + The following macro could be used to change the default English translation. + \begin{declcs}{enSetTrans}\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:idtrans} are appliable. Both \cs{enSetTrans\{2\}} and \cs{enSetTrans\{ahmedraza\}}, for example, + have the same effect. + +\subsection{How to Get the Name of Current Indonesian Translation} + \begin{declcs}{idGetTrans} + \end{declcs} + The above macro returns the name of current Indonesian translation, i.e. one of ``ahmedali'', ``ahmedraza'', ``arberry'', ``daryabadi'', ``hilali'', ``itani'', ``maududi'', ``mubarakpuri'', ``pickthall'', ``qarai'', ``qaribullah'', ``sahih'', ``sarwar'', ``shakir'', ``wahiduddin'', or ``yusufali''. + + +\subsection{How to Typeset the Indonesian Translation} + It's completely similar to the \xpackage{quran} package. + All the following macros are usable. + +\begin{multicols}{2} + \begin{itemize} + \item \cs{quransurahen} + \item \cs{quranayahen} + \item \cs{quranpageen} + \item \cs{quranjuzen} + \item \cs{quranhizben} + \item \cs{quranquarteren} + \item \cs{quranrukuen} + \item \cs{quranmanzilen} + \item \cs{qurantexten} + \end{itemize} +\end{multicols} + + \centerline{\mxf{quransurah*} + {\begin{arab}\small\quransurah*\end{arab}}} + + \foreach \x/\y in {ahmedali/1,ahmedraza/2,arberry/3,daryabadi/4,hilali/5,itani/6,maududi/7,mubarakpuri/8,pickthall/9,qarai/10,qaribullah/11,sahih/12,sarwar/13,shakir/14,wahiduddin/15,yusufali/16} {% + \centerline{\mxf{enSetTrans\{\x\}\textbackslash{}quransurahen*} + {\enSetTrans{\y}\quransurahen*}} + } + +\end{document} + diff --git a/Master/texmf-dist/doc/xelatex/quran-en/quran-en-test.pdf b/Master/texmf-dist/doc/xelatex/quran-en/quran-en-test.pdf new file mode 100644 index 00000000000..26f5c4dcae6 Binary files /dev/null and b/Master/texmf-dist/doc/xelatex/quran-en/quran-en-test.pdf differ diff --git a/Master/texmf-dist/doc/xelatex/quran-en/quran-en-test.tex b/Master/texmf-dist/doc/xelatex/quran-en/quran-en-test.tex new file mode 100644 index 00000000000..3541e4538d2 --- /dev/null +++ b/Master/texmf-dist/doc/xelatex/quran-en/quran-en-test.tex @@ -0,0 +1,46 @@ +\documentclass{article} +\usepackage[margin=2cm]{geometry} +\usepackage{arabxetex} % for typesetting Arabic text in Rigth−To−Left direction + +\usepackage{pgffor} +% trans={fa,en,de,lt} option would be sent to quran package +\usepackage[all, trans={fa,en,de,lt}, wordwise]{quran-en} + +\newcommand{\compare}[1]{% + \def\setTr##1{\par\enSetTrans{##1}\fbox{\makebox[2cm]{\enGetTrans}}} + \noindent\hrulefill{\string #1}\hrulefill + \foreach \x/\y in {ahmedali/1,ahmedraza/2,arberry/3,daryabadi/4,hilali/5,itani/6,maududi/7,mubarakpuri/8,pickthall/9,qarai/10,qaribullah/11,sahih/12,sarwar/13,shakir/14,wahiduddin/15,yusufali/16} {% + \setTr{\y} #1 + } +\par +} +\newcommand{\para}[2]{\noindent% +\begin{minipage}{.4\textwidth} +\begin{arab}[utf]#1\end{arab} +\end{minipage}\hfill +\begin{minipage}{.55\textwidth} +#2 +\end{minipage} +} + +\begin{document} + +\quranayahen[1][1][4]+ + +\begin{arab}[utf] +\quranayah[2][5][2]+ +\end{arab} + +\para{\quranayah[Al-Ikhlas][1-4]}{\quranayahlt[Al-Ikhlas][1-4]} +\bigskip +\para{\quranayahfa[Al-Ikhlas][1-4]}{\quranayahen[Al-Ikhlas][1-4]} + +%\quransurahen* + +\compare{\quransurahen*} +\compare{\quranayahen[1][1]} +\ToggleBasmalah +\quranpageen[1] +\compare{\quranpageen*[2]} + +\end{document} diff --git a/Master/texmf-dist/doc/xelatex/quran-en/quran.png b/Master/texmf-dist/doc/xelatex/quran-en/quran.png new file mode 100644 index 00000000000..f4339119f88 Binary files /dev/null and b/Master/texmf-dist/doc/xelatex/quran-en/quran.png differ -- cgit v1.2.3