From a32c1b0f28cd8ccebeb019edbcf9a6d7681c2b5c Mon Sep 17 00:00:00 2001
From: ghaymah_dev <hr@ghaymah.systems>
Date: Sun, 1 Mar 2026 08:07:04 +0000
Subject: [PATCH] Add setup-as-default.md

---
 setup-as-default.md | 72 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 72 insertions(+)
 create mode 100644 setup-as-default.md

diff --git a/setup-as-default.md b/setup-as-default.md
new file mode 100644
index 0000000..02c3767
--- /dev/null
+++ b/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` بالبحث في سجل غيمة تلقائيًا.
\ No newline at end of file