Skip to content

INSTALLATION.md

Latest commit

 

History

History
261 lines (186 loc) · 8.09 KB

INSTALLATION.md

File metadata and controls

261 lines (186 loc) · 8.09 KB
Raw

دليل التثبيت

هذا الدليل سيساعدك في إعداد بيئتك للعمل مع منهج "علم البيانات للمبتدئين".

جدول المحتويات

المتطلبات الأساسية

قبل أن تبدأ، يجب أن تكون لديك:

  • معرفة أساسية باستخدام سطر الأوامر/الطرفية
  • حساب GitHub (مجاني)
  • اتصال إنترنت مستقر للإعداد الأولي

خيارات البدء السريع

الخيار الأول: GitHub Codespaces (موصى به للمبتدئين)

أسهل طريقة للبدء هي باستخدام GitHub Codespaces، الذي يوفر بيئة تطوير كاملة في متصفحك.

  1. انتقل إلى المستودع
  2. انقر على قائمة Code المنسدلة
  3. اختر علامة التبويب Codespaces
  4. انقر على Create codespace on main
  5. انتظر حتى يتم تهيئة البيئة (2-3 دقائق)

الآن أصبحت بيئتك جاهزة مع جميع التبعيات المثبتة مسبقًا!

الخيار الثاني: التطوير المحلي

للعمل على جهاز الكمبيوتر الخاص بك، اتبع التعليمات التفصيلية أدناه.

التثبيت المحلي

الخطوة الأولى: تثبيت Git

Git مطلوب لاستنساخ المستودع وتتبع تغييراتك.

Windows:

  • قم بالتنزيل من git-scm.com
  • قم بتشغيل المثبت بالإعدادات الافتراضية

macOS:

  • قم بالتثبيت عبر Homebrew: brew install git
  • أو قم بالتنزيل من git-scm.com

Linux:

# Debian/Ubuntu
sudo apt-get update
sudo apt-get install git

# Fedora
sudo dnf install git

# Arch
sudo pacman -S git

الخطوة الثانية: استنساخ المستودع

# Clone the repository
git clone https://github.com/microsoft/Data-Science-For-Beginners.git

# Navigate to the directory
cd Data-Science-For-Beginners

الخطوة الثالثة: تثبيت Python وJupyter

Python 3.7 أو أعلى مطلوب لدروس علم البيانات.

Windows:

  1. قم بتنزيل Python من python.org
  2. أثناء التثبيت، قم بتحديد خيار "Add Python to PATH"
  3. تحقق من التثبيت:
python --version

macOS:

# Using Homebrew
brew install python3

# Verify installation
python3 --version

Linux:

# Most Linux distributions come with Python pre-installed
python3 --version

# If not installed:
# Debian/Ubuntu
sudo apt-get install python3 python3-pip

# Fedora
sudo dnf install python3 python3-pip

الخطوة الرابعة: إعداد بيئة Python

يُوصى باستخدام بيئة افتراضية للحفاظ على التبعيات معزولة.

# Create a virtual environment
python -m venv venv

# Activate the virtual environment
# On Windows:
venv\Scripts\activate

# On macOS/Linux:
source venv/bin/activate

الخطوة الخامسة: تثبيت مكتبات Python

قم بتثبيت مكتبات علم البيانات المطلوبة:

pip install jupyter pandas numpy matplotlib seaborn scikit-learn

الخطوة السادسة: تثبيت Node.js وnpm (لتطبيق الاختبارات)

تطبيق الاختبارات يتطلب Node.js وnpm.

Windows/macOS:

  • قم بالتنزيل من nodejs.org (يُوصى بالإصدار LTS)
  • قم بتشغيل المثبت

Linux:

# Debian/Ubuntu
# WARNING: Piping scripts from the internet directly into bash can be a security risk.
# It is recommended to review the script before running it:
#   curl -fsSL https://deb.nodesource.com/setup_lts.x -o setup_lts.x
#   less setup_lts.x
# Then run:
#   sudo -E bash setup_lts.x
#
# Alternatively, you can use the one-liner below at your own risk:
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# Fedora
sudo dnf install nodejs

# Verify installation
node --version
npm --version

الخطوة السابعة: تثبيت تبعيات تطبيق الاختبارات

# Navigate to quiz app directory
cd quiz-app

# Install dependencies
npm install

# Return to root directory
cd ..

الخطوة الثامنة: تثبيت Docsify (اختياري)

للوصول إلى الوثائق دون اتصال:

npm install -g docsify-cli

التحقق من التثبيت

اختبار Python وJupyter

# Activate your virtual environment if not already activated
# On Windows:
venv\Scripts\activate
# On macOS/Linux:
source venv/bin/activate

# Start Jupyter Notebook
jupyter notebook

يجب أن يفتح المتصفح بواجهة Jupyter. يمكنك الآن التنقل إلى أي ملف .ipynb من الدروس.

اختبار تطبيق الاختبارات

# Navigate to quiz app
cd quiz-app

# Start development server
npm run serve

يجب أن يكون تطبيق الاختبارات متاحًا على http://localhost:8080 (أو منفذ آخر إذا كان 8080 مشغولًا).

اختبار خادم الوثائق

# From the root directory of the repository
docsify serve

يجب أن تكون الوثائق متاحة على http://localhost:3000.

استخدام حاويات التطوير في VS Code

إذا كان لديك Docker مثبتًا، يمكنك استخدام حاويات التطوير في VS Code:

  1. قم بتثبيت Docker Desktop
  2. قم بتثبيت Visual Studio Code
  3. قم بتثبيت الإضافة Remote - Containers
  4. افتح المستودع في VS Code
  5. اضغط على F1 واختر "Remote-Containers: Reopen in Container"
  6. انتظر حتى يتم بناء الحاوية (فقط في المرة الأولى)

الخطوات التالية

  • استكشف README.md للحصول على نظرة عامة على المنهج
  • اقرأ USAGE.md للحصول على أمثلة وسير العمل الشائعة
  • تحقق من TROUBLESHOOTING.md إذا واجهت مشاكل
  • راجع CONTRIBUTING.md إذا كنت ترغب في المساهمة

الحصول على المساعدة

إذا واجهت مشاكل:

  1. تحقق من دليل TROUBLESHOOTING.md
  2. ابحث في مشاكل GitHub الحالية
  3. انضم إلى مجتمع Discord الخاص بنا
  4. قم بإنشاء مشكلة جديدة مع معلومات مفصلة حول مشكلتك

إخلاء المسؤولية:
تم ترجمة هذا المستند باستخدام خدمة الترجمة بالذكاء الاصطناعي Co-op Translator. بينما نسعى لتحقيق الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو معلومات غير دقيقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الرسمي. للحصول على معلومات حاسمة، يُوصى بالاستعانة بترجمة بشرية احترافية. نحن غير مسؤولين عن أي سوء فهم أو تفسيرات خاطئة ناتجة عن استخدام هذه الترجمة.