blob: 93201528988b8231210d4f63bbfaac773cac0fe6 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
|
%%
%% This is file `xepersian-hm-doc.tex'
%%
%% Copyright (c) Hossein Movahhedian 2020
%%
%% 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
%%
\documentclass{ltxdoc}
\usepackage{hypdoc}
\title{
The \textsf{xepersian-hm} package\\Fixing kashida in xepersian
}
\author{
Hossein Movahhedian\thanks
{
E-mail:
\href{mailto:dma8hm1334@gmail.com}
{\textsf{dma8hm1334@gmail.com}}
}
}
\date{Released 2020-03-23}
\begin{document}
\maketitle
Kashida feature in \textsf{xepersian} has problem with some fonts such as \texttt{HM Series}
fonts available at
\href{https://dma8hm1334.bitbucket.io}{\texttt{https://dma8hm1334.bitbucket.io}}
and \texttt{X Series 2} fonts available at
\href{http://wiki.irmug.com/index.php/X_Series_2}{\texttt{http://wiki.irmug.com/index.php/X\_Series\_2}}.
The \textsf{xepersian-hm} package fixes this problem.
The file \texttt{texmf-dist/doc/xelatex/xepersian-hm/test-kashida.tex} can be
used as a simple example of the usage of the package.
Any comments or suggestions would be gratefully appreciated.
Please report any bug or issue to \href{mailto:dma8hm1334@gmail.com}{\textsf{dma8hm1334@gmail.com}}.
I will do my best to fix all the bugs you report, but, unfortunately,
time is a big hurdle to overcome; so, my apologies in advance for those
which I cannot make time to fix.
Please note that \textsf{xepersian-hm} loads \textsf{xepersian} automatically,
so you may only pass options to the package using the command
\verb|\PassOptionsToPackage| before \verb|\documentclass|, for example:
\begin{verbatim}
\PassOptionsToPackage{Kashida=off,RTLdocument=on}{xepersian}
\documentclass{report}
\usepackage{xcolor}
\usepackage[Kashida,kashidastretch=0.14 em plus 0.5 em]{xepersian-hm}
\end{verbatim}
The options available in \textsf{xepersian-hm} are:
\begin{itemize}
\item \texttt{Kashida}: with two possible values, \texttt{on} which enables
\texttt{Kashida} feature and \texttt{off} which disables that feature. For
example \texttt{Kashida=on} enables \texttt{Kashida} feature.
\item \texttt{kashidastretch}: which specifies the amount of extra stretching
for some combinations of characters. You may strictly specify the value of
this option. For example \texttt{'kashidastretch=0.14 em plus 0.5 em'} or you
may use the default values. The available default values are:
\begin{tabular}{ll}
\texttt{kayhan} & \texttt{0.14 em plus 0.5 em} \\
\texttt{khorramshahr} & \texttt{0.131 em plus 0.5 em} \\
\texttt{kayhannavaar} & \texttt{0.129 em plus 0.5 em} \\
\texttt{kayhanpook} & \texttt{0.133 em plus 0.5 em} \\
\texttt{kayhansayeh} & \texttt{0.135 em plus 0.5 em} \\
\texttt{khoramshahr} & \texttt{0.128 em plus 0.5 em} \\
\texttt{khorramshahr} & \texttt{0.13 em plus 0.5 em} \\
\texttt{niloofar} & \texttt{0.132 em plus 0.5 em} \\
\texttt{paatch} & \texttt{0.127 em plus 0.5 em} \\
\texttt{riyaz} & \texttt{0.125 em plus 0.5 em} \\
\texttt{roya} & \texttt{0.142 em plus 0.5 em} \\
\texttt{shafigh} & \texttt{0.143 em plus 0.5 em} \\
\texttt{shafighKurd} & \texttt{0.126 em plus 0.5 em} \\
\texttt{shafighUzbek} & \texttt{0.123 em plus 0.5 em} \\
\texttt{shiraz} & \texttt{0.122 em plus 0.5 em} \\
\texttt{sols} & \texttt{0.124 em plus 0.5 em} \\
\texttt{tabriz} & \texttt{0.119 em plus 0.5 em} \\
\texttt{titr} & \texttt{0.12 em plus 0.5 em} \\
\texttt{titre} & \texttt{0.121 em plus 0.5 em} \\
\texttt{traffic} & \texttt{0.124 em plus 0.5 em} \\
\texttt{vahid} & \texttt{0.134 em plus 0.5 em} \\
\texttt{vosta} & \texttt{0.136 em plus 0.5 em} \\
\texttt{yaghut} & \texttt{0.138 em plus 0.5 em} \\
\texttt{yagut} & \texttt{0.137 em plus 0.5 em} \\
\texttt{yas} & \texttt{0.126 em plus 0.5 em} \\
\texttt{yekan} & \texttt{0.141 em plus 0.5 em} \\
\texttt{yermook} & \texttt{0.139 em plus 0.5 em} \\
\texttt{zar} & \texttt{0.116 em plus 0.5 em} \\
\texttt{ziba} & \texttt{0.119 em plus 0.5 em} \\
\texttt{default} & \texttt{0.14 em plus 0.5 em} \\
\texttt{noskip} & \texttt{0 em plus 0.5 em}
\end{tabular}
For example: \mbox{\texttt{'kashidastretch=titr'}} is equivalent to\linebreak
\mbox{\texttt{'kashidastretch=0.12 em plus 0.5 em'}}
\end{itemize}
\end{document}
%%% Local Variables:
%%% mode: latex
%%% TeX-master: t
%%% End:
|