تغطي هذه الدليل تعليمات التثبيت لبيئة التطوير على نظام macOS، وللاطلاع على أدلة الإنتاج يرجى الرجوع إلى: Install Discourse in production with the official supported instructions
إذن، تريد إعداد Discourse على macOS للتجربة والتطوير؟
سنفترض أنك لم تقم بتثبيت Ruby/Rails/Postgres/Redis على جهاز Mac الخاص بك بعد. لنبدأ
!
تثبيت تبعيات Discourse
ستحتاج إلى الحزم التالية على نظامك:
- Git
- rbenv أو asdf
- ruby-build
- Ruby (آخر إصدار مستقر)
- Rails
- PostgreSQL
- SQLite
- Redis
- Node.js
- pnpm
- libvips
- MailHog**
- ImageMagick**
** اختياري
أعد تشغيل الطرفية (Terminal)
الآن وبعد أن قمنا بتثبيت تبعيات Discourse، لننتقل إلى تثبيت Discourse نفسه.
أعد تشغيل الطرفية (Terminal)
إنهاء جلسة shell وإعادة تشغيلها يضمن أن يتم التقاط المسارات للحزم المثبتة بشكل صحيح بواسطة الطرفية.
استنساخ (Clone) مستودع Discourse
قم باستنساخ مستودع Discourse في مجلد ~/discourse:
git clone https://github.com/discourse/discourse.git ~/discourse
رمز ~ يشير إلى المجلد الرئيسي (Home folder)، لذا سيكون كود مصدر Discourse متاحًا في مجلدك الرئيسي.
تهيئة (Bootstrap) Discourse
انتقل إلى مجلد Discourse الخاص بك:
cd ~/discourse
قم بتثبيت الجواهر (gems) المطلوبة
bundle install
قم بتثبيت تبعيات JS
pnpm install
بعد ذلك، نفّذ هذه الأوامر لإعداد نسخة Discourse المحلية لديك:
bundle exec rake db:create
bundle exec rake db:migrate
RAILS_ENV=test bundle exec rake db:create db:migrate
ابدأ خوادم Rails + Ember، لديك خياران هنا.
الخيار 1: باستخدام تبويبات/نوافذ طرفية منفصلة، شغّل Rails ومجمّع الواجهة الأمامية (frontend bundler) بشكل منفصل عبر
bundle exec rails server
و
bin/dev --only ember
الخيار 2: باستخدام تبويب/نافذة طرفية واحدة فقط:
bin/dev # يشغّل Pitchfork ومجمّع الواجهة الأمامية معًا
يجب أن تكون قادرًا الآن على الانتقال إلى http://localhost:3000 لرؤية تثبيت Discourse المحلي لديك. (لاحظ أن التحميل الأول قد يستغرق حتى دقيقة واحدة بينما يتم تسخين الخادم.)
يمكنك أيضًا محاولة تشغيل الاختبارات (specs):
bundle exec rake autospec
يجب أن تمر جميع الاختبارات (أو تقريبًا جميعها).
إنشاء مدير جديد
لإنشاء مدير جديد، نفّذ الأمر التالي:
RAILS_ENV=development bundle exec rake admin:create
اتبع التعليمات لإنشاء حساب مدير.
تكوين البريد الإلكتروني
شغّل MailHog:
mailhog
تهانينا! أنت الآن مدير تثبيت Discourse الخاص بك!
بالتوفيق في التطوير! ولابدء ذلك، راجع دليل المبتدئين لإنشاء إضافات Discourse.
هذا المستند خاضع لرقابة الإصدارات - اقترح تغييرات على github.