@engdawood/thmanyah-font-web 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (35) hide show
  1. package/LICENSE +93 -0
  2. package/README.ar.md +234 -0
  3. package/README.md +230 -0
  4. package/fonts/thmanyah-sans/otf/thmanyah-sans-Black.otf +0 -0
  5. package/fonts/thmanyah-sans/otf/thmanyah-sans-Bold.otf +0 -0
  6. package/fonts/thmanyah-sans/otf/thmanyah-sans-Light.otf +0 -0
  7. package/fonts/thmanyah-sans/otf/thmanyah-sans-Medium.otf +0 -0
  8. package/fonts/thmanyah-sans/otf/thmanyah-sans-Regular.otf +0 -0
  9. package/fonts/thmanyah-sans/woff2/thmanyah-sans-Black.woff2 +0 -0
  10. package/fonts/thmanyah-sans/woff2/thmanyah-sans-Bold.woff2 +0 -0
  11. package/fonts/thmanyah-sans/woff2/thmanyah-sans-Light.woff2 +0 -0
  12. package/fonts/thmanyah-sans/woff2/thmanyah-sans-Medium.woff2 +0 -0
  13. package/fonts/thmanyah-sans/woff2/thmanyah-sans-Regular.woff2 +0 -0
  14. package/fonts/thmanyah-serif-display/otf/thmanyah-serif-display-Black.otf +0 -0
  15. package/fonts/thmanyah-serif-display/otf/thmanyah-serif-display-Bold.otf +0 -0
  16. package/fonts/thmanyah-serif-display/otf/thmanyah-serif-display-Light.otf +0 -0
  17. package/fonts/thmanyah-serif-display/otf/thmanyah-serif-display-Medium.otf +0 -0
  18. package/fonts/thmanyah-serif-display/otf/thmanyah-serif-display-Regular.otf +0 -0
  19. package/fonts/thmanyah-serif-display/woff2/thmanyah-serif-display-Black.woff2 +0 -0
  20. package/fonts/thmanyah-serif-display/woff2/thmanyah-serif-display-Bold.woff2 +0 -0
  21. package/fonts/thmanyah-serif-display/woff2/thmanyah-serif-display-Light.woff2 +0 -0
  22. package/fonts/thmanyah-serif-display/woff2/thmanyah-serif-display-Medium.woff2 +0 -0
  23. package/fonts/thmanyah-serif-display/woff2/thmanyah-serif-display-Regular.woff2 +0 -0
  24. package/fonts/thmanyah-serif-text/otf/thmanyah-serif-text-Black.otf +0 -0
  25. package/fonts/thmanyah-serif-text/otf/thmanyah-serif-text-Bold.otf +0 -0
  26. package/fonts/thmanyah-serif-text/otf/thmanyah-serif-text-Light.otf +0 -0
  27. package/fonts/thmanyah-serif-text/otf/thmanyah-serif-text-Medium.otf +0 -0
  28. package/fonts/thmanyah-serif-text/otf/thmanyah-serif-text-Regular.otf +0 -0
  29. package/fonts/thmanyah-serif-text/woff2/thmanyah-serif-text-Black.woff2 +0 -0
  30. package/fonts/thmanyah-serif-text/woff2/thmanyah-serif-text-Bold.woff2 +0 -0
  31. package/fonts/thmanyah-serif-text/woff2/thmanyah-serif-text-Light.woff2 +0 -0
  32. package/fonts/thmanyah-serif-text/woff2/thmanyah-serif-text-Medium.woff2 +0 -0
  33. package/fonts/thmanyah-serif-text/woff2/thmanyah-serif-text-Regular.woff2 +0 -0
  34. package/index.css +216 -0
  35. package/package.json +45 -0
package/LICENSE ADDED
@@ -0,0 +1,93 @@
1
+ Copyright (c) Thmanyah (ثمانية), https://thmanyah.com
2
+
3
+ This Font Software is licensed under the SIL Open Font License, Version 1.1.
4
+ This license is copied below, and is also available with a FAQ at:
5
+ https://openfontlicense.org
6
+
7
+ ---
8
+
9
+ SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
10
+
11
+ PREAMBLE
12
+ The goals of the Open Font License (OFL) are to stimulate worldwide
13
+ development of collaborative font projects, to support the font creation
14
+ efforts of academic and linguistic communities, and to provide a free and
15
+ open framework in which fonts may be shared and improved in partnership
16
+ with others.
17
+
18
+ The fonts covered by the Open Font License can be used, studied, modified
19
+ and redistributed freely as long as they are not sold by themselves. The
20
+ fonts, including any derivative works, can be bundled, embedded,
21
+ redistributed and/or sold with any software provided that any reserved
22
+ names are not used by derivative works. The fonts and derivatives,
23
+ however, cannot be released under any other type of license. The
24
+ requirement for fonts to remain under this license does not apply to any
25
+ document created using the fonts or their derivatives.
26
+
27
+ DEFINITIONS
28
+ "Font Software" refers to the set of files released by the Copyright
29
+ Holder(s) under this license and clearly marked as such. This may
30
+ include source files, build scripts and documentation.
31
+
32
+ "Reserved Font Name" refers to any names specified as such after the
33
+ copyright statement(s).
34
+
35
+ "Original Version" refers to the collection of Font Software components
36
+ as distributed by the Copyright Holder(s).
37
+
38
+ "Modified Version" refers to any derivative made by adding to, deleting,
39
+ or substituting—in part or in whole—any of the components of the
40
+ Original Version, by changing formats or by porting the Font Software to
41
+ a new environment.
42
+
43
+ "Author" refers to any designer, engineer, programmer, technical writer
44
+ or other person who contributed to the Font Software.
45
+
46
+ PERMISSION & CONDITIONS
47
+ Permission is hereby granted, free of charge, to any person obtaining a
48
+ copy of the original Font Software or a Modified Version of the Font
49
+ Software, to use, study, copy, merge, embed, modify, redistribute, and
50
+ sell modified and unmodified copies of the Font Software, subject to the
51
+ following conditions:
52
+
53
+ 1) Neither the Font Software nor any of its individual components, in
54
+ Original or Modified Versions, may be sold by itself.
55
+
56
+ 2) Original or Modified Versions of the Font Software may be bundled,
57
+ redistributed and/or sold with any software, provided that each copy
58
+ contains the above copyright notice and this license. These can be
59
+ included either as stand-alone text files, human-readable headers or
60
+ in the appropriate machine-readable metadata fields within text or
61
+ binary files as long as those fields can be easily viewed by the user.
62
+
63
+ 3) No Modified Version of the Font Software may use the Reserved Font
64
+ Name(s) unless explicit written permission is granted by the
65
+ corresponding Copyright Holder. This restriction only applies to the
66
+ primary font name as presented to the users.
67
+
68
+ 4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
69
+ Software shall not be used to promote, endorse or advertise any
70
+ Modified Version, except to acknowledge the contribution(s) of the
71
+ Copyright Holder(s) and the Author(s) or with their explicit written
72
+ permission.
73
+
74
+ 5) The Font Software, modified or unmodified, in part or in whole, must
75
+ be distributed entirely under this license, and must not be
76
+ distributed under any other license. The requirement for fonts to
77
+ remain under this license does not apply to any document created using
78
+ the Font Software.
79
+
80
+ TERMINATION
81
+ This license becomes null and void if any of the above conditions are
82
+ not met.
83
+
84
+ DISCLAIMER
85
+ THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
86
+ EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
87
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF
88
+ COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
89
+ COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
90
+ INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
91
+ DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
92
+ FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM OTHER
93
+ DEALINGS IN THE FONT SOFTWARE.
package/README.ar.md ADDED
@@ -0,0 +1,234 @@
1
+ <div dir="rtl" align="right">
2
+
3
+ # خط ثمانية للويب — Thmanyah Font Web
4
+
5
+ **حزمة مجتمعية لعائلة خطوط ثمانية للويب — ثلاث عائلات، خمسة أوزان لكل عائلة.** أضف ملف CSS واحد لمشروعك وابدأ باستخدام ثمانية سانس، ثمانية سيريف ديسبلاي، وثمانية سيريف تكست فورًا.
6
+
7
+ > **ملاحظة:** خط ثمانية من تصميم وملكية [ثمانية](https://thmanyah.com). هذا المستودع حزمة مجتمعية تعيد تجميع الخطوط لتسهيل استخدامها على الويب عبر npm و CDN.
8
+
9
+ ---
10
+
11
+ ## 📦 معلومات الحزمة
12
+
13
+ [![NPM Version](https://img.shields.io/npm/v/@engdawood/thmanyah-font-web)](https://www.npmjs.com/package/@engdawood/thmanyah-font-web)
14
+ [![NPM Downloads](https://img.shields.io/npm/dt/@engdawood/thmanyah-font-web?label=npm%20downloads)](https://www.npmjs.com/package/@engdawood/thmanyah-font-web)
15
+ [![jsDelivr Hits](https://img.shields.io/jsdelivr/npm/hm/@engdawood/thmanyah-font-web)](https://www.jsdelivr.com/package/npm/@engdawood/thmanyah-font-web)
16
+ [![License](https://img.shields.io/badge/license-OFL--1.1-blue)](./LICENSE)
17
+ [![Font Weights](https://img.shields.io/badge/weights-300%20·%20400%20·%20500%20·%20700%20·%20900-blueviolet)](#عائلات-الخطوط-والأوزان)
18
+
19
+ ## 📊 إحصائيات المستودع
20
+
21
+ [![GitHub Stars](https://img.shields.io/github/stars/engdawood/thmanyah-font-web)](https://github.com/engdawood/thmanyah-font-web/stargazers)
22
+ [![GitHub Forks](https://img.shields.io/github/forks/engdawood/thmanyah-font-web)](https://github.com/engdawood/thmanyah-font-web/network/members)
23
+ [![GitHub Issues](https://img.shields.io/github/issues/engdawood/thmanyah-font-web)](https://github.com/engdawood/thmanyah-font-web/issues)
24
+ [![Code Size](https://img.shields.io/github/languages/code-size/engdawood/thmanyah-font-web)](https://github.com/engdawood/thmanyah-font-web)
25
+ [![GitHub last commit](https://img.shields.io/github/last-commit/engdawood/thmanyah-font-web)](https://github.com/engdawood/thmanyah-font-web/commits)
26
+
27
+ ## 🔄 التوافق
28
+
29
+ [![Browsers](https://img.shields.io/badge/browsers-Chrome%20·%20Firefox%20·%20Safari%20·%20Edge-brightgreen)](#)
30
+ [![Platforms](https://img.shields.io/badge/platforms-Windows%20·%20Mac%20·%20Linux%20·%20Android%20·%20iOS-blue)](#)
31
+ [![Maintained](https://img.shields.io/badge/maintained%3F-yes-green.svg)](https://github.com/engdawood/thmanyah-font-web/graphs/commit-activity)
32
+ [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/engdawood/thmanyah-font-web/pulls)
33
+
34
+ ---
35
+
36
+ ## 🌍 تجربة حية
37
+
38
+ 🎉 **شاهد العرض التوضيحي هنا:**
39
+ 🔗 [عرض خط ثمانية](https://engdawood.github.io/thmanyah-font-web/examples/demo.html)
40
+
41
+ ---
42
+
43
+ ## 🔗 روابط ثمانية الرسمية
44
+
45
+ | | الرابط |
46
+ |---|---|
47
+ | 🎨 **جرّب الخط** | [font.thmanyah.com](https://font.thmanyah.com/) |
48
+ | 𝕏 **إعلان الخط** | [ثمانية على X](https://x.com/thmanyah/status/2046944611969487256?s=20) |
49
+ | 📜 **ترخيص الخط** | [font.thmanyah.com/licenses](https://font.thmanyah.com/licenses) |
50
+
51
+ ---
52
+
53
+ ## 🚀 البداية السريعة
54
+
55
+ ### الطريقة ١ — CDN (الأسرع)
56
+
57
+ أضف وسم `<link>` واحد لصفحتك. بدون تثبيت، بدون تحميل، بدون أي إعدادات.
58
+
59
+ **jsDelivr:**
60
+
61
+ ```html
62
+ <link
63
+ rel="stylesheet"
64
+ href="https://cdn.jsdelivr.net/npm/@engdawood/thmanyah-font-web/index.css"
65
+ />
66
+ ```
67
+
68
+ **unpkg:**
69
+
70
+ ```html
71
+ <link
72
+ rel="stylesheet"
73
+ href="https://unpkg.com/@engdawood/thmanyah-font-web/index.css"
74
+ />
75
+ ```
76
+
77
+ ### الطريقة ٢ — مدير الحزم
78
+
79
+ ```bash
80
+ npm install @engdawood/thmanyah-font-web
81
+ ```
82
+
83
+ ثم استورد ملف CSS في مشروعك:
84
+
85
+ ```css
86
+ /* في ملف CSS */
87
+ @import "@engdawood/thmanyah-font-web";
88
+ ```
89
+
90
+ ```js
91
+ // أو في نقطة الدخول JS/TS
92
+ import "@engdawood/thmanyah-font-web";
93
+ ```
94
+
95
+ ### الطريقة ٣ — التحميل اليدوي
96
+
97
+ 1. حمّل هذا المستودع
98
+ 2. انسخ مجلد `fonts/` وملف `index.css` لمشروعك
99
+ 3. اربط `index.css` في صفحتك:
100
+
101
+ ```html
102
+ <link rel="stylesheet" href="path/to/index.css" />
103
+ ```
104
+
105
+ ---
106
+
107
+ ## 🔤 عائلات الخطوط والأوزان
108
+
109
+ | العائلة | قيمة `font-family` في CSS | الأوزان |
110
+ | --- | --- | --- |
111
+ | **ثمانية سانس** | `"Thmanyah Sans", sans-serif` | خفيف 300 · عادي 400 · متوسط 500 · سميك 700 · أسود 900 |
112
+ | **ثمانية سيريف ديسبلاي** | `"Thmanyah Serif Display", serif` | خفيف 300 · عادي 400 · متوسط 500 · سميك 700 · أسود 900 |
113
+ | **ثمانية سيريف تكست** | `"Thmanyah Serif Text", serif` | خفيف 300 · عادي 400 · متوسط 500 · سميك 700 · أسود 900 |
114
+
115
+ ---
116
+
117
+ ## 💡 أمثلة الاستخدام
118
+
119
+ ### خصائص CSS مباشرة
120
+
121
+ ```css
122
+ body {
123
+ font-family: "Thmanyah Sans", sans-serif;
124
+ font-weight: 400;
125
+ direction: rtl;
126
+ }
127
+
128
+ h1,
129
+ h2,
130
+ h3 {
131
+ font-family: "Thmanyah Serif Display", serif;
132
+ font-weight: 700;
133
+ }
134
+
135
+ article p {
136
+ font-family: "Thmanyah Serif Text", serif;
137
+ font-weight: 400;
138
+ }
139
+ ```
140
+
141
+ ### الأصناف الجاهزة (Utility Classes)
142
+
143
+ الحزمة تأتي مع أصناف CSS جاهزة للاستخدام:
144
+
145
+ ```html
146
+ <!-- أصناف العائلة -->
147
+ <p class="font-thmanyah-sans">ثمانية سانس</p>
148
+ <h1 class="font-thmanyah-serif-display">ثمانية سيريف ديسبلاي</h1>
149
+ <p class="font-thmanyah-serif-text">ثمانية سيريف تكست</p>
150
+
151
+ <!-- أصناف الوزن -->
152
+ <p class="font-thmanyah-sans font-weight-light">وزن خفيف — 300</p>
153
+ <p class="font-thmanyah-sans font-weight-regular">وزن عادي — 400</p>
154
+ <p class="font-thmanyah-sans font-weight-medium">وزن متوسط — 500</p>
155
+ <p class="font-thmanyah-sans font-weight-bold">وزن سميك — 700</p>
156
+ <p class="font-thmanyah-sans font-weight-black">وزن أسود — 900</p>
157
+ ```
158
+
159
+ ### مرجع الأصناف الجاهزة
160
+
161
+ | الصنف | التأثير |
162
+ | --- | --- |
163
+ | `.font-thmanyah-sans` | `font-family: "Thmanyah Sans", sans-serif` |
164
+ | `.font-thmanyah-serif-display` | `font-family: "Thmanyah Serif Display", serif` |
165
+ | `.font-thmanyah-serif-text` | `font-family: "Thmanyah Serif Text", serif` |
166
+ | `.font-weight-light` | `font-weight: 300` |
167
+ | `.font-weight-regular` | `font-weight: 400` |
168
+ | `.font-weight-medium` | `font-weight: 500` |
169
+ | `.font-weight-bold` | `font-weight: 700` |
170
+ | `.font-weight-black` | `font-weight: 900` |
171
+
172
+ ---
173
+
174
+ ## 📁 هيكل المستودع
175
+
176
+ ```
177
+ thmanyah-font-web/
178
+ ├── fonts/
179
+ │ ├── thmanyah-sans/
180
+ │ │ ├── woff2/ ← الصيغة الأساسية للويب
181
+ │ │ └── otf/ ← بديل / سطح المكتب
182
+ │ ├── thmanyah-serif-display/
183
+ │ │ ├── woff2/
184
+ │ │ └── otf/
185
+ │ └── thmanyah-serif-text/
186
+ │ ├── woff2/
187
+ │ └── otf/
188
+ ├── examples/
189
+ │ └── demo.html ← صفحة العرض التوضيحي (GitHub Pages)
190
+ ├── index.css ← جميع تعريفات @font-face + الأصناف الجاهزة
191
+ ├── index.html ← إعادة توجيه GitHub Pages
192
+ ├── package.json
193
+ ├── LICENSE ← OFL-1.1
194
+ ├── README.md ← التوثيق بالإنجليزية
195
+ └── README.ar.md ← التوثيق بالعربية (أنت هنا)
196
+ ```
197
+
198
+ ---
199
+
200
+ ## ⚙️ تفاصيل تقنية
201
+
202
+ - **الصيغة الأساسية:** WOFF2 (مضغوطة، أفضل دعم للمتصفحات)
203
+ - **الصيغة البديلة:** OTF/OpenType (توافق مع سطح المكتب)
204
+ - **`font-display: swap`** — النص يظهر فورًا، والخط يُحمّل في الخلفية
205
+ - **`unicode-range`** — يغطي العربية (U+0600–06FF, U+0750–077F, U+08A0–08FF, U+FB50–FDFF, U+FE70–FEFF) واللاتينية الأساسية (U+0020–02AF)
206
+ - **جاهز لـ RTL** — مصمم ومُحسّن للكتابة من اليمين لليسار
207
+
208
+ ---
209
+
210
+ ## 📄 الترخيص
211
+
212
+ عائلة خطوط ثمانية مرخّصة تحت **[رخصة الخطوط المفتوحة SIL، الإصدار 1.1](./LICENSE)**.
213
+
214
+ - ✅ مجاني للاستخدام الشخصي والتجاري
215
+ - ✅ يمكن تضمينه مع أي برنامج
216
+ - ✅ يمكن تعديله وإعادة توزيعه
217
+ - ❌ لا يمكن بيعه بشكل مستقل
218
+
219
+ **تصميم الخط وحقوق الملكية © [ثمانية](https://thmanyah.com)** — جميع الحقوق للخط تعود لهم.
220
+ **حزمة الويب المجتمعية بواسطة [@engdawood](https://github.com/engdawood)** — هذا المستودع يعيد تجميع الخطوط فقط لاستخدام الويب.
221
+
222
+ ---
223
+
224
+ ## 🤝 المساهمة
225
+
226
+ المساهمات مرحّب بها! لا تتردد في فتح Issues أو تقديم Pull Requests.
227
+
228
+ 1. افعل Fork للمستودع
229
+ 2. أنشئ فرعك (`git checkout -b feature/improvement`)
230
+ 3. نفّذ تعديلاتك (`git commit -m 'Add improvement'`)
231
+ 4. ادفع للفرع (`git push origin feature/improvement`)
232
+ 5. افتح Pull Request
233
+
234
+ </div>
package/README.md ADDED
@@ -0,0 +1,230 @@
1
+ # خط ثمانية للويب — Thmanyah Font Web
2
+
3
+ **[🇸🇦 اقرأ التوثيق بالعربية](./README.ar.md)**
4
+
5
+ **A community‑maintained web package for the Thmanyah (ثمانية) font family — three families, five weights each.** Drop a single CSS file into your project and start using Thmanyah Sans, Thmanyah Serif Display, and Thmanyah Serif Text immediately.
6
+
7
+ > **Note:** The Thmanyah font family is designed and owned by [Thmanyah (ثمانية)](https://thmanyah.com). This repo is a community package that repackages the fonts for easy web/npm/CDN usage.
8
+
9
+ ---
10
+
11
+ ## 📦 Package Information
12
+
13
+ [![NPM Version](https://img.shields.io/npm/v/@engdawood/thmanyah-font-web)](https://www.npmjs.com/package/@engdawood/thmanyah-font-web)
14
+ [![NPM Downloads](https://img.shields.io/npm/dt/@engdawood/thmanyah-font-web?label=npm%20downloads)](https://www.npmjs.com/package/@engdawood/thmanyah-font-web)
15
+ [![jsDelivr Hits](https://img.shields.io/jsdelivr/npm/hm/@engdawood/thmanyah-font-web)](https://www.jsdelivr.com/package/npm/@engdawood/thmanyah-font-web)
16
+ [![License](https://img.shields.io/badge/license-OFL--1.1-blue)](./LICENSE)
17
+ [![Font Weights](https://img.shields.io/badge/weights-300%20·%20400%20·%20500%20·%20700%20·%20900-blueviolet)](#font-families--weights)
18
+
19
+ ## 📊 Repository Stats
20
+
21
+ [![GitHub Stars](https://img.shields.io/github/stars/engdawood/thmanyah-font-web)](https://github.com/engdawood/thmanyah-font-web/stargazers)
22
+ [![GitHub Forks](https://img.shields.io/github/forks/engdawood/thmanyah-font-web)](https://github.com/engdawood/thmanyah-font-web/network/members)
23
+ [![GitHub Issues](https://img.shields.io/github/issues/engdawood/thmanyah-font-web)](https://github.com/engdawood/thmanyah-font-web/issues)
24
+ [![Code Size](https://img.shields.io/github/languages/code-size/engdawood/thmanyah-font-web)](https://github.com/engdawood/thmanyah-font-web)
25
+ [![GitHub last commit](https://img.shields.io/github/last-commit/engdawood/thmanyah-font-web)](https://github.com/engdawood/thmanyah-font-web/commits)
26
+
27
+ ## 🔄 Compatibility
28
+
29
+ [![Browsers](https://img.shields.io/badge/browsers-Chrome%20·%20Firefox%20·%20Safari%20·%20Edge-brightgreen)](#)
30
+ [![Platforms](https://img.shields.io/badge/platforms-Windows%20·%20Mac%20·%20Linux%20·%20Android%20·%20iOS-blue)](#)
31
+ [![Maintained](https://img.shields.io/badge/maintained%3F-yes-green.svg)](https://github.com/engdawood/thmanyah-font-web/graphs/commit-activity)
32
+ [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/engdawood/thmanyah-font-web/pulls)
33
+
34
+ ---
35
+
36
+ ## 🌍 Live Demo
37
+
38
+ 🎉 **Check out the live demo here:**
39
+ 🔗 [Thmanyah Font Demo](https://engdawood.github.io/thmanyah-font-web/examples/demo.html)
40
+
41
+ ---
42
+
43
+ ## 🔗 Official Thmanyah Links
44
+
45
+ | | Link |
46
+ |---|---|
47
+ | 🎨 **Try the font** | [font.thmanyah.com](https://font.thmanyah.com/) |
48
+ | 𝕏 **Announcement** | [Thmanyah on X](https://x.com/thmanyah/status/2046944611969487256?s=20) |
49
+ | 📜 **Font License** | [font.thmanyah.com/licenses](https://font.thmanyah.com/licenses) |
50
+
51
+ ---
52
+
53
+ ## 🚀 Quick Start
54
+
55
+ ### Option 1 — CDN (Fastest)
56
+
57
+ Add a single `<link>` tag to your HTML. No build step, no install, no download.
58
+
59
+ **jsDelivr:**
60
+
61
+ ```html
62
+ <link
63
+ rel="stylesheet"
64
+ href="https://cdn.jsdelivr.net/npm/@engdawood/thmanyah-font-web/index.css"
65
+ />
66
+ ```
67
+
68
+ **unpkg:**
69
+
70
+ ```html
71
+ <link
72
+ rel="stylesheet"
73
+ href="https://unpkg.com/@engdawood/thmanyah-font-web/index.css"
74
+ />
75
+ ```
76
+
77
+ ### Option 2 — Package Manager
78
+
79
+ ```bash
80
+ npm install @engdawood/thmanyah-font-web
81
+ ```
82
+
83
+ Then import the CSS in your project:
84
+
85
+ ```css
86
+ /* In your CSS */
87
+ @import "@engdawood/thmanyah-font-web";
88
+ ```
89
+
90
+ ```js
91
+ // Or in your JS/TS entry point
92
+ import "@engdawood/thmanyah-font-web";
93
+ ```
94
+
95
+ ### Option 3 — Manual Download
96
+
97
+ 1. Download this repository
98
+ 2. Copy the `fonts/` directory and `index.css` to your project
99
+ 3. Link `index.css` in your HTML:
100
+
101
+ ```html
102
+ <link rel="stylesheet" href="path/to/index.css" />
103
+ ```
104
+
105
+ ---
106
+
107
+ ## 🔤 Font Families & Weights
108
+
109
+ | Family | CSS `font-family` | Weights |
110
+ | ------------------------ | ---------------------------- | ------------------------------------ |
111
+ | **Thmanyah Sans** | `"Thmanyah Sans", sans-serif` | Light 300 · Regular 400 · Medium 500 · Bold 700 · Black 900 |
112
+ | **Thmanyah Serif Display** | `"Thmanyah Serif Display", serif` | Light 300 · Regular 400 · Medium 500 · Bold 700 · Black 900 |
113
+ | **Thmanyah Serif Text** | `"Thmanyah Serif Text", serif` | Light 300 · Regular 400 · Medium 500 · Bold 700 · Black 900 |
114
+
115
+ ---
116
+
117
+ ## 💡 Usage Examples
118
+
119
+ ### Direct CSS Properties
120
+
121
+ ```css
122
+ body {
123
+ font-family: "Thmanyah Sans", sans-serif;
124
+ font-weight: 400;
125
+ direction: rtl;
126
+ }
127
+
128
+ h1,
129
+ h2,
130
+ h3 {
131
+ font-family: "Thmanyah Serif Display", serif;
132
+ font-weight: 700;
133
+ }
134
+
135
+ article p {
136
+ font-family: "Thmanyah Serif Text", serif;
137
+ font-weight: 400;
138
+ }
139
+ ```
140
+
141
+ ### Utility Classes
142
+
143
+ The package ships ready-made utility classes:
144
+
145
+ ```html
146
+ <!-- Family classes -->
147
+ <p class="font-thmanyah-sans">ثمانية سانس</p>
148
+ <h1 class="font-thmanyah-serif-display">ثمانية سيريف ديسبلاي</h1>
149
+ <p class="font-thmanyah-serif-text">ثمانية سيريف تكست</p>
150
+
151
+ <!-- Weight classes -->
152
+ <p class="font-thmanyah-sans font-weight-light">وزن خفيف — 300</p>
153
+ <p class="font-thmanyah-sans font-weight-regular">وزن عادي — 400</p>
154
+ <p class="font-thmanyah-sans font-weight-medium">وزن متوسط — 500</p>
155
+ <p class="font-thmanyah-sans font-weight-bold">وزن سميك — 700</p>
156
+ <p class="font-thmanyah-sans font-weight-black">وزن أسود — 900</p>
157
+ ```
158
+
159
+ ### Utility Classes Reference
160
+
161
+ | Class | Effect |
162
+ | ------------------------------ | -------------------------------------------- |
163
+ | `.font-thmanyah-sans` | `font-family: "Thmanyah Sans", sans-serif` |
164
+ | `.font-thmanyah-serif-display` | `font-family: "Thmanyah Serif Display", serif` |
165
+ | `.font-thmanyah-serif-text` | `font-family: "Thmanyah Serif Text", serif` |
166
+ | `.font-weight-light` | `font-weight: 300` |
167
+ | `.font-weight-regular` | `font-weight: 400` |
168
+ | `.font-weight-medium` | `font-weight: 500` |
169
+ | `.font-weight-bold` | `font-weight: 700` |
170
+ | `.font-weight-black` | `font-weight: 900` |
171
+
172
+ ---
173
+
174
+ ## 📁 Repository Structure
175
+
176
+ ```
177
+ thmanyah-font-web/
178
+ ├── fonts/
179
+ │ ├── thmanyah-sans/
180
+ │ │ ├── woff2/ ← Primary web format
181
+ │ │ └── otf/ ← Fallback / desktop
182
+ │ ├── thmanyah-serif-display/
183
+ │ │ ├── woff2/
184
+ │ │ └── otf/
185
+ │ └── thmanyah-serif-text/
186
+ │ ├── woff2/
187
+ │ └── otf/
188
+ ├── examples/
189
+ │ └── demo.html ← Live demo page (GitHub Pages)
190
+ ├── index.css ← All @font-face declarations + utility classes
191
+ ├── package.json
192
+ ├── LICENSE ← OFL-1.1
193
+ └── README.md
194
+ ```
195
+
196
+ ---
197
+
198
+ ## ⚙️ Technical Details
199
+
200
+ - **Primary format:** WOFF2 (compressed, best browser support)
201
+ - **Fallback format:** OTF/OpenType (desktop compatibility)
202
+ - **`font-display: swap`** — text is visible immediately, font loads in background
203
+ - **`unicode-range`** — covers Arabic (U+0600–06FF, U+0750–077F, U+08A0–08FF, U+FB50–FDFF, U+FE70–FEFF) and Basic Latin (U+0020–02AF)
204
+ - **RTL-ready** — designed and optimized for right-to-left layouts
205
+
206
+ ---
207
+
208
+ ## 📄 License
209
+
210
+ The Thmanyah font family is licensed under the **[SIL Open Font License, Version 1.1](./LICENSE)**.
211
+
212
+ - ✅ Free to use in personal and commercial projects
213
+ - ✅ Can be bundled with any software
214
+ - ✅ Can be modified and redistributed
215
+ - ❌ Cannot be sold by itself
216
+
217
+ **Font design & copyright © [Thmanyah (ثمانية)](https://thmanyah.com)** — all rights to the font belong to them.
218
+ **Community web package by [@engdawood](https://github.com/engdawood)** — this repo only repackages the fonts for web usage.
219
+
220
+ ---
221
+
222
+ ## 🤝 Contributing
223
+
224
+ Contributions are welcome! Feel free to open issues or submit pull requests.
225
+
226
+ 1. Fork the repository
227
+ 2. Create your feature branch (`git checkout -b feature/improvement`)
228
+ 3. Commit your changes (`git commit -m 'Add improvement'`)
229
+ 4. Push to the branch (`git push origin feature/improvement`)
230
+ 5. Open a Pull Request
package/index.css ADDED
@@ -0,0 +1,216 @@
1
+ /*! Thmanyah Font Web v1.0.0 | OFL-1.1 License | github.com/engdawood/thmanyah-font-web */
2
+
3
+ /* ============================================================
4
+ Thmanyah Sans
5
+ ============================================================ */
6
+
7
+ @font-face {
8
+ font-family: "Thmanyah Sans";
9
+ src: url("fonts/thmanyah-sans/woff2/thmanyah-sans-Light.woff2") format("woff2"),
10
+ url("fonts/thmanyah-sans/otf/thmanyah-sans-Light.otf") format("opentype");
11
+ font-weight: 300;
12
+ font-style: normal;
13
+ font-display: swap;
14
+ unicode-range: U+0600-06FF, U+0750-077F, U+08A0-08FF, U+FB50-FDFF,
15
+ U+FE70-FEFF, U+0020-007F, U+00A0-00FF, U+0100-024F, U+0250-02AF;
16
+ }
17
+
18
+ @font-face {
19
+ font-family: "Thmanyah Sans";
20
+ src: url("fonts/thmanyah-sans/woff2/thmanyah-sans-Regular.woff2") format("woff2"),
21
+ url("fonts/thmanyah-sans/otf/thmanyah-sans-Regular.otf") format("opentype");
22
+ font-weight: 400;
23
+ font-style: normal;
24
+ font-display: swap;
25
+ unicode-range: U+0600-06FF, U+0750-077F, U+08A0-08FF, U+FB50-FDFF,
26
+ U+FE70-FEFF, U+0020-007F, U+00A0-00FF, U+0100-024F, U+0250-02AF;
27
+ }
28
+
29
+ @font-face {
30
+ font-family: "Thmanyah Sans";
31
+ src: url("fonts/thmanyah-sans/woff2/thmanyah-sans-Medium.woff2") format("woff2"),
32
+ url("fonts/thmanyah-sans/otf/thmanyah-sans-Medium.otf") format("opentype");
33
+ font-weight: 500;
34
+ font-style: normal;
35
+ font-display: swap;
36
+ unicode-range: U+0600-06FF, U+0750-077F, U+08A0-08FF, U+FB50-FDFF,
37
+ U+FE70-FEFF, U+0020-007F, U+00A0-00FF, U+0100-024F, U+0250-02AF;
38
+ }
39
+
40
+ @font-face {
41
+ font-family: "Thmanyah Sans";
42
+ src: url("fonts/thmanyah-sans/woff2/thmanyah-sans-Bold.woff2") format("woff2"),
43
+ url("fonts/thmanyah-sans/otf/thmanyah-sans-Bold.otf") format("opentype");
44
+ font-weight: 700;
45
+ font-style: normal;
46
+ font-display: swap;
47
+ unicode-range: U+0600-06FF, U+0750-077F, U+08A0-08FF, U+FB50-FDFF,
48
+ U+FE70-FEFF, U+0020-007F, U+00A0-00FF, U+0100-024F, U+0250-02AF;
49
+ }
50
+
51
+ @font-face {
52
+ font-family: "Thmanyah Sans";
53
+ src: url("fonts/thmanyah-sans/woff2/thmanyah-sans-Black.woff2") format("woff2"),
54
+ url("fonts/thmanyah-sans/otf/thmanyah-sans-Black.otf") format("opentype");
55
+ font-weight: 900;
56
+ font-style: normal;
57
+ font-display: swap;
58
+ unicode-range: U+0600-06FF, U+0750-077F, U+08A0-08FF, U+FB50-FDFF,
59
+ U+FE70-FEFF, U+0020-007F, U+00A0-00FF, U+0100-024F, U+0250-02AF;
60
+ }
61
+
62
+ /* ============================================================
63
+ Thmanyah Serif Display
64
+ ============================================================ */
65
+
66
+ @font-face {
67
+ font-family: "Thmanyah Serif Display";
68
+ src: url("fonts/thmanyah-serif-display/woff2/thmanyah-serif-display-Light.woff2") format("woff2"),
69
+ url("fonts/thmanyah-serif-display/otf/thmanyah-serif-display-Light.otf") format("opentype");
70
+ font-weight: 300;
71
+ font-style: normal;
72
+ font-display: swap;
73
+ unicode-range: U+0600-06FF, U+0750-077F, U+08A0-08FF, U+FB50-FDFF,
74
+ U+FE70-FEFF, U+0020-007F, U+00A0-00FF, U+0100-024F, U+0250-02AF;
75
+ }
76
+
77
+ @font-face {
78
+ font-family: "Thmanyah Serif Display";
79
+ src: url("fonts/thmanyah-serif-display/woff2/thmanyah-serif-display-Regular.woff2") format("woff2"),
80
+ url("fonts/thmanyah-serif-display/otf/thmanyah-serif-display-Regular.otf") format("opentype");
81
+ font-weight: 400;
82
+ font-style: normal;
83
+ font-display: swap;
84
+ unicode-range: U+0600-06FF, U+0750-077F, U+08A0-08FF, U+FB50-FDFF,
85
+ U+FE70-FEFF, U+0020-007F, U+00A0-00FF, U+0100-024F, U+0250-02AF;
86
+ }
87
+
88
+ @font-face {
89
+ font-family: "Thmanyah Serif Display";
90
+ src: url("fonts/thmanyah-serif-display/woff2/thmanyah-serif-display-Medium.woff2") format("woff2"),
91
+ url("fonts/thmanyah-serif-display/otf/thmanyah-serif-display-Medium.otf") format("opentype");
92
+ font-weight: 500;
93
+ font-style: normal;
94
+ font-display: swap;
95
+ unicode-range: U+0600-06FF, U+0750-077F, U+08A0-08FF, U+FB50-FDFF,
96
+ U+FE70-FEFF, U+0020-007F, U+00A0-00FF, U+0100-024F, U+0250-02AF;
97
+ }
98
+
99
+ @font-face {
100
+ font-family: "Thmanyah Serif Display";
101
+ src: url("fonts/thmanyah-serif-display/woff2/thmanyah-serif-display-Bold.woff2") format("woff2"),
102
+ url("fonts/thmanyah-serif-display/otf/thmanyah-serif-display-Bold.otf") format("opentype");
103
+ font-weight: 700;
104
+ font-style: normal;
105
+ font-display: swap;
106
+ unicode-range: U+0600-06FF, U+0750-077F, U+08A0-08FF, U+FB50-FDFF,
107
+ U+FE70-FEFF, U+0020-007F, U+00A0-00FF, U+0100-024F, U+0250-02AF;
108
+ }
109
+
110
+ @font-face {
111
+ font-family: "Thmanyah Serif Display";
112
+ src: url("fonts/thmanyah-serif-display/woff2/thmanyah-serif-display-Black.woff2") format("woff2"),
113
+ url("fonts/thmanyah-serif-display/otf/thmanyah-serif-display-Black.otf") format("opentype");
114
+ font-weight: 900;
115
+ font-style: normal;
116
+ font-display: swap;
117
+ unicode-range: U+0600-06FF, U+0750-077F, U+08A0-08FF, U+FB50-FDFF,
118
+ U+FE70-FEFF, U+0020-007F, U+00A0-00FF, U+0100-024F, U+0250-02AF;
119
+ }
120
+
121
+ /* ============================================================
122
+ Thmanyah Serif Text
123
+ ============================================================ */
124
+
125
+ @font-face {
126
+ font-family: "Thmanyah Serif Text";
127
+ src: url("fonts/thmanyah-serif-text/woff2/thmanyah-serif-text-Light.woff2") format("woff2"),
128
+ url("fonts/thmanyah-serif-text/otf/thmanyah-serif-text-Light.otf") format("opentype");
129
+ font-weight: 300;
130
+ font-style: normal;
131
+ font-display: swap;
132
+ unicode-range: U+0600-06FF, U+0750-077F, U+08A0-08FF, U+FB50-FDFF,
133
+ U+FE70-FEFF, U+0020-007F, U+00A0-00FF, U+0100-024F, U+0250-02AF;
134
+ }
135
+
136
+ @font-face {
137
+ font-family: "Thmanyah Serif Text";
138
+ src: url("fonts/thmanyah-serif-text/woff2/thmanyah-serif-text-Regular.woff2") format("woff2"),
139
+ url("fonts/thmanyah-serif-text/otf/thmanyah-serif-text-Regular.otf") format("opentype");
140
+ font-weight: 400;
141
+ font-style: normal;
142
+ font-display: swap;
143
+ unicode-range: U+0600-06FF, U+0750-077F, U+08A0-08FF, U+FB50-FDFF,
144
+ U+FE70-FEFF, U+0020-007F, U+00A0-00FF, U+0100-024F, U+0250-02AF;
145
+ }
146
+
147
+ @font-face {
148
+ font-family: "Thmanyah Serif Text";
149
+ src: url("fonts/thmanyah-serif-text/woff2/thmanyah-serif-text-Medium.woff2") format("woff2"),
150
+ url("fonts/thmanyah-serif-text/otf/thmanyah-serif-text-Medium.otf") format("opentype");
151
+ font-weight: 500;
152
+ font-style: normal;
153
+ font-display: swap;
154
+ unicode-range: U+0600-06FF, U+0750-077F, U+08A0-08FF, U+FB50-FDFF,
155
+ U+FE70-FEFF, U+0020-007F, U+00A0-00FF, U+0100-024F, U+0250-02AF;
156
+ }
157
+
158
+ @font-face {
159
+ font-family: "Thmanyah Serif Text";
160
+ src: url("fonts/thmanyah-serif-text/woff2/thmanyah-serif-text-Bold.woff2") format("woff2"),
161
+ url("fonts/thmanyah-serif-text/otf/thmanyah-serif-text-Bold.otf") format("opentype");
162
+ font-weight: 700;
163
+ font-style: normal;
164
+ font-display: swap;
165
+ unicode-range: U+0600-06FF, U+0750-077F, U+08A0-08FF, U+FB50-FDFF,
166
+ U+FE70-FEFF, U+0020-007F, U+00A0-00FF, U+0100-024F, U+0250-02AF;
167
+ }
168
+
169
+ @font-face {
170
+ font-family: "Thmanyah Serif Text";
171
+ src: url("fonts/thmanyah-serif-text/woff2/thmanyah-serif-text-Black.woff2") format("woff2"),
172
+ url("fonts/thmanyah-serif-text/otf/thmanyah-serif-text-Black.otf") format("opentype");
173
+ font-weight: 900;
174
+ font-style: normal;
175
+ font-display: swap;
176
+ unicode-range: U+0600-06FF, U+0750-077F, U+08A0-08FF, U+FB50-FDFF,
177
+ U+FE70-FEFF, U+0020-007F, U+00A0-00FF, U+0100-024F, U+0250-02AF;
178
+ }
179
+
180
+ /* ============================================================
181
+ Utility Classes
182
+ ============================================================ */
183
+
184
+ /* --- Family Selectors --- */
185
+ .font-thmanyah-sans {
186
+ font-family: "Thmanyah Sans", sans-serif;
187
+ }
188
+
189
+ .font-thmanyah-serif-display {
190
+ font-family: "Thmanyah Serif Display", serif;
191
+ }
192
+
193
+ .font-thmanyah-serif-text {
194
+ font-family: "Thmanyah Serif Text", serif;
195
+ }
196
+
197
+ /* --- Weight Selectors --- */
198
+ .font-weight-light {
199
+ font-weight: 300;
200
+ }
201
+
202
+ .font-weight-regular {
203
+ font-weight: 400;
204
+ }
205
+
206
+ .font-weight-medium {
207
+ font-weight: 500;
208
+ }
209
+
210
+ .font-weight-bold {
211
+ font-weight: 700;
212
+ }
213
+
214
+ .font-weight-black {
215
+ font-weight: 900;
216
+ }
package/package.json ADDED
@@ -0,0 +1,45 @@
1
+ {
2
+ "name": "@engdawood/thmanyah-font-web",
3
+ "version": "1.0.0",
4
+ "description": "Community web package for the Thmanyah (ثمانية) font family — Sans, Serif Display & Serif Text in five weights. Drop-in CSS, CDN-ready, npm-installable.",
5
+ "main": "index.css",
6
+ "style": "index.css",
7
+ "files": [
8
+ "index.css",
9
+ "fonts/**/*",
10
+ "LICENSE"
11
+ ],
12
+ "directories": {
13
+ "example": "examples"
14
+ },
15
+ "scripts": {
16
+ "test": "echo \"No tests — this is a font package\" && exit 0"
17
+ },
18
+ "repository": {
19
+ "type": "git",
20
+ "url": "git+https://github.com/engdawood/thmanyah-font-web.git"
21
+ },
22
+ "keywords": [
23
+ "thmanyah",
24
+ "ثمانية",
25
+ "font",
26
+ "arabic",
27
+ "arabic-font",
28
+ "webfont",
29
+ "css",
30
+ "rtl",
31
+ "sans",
32
+ "serif",
33
+ "typography",
34
+ "font-face",
35
+ "woff2",
36
+ "otf",
37
+ "opentype"
38
+ ],
39
+ "author": "engdawood",
40
+ "license": "OFL-1.1",
41
+ "bugs": {
42
+ "url": "https://github.com/engdawood/thmanyah-font-web/issues"
43
+ },
44
+ "homepage": "https://engdawood.github.io/thmanyah-font-web/"
45
+ }