Debian Codegraph @

documentation/features.html

raw
1 <!DOCTYPE html>
2 <html lang="en-us">
3 <head>
4 <meta charset="utf-8">
5 <title>Awami Nastaliq - Font Features</title>
6 <meta name="author" content="SIL Writing Systems Technology">
7 <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
8 <link rel="stylesheet" href="./assets/css/theme.css">
9 <link rel="stylesheet" href="./assets/css/webfonts.css">
10 </head>
11 <body>
12 <div class="container">
13 <article class="article">
14 <header>
15 <h1 class="title">Awami Nastaliq - Font Features</h1>
16 </header>
17 <table>
18 <colgroup>
19 <col style="width: 92%" />
20 <col style="width: 7%" />
21 </colgroup>
22 <thead>
23 <tr class="header">
24 <th style="text-align: left;"><font color="red">Note:</font></th>
25 <th></th>
26 </tr>
27 </thead>
28 <tbody>
29 <tr class="odd">
30 <td style="text-align: left;"><strong>This page will only display properly in Mozilla Firefox. Also, Graphite must be enabled. See the <a href="https://scripts.sil.org/cms/scripts/page.php?site_id=projects&amp;item_id=graphite_firefox#cf8a0574">instructions on how to enable Graphite in Firefox</a>.</strong></td>
31 <td></td>
32 </tr>
33 </tbody>
34 </table>
35 <p>Awami Nastaliq is a TrueType font with smart font capabilities added using the <a href="https://graphite.sil.org">Graphite</a> font technology. The font includes a number of optional features that provide alternative rendering that might be preferable for use in some contexts. The chart below enumerates the details of these features. Whether these features are available to users will depend on the application being used.</p>
36 <p>See <a href="https://software.sil.org/fonts/features/">Using Font Features</a>. Although that page is not targeted at Arabic script support, it does provide a comprehensive list of applications that make full use of both the OpenType and Graphite font technologies.</p>
37 <p>See also <a href="https://software.sil.org/arabicfonts/support/application-support/">Arabic Fonts — Application Support</a>. It provides a fairly comprehensive list of applications that make full use of the <a href="https://graphite.sil.org">Graphite</a> font technology.</p>
38 <p>This page uses web fonts (WOFF) to demonstrate font features. However, it will only display correctly in Mozilla Firefox. For a more concise example of how to use Awami Nastaliq as a web font see <em>AwamiNastaliq-webfont-example.html</em> in the font package web folder.</p>
39 <p><em>If this document is not displaying correctly a PDF version is also provided in the documentation/pdf folder of the release package.</em></p>
40 <h2 id="end-of-ayah-u06dd-subtending-marks-u0600..u0605">End of Ayah (U+06DD), subtending marks (U+0600..U+0605)</h2>
41 <p>These Arabic characters are intended to enclose or hold one or more digits.</p>
42 <p>Specific technical details of how to use them are discussed in the <a href="https://software.sil.org/arabicfonts/support/faq#Ayah">Arabic fonts FAQ -- Subtending marks</a>.</p>
43 <h2 id="customizing-with-typetuner">Customizing with TypeTuner</h2>
44 <p>For applications that do not make use of Graphite features or the OpenType Character Variants, you can now download fonts customized with the variant glyphs you choose. Read this document, visit <a href="https://scripts.sil.org/ttw/fonts2go.cgi">TypeTuner Web</a>, then choose the variants and download your font.</p>
45 <h3 id="character-variants">Character variants</h3>
46 <p>There are some character shape differences in different languages which use the Arabic script. These can be accessed by using Graphite features.</p>
47 <p>Unless otherwise indicated, the first feature in a table is the default.</p>
48 <h4 id="hook-on-medial-heh-goal">Hook on medial heh-goal</h4>
49 <p><span class="affects">Affects: U+06C1, U+06C2</span></p>
50 <table>
51 <thead>
52 <tr class="header">
53 <th>Feature</th>
54 <th style="text-align: right;">Sample</th>
55 <th style="text-align: left;">Feature setting</th>
56 </tr>
57 </thead>
58 <tbody>
59 <tr class="odd">
60 <td>True</td>
61 <td style="text-align: right;"><span class="awami-R normal" dir="rtl">ب<font color="red">ہ</font>ب ب<font color="red">ۂ</font>ب</span></td>
62 <td style="text-align: left;"><code>hehk=1</code></td>
63 </tr>
64 <tr class="even">
65 <td>False</td>
66 <td style="text-align: right;"><span class="awami-R normal" dir="rtl" style="font-feature-settings: &quot;hehk&quot; 0">ب<font color="red">ہ</font>ب ب<font color="red">ۂ</font>ب</span></td>
67 <td style="text-align: left;"><code>hehk=0</code></td>
68 </tr>
69 </tbody>
70 </table>
71 <h4 id="initial-heh-doachashmee">Initial heh doachashmee</h4>
72 <p><span class="affects">Affects: U+06BE</span></p>
73 <table>
74 <thead>
75 <tr class="header">
76 <th>Feature</th>
77 <th style="text-align: right;">Sample</th>
78 <th style="text-align: left;">Feature setting</th>
79 </tr>
80 </thead>
81 <tbody>
82 <tr class="odd">
83 <td>Heart shape</td>
84 <td style="text-align: right;"><span class="awami-R normal" dir="rtl"><font color="red">ھ</font>ا</span></td>
85 <td style="text-align: left;"><code>hedo=0</code></td>
86 </tr>
87 <tr class="even">
88 <td>Round</td>
89 <td style="text-align: right;"><span class="awami-R normal" dir="rtl" style="font-feature-settings: &quot;hedo&quot; 1"><font color="red">ھ</font>ا</span></td>
90 <td style="text-align: left;"><code>hedo=1</code></td>
91 </tr>
92 </tbody>
93 </table>
94 <h4 id="lam-with-v">Lam with V</h4>
95 <p><span class="affects">Affects: U+06B5</span></p>
96 <table>
97 <thead>
98 <tr class="header">
99 <th>Feature</th>
100 <th style="text-align: right;">Sample</th>
101 <th style="text-align: left;">Feature setting</th>
102 </tr>
103 </thead>
104 <tbody>
105 <tr class="odd">
106 <td>V over stem</td>
107 <td style="text-align: right;"><span class="awami-R normal" dir="rtl"><font color="red">ڵ</font> ڵبڵب<font color="red">ڵ</font></span></td>
108 <td style="text-align: left;"><code>lamv=0</code></td>
109 </tr>
110 <tr class="even">
111 <td>V over bowl</td>
112 <td style="text-align: right;"><span class="awami-R normal" dir="rtl" style="font-feature-settings: &quot;lamv&quot; 1"><font color="red">ڵ</font> ڵبڵب<font color="red">ڵ</font></span></td>
113 <td style="text-align: left;"><code>lamv=1</code></td>
114 </tr>
115 </tbody>
116 </table>
117 <h4 id="full-stop">Full Stop</h4>
118 <p><span class="affects">Affects: U+06D4</span></p>
119 <table>
120 <thead>
121 <tr class="header">
122 <th>Feature</th>
123 <th style="text-align: right;">Sample</th>
124 <th style="text-align: left;">Feature setting</th>
125 </tr>
126 </thead>
127 <tbody>
128 <tr class="odd">
129 <td>Dash</td>
130 <td style="text-align: right;"><span class="awami-R normal" dir="rtl">ججج<font color="red">۔</font></span></td>
131 <td style="text-align: left;"><code>cv85=0</code></td>
132 </tr>
133 <tr class="even">
134 <td>Dot</td>
135 <td style="text-align: right;"><span class="awami-R normal" dir="rtl" style="font-feature-settings: &quot;cv85&quot; 1">ججج<font color="red">۔</font></span></td>
136 <td style="text-align: left;"><code>cv85=1</code></td>
137 </tr>
138 </tbody>
139 </table>
140 <h4 id="punctuation">Punctuation</h4>
141 <p><span class="affects">Affects: U+0021, U+0022, U+0027, U+0028, U+0029, U+002A, U+002B, U+002D, U+002F, U+003A, U+003C, U+003D, U+003E, U+005B, U+005C, U+005D, U+007B, U+007C, U+007D, U+00AB, U+00AD, U+00B1, U+00B7, U+00BB, U+00D7, U+2004, U+2010, U+2011, U+2012, U+2013, U+2014, U+2015, U+2018, U+2019, U+201A, U+201C, U+201D, U+201E, U+2022, U+2025, U+2026, U+2027, U+2030, U+2039, U+203A, U+2212, U+2219</span></p>
142 <p>Default uses Arabic-style punctuation for right-to-left segments and Latin-style for left-to-right segments</p>
143 <table>
144 <colgroup>
145 <col style="width: 16%" />
146 <col style="width: 64%" />
147 <col style="width: 20%" />
148 </colgroup>
149 <thead>
150 <tr class="header">
151 <th>Feature</th>
152 <th style="text-align: right;">Sample</th>
153 <th style="text-align: left;">Feature setting</th>
154 </tr>
155 </thead>
156 <tbody>
157 <tr class="odd">
158 <td>Default</td>
159 <td style="text-align: right;"><span class="awami-R normal" dir="rtl">! " ' ( ) * + - / : [  ] { } « ­ ± · » ×   ‐ ‑ ‒ – — ― ‘ ’ ‚ “ ” „ • ‥ … ‧ ‰ ‹ › − ∙ </span></td>
160 <td style="text-align: left;"><code>punc=0</code></td>
161 </tr>
162 <tr class="even">
163 <td>Arabic</td>
164 <td style="text-align: right;"><span class="awami-R normal" dir="rtl" style="font-feature-settings: &quot;punc&quot; 1">! " ' ( ) * + - / : [  ] { } « ­ ± · » ×   ‐ ‑ ‒ – — ― ‘ ’ ‚ “ ” „ • ‥ … ‧ ‰ ‹ › − ∙ </font></span></td>
165 <td style="text-align: left;"><code>punc=1</code></td>
166 </tr>
167 <tr class="odd">
168 <td>Latin</td>
169 <td style="text-align: right;"><span class="awami-R normal" dir="rtl" style="font-feature-settings: &quot;punc&quot; 2">! " ' ( ) * + - / : [  ] { } « ­ ± · » ×   ‐ ‑ ‒ – — ― ‘ ’ ‚ “ ” „ • ‥ … ‧ ‰ ‹ › − ∙ </font></span></td>
170 <td style="text-align: left;"><code>punc=2</code></td>
171 </tr>
172 </tbody>
173 </table>
174 <h4 id="sukunjazm">Sukun/jazm</h4>
175 <p><span class="affects">Affects: U+0652</span></p>
176 <table>
177 <thead>
178 <tr class="header">
179 <th>Feature</th>
180 <th style="text-align: right;">Sample</th>
181 <th style="text-align: left;">Feature setting</th>
182 </tr>
183 </thead>
184 <tbody>
185 <tr class="odd">
186 <td>Open down</td>
187 <td style="text-align: right;"><span class="awami-R normal" dir="rtl" style="font-feature-settings: &quot;cv78&quot; 1">بْ ◌ْ</span></td>
188 <td style="text-align: left;"><code>cv78=1</code></td>
189 </tr>
190 <tr class="even">
191 <td>Open left</td>
192 <td style="text-align: right;"><span class="awami-R normal" dir="rtl" style="font-feature-settings: &quot;cv78&quot; 2">بْ ◌ْ</font></span></td>
193 <td style="text-align: left;"><code>cv78=2</code></td>
194 </tr>
195 </tbody>
196 </table>
197 <h4 id="hamza">Hamza</h4>
198 <p><span class="affects">Affects: U+0654, U+0655, U+0623, U+0624, U+0626, U+0675, U+076C, U+0681, U+06C2, U+06D3</span></p>
199 <table>
200 <thead>
201 <tr class="header">
202 <th>Feature</th>
203 <th style="text-align: right;">Sample</th>
204 <th style="text-align: left;">Feature setting</th>
205 </tr>
206 </thead>
207 <tbody>
208 <tr class="odd">
209 <td>Urdu style</td>
210 <td style="text-align: right;"><span class="awami-R normal" dir="rtl">ء أ ؤ بؤ إ ۂ بۂ ۓ بۓ ٵ ݬ بݬ ځ بځ بځب بٔ بٕ</span></td>
211 <td style="text-align: left;"><code>hamz=0</code></td>
212 </tr>
213 <tr class="even">
214 <td>Arabic style</td>
215 <td style="text-align: right;"><span class="awami-R normal" dir="rtl" style="font-feature-settings: &quot;hamz&quot; 1">ء أ ؤ بؤ إ ۂ بۂ ۓ بۓ ٵ ݬ بݬ ځ بځ بځب بٔ بٕ</font></span></td>
216 <td style="text-align: left;"><code>hamz=1</code></td>
217 </tr>
218 </tbody>
219 </table>
220 <h4 id="word-spacing">Word spacing</h4>
221 <table>
222 <thead>
223 <tr class="header">
224 <th>Feature</th>
225 <th style="text-align: right;">Sample</th>
226 <th style="text-align: left;">Feature setting</th>
227 </tr>
228 </thead>
229 <tbody>
230 <tr class="odd">
231 <td>Extra tight</td>
232 <td style="text-align: right;"><span class="awami-R normal" dir="rtl" style="font-feature-settings: &quot;wdsp&quot; 0"> کیوں جو انسانی حقوق کنوں</span></td>
233 <td style="text-align: left;"><code>wdsp=0</code></td>
234 </tr>
235 <tr class="even">
236 <td>Tight</td>
237 <td style="text-align: right;"><span class="awami-R normal" dir="rtl" style="font-feature-settings: &quot;wdsp&quot; 1"> کیوں جو انسانی حقوق کنوں</span></td>
238 <td style="text-align: left;"><code>wdsp=1</code></td>
239 </tr>
240 <tr class="odd">
241 <td>Medium (default)</td>
242 <td style="text-align: right;"><span class="awami-R normal" dir="rtl"> کیوں جو انسانی حقوق کنوں</span></td>
243 <td style="text-align: left;"><code>wdsp=2</code></td>
244 </tr>
245 <tr class="even">
246 <td>Wide</td>
247 <td style="text-align: right;"><span class="awami-R normal" dir="rtl" style="font-feature-settings: &quot;wdsp&quot; 3"> کیوں جو انسانی حقوق کنوں</span></td>
248 <td style="text-align: left;"><code>wdsp=3</code></td>
249 </tr>
250 <tr class="odd">
251 <td>Extra wide</td>
252 <td style="text-align: right;"><span class="awami-R normal" dir="rtl" style="font-feature-settings: &quot;wdsp&quot; 4"> کیوں جو انسانی حقوق کنوں</span></td>
253 <td style="text-align: left;"><code>wdsp=4</code></td>
254 </tr>
255 </tbody>
256 </table>
257 <h4 id="short-forms">Short forms</h4>
258 <p><span class="affects">Affects: kafs &amp; gafs: U+06A9, U+06AF, U+0643, U+06B1, U+06B3, U+06AB, U+06B0; finals: U+06CC, U+0633, U+0642, U+0644, U+0645, U+0646, U+06B5, U+06D0, U+0626, U+06CE, U+06BA, U+06BB, U+06B9, U+0768, U+0769</span></p>
259 <table>
260 <thead>
261 <tr class="header">
262 <th>Feature</th>
263 <th style="text-align: right;">Sample</th>
264 <th style="text-align: left;">Feature setting</th>
265 </tr>
266 </thead>
267 <tbody>
268 <tr class="odd">
269 <td>None</td>
270 <td style="text-align: right;"><span class="awamipar-R normal" dir="rtl" style="font-feature-settings: &quot;shrt&quot; 0">دیکھتی کنسلٹنٹس نگھنے تکمیل</span></td>
271 <td style="text-align: left;"><code>shrt=0</code></td>
272 </tr>
273 <tr class="even">
274 <td>Kafs and gafs</td>
275 <td style="text-align: right;"><span class="awamipar-R normal" dir="rtl" style="font-feature-settings: &quot;shrt&quot; 1">دی<font color="red">ک</font>ھتی <font color="red">ک</font>نسلٹنٹس ن<font color="red">گ</font>ھنے ت<font color="red">ک</font>میل</font></span></td>
276 <td style="text-align: left;"><code>shrt=1</code></td>
277 </tr>
278 <tr class="odd">
279 <td>Finals</td>
280 <td style="text-align: right;"><span class="awamipar-R normal" dir="rtl" style="font-feature-settings: &quot;shrt&quot; 2">دیکھت<font color="red">ی</font> کنسلٹنٹ<font color="red">س</font> نگھنے تکمی<font color="red">ل</font></span></td>
281 <td style="text-align: left;"><code>shrt=2</code></td>
282 </tr>
283 <tr class="even">
284 <td>All (default)</td>
285 <td style="text-align: right;"><span class="awamipar-R normal" dir="rtl" style="font-feature-settings: &quot;shrt&quot; 3">دی<font color="red">ک</font>ھت<font color="red">ی</font> <font color="red">ک</font>نسلٹنٹ<font color="red">س</font> ن<font color="red">گ</font>ھنے ت<font color="red">ک</font>می<font color="red">ل</font></span></td>
286 <td style="text-align: left;"><code>shrt=3</code></td>
287 </tr>
288 </tbody>
289 </table>
290 <h4 id="collision-avoidance">Collision avoidance</h4>
291 <table>
292 <thead>
293 <tr class="header">
294 <th>Feature</th>
295 <th style="text-align: right;">Sample</th>
296 <th style="text-align: left;">Feature setting</th>
297 </tr>
298 </thead>
299 <tbody>
300 <tr class="odd">
301 <td>Off</td>
302 <td style="text-align: right;"><span class="awami-R normal" dir="rtl" style="font-feature-settings: &quot;agca&quot; 0"><font color="red">پی</font>ٹی <font color="red">اؔبِی</font>ج<font color="red">یل</font> تح<font color="red">ر</font>ِ<font color="red">ی</font>ج</span></td>
303 <td style="text-align: left;"><code>agca=0</code></td>
304 </tr>
305 <tr class="even">
306 <td>Kern-only</td>
307 <td style="text-align: right;"><span class="awami-R normal" dir="rtl" style="font-feature-settings: &quot;agca&quot; 1"><font color="red">پی</font>ٹی <font color="red">اؔبِی</font>ج<font color="red">یل</font> تح<font color="red">ر</font>ِ<font color="red">ی</font>ج</span></td>
308 <td style="text-align: left;"><code>agca=1</code></td>
309 </tr>
310 <tr class="odd">
311 <td>Not implemented</td>
312 <td style="text-align: right;"></td>
313 <td style="text-align: left;"><code>agca=2</code></td>
314 </tr>
315 <tr class="even">
316 <td>On (default)</td>
317 <td style="text-align: right;"><span class="awami-R normal" dir="rtl" style="font-feature-settings: &quot;agca&quot; 3"><font color="red">پی</font>ٹی <font color="red">اؔبِی</font>ج<font color="red">یل</font> تح<font color="red">ر</font>ِ<font color="red">ی</font>ج</span></td>
318 <td style="text-align: left;"><code>agca=3</code></td>
319 </tr>
320 </tbody>
321 </table>
322 <h2 id="end-of-ayah-and-subtending-marks">End of Ayah and Subtending marks</h2>
323 <p><em>This is not technically a feature, but we find it useful to demonstrate the use of these characters.</em></p>
324 <p>Firefox allows you to use U+06DD followed by the digits and proper rendering occurs. However, surrounding the sequence with U+202D and U+202C seems to give the most reliable results in different browsers, and so this font requires those characters in order to display properly.</p>
325 <table>
326 <colgroup>
327 <col style="width: 44%" />
328 <col style="width: 55%" />
329 </colgroup>
330 <thead>
331 <tr class="header">
332 <th>Character</th>
333 <th style="text-align: right;">Sample</th>
334 </tr>
335 </thead>
336 <tbody>
337 <tr class="odd">
338 <td>U+06DD ARABIC END OF AYAH<br>(U+202D U+06DD U+06F1 U+06F2 U+06F3 U+202C)</td>
339 <td style="text-align: right;"><span class="awami-R normal" dir="rtl">‭۝۱۲۳‬ ‭۝۱۲‬ ‭۝۱‬</span></td>
340 </tr>
341 <tr class="even">
342 <td>U+0600 ARABIC NUMBER SIGN<br>(U+202D U+0600 U+06F1 U+06F2 U+06F3 U+202C)</td>
343 <td style="text-align: right;"><span class="awami-R normal" dir="rtl">‭؀۱۲۳‬ ‭؀۱۲‬ ‭؀۱‬</span></td>
344 </tr>
345 <tr class="odd">
346 <td>U+0601 ARABIC SIGN SANAH (year)<br>(U+202D U+0601 U+06F1 U+06F2 U+06F3 U+202C)</td>
347 <td style="text-align: right;"><span class="awami-R normal" dir="rtl">‭؁۱۹۳۲‬</span></td>
348 </tr>
349 <tr class="even">
350 <td>U+0602 ARABIC FOOTNOTE MARKER<br>(U+202D U+0602 U+06F1 U+06F2 U+202C)</td>
351 <td style="text-align: right;"><span class="awami-R normal" dir="rtl">‭؂۱۲‬ ‭؂۱‬</span></td>
352 </tr>
353 <tr class="odd">
354 <td>U+0603 ARABIC SIGN SAFHA (page)<br>(U+202D U+0603 U+06F1 U+06F2 U+06F3 U+202C)</td>
355 <td style="text-align: right;"><span class="awami-R normal" dir="rtl">‭؃۱۲۳‬ ‭؃۱۲‬ ‭؃۱‬</span></td>
356 </tr>
357 </tbody>
358 </table>
359 <h2 id="paragraph-of-text">Paragraph of text</h2>
360 <p>This sentence comes from the <a href="https://www.unicode.org/udhr/d/udhr_skr.txt">Saraiki UDHR</a>.</p>
361 <table>
362 <colgroup>
363 <col style="width: 76%" />
364 <col style="width: 23%" />
365 </colgroup>
366 <thead>
367 <tr class="header">
368 <th style="text-align: right;">Sample</th>
369 <th style="text-align: left;">Feature setting</th>
370 </tr>
371 </thead>
372 <tbody>
373 <tr class="odd">
374 <td style="text-align: right;"><span class="awamipar-R normal" dir="rtl"> اقوام متحدہ نے ہر ک<font color="red">ہ</font>یں دے حقوق دی حفاظت تے ود<font color="red">ھ</font>ارے دا جھنڈا اچار <font color="red">ک</font>ھ<font color="red">ڻ</font> دا ارادہ کیتا ہوے۔ ای<font color="red">ہ</font>و ڄ<font color="red">ئ</font>ے و حشیانہ کماں دی صورت وچ ظاہر تھ<font color="red">ئ</font>ی ہے</span></td>
375 <td style="text-align: left;"><code>hehk=1, hedo=0, hamz=0, shrt=3</code></td>
376 </tr>
377 <tr class="even">
378 <td style="text-align: right;"><span class="awamipar-R normal" dir="rtl" style="font-feature-settings: &quot;hehk&quot; 0, &quot;hedo&quot; 1, &quot;hamz&quot; 1, &quot;shrt&quot; 2"> اقوام متحدہ نے ہر ک<font color="red">ہ</font>یں دے حقوق دی حفاظت تے ود<font color="red">ھ</font>ارے دا جھنڈا اچار <font color="red">ک</font>ھ<font color="red">ڻ</font> دا ارادہ کیتا ہوے۔ ای<font color="red">ہ</font>و ڄ<font color="red">ئ</font>ے و حشیانہ کماں دی صورت وچ ظاہر تھ<font color="red">ئ</font>ی ہے</span></td>
379 <td style="text-align: left;"><code>hehk=0, hedo=1, hamz=1, shrt=2</code></td>
380 </tr>
381 </tbody>
382 </table>
383 <!-- PRODUCT SITE ONLY
384 [font id='awami' face='AwamiNastaliq-Regular' bold='AwamiNastaliq-Bold' size='150%' lineheight='200%' rtl=1]
385 [font id='awamiL' face='AwamiNastaliq-Regular' bold='AwamiNastaliq-Bold' size='100%' ltr=1]
386 [font id='awamipar' face='AwamiNastaliq-Regular' bold='AwamiNastaliq-Bold' size='150%' lineheight='200%' rtl=1]
387
388 -->
389 <footer class="footer">
390 <p>This guide is from the <a href="https://software.sil.org/awami/" title="" class="active">Awami Nastaliq project</a> version 3.200 and is copyright © 2014-2023 SIL International.</p>
391 </footer>
392 </article>
393 </div>
394 </body>
395 </html>