summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/xelatex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2020-05-12 21:23:12 +0000
committerKarl Berry <karl@freefriends.org>2020-05-12 21:23:12 +0000
commit2f26cad4e30cb3c23a5d1523875b3abbba43a267 (patch)
tree8fbba76911797627b3889a639e7c857f5c174d72 /Master/texmf-dist/doc/xelatex
parentf36c8d17d5eb18410042dd433a2c9899cb7a3db9 (diff)
xepersian-hm (12may20)
git-svn-id: svn://tug.org/texlive/trunk@55123 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/xelatex')
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian-hm/INSTALL.txt38
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian-hm/doc-ligature-xep.pdfbin0 -> 10115 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian-hm/doc-ligature-xephm.pdfbin0 -> 13119 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian-hm/kashida-glyph-example.pdfbin91742 -> 91743 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian-hm/kashida-hrule-example.pdfbin90706 -> 90701 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian-hm/kashida-xep-XB-example.pdfbin78687 -> 78693 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian-hm/xepersian-hm-doc.ltx59
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian-hm/xepersian-hm-doc.pdfbin240878 -> 264881 bytes
-rw-r--r--Master/texmf-dist/doc/xelatex/xepersian-hm/xepersian-hm.pdfbin55239 -> 57525 bytes
9 files changed, 89 insertions, 8 deletions
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.
+ <dma8hm1334 AT gmail DOT com>
+
+- 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
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian-hm/doc-ligature-xep.pdf
Binary files 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
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xepersian-hm/doc-ligature-xephm.pdf
Binary files 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
--- a/Master/texmf-dist/doc/xelatex/xepersian-hm/kashida-glyph-example.pdf
+++ b/Master/texmf-dist/doc/xelatex/xepersian-hm/kashida-glyph-example.pdf
Binary files 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
--- a/Master/texmf-dist/doc/xelatex/xepersian-hm/kashida-hrule-example.pdf
+++ b/Master/texmf-dist/doc/xelatex/xepersian-hm/kashida-hrule-example.pdf
Binary files 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
--- 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
Binary files 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
--- a/Master/texmf-dist/doc/xelatex/xepersian-hm/xepersian-hm-doc.pdf
+++ b/Master/texmf-dist/doc/xelatex/xepersian-hm/xepersian-hm-doc.pdf
Binary files 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
--- a/Master/texmf-dist/doc/xelatex/xepersian-hm/xepersian-hm.pdf
+++ b/Master/texmf-dist/doc/xelatex/xepersian-hm/xepersian-hm.pdf
Binary files differ