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

3 دقيقة

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

  1. مقدمة
  2. الإعداد العام
  3. الإعداد المحلي
  4. الخاتمة

مقدمة

إعداد Git يسمح بتعريف المعاملات العامة أو المحلية لمشروع Git. عندما تنشئ مشروعاً وتحفظه في مستودع محلي، من الضروري تحديد اسم المؤلّف وعنوان بريده. يمكن تخزين هذه المعلومات في ملف إعداد يكون عاماً أو محلياً.

⬆️ العودة إلى جدول المحتويات


1 - الإعداد العام

ملف الإعداد العام مشترك بين كل مشاريع Git على النظام المحلي نفسه. إن لم يُعرَّف إعداد محلي، يستخدم Git الإعداد العام. يُنشأ ملف .gitconfig في مجلد المستخدم.

مثال: إنشاء اسم مستخدم وعنوان بريد في ملف الإعداد العام

1.1- إيجاد دليل المستخدم

نفّذ الأمر التالي لتحديد موقع دليل المستخدم:

bash
echo $HOME

1.2- إنشاء ملف إعداد عام وتعريف مؤلّف

استخدم الأوامر التالية لإنشاء ملف إعداد عام (ملف .gitconfig في دليل المستخدم) وتعريف اسم وعنوان بريد للمؤلّف:

bash
git config --global user.name "Haythem"
git config --global user.email "rehoumahaythem@gmail.com"

1.3- التحقق من ملف الإعداد

بعد تنفيذ هذه الأوامر، يمكنك التحقق من محتوى ملف .gitconfig بالأمر التالي:

bash
cat ~/.gitconfig

سيشبه محتوى ملف .gitconfig هذا:

[user]
    name = Haythem
    email = rehoumahaythem@gmail.com

⬆️ العودة إلى جدول المحتويات


2 - دراسة حالة 1: الإعداد العام

السياق:

هيثم مطوّر برمجيات ويعمل على مشروع اسمه MyProj على حاسوبه المحمول. يستخدم Git لإدارة مستودع مشروعه. يريد هيثم تعريف اسمه وعنوان بريده في الإعداد العام حتى تُسجَّل مساهماته بشكل صحيح.

الحل:

  1. تهيئة مستودع Git لمشروع MyProj:

    bash
    cd MyProj
    git init
  2. تعريف اسم المؤلّف والبريد على المستوى العام:

    bash
    git config --global user.name "Haythem"
    git config --global user.email "haythem@gmail.com"
  3. إنشاء ملف مشروع (مثال: myfile_1.txt):

    bash
    touch myfile_1.txt
  4. التحقق من حالة Git للملف (سيُعلَّم كغير متتبَّع):

    bash
    git status
  5. إضافة التغييرات وإيداعها:

    bash
    git add myfile_1.txt
    git commit -m "Ajout du fichier myfile_1.txt"
  6. التحقق من سجل الإيداعات:

    bash
    git log

    سيُظهر السجل المؤلّف باسم "Haythem" وعنوان البريد المرتبط.

⬆️ العودة إلى جدول المحتويات


3 - الإعداد المحلي

الإعداد المحلي خاص بمشروع Git معيّن. إن عمل عدة مطوّرين على الجهاز نفسه، يمكن لكل مشروع أن يملك معاملات اسم وبريد خاصة به. يُخزَّن الإعداد المحلي في ملف .git/config للمشروع.

مثال: إنشاء اسم مستخدم وعنوان بريد في الإعداد المحلي

الخطوة 1: تهيئة مشروع Git

bash
cd LocalConfigProj
git init

الخطوة 2: تعريف اسم المؤلّف والبريد على المستوى المحلي

استخدم الأوامر التالية لتعريف اسم المؤلّف وعنوان البريد الخاصين بهذا المشروع:

bash
git config --local user.name "Haythem Local"
git config --local user.email "localhaythem@gmail.com"

الخطوة 3: التحقق من ملف الإعداد المحلي

سيحتوي ملف .git/config للمشروع على:

[user]
    name = Haythem Local
    email = localhaythem@gmail.com

⬆️ العودة إلى جدول المحتويات


4 - دراسة حالة 2: الإعداد المحلي

السياق:

يجب على هيثم الآن العمل على خادم تطوير يتعاون عليه عدة مطوّرين. لا يريد استخدام الإعداد العام، بل يفضّل تعريف اسم وعنوان بريد خاصين بالمشروع حتى تُسجَّل مساهماته بشكل صحيح.

الحل:

  1. تهيئة مستودع Git لمشروع LocalConfigProj:

    bash
    cd LocalConfigProj
    git init
  2. تعريف اسم المؤلّف والبريد على المستوى المحلي:

    bash
    git config --local user.name "Haythem_dev"
    git config --local user.email "dev_haythem@company.com"
  3. إنشاء ملف مشروع (مثال: myfile_1.txt):

    bash
    touch myfile_1.txt
  4. التحقق من حالة Git للملف:

    bash
    git status
  5. إضافة التغييرات وإيداعها:

    bash
    git add myfile_1.txt
    git commit -m "Ajout du fichier myfile_1.txt"
  6. التحقق من سجل الإيداعات:

    bash
    git log

    سيُظهر السجل المؤلّف باسم "Haythem_dev" مع البريد المقابل.

⬆️ العودة إلى جدول المحتويات


5 - الخاتمة

إعداد Git خطوة أساسية لضمان نسبة كل إيداع إلى المؤلّف بالمعلومات المناسبة. يمكن إعداد Git على المستوى العام أو المحلي، حسب سياق التطوير. الإعداد العام مفيد للمشاريع الشخصية أو على جهاز مخصَّص، بينما الإعداد المحلي عملي عندما يتشارك عدة مطوّرين البيئة نفسها. أراك هذا الدرس كيف تعدّ Git على المستويين العام والمحلي، مع دراسات حالة توضّح سيناريوهات الاستخدام المختلفة.

⬆️ العودة إلى جدول المحتويات