Debian Codegraph @

documentation/source/features.md

raw
1 ---
2 title: Awami Nastaliq - Font Features
3 fontversion: 3.200
4 ---
5
6
7 <font color="red">Note:</font> |
8 :------------ | -
9 **This page will only display properly in Mozilla Firefox. Also, Graphite must be enabled. See the [instructions on how to enable Graphite in Firefox](https://scripts.sil.org/cms/scripts/page.php?site_id=projects&amp;item_id=graphite_firefox#cf8a0574).** |
10
11
12 Awami Nastaliq is a TrueType font with smart font capabilities added using the [Graphite](https://graphite.sil.org) 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.
13
14 See [Using Font Features](https://software.sil.org/fonts/features/). 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.
15
16 See also [Arabic Fonts — Application Support](https://software.sil.org/arabicfonts/support/application-support/). It provides a fairly comprehensive list of applications that make full use of the [Graphite](https://graphite.sil.org) font technology.
17
18 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 *AwamiNastaliq-webfont-example.html* in the font package web folder.
19
20 *If this document is not displaying correctly a PDF version is also provided in the documentation/pdf folder of the release package.*
21
22 ## End of Ayah (U+06DD), subtending marks (U+0600..U+0605)
23
24 These Arabic characters are intended to enclose or hold one or more digits.
25
26 Specific technical details of how to use them are discussed in the [Arabic fonts FAQ -- Subtending marks](https://software.sil.org/arabicfonts/support/faq#Ayah).
27
28 ## Customizing with TypeTuner
29
30 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 [TypeTuner Web](https://scripts.sil.org/ttw/fonts2go.cgi), then choose the variants and download your font.
31
32 ### Character variants
33
34 There are some character shape differences in different languages which use the Arabic script. These can be accessed by using Graphite features.
35
36 Unless otherwise indicated, the first feature in a table is the default.
37
38 #### Hook on medial heh-goal
39
40 <span class='affects'>Affects: U+06C1, U+06C2</span>
41
42 Feature | Sample | Feature setting
43 ---- | ------: | :----
44 True| <span dir="rtl" class='awami-R normal'>&#x628;<font color="red">&#x6C1;</font>&#x628; &#x628;<font color="red">&#x6C2;</font>&#x628;</span>| `hehk=1`
45 False | <span dir="rtl" class='awami-R normal' style='font-feature-settings: "hehk" 0'>&#x628;<font color="red">&#x6C1;</font>&#x628; &#x628;<font color="red">&#x6C2;</font>&#x628;</span>| `hehk=0`
46
47 #### Initial heh doachashmee
48
49 <span class='affects'>Affects: U+06BE</span>
50
51 Feature | Sample | Feature setting
52 ---- | ------: | :----
53 Heart shape | <span dir="rtl" class='awami-R normal'><font color="red">&#x6BE;</font>&#x627;</span> | `hedo=0`
54 Round | <span dir="rtl" class='awami-R normal' style='font-feature-settings: "hedo" 1'><font color="red">&#x6BE;</font>&#x627;</span>| `hedo=1`
55
56 #### Lam with V
57
58 <span class='affects'>Affects: U+06B5</span>
59
60 Feature | Sample | Feature setting
61 ---- | ------: | :----
62 V over stem | <span dir="rtl" class='awami-R normal'><font color="red">&#x6B5;</font> &#x6B5;&#x628;&#x6B5;&#x628;<font color="red">&#x6B5;</font></span>| `lamv=0`
63 V over bowl | <span dir="rtl" class='awami-R normal' style='font-feature-settings: "lamv" 1'><font color="red">&#x6B5;</font> &#x6B5;&#x628;&#x6B5;&#x628;<font color="red">&#x6B5;</font></span>| `lamv=1`
64
65 #### Full Stop
66
67 <span class='affects'>Affects: U+06D4</span>
68
69 Feature | Sample | Feature setting
70 ---- | ------: | :----
71 Dash | <span dir="rtl" class='awami-R normal'>&#x62c;&#x62c;&#x62c;<font color="red">&#x6d4;</font></span>| `cv85=0`
72 Dot | <span dir="rtl" class='awami-R normal' style='font-feature-settings: "cv85" 1'>&#x62c;&#x62c;&#x62c;<font color="red">&#x6d4;</font></span>| `cv85=1`
73
74 #### Punctuation
75
76 <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>
77
78 Default uses Arabic-style punctuation for right-to-left segments and Latin-style for left-to-right segments
79
80 Feature | Sample | Feature setting
81 ---- | ---------------: | :----
82 Default | <span dir="rtl" class='awami-R normal'>! " ' ( ) * + - / : [ \ ] { } « ­ ± · » ×   ‐ ‑ ‒ – — ― ‘ ’ ‚ “ ” „ • ‥ … ‧ ‰ ‹ › − ∙ </span>| `punc=0`
83 Arabic | <span dir="rtl" class='awami-R normal' style='font-feature-settings: "punc" 1'>! " ' ( ) * + - / : [ \ ] { } « ­ ± · » ×   ‐ ‑ ‒ – — ― ‘ ’ ‚ “ ” „ • ‥ … ‧ ‰ ‹ › − ∙ </font></span> | `punc=1`
84 Latin | <span dir="rtl" class='awami-R normal' style='font-feature-settings: "punc" 2'>! " ' ( ) * + - / : [ \ ] { } « ­ ± · » ×   ‐ ‑ ‒ – — ― ‘ ’ ‚ “ ” „ • ‥ … ‧ ‰ ‹ › − ∙ </font></span>| `punc=2`
85
86 #### Sukun/jazm
87
88 <span class='affects'>Affects: U+0652</span>
89
90 Feature | Sample | Feature setting
91 ---- | ------: | :----
92 Open down | <span dir="rtl" class='awami-R normal' style='font-feature-settings: "cv78" 1'>&#x628;&#x652; &#x25cc;&#x652;</span>| `cv78=1`
93 Open left | <span dir="rtl" class='awami-R normal' style='font-feature-settings: "cv78" 2'>&#x628;&#x652; &#x25cc;&#x652;</font></span>| `cv78=2`
94
95 #### Hamza
96
97 <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>
98
99 Feature | Sample | Feature setting
100 ---- | ---------------: | :----
101 Urdu style | <span dir="rtl" class='awami-R normal'>ء أ ؤ بؤ إ ۂ بۂ ۓ بۓ ٵ ݬ بݬ ځ بځ بځب بٔ بٕ</span>| `hamz=0`
102 Arabic style | <span dir="rtl" class='awami-R normal' style='font-feature-settings: "hamz" 1'>ء أ ؤ بؤ إ ۂ بۂ ۓ بۓ ٵ ݬ بݬ ځ بځ بځب بٔ بٕ</font></span>| `hamz=1`
103
104 #### Word spacing
105
106 Feature | Sample | Feature setting
107 ---- | ---------------: | :----
108 Extra tight | <span dir="rtl" class='awami-R normal' style='font-feature-settings: "wdsp" 0'> کیوں جو انسانی حقوق کنوں</span>| `wdsp=0`
109 Tight | <span dir="rtl" class='awami-R normal' style='font-feature-settings: "wdsp" 1'> کیوں جو انسانی حقوق کنوں</span>| `wdsp=1`
110 Medium (default) | <span dir="rtl" class='awami-R normal'> کیوں جو انسانی حقوق کنوں</span>| `wdsp=2`
111 Wide| <span dir="rtl" class='awami-R normal' style='font-feature-settings: "wdsp" 3'> کیوں جو انسانی حقوق کنوں</span>| `wdsp=3`
112 Extra wide| <span dir="rtl" class='awami-R normal' style='font-feature-settings: "wdsp" 4'> کیوں جو انسانی حقوق کنوں</span>| `wdsp=4`
113
114 #### Short forms
115
116 <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>
117
118 Feature | Sample | Feature setting
119 ---- | ---------------: | :----
120 None | <span dir="rtl" class='awamipar-R normal' style='font-feature-settings: "shrt" 0'>&#x62F;&#x6CC;&#x6A9;&#x6BE;&#x62A;&#x6CC; &#x6A9;&#x646;&#x633;&#x644;&#x679;&#x646;&#x679;&#x633; &#x646;&#x6AF;&#x6BE;&#x646;&#x6D2; &#x62A;&#x6A9;&#x645;&#x6CC;&#x644;</span>| `shrt=0`
121 Kafs and gafs | <span dir="rtl" class='awamipar-R normal' style='font-feature-settings: "shrt" 1'>&#x62F;&#x6CC;<font color="red">&#x6A9;</font>&#x6BE;&#x62A;&#x6CC; <font color="red">&#x6A9;</font>&#x646;&#x633;&#x644;&#x679;&#x646;&#x679;&#x633; &#x646;<font color="red">&#x6AF;</font>&#x6BE;&#x646;&#x6D2; &#x62A;<font color="red">&#x6A9;</font>&#x645;&#x6CC;&#x644;</font></span>| `shrt=1`
122 Finals | <span dir="rtl" class='awamipar-R normal' style='font-feature-settings: "shrt" 2'>&#x62F;&#x6CC;&#x6A9;&#x6BE;&#x62A;<font color="red">&#x6CC;</font> &#x6A9;&#x646;&#x633;&#x644;&#x679;&#x646;&#x679;<font color="red">&#x633;</font> &#x646;&#x6AF;&#x6BE;&#x646;&#x6D2; &#x62A;&#x6A9;&#x645;&#x6CC;<font color="red">&#x644;</font></span>| `shrt=2`
123 All (default)| <span dir="rtl" class='awamipar-R normal' style='font-feature-settings: "shrt" 3'>&#x62F;&#x6CC;<font color="red">&#x6A9;</font>&#x6BE;&#x62A;<font color="red">&#x6CC;</font> <font color="red">&#x6A9;</font>&#x646;&#x633;&#x644;&#x679;&#x646;&#x679;<font color="red">&#x633;</font> &#x646;<font color="red">&#x6AF;</font>&#x6BE;&#x646;&#x6D2; &#x62A;<font color="red">&#x6A9;</font>&#x645;&#x6CC;<font color="red">&#x644;</font></span>| `shrt=3`
124
125 #### Collision avoidance
126
127 Feature | Sample | Feature setting
128 ---- | ---------------: | :----
129 Off | <span dir="rtl" class='awami-R normal' style='font-feature-settings: "agca" 0'><font color="red">&#x67e;&#x6cc;</font>&#x679;&#x6cc; <font color="red">&#x627;&#x614;&#x628;&#x650;&#x6cc;</font>&#x62c;<font color="red">&#x6cc;&#x644;</font> &#x62a;&#x62d;<font color="red">&#x631;</font>&#x650;<font color="red">&#x6cc;</font>&#x62c;</span> | `agca=0`
130 Kern-only | <span dir="rtl" class='awami-R normal' style='font-feature-settings: "agca" 1'><font color="red">&#x67e;&#x6cc;</font>&#x679;&#x6cc; <font color="red">&#x627;&#x614;&#x628;&#x650;&#x6cc;</font>&#x62c;<font color="red">&#x6cc;&#x644;</font> &#x62a;&#x62d;<font color="red">&#x631;</font>&#x650;<font color="red">&#x6cc;</font>&#x62c;</span> | `agca=1`
131 Not implemented | | `agca=2`
132 On (default) | <span dir="rtl" class='awami-R normal' style='font-feature-settings: "agca" 3'><font color="red">&#x67e;&#x6cc;</font>&#x679;&#x6cc; <font color="red">&#x627;&#x614;&#x628;&#x650;&#x6cc;</font>&#x62c;<font color="red">&#x6cc;&#x644;</font> &#x62a;&#x62d;<font color="red">&#x631;</font>&#x650;<font color="red">&#x6cc;</font>&#x62c;</span> | `agca=3`
133
134 ## End of Ayah and Subtending marks
135
136 *This is not technically a feature, but we find it useful to demonstrate the use of these characters.*
137
138 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.
139
140 Character | Sample
141 ------------- | ---------------:
142 U+06DD ARABIC END OF AYAH<br>(U+202D U+06DD U+06F1 U+06F2 U+06F3 U+202C)| <span dir="rtl" class='awami-R normal'>&#x202D;&#x6DD;&#x6F1;&#x6F2;&#x6F3;&#x202C; &#x202D;&#x6DD;&#x6F1;&#x6F2;&#x202C; &#x202D;&#x6DD;&#x6F1;&#x202C;</span>
143 U+0600 ARABIC NUMBER SIGN<br>(U+202D U+0600 U+06F1 U+06F2 U+06F3 U+202C)| <span dir="rtl" class='awami-R normal'>&#x202D;&#x600;&#x6F1;&#x6F2;&#x6F3;&#x202C; &#x202D;&#x600;&#x6F1;&#x6F2;&#x202C; &#x202D;&#x600;&#x6F1;&#x202C;</span>
144 U+0601 ARABIC SIGN SANAH (year)<br>(U+202D U+0601 U+06F1 U+06F2 U+06F3 U+202C)| <span dir="rtl" class='awami-R normal'>&#x202D;&#x601;&#x6F1;&#x6F9;&#x6F3;&#x6F2;&#x202C;</span>
145 U+0602 ARABIC FOOTNOTE MARKER<br>(U+202D U+0602 U+06F1 U+06F2 U+202C)| <span dir="rtl" class='awami-R normal'>&#x202D;&#x602;&#x6F1;&#x6F2;&#x202C; &#x202D;&#x602;&#x6F1;&#x202C;</span>
146 U+0603 ARABIC SIGN SAFHA (page)<br>(U+202D U+0603 U+06F1 U+06F2 U+06F3 U+202C)| <span dir="rtl" class='awami-R normal'>&#x202D;&#x603;&#x6F1;&#x6F2;&#x6F3;&#x202C; &#x202D;&#x603;&#x6F1;&#x6F2;&#x202C; &#x202D;&#x603;&#x6F1;&#x202C;</span>
147
148
149
150 ## Paragraph of text
151
152 This sentence comes from the [Saraiki UDHR](https://www.unicode.org/udhr/d/udhr_skr.txt).
153
154 Sample | Feature setting
155 ---------------: | :----
156 <span dir="rtl" class='awamipar-R normal'> &#x627;&#x642;&#x648;&#x627;&#x645;&#x20;&#x645;&#x62a;&#x62d;&#x62f;&#x6c1;&#x20;&#x646;&#x6d2;&#x20;&#x6c1;&#x631;&#x20;&#x6a9;<font color="red">&#x6c1;</font>&#x6cc;&#x6ba;&#x20;&#x62f;&#x6d2;&#x20;&#x62d;&#x642;&#x648;&#x642;&#x20;&#x62f;&#x6cc;&#x20;&#x62d;&#x641;&#x627;&#x638;&#x62a;&#x20;&#x62a;&#x6d2;&#x20;&#x648;&#x62f;<font color="red">&#x6be;</font>&#x627;&#x631;&#x6d2;&#x20;&#x62f;&#x627;&#x20;&#x62c;&#x6be;&#x646;&#x688;&#x627;&#x20;&#x627;&#x686;&#x627;&#x631;&#x20;<font color="red">&#x6a9;</font>&#x6be;<font color="red">&#x6bb;</font>&#x20;&#x62f;&#x627;&#x20;&#x627;&#x631;&#x627;&#x62f;&#x6c1;&#x20;&#x6a9;&#x6cc;&#x62a;&#x627;&#x20;&#x6c1;&#x648;&#x6d2;&#x6d4;&#x20;&#x627;&#x6cc;<font color="red">&#x6c1;</font>&#x648;&#x20;&#x684;<font color="red">&#x626;</font>&#x6d2;&#x20;&#x648;&#x20;&#x62d;&#x634;&#x6cc;&#x627;&#x646;&#x6c1;&#x20;&#x6a9;&#x645;&#x627;&#x6ba;&#x20;&#x62f;&#x6cc;&#x20;&#x635;&#x648;&#x631;&#x62a;&#x20;&#x648;&#x686;&#x20;&#x638;&#x627;&#x6c1;&#x631;&#x20;&#x62a;&#x6be;<font color="red">&#x626;</font>&#x6cc;&#x20;&#x6c1;&#x6d2;</span>|`hehk=1, hedo=0, hamz=0, shrt=3`
157 <span dir="rtl" class='awamipar-R normal' style='font-feature-settings: "hehk" 0, "hedo" 1, "hamz" 1, "shrt" 2'> &#x627;&#x642;&#x648;&#x627;&#x645;&#x20;&#x645;&#x62a;&#x62d;&#x62f;&#x6c1;&#x20;&#x646;&#x6d2;&#x20;&#x6c1;&#x631;&#x20;&#x6a9;<font color="red">&#x6c1;</font>&#x6cc;&#x6ba;&#x20;&#x62f;&#x6d2;&#x20;&#x62d;&#x642;&#x648;&#x642;&#x20;&#x62f;&#x6cc;&#x20;&#x62d;&#x641;&#x627;&#x638;&#x62a;&#x20;&#x62a;&#x6d2;&#x20;&#x648;&#x62f;<font color="red">&#x6be;</font>&#x627;&#x631;&#x6d2;&#x20;&#x62f;&#x627;&#x20;&#x62c;&#x6be;&#x646;&#x688;&#x627;&#x20;&#x627;&#x686;&#x627;&#x631;&#x20;<font color="red">&#x6a9;</font>&#x6be;<font color="red">&#x6bb;</font>&#x20;&#x62f;&#x627;&#x20;&#x627;&#x631;&#x627;&#x62f;&#x6c1;&#x20;&#x6a9;&#x6cc;&#x62a;&#x627;&#x20;&#x6c1;&#x648;&#x6d2;&#x6d4;&#x20;&#x627;&#x6cc;<font color="red">&#x6c1;</font>&#x648;&#x20;&#x684;<font color="red">&#x626;</font>&#x6d2;&#x20;&#x648;&#x20;&#x62d;&#x634;&#x6cc;&#x627;&#x646;&#x6c1;&#x20;&#x6a9;&#x645;&#x627;&#x6ba;&#x20;&#x62f;&#x6cc;&#x20;&#x635;&#x648;&#x631;&#x62a;&#x20;&#x648;&#x686;&#x20;&#x638;&#x627;&#x6c1;&#x631;&#x20;&#x62a;&#x6be;<font color="red">&#x626;</font>&#x6cc;&#x20;&#x6c1;&#x6d2;</span>|`hehk=0, hedo=1, hamz=1, shrt=2`
158
159
160 <!-- PRODUCT SITE ONLY
161 [font id='awami' face='AwamiNastaliq-Regular' bold='AwamiNastaliq-Bold' size='150%' lineheight='200%' rtl=1]
162 [font id='awamiL' face='AwamiNastaliq-Regular' bold='AwamiNastaliq-Bold' size='100%' ltr=1]
163 [font id='awamipar' face='AwamiNastaliq-Regular' bold='AwamiNastaliq-Bold' size='150%' lineheight='200%' rtl=1]
164
165 -->
166
167