|||
-|-|-|
| ملخص | يسمح Discourse FontAwesome Pro باستخدام أيقونات Font Awesome Pro في Discourse مع ترخيص FontAwesome عن طريق استخدام رمز حزمة NPM الخاص بحسابك.
| رابط المستودع | https://github.com/discourse/discourse-fontawesome-pro
| دليل التثبيت | كيفية تثبيت الإضافات في Discourse
التكوين
يتطلب هذا بضع خطوات إضافية لتمكينه من إضافة عادية:
أولاً، ستحتاج إلى إعداد متغير بيئة إضافي يحتوي على مفتاح ترخيص Font Awesome Pro الخاص بك: DISCOURSE_FONTAWESOME_AUTH_TOKEN
يجب أيضًا استدعاء برنامج التثبيت أثناء التهيئة، كخطاف “after_code” إضافي. يقوم هذا بتنزيل وإضافة ملفات SVG الخاصة بـ FontAwesome Pro عند البناء باستخدام رمز المصادقة الخاص بك. هذه كتلة إضافية منفصلة عن كتلة استنساخ الإضافة.
إليك مثال تثبيت في app.yml:
env:
DISCOURSE_FONTAWESOME_AUTH_TOKEN: 123456
hooks:
after_code:
- exec:
cd: $home/plugins
cmd:
- git clone https://github.com/discourse/discourse-fontawesome-pro.git
- exec:
cd: $home/plugins/discourse-fontawesome-pro
raise_on_fail: false
cmd:
- $home/plugins/discourse-fontawesome-pro/scripts/install.sh
اختيار عائلة افتراضية:
في إعدادات المسؤول، يمكنك تجاوز عائلة الأيقونات الافتراضية لـ Discourse:
اختيار نمط افتراضي:
يمكنك أيضًا تجاوز نمط الأيقونة الافتراضي:
Duotone
للحصول على تحكم كامل في دعم Duotone، ستحتاج إلى تجاوز CSS التالي (في سمة، أو غير ذلك) واستبداله بمخطط الألوان الخاص بك:
svg {
--fa-secondary-color: red;
--fa-secondary-opacity: 0.6;
}
لتلوين الأيقونات الفردية، ارجع إلى معرف SVG:
#fad-search .fa-secondary {
--fa-secondary-color: red;
--fa-secondary-opacity: 0.6;
}
تحديث تنسيق Duotone
إذا كنت تستخدم محددات تعتمد على الفئات مثل:.fa-secondary { color: red; }ستحتاج إلى تحديث التنسيق الخاص بك لاستخدام خصائص CSS المخصصة بدلاً من ذلك. لم تعد تجاوزات الألوان المستندة إلى الفئات تعمل منذ أن تم إسقاطها في Font Awesome v7
في الخلفية، يستخدم هذا مستودع FontAwesome لتثبيت الخطوط في مجلد SVG الخاص بالإضافة، ويسمح لـ Discourse بالتقاط الصور من هناك.
مستضاف من قبلنا؟ هذه الإضافة متاحة في خطط Enterprise الخاصة بنا.