التثبيت على macOS
المتطلبات والتثبيت والاستخدام اليومي على جهاز Mac.
الحالة: متاح من الشيفرة المصدرية. اختُبر على جهاز Mac بمعالج Apple Silicon، بما في ذلك المشاركة مع جهاز Android لوحي على شبكة Wi-Fi نفسها. لا يوجد تطبيق جاهز — يعمل RTW من الطرفية.
المتطلبات
- macOS على Apple Silicon أو Intel
- أدوات سطر أوامر Xcode — توفّر
gitوPython 3 (xcode-select --install) - Homebrew
- مساحة تخزين للمحتوى (راجع تجهيز مكتبتك)
التثبيت
git clone https://github.com/eslam-mahmoud/reinvent-the-wheel.git
cd reinvent-the-wheel
./rtw setup
./rtw startيقوم ./rtw setup بما يلي:
- يثبّت nginx عبر Homebrew إن لم يكن موجودًا.
- ينزّل kiwix-tools الخاصة بـmacOS من Kiwix إلى
state/bin. - ينزّل ملفات JavaScript والخطوط والأيقونات الخاصة بعارض الخرائط إلى
web/vendor. - يكتب الإعدادات في
state/conf، وينشئ شهادة HTTPS موقّعة ذاتيًا ومجلدات المحتوى. - يطلب كلمة مرور للمشرف.
يمكن تشغيله مجددًا بأمان؛ فهو لا يمسّ محتواك ولا كلمة المرور.
أين توجد الأشياء
| المسار | المحتوى |
|---|---|
content/ |
مكتبتك — مجلد لكل قسم |
state/conf/ |
الإعدادات المولَّدة وشهادة HTTPS وبصمة كلمة المرور |
state/logs/ |
السجلات (./rtw logs admin، ./rtw logs kiwix) |
العناوين
| العنوان | الاستخدام |
|---|---|
http://127.0.0.1:8080 |
على جهاز Mac نفسه |
http://<mac-ip>:8080 |
الأجهزة الأخرى على شبكة Wi-Fi نفسها |
https://<mac-ip>:8443 |
العنوان نفسه عبر HTTPS — مطلوب لعرض الموقع على صفحة الخريطة |
التحديث
./rtw updateيجلب أحدث إصدار من GitHub ويعيد تشغيل الخدمات.
القيود
- يجب أن يبقى Mac مستيقظًا أثناء تقديم المكتبة. امنع السكون من إعدادات النظام، أو شغّل
caffeinate -dفي طرفية أخرى. - قد يطلب macOS السماح باتصالات واردة لـnginx في أول مرة تتصل فيها أجهزة أخرى.