Add setup-as-default.md

setup-as-default.md

@@ -0,0 +1,72 @@
+
+بسم الله الرحمن الرحيم
+
+
+إليك كيفية إعداد ملف `pip.conf` لجعل سجل "غيمة" هو المصدر الافتراضي:
+
+## 📝 إعداد ملف pip.conf
+
+يعتمد مسار هذا الملف على نظام التشغيل الخاص بك. اختر النظام المناسب أدناه:
+
+### 1. على أنظمة Linux و macOS
+يتم وضع الملف عادةً في المسار `~/.config/pip/pip.conf`. إذا لم يكن المجلد موجودًا، يمكنك إنشاؤه.
+
+أو يمكنك وضعه في المجلد الرئيسي `~/.pip/pip.conf` (للإصدارات القديمة).
+
+### 2. على نظام Windows
+يتم وضع الملف في المسار `%APPDATA%\pip\pip.ini`.
+
+---
+
+### ⚙️ محتوى الملف
+
+بما أن سجل "غيمة" هو سجل خاص (Private Registry)، يفضل إضافة `trusted-host` لتجنب مشاكل شهادات SSL ولتعريف الجهاز بأن هذا المستضيف موثوق.
+
+افتح الملف `pip.conf` (أو `pip.ini`) وأضف الأسطر التالية:
+
+```ini
+[global]
+index-url = https://pypi.ghaymah.systems/simple/
+trusted-host = pypi.ghaymah.systems
+```
+
+**توضيح الإعدادات:**
+*   `index-url`: يحدد أن أي أمر `pip install` سيبحث تلقائيًا في سجل غيمة بدلاً من PyPI العالمي.
+*   `trusted-host`: يخبر `pip` بالوثوق في هذا النطاق، وهو ضروري إذا كان السجل يستخدم شهادات داخلية أو HTTP (رغم أن الرابط يستخدم HTTPS، فهذا الإعداد يمنع بعض التحذيرات).
+
+---
+
+### 🔐 إضافة بيانات الاعتماد تلقائيًا
+
+إذا كنت لا تريد إدخال اسم المستخدم وكلمة المرور في كل مرة تطلب فيها حزمة، يمكنك تضمينها داخل الرابط في ملف الإعداد (مع مراعاة الحيطة من كشف كلمة المرور في الأجهزة المشتركة):
+
+```ini
+[global]
+index-url = https://myuser:mypassword@pypi.ghaymah.systems/simple/
+trusted-host = pypi.ghaymah.systems
+```
+
+*(استبدل `myuser` و `mypassword` بالبيانات التي حصلت عليها من فريق الدعم).*
+
+---
+
+### 🔄 السيناريو المختلط: الاستخدام مع PyPI العالمي
+
+إذا كنت تريد استخدام سجل "غيمة" للحزم الخاصة بك، مع الحفاظ على القدرة على تحميل الحزم العامة من PyPI، يفضل استخدام `extra-index-url` بدلاً من `index-url` ليبحث في كلا السجلين:
+
+```ini
+[global]
+# يبحث هنا أولاً (غيمة)
+index-url = https://myuser:mypassword@pypi.ghaymah.systems/simple/
+# إذا لم يجد الحزمة، يبحث هنا (PyPI الرسمي)
+extra-index-url = https://pypi.org/simple
+trusted-host = pypi.ghaymah.systems
+```
+
+بعد حفظ هذا الملف، يمكنك ببساطة تشغيل:
+
+```bash
+pip install my-package
+```
+
+وسيقوم `pip` بالبحث في سجل غيمة تلقائيًا.