حسنًا، يرجى تجربة التثبيت اليدوي
دليل التثبيت اليدوي (إصدار التجاوز)
يشرح هذا الدليل كيفية التثبيت والتطبيق يدويًا للإضافة discourse-moetwemoji-twemoji-fakepng-override داخل حاوية Discourse قيد التشغيل، ويوضح لماذا ليس من الضروري بشكل صارم إجراء إعادة بناء كاملة لإصدار التجاوز.
1. الدخول إلى حاوية Discourse
على الخادم الخاص بك، انتقل إلى دليل Discourse Docker (عادةً /var/discourse) وادخل إلى الحاوية قيد التشغيل:
cd /var/discourse
./launcher enter app
يجب أن تكون الآن داخل قوقعة الحاوية.
2. استنساخ إضافة التجاوز يدويًا
انتقل إلى دليل الإضافات واستنسخ المستودع:
cd /var/www/discourse/plugins
git clone https://github.com/constansino/discourse-moetwemoji-twemoji-fakepng-override.git
تحقق من وجود الدليل:
ls discourse-moetwemoji-twemoji-fakepng-override
3. تطبيق تجاوز الرموز التعبيرية
ارجع إلى دليل جذر Discourse:
su - discourse
cd /var/www/discourse
تحقق من الحالة الحالية (اختياري ولكن موصى به):
RAILS_ENV=production bundle exec rake moetwemoji_twemoji:status
قم بتطبيق التجاوز:
RAILS_ENV=production bundle exec rake moetwemoji_twemoji:apply
إذا انتهت الأوامر دون أخطاء، فقد تم استبدال ملفات PNG الخاصة بـ Twemoji بملفات Moetwemoji.
4. ملاحظات هامة حول عمليات إعادة البناء (الاستمرارية)
لا يلزم إجراء إعادة بناء لكي يعمل التجاوز
يعمل إصدار التجاوز هذا عن طريق استبدال الملفات مباشرة في الحاوية قيد التشغيل.
لذلك:
لكن التغيير غير دائم
نظرًا لأن هذا يتم داخل نظام ملفات الحاوية:
سوف تمحو التغييرات، وسيتم فقدان تجاوز الرموز التعبيرية.
إذا كنت بحاجة إلى الاستمرارية عبر عمليات إعادة البناء، فيجب عليك تثبيت الإضافة عبر خطافات app.yml وإعادة البناء بشكل صحيح.
5. مسح ذاكرة التخزين المؤقت لشبكة توصيل المحتوى (CDN) وذاكرة التخزين المؤقت للمتصفح (مهم جدًا)
بعد تطبيق التجاوز، قد تظل الرموز التعبيرية تظهر دون تغيير بسبب التخزين المؤقت.
5.1 مسح ذاكرة التخزين المؤقت لشبكة توصيل المحتوى (مثل Cloudflare)
إذا كنت تستخدم شبكة توصيل محتوى مثل Cloudflare:
وإلا، فقد يستمر تقديم ملفات PNG القديمة لـ Twemoji.
5.2 مسح ذاكرة التخزين المؤقت للمتصفح
على جانب العميل:
-
تحديث الصفحة بالقوة (Ctrl + F5 / Cmd + Shift + R)
-
أو مسح ذاكرة التخزين المؤقت للمتصفح
-
أو الاختبار في نافذة متصفح متخفية/خاصة
حتى يتم مسح ذاكرة التخزين المؤقت لكل من شبكة توصيل المحتوى والمتصفح، قد لا تظهر تغييرات الرموز التعبيرية.
6. ملخص
-
يمكن تثبيت وتطبيق إضافة التجاوز هذه دون إعادة بناء
-
التثبيت اليدوي مفيد لـ:
-
الاختبار
-
الاستخدام المؤقت
-
تصحيح الأخطاء
-
الجانب السلبي هو نقص الاستمرارية
-
امسح دائمًا ذاكرة التخزين المؤقت لشبكة توصيل المحتوى + ذاكرة التخزين المؤقت للمتصفح بعد تطبيق تجاوزات الرموز التعبيرية