أنشئ مستودع الدورة وميّز بين استنساخه وفتحه

• تهيئة أول مستودع للدورة داخل GitTree مع اختيار main صراحةً.
• فهم وجود اسم فرع دون أول إيداع.
• حفظ الهوية الخيالية في مستودع الدورة وحده.
• استنساخ المستودع الفارغ نفسه إلى مجلد منفصل وفحص origin.
• إعادة فتح الأصل دون نسخه أو إنشاء إيداع.

ابدأ من حيث انتهى الدرسان الثاني والثالث: يعمل Git، ولا يوجد مستودع للدورة بعد. عاينّا الهوية في الدرس الثاني ولم نحفظها عالميًا. اختر مجلدًا أبًا موجودًا وقابلًا للكتابة، مخصصًا للدورة. يجب أن يكون مجلد gittree-features الفرعي جديدًا أو فارغًا، وخارج مستودعات المصدر القائمة. لا تهيّئ المشروع داخل مستودع الويب هذا أو عملك الشخصي.

الحد الأدنى المقروء لـ GitTree هو Git 2.39.0. سُجّلت الأوامر واللقطات في الفيديو باستخدام Git 2.52.0 وGitTree 2.0 على Ubuntu 24.04 داخل مجلد منزل خاص، وجرت الفحوص في هذا الدرس على المستودعات التي أنشأها التسجيل. لم تُنفَّذ على macOS أو Windows. تستخدم الاختصارات Command على macOS وCtrl على Windows وLinux، ويختلف شكل نافذة اختيار المجلدات في النظام من نظام إلى آخر ولم نصوّرها.

بعد تسجيل الدخول إلى GitTree لا تحتاج هذه العمليات المحلية إلى تكامل مضيف أو Pro أو تجربة: تشملها الخطة المجانية. نستخدم عنوان file:// على الجهاز نفسه، لا GitLab مستضافًا ولا مفتاح Claude.

التهيئة تنشئ بيانات مستودع Git في مجلد تختاره، لكنها لا تنشئ إيداعًا لمجرد ظهور اسم الفرع. للمستودع العادي مجلد عمل وفهرس خالٍ في البداية. يمكن أن يشير HEAD رمزيًا إلى refs/heads/main قبل وجود إيداع عند طرف ذلك الفرع.

الاستنساخ ينشئ مستودعًا منفصلًا من مصدر. في الحالة المعتادة ينسخ التاريخ المتاح ويستخرج الفرع المختار، ويضبط بعيدًا يسمى origin. مصدرنا هنا فارغ عمدًا، فلا يوجد تاريخ أو ملفات عمل لينسخها. هذه حالة صحيحة وليست فشل رفع.

الفتح يختار مستودعًا قائمًا لفحصه في GitTree. فتح علامة تبويب لا ينسخ ملفاته ولا ينشئ إيداعًا ولا يربطه تلقائيًا بمضيف. قد يحفظ التطبيق بيانات حديثة أو مساحة عمل ويفحص الثقة بصورة مستقلة.

شبّه الأفعال بإنشاء دفتر جديد، ونسخة منفصلة منه، ووضع دفتر موجود أمامك. لكن التشبيه لا يحدد الصلاحيات: قد تشغّل إعدادات المستودع أو خطّافاته برامج، ولذلك توجد مراجعة ثقة.

المستودع المجرّد يحفظ التاريخ دون ملفات عمل عادية، وله استخدام لاحق في سيناريوهات الخادم؛ ليس مناسبًا لبناء صفحة الدورة. اختيار قالب تجاهل أو ترخيص سيضيف ملفات غير مُودَعة، لذا نرفض القوالب هنا.

راجع مرجع التهيئة ومرجع الاستنساخ. يفرض التطبيق شروطًا على المجلد الوجهة أشد من قدرة Git الأصلي على إعادة التهيئة؛ لا تستخدم الطرفية لتجاوز رفض يحمي محتوى قائمًا دون فهمه.

الأسماء الدقيقة في المصدر الحالي: بطاقة تهيئة (Init)، ثم نافذة تهيئة مستودع (Initialize a repository)، وزر تهيئة (Initialize). الصياغة القديمة “Init a repository” كانت وصفًا للإجراء لا نص زر حالي.

1. افتح علامة تبويب جديدة (New Tab) بـ Command+T أو Ctrl+T (tab.new). تظهر بطاقات فتح (Open) واستنساخ (Clone) وتهيئة.
2. اختر تهيئة (Init). تظهر تهيئة مستودع (Initialize a repository) دون كتابة قبل الإرسال. البديل: لوحة الأوامر… (Command Palette…) بـ Command+Shift+P أو Ctrl+Shift+P → تهيئة مستودع… (Initialize Repository…، repo.init). لا نفترض اختصارًا مباشرًا آخر للتهيئة.
3. في الموقع (Location) أدخل المسار الكامل إلى gittree-features تحت المجلد الأب المخصص. أو استخدم استعراض… (Browse…) ثم منتقي النظام بعنوان اختر مكان إنشاء المستودع (Choose where to create the repository). لا نفترض أسماء أزرار النظام؛ افحص قيمة الموقع النهائية.
4. اكتب main في الفرع الأولي (Initial branch). أبقِ مستودع مجرّد (السجل فقط، بلا ملفات عمل) غير محدد.
5. اجعل قالب .gitignore (.gitignore template) والترخيص (Licence) على بلا (None) حين تُحمَّل عناصر القوالب. الافتراضي دون اختيار؛ لا تضف ملفات يدويًا إذا لم تظهر العناصر. أبقِ الفتح بعد الإنشاء (Open after creating) مفعّلًا.
6. راجع المسار والفرع وإيقاف المجرّد ورفض القوالب، ثم اختر تهيئة (Initialize) مرة واحدة. يُنشأ المستودع ويفتح، وربما يمر بمراجعة الثقة المعتادة. لا تكرر الإرسال أثناء الانتظار.
7. إذا ظهرت الوثوق بهذا المستودع؟ (Trust this repository?) فافحص المسار والنتائج الفعلية. إلغاء (Cancel) يتركه مغلقًا، وفتح في الوضع المقيَّد (Open in Restricted Mode) يحد الإجراءات، والوثوق والفتح (Trust and Open) يسمح بالإعدادات والخطّافات المعتادة. اختر الأخير لهذا المشروع الذي أنشأته فقط بعد فهم النتائج؛ لم تظهر نافذة الثقة في التسجيل للمجلد الجديد؛ فلا تتوقعها مع كل مستودع جديد.
8. تأكد من أن علامة التبويب تخص الأصل gittree-features، لا الأب أو النسخة. يبقى الرسم دون إيداع؛ لا تنشئ إيداعًا زائدًا لإخفاء الحالة الخالية.

حفظ الهوية في المستودع وحده

1. مع نشاط الأصل افتح التفضيلات (Preferences)، Command+, أو Ctrl+, (app.preferences.open).
2. في قسم المستودعات اختر gittree-features. هذا اسم ديناميكي، لا صفحة ملفات التعريف العامة. في منتقي الصفحات الضيق يكون النص خاصة بالمستودع: gittree-features.
3. عند الاسم في الإيداعات (Name for commits) (repo.userName، والمفتاح الأصلي user.name) افحص يكتب في (Writes to) واختر محلي (هذا المستودع)، لا عام (كل المستودعات).
4. اكتب GitTree Demo ثم تطبيق (Apply)، أو اضغط Enter في الحقل. انتظر حالة الحفظ قبل المتابعة.
5. كرّر ذلك عند البريد الإلكتروني في الإيداعات (Email for commits) (repo.userEmail، والمفتاح user.email) بالقيمة demo@example.com وعلى المستوى المحلي نفسه. طبّق وانتظر.
6. اختر الخروج من التفضيلات (Exit Preferences). يبقى المستودع الأصلي نشطًا وسجله خاليًا؛ تغير إعداد الهوية لا ملفات العمل أو الرسم.

الكتابة وحدها مسودة. يلغِي Escape في حقل معدّل تلك المسودة أولًا، وليس اختصارًا مضمونًا للخروج من كل شيء. اختيار النطاق ثم التطبيق هو الفرق عن معاينة الدرس الثاني الملغاة.

استبدل <course-parent> بمسار الأب المطلق المخصص لك، وأبقِ الاقتباس حول المسارات. نفّذ بعد التهيئة داخل التطبيق، لا في مستودع الويب:

cd "<course-parent>/gittree-features"
git rev-parse --is-inside-work-tree
git rev-parse --is-bare-repository
git symbolic-ref --short HEAD

النتائج المرصودة بالترتيب:

true
false
main

تحقّق من غياب الإيداع:

git rev-parse --verify --quiet HEAD

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

افحص حالة الملفات والفهرس وأسماء المراجع البعيدة:

git status --short
git ls-files
git remote

كل أمر خرج بالحالة 0 دون ناتج في نسخة الفحص. لا يثبت ذلك وحده غياب كل ملف مُتجاهَل. افتح المجلد المخصص في مدير الملفات مع إظهار العناصر المخفية: ينبغي أن توجد بيانات .git دون ملفات مشروع. لا تحرّر محتويات .git.

اقرأ حقلي الهوية المحليين فقط:

git config --local --get user.name
git config --local --get user.email

الناتج:

GitTree Demo
demo@example.com

لا نحتاج إلى عرض إعدادات شخصية أو عامة.

البديل الأصلي — لا بداية ثانية للمشروع

لنسخة مقارنة مؤقتة منفصلة، أو لمن يدرس Git دون التطبيق:

cd "<course-parent>"
git init --quiet --initial-branch=main --template= gittree-features

خرج الأمر بالحالة 0 دون ناتج في الفحص المعزول. لا تعِد تنفيذه على الأصل المنشأ داخل GitTree. خيار قالب Git الفارغ يختلف عن قائمتَي تجاهل الملفات والترخيص في التطبيق. تبقى القوالب والإعدادات الموروثة على جهازك بحاجة إلى مراجعة.

إذا استخدمت الطرفية بدل صف الهوية في التطبيق، اختر المستودع الجديد أولًا ثم اكتب محليًا عمدًا:

cd "<course-parent>/gittree-features"
git config --local user.name "GitTree Demo"
git config --local user.email demo@example.com

كانت الكتابتان ناجحتين دون ناتج في الفحص. هما بديل عن خطوة التطبيق، لا دليل على أن تسجيل التطبيق نُفّذ.

نستخدم المشروع نفسه، لا تطبيقًا تجريبيًا آخر. يبقى الأصل نقطة استمرار الدورة ويجب العودة إليه قبل الدرس الخامس. هذه الخطوة لا تضيف بعيدًا إلى الأصل.

في GitTree

1. افتح علامة تبويب جديدة ثم استنساخ (Clone). البديل في لوحة الأوامر استنساخ مستودع… (Clone Repository…، repo.clone). تظهر نافذة استنساخ مستودع (Clone Repository).
2. اختر الاستنساخ عبر URL. في عنوان URL للمستودع أدخل عنوان الأصل المطلق، مثل file:///absolute/course-parent/gittree-features بعد استبداله بمسارك الفعلي. يقبل محلل التطبيق عنوان file مطلقًا لا مسارًا خامًا. استخدم مسارًا بسيطًا دون مسافات في أول تدريب؛ لترميز URL وصيغة محركات Windows فحص منفصل.
3. اختر الأب الموجود في المجلد الأصل، واكتب gittree-features-copy صراحةً في اسم المجلد. افحص يُستنسخ إلى؛ يجب أن يشير إلى النسخة لا الأصل.
4. اترك العمق فارغًا للتاريخ الكامل، وأبقِ استنساخ الوحدات الفرعية أيضًا واستخراج جزئي: ملفات المستوى الأعلى فقط في البداية، ثم المجلدات التي تختارها وتنزيل محتوى الملفات عند الحاجة إليه فقط (blobless) معطلة. أبقِ الفتح بعد الاستنساخ مفعّلًا؛ لا تختَر خيارات متقدمة هنا.
5. اختر استنساخ (Clone) مرة واحدة. يظهر تقدم فعلي أو اكتمال سريع للمصدر الخالي، ثم تُفتح النسخة عبر مراجعة الثقة عند الحاجة. لا نشترط ظهور كل مرحلة تقدم لعملية صغيرة كهذه.
6. افحص الرسم الخالي واستعلامات الطرفية الآتية. يخص origin النسخة ويشير إلى الأصل. ضبط بعيد لا يعني وجود طرف فرع تتبّع بعيد أو منصة استضافة.
7. عد إلى الأصل عبر فتح (Open) من علامة جديدة أو فتح مستودع… (Open Repository…، repo.open)، Command+O أو Ctrl+O، ثم اختر مجلد الأصل وراجع الثقة عند الحاجة. استخدم التسجيل بدلًا من ذلك زر فتح في صف الأصل ضمن الأخيرة في علامة التبويب الجديدة، وفتحه بالطريقة نفسها؛ ولم نصوّر نافذة اختيار المجلدات. البديل إسقاط مجلد الأصل على سطح إسقاط المجلد في علامة التبويب الجديدة (لم يُصوَّر). لا نفترض هل يعيد الإصدار استخدام تبويب أو ينشئ آخر.
8. اترك النسخة الإضافية دون تعديل؛ لا يلزم حذفها. تأكد من غياب البعيد في الأصل ومن هويته المحلية قبل الدرس الخامس.

المقارنة الأصلية والنتيجة

من الأب المخصص، في لقطة منفصلة لا توجد وجهتها مسبقًا:

git clone --quiet "file://<absolute-source-path>" gittree-features-copy

يبدأ <absolute-source-path> بـ / في تسجيل macOS، فتكون بعد file: ثلاث شرطات مائلة. استبدل العنصر النائب ولا تكتب الأقواس. خرج الأمر بالحالة 0، وطبع على قناة stderr:

warning: You appear to have cloned an empty repository.

افحص النسخة:

cd "<course-parent>/gittree-features-copy"
git remote
git symbolic-ref --short HEAD
git config --local --get user.name

نتيجتا الأمرين الأولين:

origin
main

لا يطبع الاستعلام الأخير شيئًا ويخرج بالحالة 1؛ لم ينسخ الاستنساخ إعداد الاسم المحلي من الأصل. قد توفر إعداداتك العامة هوية فعالة على جهازك، لكن السؤال المحلي يقرأ النسخة وحدها. لا نعرض الإعدادات العامة على الكاميرا ولا نُودِع شيئًا في النسخة.

في نهاية هذا الدرس يكون الأصل مستودعًا عاديًا، وHEAD رمزيًا إلى main دون إيداع، ولا ملفات مشروع أو بعيد. الفهرس خالٍ منطقيًا، والهوية المحلية GitTree Demo / demo@example.com. أما النسخة الإضافية فلها origin دون تاريخ وتبقى خارج نقطة استمرار المشروع.

يبقى الرسم خاليًا عمدًا. ينشئ الدرس الخامس ملفي README.md وindex.html وأول إيداع مقصود.

• اختيار الأب بدل الابن: افحص الموقع والتبويب النشط قبل حفظ الإعداد.
• تشغيل وضع المجرّد: لا يوفر ملفات العمل اللازمة لصفحة الدورة.
• اختيار القوالب: تضيف ملفات غير مُودَعة خارج نقطة البداية الخالية.
• اعتبار HEAD دون إيداع فاسدًا: الحالة طبيعية بعد التهيئة.
• الاستنساخ فوق الأصل: استخدم وجهة جديدة أو فارغة منفصلة.
• توقّع نسخ الهوية المحلية: التاريخ يُنسخ، لا إعدادات الاسم والبريد المحلية للأصل.
• متابعة الدورة في النسخة: وجود origin يجعلها تختلف عن الأصل المحدد.

رفض وجهة غير فارغة يحمي محتواها. اختر ابنًا جديدًا دون حذف الملفات لإسكات الرسالة. أما غياب المجلد الأب فيحتاج إلى اختيار أب موجود أو إنشائه عمدًا قبل المحاولة.

إذا وجد مستودع سابق فافتحه وافحصه بدل إعادة تهيئته. وإن كان عملًا غير متعلق بالدورة فاتركه واستخدم مجلدًا منفصلًا.

عند فشل الاستنساخ اقرأ الخطأ ونتيجة التنظيف الحقيقية. يميّز التطبيق بين مجلد أنشأته العملية وأزالته، ومجلد سابق احتُفظ به، ومحتوى غير متوقع، وفشل الإزالة. إلغاء الاستنساخ يطلب التوقف ولا يثبت زوال كل شيء. افحص ما بقي قبل حذفه. التحذير من مصدر فارغ ليس فشلًا وحده.

عند نتائج ثقة غير مفهومة اختر الإلغاء أو الوضع المقيّد. لا تثق بمستودع عشوائي لمجرد إكمال الدرس؛ يعطل التقييد الشبكة وقد يحد بعض إجراءات مجلد العمل.

أجب عن كل سؤال ثم اقرأ السبب. الأسئلة المعلَّمة «مطلوب» تُحتسب لإكمال الدرس.

1. السؤال 1 من 6

   السؤال 1 من 6

   لديك مستودع الدورة على القرص وتريد عرضه دون نسخه. أي إجراء تختار؟

   اختر إجابة واحدة.

   فتح مستودع…

   تهيئة مستودع…

   استنساخ مستودع…

   تحقّق من الإجابة
2. السؤال 2 من 6

   السؤال 2 من 6

   ما الاختيارات المطلوبة للأصل؟

   اختر كل إجابة صحيحة.

   حفظ الهوية التجريبية عالميًا

   أب موجود وابن جديد أو فارغ

   تفعيل المجرّد

   رفض قالب التجاهل والترخيص

   الفرع الأولي main

   تحقّق من الإجابة
3. السؤال 3 من 6

   السؤال 3 من 6مطلوب

   بعد التهيئة يعرض symbolic-ref الاسم main، ويفشل verify --quiet HEAD بالحالة 1 دون ناتج. ماذا يعني ذلك؟

   اختر إجابة واحدة.

   يوجد إيداع أول مخفي

   فساد مؤكد للمستودع

   فرع طبيعي دون إيداع أول

   تحقّق من الإجابة
4. السؤال 4 من 6

   السؤال 4 من 6مطلوب

   في نسخة تهيئة منفصلة اخترت trunk بدل main، دون إيداع. ما نتيجة symbolic-ref --short HEAD؟

   اختر إجابة واحدة.

   الاسم trunk

   main لأن الدورة تستخدمه

   معرّف إيداع جديد

   تحقّق من الإجابة
5. السؤال 5 من 6

   السؤال 5 من 6

   نجح استنساخ الأصل الفارغ، وظهر تحذير المصدر الخالي. ما العبارات الصحيحة؟

   اختر كل إجابة صحيحة.

   لا طرف فرع تتبّع بعيد بعد

   التحذير وحده يعني الفشل

   للنسخة origin

   نُسخ اسم الأصل المحلي

   أصبح للأصل origin

   تحقّق من الإجابة
6. السؤال 6 من 6

   السؤال 6 من 6مطلوب

   عد إلى الأصل وافحص الاستعلامات المحددة. ما الأدلة التي يجب أن تتفق؟

   اختر كل إجابة صحيحة.

   فحص HEAD بلا ناتج وحالته 1

   يطبع الأصل origin

   مجلد عمل صحيح ومجرّد false وmain رمزي

   فراغ الاستعلامات وعدم وجود ملفات مشروع

   الاسم والبريد المحليان هما الزوج الخيالي

   تحقّق من الإجابة

أعد فتح الأصل بأمر فتح مستودع… (Open Repository…) أو إسقاط المجلد. افحص حالة مجلد العمل والمجرّد واسم الفرع، وغياب إيداع HEAD، وفراغ الحالة والفهرس والبعيد، وقيمتي الهوية المحلية. اشرح وجود main دون إيداع واختلاف origin بين النسخة والأصل.

توقّع مُدخل متغير: إذا استُخدم الفرع الأولي = trunk في تهيئة جديدة منفصلة، فما نتيجة git symbolic-ref --short HEAD؟ تكون trunk دون إنشاء إيداع. فُحص ذلك في نسخة أصلية معزولة أخرى؛ لا تغيّر main في المشروع المستمر لأجل التوقّع.

• التهيئة تنشئ البيانات، والاستنساخ ينشئ نسخة، والفتح يختار مستودعًا موجودًا.
• اسم main لا يضمن وجود أول إيداع.
• افصل الهوية المحلية والنسخة الإضافية عن إعداداتك العامة ونقطة المشروع الأصلية.

• ثبّت Git وعاين هوية الإيداع بأمان (الدرس الثاني)
• توقّع ما سيحفظه إيداعك المقبل (الدرس الثالث)
• تنزيل GitTree

Initialize — تهيئة؛ clone — استنساخ؛ repository — مستودع؛ branch — فرع؛ remote — بعيد؛ working tree — مجلد العمل؛ staging area — منطقة التجهيز. الفرع دون إيداع أول هو المقصود بـ unborn branch، ويظل HEAD وorigin معرّفين لاتينيين.