٢، ١، الحصول على مستودع جت
في المعتاد تحصل على مستودع جت بإحدى طريقتين:
-
تأتي مجلدًا محليًّا ليس تحت إدارة نُسخ، وتحوله إلى مستودع جت،
-
أو تستنسخ مستودع جت موجودًا بالفعل.
في كلتا الحالتين، سيصير معك مستودع جت على حاسوبك المحلي وجاهز للعمل.
ابتداء مستودع في مجلد موجود
إذا كان لديك مجلد مشروع ليس تحت إدارة نسخ الآن، وتريد أن تبدأ في إدارته باستخدام جت، تحتاج أولا إلى الذهاب إلى ذلك المجلد. إن لم تفعل هذا من قبل، فهذا قد يختلف قليلا حسب نظامك:
للينكس:
$ cd /home/user/my_projectلماك أو إس:
$ cd /Users/user/my_projectلويندوز:
$ cd C:/Users/user/my_projectثم اكتب:
$ git initهذا ينشئ لك مجلدًا فرعيًّا جديدًا يُسمى .git (يبدأ اسمه بنقطة، ليكون مجلدًا مخفيًّا) ويحوي كل الملفات الضرورية لمستودعك؛ أيْ هيكل مستودع جت.
حتى الآن، لا شيء في مشروعك متعقَّب بعد.
انظر باب دواخل جت للمزيد من المعلومات عن تفاصيل الملفات التي في مجلد .git الذي أنشأته للتو.
إذا أردت أن تبدأ في إدارة نسخ ملفات موجودة (وليس مجلدًا فارغًا)، فعليك بَدء تعقُّب هذه الملفات وصنع إيداع أوّلي.
يمكنك فعل هذا ببعض أوامر الإضافة git add، التي تحدد الملفات التي تريد تعقبها، ثم بأمر الإيداع git commit:
$ git add *.c
$ git add LICENSE
$ git commit -m 'Initial project version' # إيداع «أول نسخة من المشروع»سنعرف ماذا تفعل هذه الأوامر خلال لحظات. لكن الآن، لديك مستودع جت به ملفات متعقبة وإيداع أول.
استنساخ مستودع موجود
إذا كنت تريد الحصول على نسخة من مستودع جت موجود — مثلا مشروع تحب المساهمة فيه — فإن الأمر الذي تريده هو أمر الاستنساخ git clone.
إذا كنت تعرف أنظمة أخرى لإدارة النسخ مثل Subversion، ستلاحظ أن الأمر هو clone (استنساخ) وليس checkout (سحب).
هذا فرق مهم؛ فبدلا من جلب مجرد نسخة للعمل عليها، فإن جت يحضر لك تقريبا كل شيء لدى الخادوم؛
كل نسخة من كل ملف عبر تاريخ المشروع، يجذبها جت إليك عندما تنفِّذ git clone.
في الحقيقة، إذا تلف قرص الخادوم، يمكنك في الغالب استعمال أي استنساخ عند أي عميل لإرجاع الخادوم إلى حالته عندما اُستنسخ (قد تفقد بعض الخطاطيف الخاصة بالخادوم وأشياء من هذا القبيل، لكن جميع البيانات التي تحت إدارة النسخ ستكون موجودة؛ انظر فصل تثبيت جت على خادوم للمزيد من التفاصيل).
استنسخ مستودعًا بالأمر git clone «رابط».
مثلا إذا أردت استنساخ مكتبة جت القابلة للربط المسماة libgit2، يمكنك فعل ذلك هكذا:
$ git clone https://github.com/libgit2/libgit2هذا ينشئ مجلدًا اسمه libgit2، ويبتدئ مجلد .git فيه، ويجذب جميع بيانات هذا المستودع، ويسحب لك من النسخة الأخيرة منه نسخةً للعمل.
فإذا دخلت مجلد libgit2 الجديد الذي أُنشئ آنفًا، فستجد فيه ملفات المشروع تنتظرك للعمل عليها أو استعمالها.
وإذا أردت استنساخ المستودع إلى مجلد باسم غير libgit2، يمكنك تعيين هذا الاسم الجديد بإضافته إلى معاملات الأمر:
$ git clone https://github.com/libgit2/libgit2 mylibgitهذا الأمر يفعل الشيء نفسه الذي يفعله الأمر السابق، لكن اختلف المجلد الهدف فصار mylibgit.
يستطيع جت التعامل مع عدد من موافيق (بروتوكولات) النقل المختلفة.
استخدم المثال السابق ميفاق https://، ولكنك قد ترى أيضا git://، أو user@server:path/to/repo.git الذي يستخدم ميفاق SSH.
يخبرك فصل تثبيت جت على خادوم بجميع الخيارات التي يستطيع الخادوم إعدادها حتى يمكنك الوصول إلى مستودع جت الخاص بك، ومزايا وعيوب كلٍ منها.