From 2f26cad4e30cb3c23a5d1523875b3abbba43a267 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Tue, 12 May 2020 21:23:12 +0000 Subject: xepersian-hm (12may20) git-svn-id: svn://tug.org/texlive/trunk@55123 c570f23f-e606-0410-a88d-b1316a301751 --- .../doc/xelatex/xepersian-hm/INSTALL.txt | 38 +++++++++++++ .../doc/xelatex/xepersian-hm/doc-ligature-xep.pdf | Bin 0 -> 10115 bytes .../xelatex/xepersian-hm/doc-ligature-xephm.pdf | Bin 0 -> 13119 bytes .../xelatex/xepersian-hm/kashida-glyph-example.pdf | Bin 91742 -> 91743 bytes .../xelatex/xepersian-hm/kashida-hrule-example.pdf | Bin 90706 -> 90701 bytes .../xepersian-hm/kashida-xep-XB-example.pdf | Bin 78687 -> 78693 bytes .../doc/xelatex/xepersian-hm/xepersian-hm-doc.ltx | 59 ++++++++++++++++++--- .../doc/xelatex/xepersian-hm/xepersian-hm-doc.pdf | Bin 240878 -> 264881 bytes .../doc/xelatex/xepersian-hm/xepersian-hm.pdf | Bin 55239 -> 57525 bytes 9 files changed, 89 insertions(+), 8 deletions(-) create mode 100644 Master/texmf-dist/doc/xelatex/xepersian-hm/INSTALL.txt create mode 100644 Master/texmf-dist/doc/xelatex/xepersian-hm/doc-ligature-xep.pdf create mode 100644 Master/texmf-dist/doc/xelatex/xepersian-hm/doc-ligature-xephm.pdf (limited to 'Master/texmf-dist/doc/xelatex') diff --git a/Master/texmf-dist/doc/xelatex/xepersian-hm/INSTALL.txt b/Master/texmf-dist/doc/xelatex/xepersian-hm/INSTALL.txt new file mode 100644 index 00000000000..3176048e778 --- /dev/null +++ b/Master/texmf-dist/doc/xelatex/xepersian-hm/INSTALL.txt @@ -0,0 +1,38 @@ + xepersian-hm -- INSTALL +====================== + + Source: xepersian-hm.dtx ( 2020/05/11 v0.5e) + Author: Hossein Movahhedian + Info: filecontents + macro + verbatim + License: LPPL 1.3c + Copyright (C) 2020 Hossein Movahedian. + + +- To extract the package and at the same time produce the + documentation, execute: xelatex thrice on xepersian-hm.dtx. + +Files should then be moved to appropriate locations. + +-- *.dtx -> TEXMF/source/xelatex/xepersian-hm/ +-- *.ins -> TEXMF/source/xelatex/xepersian-hm/ + +-- *.sty -> TEXMF/tex/xelatex/xepersian-hm/ +-- *.def -> TEXMF/tex/xelatex/xepersian-hm/ + +-- *.pdf -> TEXMF/doc/xelatex/xepersian-hm/ +-- *.tex -> TEXMF/doc/xelatex/xepersian-hm/ +-- *.ltx -> TEXMF/doc/xelatex/xepersian-hm/ +-- *.txt -> TEXMF/doc/xelatex/xepersian-hm/ + +Don't forget to run 'texconfig rehash' afterwards. + +The example files + + kashida-glyph-example.tex + kashida-hrule-example.tex + kashida-xep-XB-example.tex + +illustrate some features of the package and are an addendum to the +main documentation xepersian-hm.pdf. + +Thats it. diff --git a/Master/texmf-dist/doc/xelatex/xepersian-hm/doc-ligature-xep.pdf b/Master/texmf-dist/doc/xelatex/xepersian-hm/doc-ligature-xep.pdf new file mode 100644 index 00000000000..c02b5b5a5c0 Binary files /dev/null and b/Master/texmf-dist/doc/xelatex/xepersian-hm/doc-ligature-xep.pdf differ diff --git a/Master/texmf-dist/doc/xelatex/xepersian-hm/doc-ligature-xephm.pdf b/Master/texmf-dist/doc/xelatex/xepersian-hm/doc-ligature-xephm.pdf new file mode 100644 index 00000000000..ea5822c8d92 Binary files /dev/null and b/Master/texmf-dist/doc/xelatex/xepersian-hm/doc-ligature-xephm.pdf differ diff --git a/Master/texmf-dist/doc/xelatex/xepersian-hm/kashida-glyph-example.pdf b/Master/texmf-dist/doc/xelatex/xepersian-hm/kashida-glyph-example.pdf index 77033af7c55..9e65b1261e9 100644 Binary files a/Master/texmf-dist/doc/xelatex/xepersian-hm/kashida-glyph-example.pdf and b/Master/texmf-dist/doc/xelatex/xepersian-hm/kashida-glyph-example.pdf differ diff --git a/Master/texmf-dist/doc/xelatex/xepersian-hm/kashida-hrule-example.pdf b/Master/texmf-dist/doc/xelatex/xepersian-hm/kashida-hrule-example.pdf index 6cf4f8078c8..5578b52549b 100644 Binary files a/Master/texmf-dist/doc/xelatex/xepersian-hm/kashida-hrule-example.pdf and b/Master/texmf-dist/doc/xelatex/xepersian-hm/kashida-hrule-example.pdf differ diff --git a/Master/texmf-dist/doc/xelatex/xepersian-hm/kashida-xep-XB-example.pdf b/Master/texmf-dist/doc/xelatex/xepersian-hm/kashida-xep-XB-example.pdf index a35eef3bcdd..5e022cdf557 100644 Binary files a/Master/texmf-dist/doc/xelatex/xepersian-hm/kashida-xep-XB-example.pdf and b/Master/texmf-dist/doc/xelatex/xepersian-hm/kashida-xep-XB-example.pdf differ diff --git a/Master/texmf-dist/doc/xelatex/xepersian-hm/xepersian-hm-doc.ltx b/Master/texmf-dist/doc/xelatex/xepersian-hm/xepersian-hm-doc.ltx index ba04fee9039..42c5562cafe 100644 --- a/Master/texmf-dist/doc/xelatex/xepersian-hm/xepersian-hm-doc.ltx +++ b/Master/texmf-dist/doc/xelatex/xepersian-hm/xepersian-hm-doc.ltx @@ -27,7 +27,7 @@ } } -\date{Released \quad 2020-05-07 \quad v0.5d} +\date{Released \quad 2020-05-12 \quad v0.5e} \let\tmpthepage\thepage \renewcommand{\thepage}{\lr{\Large\textbf\tmpthepage}} @@ -81,6 +81,19 @@ problems. These problems along withe fixes in xepersian-hm are briefly: filled by horizontal rule appears as a solid box. This is fixed by using the \textsf{kashida} glyph instead of the horizontal rule in \textsf{xepersian-hm}. + \item Activating kashida in \textsf{xepersian} disturbs ligatures. This is + fixed in \textsf{xepersian-hm} by escaping the components of the + ligature which form the glyph, i.e. by inserting an escape character + before Persian letters joined to form the ligature without any empty + characters, blank characters, invisible characters and whitespace + characters which form the glyph. See + \mbox{Figures \ref{fig:ligatures-xep} and \ref{fig:ligatures-xephm}}. + Currently only 3 ligature glyphs are available in + \textsf{xepersian-hm}, but you can add as many as you want or let + me know the ligature glyphs that you need, so that I can add them in + the next release of the package. Of course, this is not the best + solution, but it works. + \item If italic or oblique style of some fonts such as \textsf{X Series 2} is used in \textsf{xepersian}, an extra gap is left between the stretched characters. This is fixed in \textsf{HM Series} fonts. @@ -88,24 +101,34 @@ problems. These problems along withe fixes in xepersian-hm are briefly: For comparing the outputs of \textsf{xepersian} and \textsf{xepersian-hm} with a variety of options available to these packages, please see the -\mbox{Figure \ref{fig:xepersian-XB}}, -\mbox{Figure \ref{fig:xepersian-hm-hrule}}, and -\mbox{Figure \ref{fig:xepersian-hm-glyph}}. +\mbox{Figures \ref{fig:xepersian-XB}, \ref{fig:xepersian-hm-hrule}}, and \ref{fig:xepersian-hm-glyph}. + +\begin{figure} + \centerline{\fbox{\includegraphics[scale=1]{doc-ligature-xep.pdf}}} + \caption{Package: \textsf{xeprsian}, Font: \textsf{Noto Sans Arabic}, \textsf{Scale=1.1}, \textsf{Kashida=On}} + \label{fig:ligatures-xep} +\end{figure} + +\begin{figure} + \centerline{\fbox{\includegraphics[scale=1]{doc-ligature-xephm.pdf}}} + \caption{Package: \textsf{xeprsian-hm}, Font: \textsf{Noto Sans Arabic}, \textsf{Scale=1.1}, \textsf{Kashida=glyph}} + \label{fig:ligatures-xephm} +\end{figure} \begin{figure} - \centerline{\includegraphics[scale=1]{doc-samples-xep.pdf}} + \centerline{\fbox{\includegraphics[scale=1]{doc-samples-xep.pdf}}} \caption{Package: \textsf{xeprsian}, Font: \textsf{XB Kayhan}, \textsf{Scale=4.5}, \textsf{Kashida=0n}} \label{fig:xepersian-XB} \end{figure} \begin{figure} - \centerline{\includegraphics[scale=1]{doc-samples-hrule.pdf}} + \centerline{\fbox{\includegraphics[scale=1]{doc-samples-hrule.pdf}}} \caption{Package: \textsf{xeprsian-hm}, Font: \textsf{HM XKayhan}, \textsf{Scale=4.5}, \textsf{Kashida=hrule}} \label{fig:xepersian-hm-hrule} \end{figure} \begin{figure} - \centerline{\includegraphics[scale=1]{doc-samples-glyph.pdf}} + \centerline{\fbox{\includegraphics[scale=1]{doc-samples-glyph.pdf}}} \caption{Package: \textsf{xeprsian-hm}, Font: \textsf{HM XKayhan}, \textsf{Scale=4.5}, \textsf{Kashida=glyph}} \label{fig:xepersian-hm-glyph} \end{figure} @@ -160,6 +183,7 @@ The options available in \textsf{xepersian-hm} are: \texttt{high}: & \texttt{25} \\ \texttt{max}: & \texttt{10000} \end{longtable} + \item \texttt{kashidastretch}: \\ which specifies the amount of extra stretching for some combinations of characters. You may strictly specify the value of @@ -202,6 +226,25 @@ The options available in \textsf{xepersian-hm} are: For example: \mbox{\texttt{'kashidastretch=titr'}} is equivalent to\linebreak \mbox{\texttt{'kashidastretch=0.12 em plus 0.5 em'}} + + \item \texttt{ligature}: \\ + which fixes the disturbance of ligatures caused by activation of kashida in + \textsf{xepersian}. You may strictly specify the value of this option. + For example \texttt{'ligature=dlig'} or you may use the default value. + The available values are: + + \begin{longtable}{ll} + \texttt{aalt}: & Access All Alternatives \\ + \texttt{ccmp}: & Glyph Composition/Decomposition \\ + \texttt{dlig}: & Discretionary Ligatures \\ + \texttt{fina}: & Final (Terminal) Forms \\ + \texttt{init}: & Initial Forms \\ + \texttt{locl}: & Localized Forms \\ + \texttt{medi}: & Medial Forms \\ + \texttt{rlig}: & Required Ligatures \\ + \texttt{default}: & All the above features + \end{longtable} + Please note that this feature is still experimental and is not regarded as stable. \end{itemize} \section{Commands} @@ -223,7 +266,7 @@ The options available in \textsf{xepersian-hm} are: \item Kashida and ligatures: The method used to implement kashida feature breaks a ligature if it is applied to the letters which are joined to form - the ligature. + the ligature. This is fixed in \textsf{xepersian-hm}, but it is still immature. \end{description} \end{latin} diff --git a/Master/texmf-dist/doc/xelatex/xepersian-hm/xepersian-hm-doc.pdf b/Master/texmf-dist/doc/xelatex/xepersian-hm/xepersian-hm-doc.pdf index f1f5e0dad2d..06a9d05ddda 100644 Binary files a/Master/texmf-dist/doc/xelatex/xepersian-hm/xepersian-hm-doc.pdf and b/Master/texmf-dist/doc/xelatex/xepersian-hm/xepersian-hm-doc.pdf differ diff --git a/Master/texmf-dist/doc/xelatex/xepersian-hm/xepersian-hm.pdf b/Master/texmf-dist/doc/xelatex/xepersian-hm/xepersian-hm.pdf index fd7f0439922..bf0ff83fe0f 100644 Binary files a/Master/texmf-dist/doc/xelatex/xepersian-hm/xepersian-hm.pdf and b/Master/texmf-dist/doc/xelatex/xepersian-hm/xepersian-hm.pdf differ -- cgit v1.2.3