توثيق شامل لمنصة GitHub

المميزات الرئيسية:

• استضافة مستودعات Git بشكل مجاني للمشاريع المفتوحة المصدر
• أدوات تعاونية متكاملة للفرق
• واجهة مستخدم رسومية سهلة الاستخدام
• تكامل مع أدوات التطوير المختلفة
• خدمات CI/CD مدمجة من خلال GitHub Actions
• إدارة المشاريع من خلال لوحات المشروع والمهام

خطوات إنشاء حساب:

1. زيارة موقع github.com
2. النقر على زر "Sign up" في الصفحة الرئيسية
3. إدخال البريد الإلكتروني، كلمة المرور، واسم المستخدم
4. إكمال اختبار التحقق
5. تأكيد البريد الإلكتروني
6. تخصيص الإعدادات (اختياري)

العناصر الرئيسية في واجهة GitHub:

• الصفحة الرئيسية (Dashboard):

  تعرض نشاط المستودعات التي تتابعها، والإشعارات، والاقتراحات.

• الملف الشخصي (Profile):

  يعرض معلوماتك، مستودعاتك، ومساهماتك في مشاريع أخرى.

• صفحة المستودع (Repository):

  تعرض محتويات المستودع، التاريخ، المشكلات، وطلبات السحب.

• الإشعارات (Notifications):

  تنبيهات عن النشاطات في المستودعات التي تتابعها أو تشارك فيها.

• الاستكشاف (Explore):

  اكتشاف مشاريع جديدة واتجاهات في عالم البرمجة.

خطوات إنشاء مستودع جديد:

1. انقر على زر "+" في الزاوية العلوية اليمنى، ثم اختر "New repository"
2. أدخل اسم المستودع (مطلوب)
3. أضف وصفاً اختيارياً للمستودع
4. اختر ما إذا كان المستودع عاماً أو خاصاً
5. حدد ما إذا كنت تريد إضافة ملف README، ملف .gitignore، أو ترخيص
6. انقر على "Create repository"

إعداد مستودع محلي وربطه بـ GitHub:

# إنشاء مستودع محلي جديد
git init

# إضافة الملفات للمستودع
git add .

# عمل أول التزام
git commit -m "الالتزام الأولي"

# ربط المستودع المحلي بمستودع GitHub
git remote add origin https://github.com/username/repository.git

# دفع الكود إلى GitHub
git push -u origin main

طرق استنساخ مستودع:

git clone https://github.com/username/repository.git

git clone [email protected]:username/repository.git

git clone -b branch-name https://github.com/username/repository.git

العمليات الأساسية للفروع:

git branch -a

git checkout -b new-branch-name

git push -u origin new-branch-name

git branch -d branch-name

git push origin --delete branch-name

إنشاء طلب سحب:

1. انتقل إلى صفحة المستودع على GitHub
2. انقر على تبويب "Pull requests"
3. انقر على زر "New pull request"
4. اختر الفرع الأساسي (الذي تريد الدمج فيه) والفرع المقارن (الذي يحتوي على تغييراتك)
5. راجع التغييرات وتأكد من صحتها
6. أضف عنواناً ووصفاً لطلب السحب
7. انقر على "Create pull request"

مراجعة طلب السحب:

• مراجعة التغييرات:

  فحص الكود المتغير، إضافة تعليقات على أسطر محددة، واقتراح تغييرات.

• إضافة مراجعة:

  يمكنك تقديم تعليق، الموافقة، أو طلب تغييرات.

• دمج طلب السحب:

  بعد الموافقة، يمكن دمج التغييرات في الفرع الأساسي.

إنشاء مشكلة جديدة:

1. انتقل إلى تبويب "Issues" في المستودع
2. انقر على زر "New issue"
3. اختر قالباً إذا كان متاحاً
4. أضف عنواناً ووصفاً للمشكلة
5. أضف تسميات، مهام، ومراحل إذا لزم الأمر
6. عين المشكلة لشخص معين (اختياري)
7. انقر على "Submit new issue"

إدارة المشكلات:

• التسميات (Labels):

  تصنيف المشكلات (مثل: خطأ، تحسين، وثائق).

• المراحل (Milestones):

  تجميع المشكلات في مراحل زمنية أو إصدارات.

• المهام (Projects):

  تنظيم المشكلات في لوحات مشاريع.

• التعيين (Assignment):

  تعيين المشكلة لشخص معين للعمل عليها.

أنواع المناقشات:

• أسئلة وأجوبة:

  طرح أسئلة ووضع علامة على الإجابات المقبولة.

• إعلانات:

  مشاركة تحديثات وإعلانات مع المجتمع.

• عام:

  مناقشات عامة حول المشروع.

• أفكار:

  اقتراح أفكار جديدة للمشروع.

أنواع لوحات المشاريع:

• المشاريع الكلاسيكية:

  النسخة الأصلية من لوحات المشاريع في GitHub.

• المشاريع (beta):

  النسخة المحسنة مع ميزات إضافية مثل العرض المخصص والحقول المخصصة.

إنشاء وإدارة لوحة مشروع:

1. انتقل إلى تبويب "Projects" في المستودع أو الملف الشخصي
2. انقر على "New project"
3. اختر قالباً (مثل: Kanban، Backlog، Bug triage)
4. أضف أعمدة حسب احتياجاتك (مثل: To do، In progress، Done)
5. أضف بطاقات للمهام أو اربط المشكلات وطلبات السحب الموجودة
6. اسحب البطاقات بين الأعمدة لتحديث حالتها

إنشاء وإدارة المراحل:

1. انتقل إلى تبويب "Issues" في المستودع
2. انقر على "Milestones"
3. انقر على "New milestone"
4. أضف عنواناً ووصفاً وتاريخ استحقاق (اختياري)
5. انقر على "Create milestone"
6. أضف المشكلات وطلبات السحب ذات الصلة إلى المرحلة

المفاهيم الأساسية:

• سير العمل (Workflow):

  عملية آلية قابلة للتكوين تتكون من واحد أو أكثر من الوظائف.

• الحدث (Event):

  نشاط محدد يؤدي إلى تشغيل سير العمل (مثل: دفع الكود، إنشاء طلب سحب).

• الوظيفة (Job):

  مجموعة من الخطوات التي تنفذ على نفس العامل.

• الخطوة (Step):

  مهمة فردية يمكن أن تنفذ أوامر أو إجراءات.

• الإجراء (Action):

  تطبيق مستقل يؤدي مهمة معقدة متكررة.

• العامل (Runner):

  خادم يقوم بتشغيل سير العمل.

مثال بسيط لملف سير عمل:

name: CI

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  build:
    runs-on: ubuntu-latest
    
    steps:
    - uses: actions/checkout@v2
    
    - name: Set up Node.js
      uses: actions/setup-node@v2
      with:
        node-version: '14'
        
    - name: Install dependencies
      run: npm ci
      
    - name: Run tests
      run: npm test

خطوات إنشاء سير عمل:

1. انتقل إلى تبويب "Actions" في المستودع
2. انقر على "New workflow"
3. اختر "set up a workflow yourself" لإنشاء ملف سير عمل من الصفر
4. قم بتحرير ملف YAML لتحديد الأحداث والوظائف والخطوات
5. انقر على "Start commit" لحفظ سير العمل

مميزات GitHub Pages:

• استضافة مجانية للمواقع الساكنة
• دعم للمواقع الشخصية والتنظيمية ومواقع المشاريع
• تكامل مباشر مع مستودعات GitHub
• دعم لنطاقات مخصصة
• دعم لمولدات المواقع الساكنة مثل Jekyll

خطوات تفعيل GitHub Pages:

1. انتقل إلى إعدادات المستودع (Settings)
2. اختر قسم "Pages" من القائمة الجانبية
3. حدد الفرع المصدر (Source branch) الذي يحتوي على ملفات الموقع
4. اختر المجلد (/ أو /docs)
5. انقر على "Save"
6. انتظر بضع دقائق حتى يتم نشر الموقع

خطوات إعداد نطاق مخصص:

1. أضف ملف CNAME في جذر المستودع يحتوي على اسم النطاق المخصص
2. انتقل إلى إعدادات GitHub Pages في المستودع
3. أدخل اسم النطاق المخصص في قسم "Custom domain"
4. قم بتكوين سجلات DNS لدى مزود النطاق الخاص بك:
• سجل A يشير إلى عناوين IP الخاصة بـ GitHub Pages
• أو سجل CNAME يشير إلى username.github.io

أنواع الأدوات في Marketplace:

• أدوات CI/CD
• أدوات مراجعة الكود
• أدوات الأمان والتدقيق
• أدوات إدارة المشاريع
• أدوات النشر والاستضافة
• أدوات المراقبة والتنبيه

كيفية استخدام GitHub Marketplace:

1. انتقل إلى Marketplace من القائمة العلوية في GitHub
2. تصفح الأدوات أو ابحث عن أداة محددة
3. اختر الأداة المناسبة واقرأ التفاصيل والتقييمات
4. انقر على "Install it for free" أو اختر خطة مدفوعة
5. اتبع خطوات التثبيت والتكوين

مميزات Codespaces:

• بيئة تطوير كاملة في المتصفح
• تكوين مخصص للبيئة باستخدام ملفات devcontainer.json
• تكامل مع VS Code
• مشاركة البيئة مع أعضاء الفريق
• تشغيل التطبيقات وعرضها مباشرة

مميزات Copilot:

• اقتراح أكواد بناءً على التعليقات والسياق
• دعم للعديد من لغات البرمجة
• تكامل مع محررات الأكواد الشائعة
• تحسين الإنتاجية وتسريع عملية التطوير

مميزات Discussions:

• فئات مخصصة للمناقشات
• تمييز الإجابات المقبولة
• تنظيم المناقشات بشكل منفصل عن المشكلات
• بناء مجتمع حول المشروع