{"type":"doc","content":[{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"الحمد لله الذي علَّم بالقلم، علَّم الإنسان ما لم يعلم، والصلاة والسلام على خير معلِّم الناس الخير سيدنا محمد - صلَّى الله عليه وسلم … أما بعد ،،"}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"هل لاحظت أن Git أصبح جزءًا لا يتجزأ من العمل مع الكود البرمجي لدرجة أن الناس نادرًا ما يدرجونه ضمن التقنيات التي يستخدمونها أو في سيرهم الذاتية؟ "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"الافتراض السائد هو أنك تعرفه بالفعل، أو على الأقل تعرف ما يكفي لاستخدامه، لكن هل تعرفه حقًا؟!"}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"كمطورين، يدور روتين حياتنا اليومية حول قراءة وكتابة ومراجعة الأكواد، و Git بلا شك أحد أهم الأدوات التي نستخدمها، إن إتقان الميزات والوظائف التي يقدمها Git يعد أحد أفضل الاستثمارات التي يمكنك القيام بها لتطوير نفسك كمبرمج."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"يمكنك اعتبار Git كأنه \"آلة زمن\" خاصة بالكود البرمجي؛ فهو يُمكّنك من استعراض تاريخ الكود، مما يسمح لك بالعودة إلى لحظة محددة في الماضي لمراجعة حالة الكود البرمجي في تلك الفترة. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"إضافة إلى أنه يوفر ميزة تتبع التغييرات التي أجريت على الكود، حيث يمكنك معرفة من قام بالتعديل، ومتى تم ذلك، مما يُسهل التعاون في المشاريع الجماعية. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"والأهم من ذلك، أنه يمنحك القدرة على التراجع عن أي تعديلات قمت بها واستعادة النسخ السابقة من الكود بسهولة، مما يجعله أداة قوية لإدارة التغييرات وحماية العمل من الأخطاء."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":null}},{"type":"heading","attrs":{"textAlign":"right","dir":"rtl","level":2},"content":[{"type":"text","marks":[{"type":"bold"}],"text":"أهم المفاهيم"}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"لفهم قوة وكفاءة Git بشكل كامل، من الضروري التعمق في بعض التفاصيل التقنية التي تجعله مميزًا، إليك شرحاً مفصلاً لأهم المفاهيم الأساسية التي تساعد في فهم آلية عمل Git:"}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":null}},{"type":"heading","attrs":{"textAlign":"right","dir":"rtl","level":2},"content":[{"type":"text","text":"المستودع (repository) "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"يعرف اختصارا ب \"Repo\"، وهو عبارة عن مجلد يحتوي على جميع ملفات المشروع بالإضافة إلى تاريخ التغييرات التي أجريتها على هذه الملفات. يمكن أن يشمل المستودع عدة فروع، وكل فرع يمثل مسارًا مختلفًا للتطوير. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"عندما تقوم بتهيئة Git في مجلد باستخدام الأمر "},{"type":"text","marks":[{"type":"code"}],"text":"git init"},{"type":"text","text":"، يصبح هذا المجلد مستودعًا يحتوي على كل الإصدارات والتعديلات التي تمت على المشروع. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"باختصار، المستودع يحفظ جميع مراحل التطوير ويسهل الرجوع لأي نقطة زمنية في تاريخ المشروع."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":null}},{"type":"heading","attrs":{"textAlign":"right","dir":"rtl","level":2},"content":[{"type":"text","text":"الإيداعات (Commits) "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"هي طريقة لحفظ التغييرات التي تجريها على مشروعك، كل إيداع لديه معرف خاص به يساعد Git على تتبع التغييرات بترتيب حدوثها. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"يمكنك التفكير في الإيداع كصورة لحالة مشروعك في لحظة محددة، بعد نقل الملفات إلى منطقة التهيئة، يمكنك استخدام الأمر "},{"type":"text","marks":[{"type":"code"}],"text":"git commit"},{"type":"text","text":" لحفظ حالة الملفات في تلك اللحظة. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"هذا يعني أنك ستتمكن دائمًا من الرجوع إلى الإيداع في وقت لاحق أو مقارنة التغييرات بين إيداعين. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"من المهم أن تفهم أن الإيداع ليس نشرًا للتطبيق، بل هو مجرد حفظ نسخة يمكنك العمل عليها أو اختبارها، وبمرور الوقت، تشكل الإيداعات تاريخًا شاملًا لمراحل تطوّر مشروعك."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":null}},{"type":"heading","attrs":{"textAlign":"right","dir":"rtl","level":2},"content":[{"type":"text","text":"منطقة التهيئة (Staging area) "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"هي مكان مؤقت تضع فيه التغييرات التي قمت بها على ملفاتك قبل حفظها بشكل نهائي في المستودع، يمكنك التفكير فيها كمسودة تُعد فيها التعديلات قبل اتخاذ القرار بحفظها، لإضافة الملفات إلى هذه المنطقة، تستخدم الأمر "},{"type":"text","marks":[{"type":"code"}],"text":"git add"},{"type":"text","text":". "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"هذه المرحلة تساعدك على مراجعة التغييرات والتأكد منها قبل أن تصبح جزءًا من المشروع، فهي تتيح لك التحكم الكامل فيما يتم حفظه وما يبقى للتعديل لاحقًا."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":null}},{"type":"heading","attrs":{"textAlign":"right","dir":"rtl","level":2},"content":[{"type":"text","text":"الفروع (Branches) "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"تساعدك على العمل على تغييرات جديدة في المشروع دون التأثير على الكود الرئيسي. بشكل افتراضي، الفرع الرئيسي يسمى \"main\" (أو \"master\" سابقًا). "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"إذا كنت تريد إضافة ميزة جديدة أو إصلاح مشكلة، يمكنك إنشاء فرع جديد باستخدام الأمر."}]},{"type":"codeBlock","attrs":{"language":"git"},"content":[{"type":"text","text":"git branch "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"هذا يعني أن التغييرات التي تجريها ستكون معزولة عن الكود الأساسي، مما يسمح لك بالتجربة دون الإضرار بالمشروع. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"الفروع تعمل بشكل منفصل، حيث يمكنك إجراء تعديلات على فرع خاص بك دون أن تؤثر على فروع الآخرين، وكل فرع يمثل مجموعة من الإيداعات التي تسجل التغييرات التي قمت بها منذ بدء العمل على المشروع."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":null}},{"type":"heading","attrs":{"textAlign":"right","dir":"rtl","level":2},"content":[{"type":"text","text":"الدمج (Merging) "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"هو عملية إدماج التغييرات التي أجريتها في فرع معين مع الفرع الرئيسي \"main\" (أو أي فرع آخر). "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"بمجرد الانتهاء من التعديلات في فرعك، يمكنك استخدام الأمر "},{"type":"text","marks":[{"type":"code"}],"text":"git merge"},{"type":"text","text":" لدمج هذه التغييرات مع الفرع الرئيسي. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"ببساطة، الدمج هو عملية إعادة توحيد مسارات التطوير المختلفة في المشروع إلى مسار واحد. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"يقوم Git بجمع الإيداعات من فرعين ودمجها في فرع واحد، مما يضمن أن جميع التغييرات متزامنة وموجودة في نفس الفرع."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":null}},{"type":"heading","attrs":{"textAlign":"right","dir":"rtl","level":2},"content":[{"type":"text","text":"المستودعات البعيدة (Remote Repositories) "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"هي مستودعات موجودة على خوادم خارجية مثل GitHub أو GitLab أو Bitbucket، وتتيح لك التعاون مع الآخرين في مشروعك. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"أثناء العمل محليًا على جهازك، يمكنك الإتصال بالمستودعات البعيدة باستخدام الأمر "},{"type":"text","marks":[{"type":"code"}],"text":"git remote"},{"type":"text","text":"، هذا يسمح لك بمشاركة التغييرات وسحب التحديثات من مستودع مركزي. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"المستودع البعيد هو مستودع لا يوجد على جهازك، ويمكنك ربطه بمشروعك لتتمكن من إرسال التغييرات إليه أو استلام التحديثات منه."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":null}},{"type":"heading","attrs":{"textAlign":"right","dir":"rtl","level":2},"content":[{"type":"text","text":"الأوامر \"Push\" و\"Pull\" "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"تسمح لك بالتفاعل مع المستودعات البعيدة، بعد الاتصال بمستودع بعيد، يمكنك استخدام الأمر "},{"type":"text","marks":[{"type":"code"}],"text":"push"},{"type":"text","text":" لإرسال التغييرات من جهازك إلى المستودع البعيد، مما يتيح للآخرين رؤية الكود الخاص بك والتعاون عليه. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"وبالمثل، يمكنك استخدام الأمر "},{"type":"text","marks":[{"type":"code"}],"text":"pull"},{"type":"text","text":" لجلب التحديثات من المستودع البعيد إلى نسختك المحلية، لضمان أن لديك أحدث التعديلات. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"عندما تقوم بعملية "},{"type":"text","marks":[{"type":"code"}],"text":"pull"},{"type":"text","text":"، فأنت تقوم بجلب التغييرات من الخادم البعيد ودمجها مع الكود الموجود على جهازك، أما عند استخدام "},{"type":"text","marks":[{"type":"code"}],"text":"push"},{"type":"text","text":"، فأنت تقوم بنقل التغييرات التي أجريتها محليًا إلى المستودع البعيد."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":null}},{"type":"heading","attrs":{"textAlign":"right","dir":"rtl","level":2},"content":[{"type":"text","text":"الأمر \"fetch\" "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"هذا الأمر يشبه الأمر "},{"type":"text","marks":[{"type":"code"}],"text":"pull"},{"type":"text","text":" من حيث أنه يتيح لك جلب التحديثات من مستودع بعيد، ولكنه لا يقوم بدمج هذه التغييرات تلقائيًا في الفرع الحالي. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"هذا يمنحك مرونة لمراجعة التغييرات أولاً قبل دمجها في الكود الخاص بك. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"باستخدام "},{"type":"text","marks":[{"type":"code"}],"text":"fetch"},{"type":"text","text":"، يمكنك الاطلاع على التحديثات والتأكد من أنها مناسبة قبل اتخاذ قرار بدمجها، مما يوفر لك سيطرة أكبر على عملية التطوير."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":null}},{"type":"heading","attrs":{"textAlign":"right","dir":"rtl","level":2},"content":[{"type":"text","text":"الأمر \"clone\" "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"يُستخدم لإنشاء نسخة من مستودع Git موجود بالفعل، عند تنفيذ الأمر "},{"type":"text","marks":[{"type":"code"}],"text":"git clone"},{"type":"text","text":"، يتم إنشاء مجلد جديد على جهازك يحتوي على جميع ملفات المستودع وتاريخه الكامل. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"هذه هي الطريقة الأسهل لبدء التعاون في مشروع، حيث يقوم "},{"type":"text","marks":[{"type":"code"}],"text":"clone"},{"type":"text","text":" بتنزيل جميع محتويات المستودع من خادم بعيد مثل GitHub إلى جهازك المحلي. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"يعتبر "},{"type":"text","marks":[{"type":"code"}],"text":"clone"},{"type":"text","text":" نسخة كاملة من المستودع البعيد، ولكن إذا لم تكن لديك الأذونات اللازمة، فلن تتمكن من إرسال تغييراتك إلى المستودع الأصلي (الذي تم نسخه)."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":null}},{"type":"heading","attrs":{"textAlign":"right","dir":"rtl","level":2},"content":[{"type":"text","text":"حل التعارضات (Conflict resolution) "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"يحدث أحيانًا عندما يعمل عدة أشخاص على نفس الجزء من الكود أن تنشأ تعارضات، ولكن Git يحتوي على أدوات مدمجة لتحديد هذه التعارضات وإبرازها، مما يتيح للمطورين حلها يدويًا قبل إتمام عملية الدمج. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"لا داعي للقلق، فعند محاولة دمج أو إعادة ترتيب (rebase) الفروع وظهور تعارضات، فهذا يعني ببساطة أن هناك تغييرات متعارضة في إصدارات مختلفة من نفس الملف. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"يمكن عادةً حل هذه التعارضات بسهولة عن طريق فهم الهدف من كل تغيير وتحديد كيفية دمج كلا التعديلين معًا. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"في بعض الأحيان، قد تحتاج إلى مراجعة الإيداعات (commits) المتعلقة بكل تغيير للحصول على السياق الكامل وحل التعارض بشكل صحيح."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":null}},{"type":"heading","attrs":{"textAlign":"right","dir":"rtl","level":2},"content":[{"type":"text","text":"الأمر \"stash\" "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"يسمح لك بحفظ التغييرات التي تعمل عليها مؤقتًا دون الحاجة إلى إنشاء إيداع (commit). "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"إذا كنت تعمل على ملفات معينة وتريد التوقف مؤقتًا أو الانتقال للعمل على شيء آخر دون فقدان التغييرات، يمكنك استخدام الأمر "},{"type":"text","marks":[{"type":"code"}],"text":"git stash"},{"type":"text","text":" لتخزين التغييرات بشكل مؤقت. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"هذا مفيد عندما ترغب في تبديل الفروع أثناء العمل على جزء غير مكتمل من المشروع، حيث يمكنك حفظ التغييرات واستئناف العمل عليها لاحقًا دون الحاجة إلى إيداع عمل غير مكتمل."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":null}},{"type":"heading","attrs":{"textAlign":"right","dir":"rtl","level":2},"content":[{"type":"text","text":"الأمر \"checkout\" "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"يُستخدم هذا الأمر للتنقل بين الفروع المختلفة في المشروع؛ في المشاريع الكبيرة، قد يكون هناك العديد من الفروع النشطة في نفس الوقت. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"باستخدام "},{"type":"text","marks":[{"type":"code"}],"text":"git checkout"},{"type":"text","text":" يمكنك تغيير الفرع الذي تعمل عليه حاليًا."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"هذا الأمر يقوم بتحديث الملفات في دليل العمل إلى أحدث نسخة من الفرع الذي اخترته، وأي إيداعات جديدة ستتم على هذا الفرع حتى تقرر الانتقال إلى فرع آخر."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":null}},{"type":"heading","attrs":{"textAlign":"right","dir":"rtl","level":2},"content":[{"type":"text","text":"التفرع (Forking)"}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"إن الفرع (Branch) في Git يُعتبر انحرافًا مؤقتًا عن الكود الأساسي للمشروع، بهدف دمج التغييرات مرة أخرى لاحقًا، أما التفرع (Fork) فهو انحراف دائم عن المشروع الأصلي. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"في المشاريع مفتوحة المصدر، يحدث التفرع عندما يقرر مطور أخذ كود المصدر الخاص بمشروع معين وتطويره لأهداف مختلفة عن أهداف المسؤولين عن المشروع. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"منصة GitHub تسهل عملية التفرع بشكل كبير، حيث يمكنك بنقرة واحدة نسخ مستودع Git موجود والبدء في العمل عليه وفقًا لرؤيتك الخاصة. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"التفرع يعني أنك تمتلك نسخة كاملة من مشروع شخص آخر في حسابك على GitHub، بحيث يكون هناك مستودعان لنفس المشروع: واحد في حساب المطور الأصلي وآخر في حسابك."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":null}},{"type":"heading","attrs":{"textAlign":"right","dir":"rtl","level":2},"content":[{"type":"text","text":"طلب السحب (Pull Request) "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"هو طريقة شائعة في Git للتعاون بين المطورين؛ بدلاً من دفع (push) التغييرات مباشرةً إلى المستودع المركزي، يمكنك إرسال طلب سحب. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"على سبيل المثال، إذا كنت قد أكملت ميزة جديدة وترغب في دمجها في الكود الأساسي للمشروع، يمكنك تقديم طلب سحب، مما يتيح لمديري المشروع مراجعة التغييرات والموافقة عليها أو رفضها. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"طلب السحب لا يتيح فقط لمديري المشروع اتخاذ القرار، بل يفتح أيضًا نقاشًا بين أعضاء الفريق حول التعديلات المقترحة. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"هذا الأمر مهم بشكل خاص في المشاريع مفتوحة المصدر، حيث يعد Git المكان الرئيسي لتفاعل المساهمين. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"من خلال طلبات السحب، يمكن للمطورين التعاون ومراجعة الكود بسهولة قبل دمجه في المستودع الرئيسي."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":null}},{"type":"heading","attrs":{"textAlign":"right","dir":"rtl","level":2},"content":[{"type":"text","text":"عملية \"Cherry-picking\" "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"تُستخدم هذه العملية لانتقاء تغييرات محددة من فرع ودمجها في فرع آخر، وذلك عندما لا يكون من المناسب أو الممكن دمج الفرع بأكمله. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"هذه الطريقة مفيدة إذا كنت بحاجة إلى دمج إيداعات معينة فقط دون سحب كل التغييرات. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"ومع ذلك، من المهم استخدام \"Cherry-picking\" بحذر، لأنه قد يؤدي إلى تكرار الإيداعات وتباين في تاريخ المشروع إذا تم استخدامه بشكل غير صحيح."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":null}},{"type":"heading","attrs":{"textAlign":"right","dir":"rtl","level":2},"content":[{"type":"text","text":"الأمر \"log\" "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"يسمح لك هذا الأمر بمشاهدة تاريخ الإيداعات التي قمت بها في المشروع. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"باستخدام الأمر "},{"type":"text","marks":[{"type":"code"}],"text":"git log"},{"type":"text","text":"، يمكنك عرض قائمة بالإيداعات السابقة، بما في ذلك مُعرّفاتها الفريدة (IDs) والرسائل المرتبطة بكل إيداع. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"هذا يساعدك على تتبع التغييرات التي تمت على الكود وفهم تفاصيل كل إيداع، مثل من قام به ومتى تم إجراؤه. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"يعتبر "},{"type":"text","marks":[{"type":"code"}],"text":"git log"},{"type":"text","text":" أداة مفيدة لمراجعة تاريخ المشروع وفهم مسار التطوير."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":null}},{"type":"heading","attrs":{"textAlign":"right","dir":"rtl","level":2},"content":[{"type":"text","marks":[{"type":"bold"}],"text":"نصائح هامة"}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"فيما يلي مجموعة من النصائح التي يجب معرفتها لاستخدام Git، سواء كنت مبتدئًا أو تستخدمه منذ فترة، ستساعدك هذه النصائح على تحسين مهاراتك والحفاظ على مستواك المتميز."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":null}},{"type":"heading","attrs":{"textAlign":"right","dir":"rtl","level":2},"content":[{"type":"text","text":"قم بعمل إيداعات (Commits) صغيرة ومنتظمة"}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"فكر في الإيداعات كما لو كنت تحفظ تقدمك في لعبة فيديو. بالطبع لن تلعب لساعات دون أن تحفظ تقدمك، أليس كذلك؟ نفس الفكرة تنطبق على البرمجة. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"عندما تعمل على مشروع، حاول أن تقوم بعمل إيداع (Commit) للتغييرات التي تجريها على شكل أجزاء صغيرة وسهلة الإدارة."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"لماذا هذا مهم؟ لأنه إذا حدث خطأ ما، سيكون من الأسهل تحديد السبب وإصلاحه. كما أنه يوفر عليك التوتر الناتج عن محاولة التعامل مع الكثير من التغييرات دفعة واحدة."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"أيضا حاول أن تكتب رسائل إيداع واضحة. بدلاً من كتابة شيء غامض مثل \""},{"type":"text","marks":[{"type":"italic"}],"text":"تم الإصلاح"},{"type":"text","text":"\"، جرب أن تكتب رسالة توضح بالضبط ما قمت به، مثل \""},{"type":"text","marks":[{"type":"italic"}],"text":"إصلاح مشكلة تسجيل الدخول"},{"type":"text","text":"\". "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"هذا سيساعدك لاحقًا إذا إحتجت للعودة ومراجعة التغييرات التي أجريتها."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":null}},{"type":"heading","attrs":{"textAlign":"right","dir":"rtl","level":2},"content":[{"type":"text","text":"استخدم الفروع (Branches) بذكاء "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"لنفترض أنك تريد إضافة ميزة جديدة إلى مشروعك، لكنك لا ترغب في التأثير على الكود الرئيسي أو المخاطرة بإفساده. هنا تأتي أهمية الفروع."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"فكر في الفروع على أنها نسخ منفصلة من الكود البرمجي. يمكنك العمل على هذه النسخة وإجراء التعديلات دون تغيير الكود الرئيسي. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"إذا كنت راضيًا عن التعديلات، يمكنك دمجها في الكود الرئيسي. وإذا حدثت مشكلة، يمكنك ببساطة حذف الفرع ولن يؤثر ذلك على الكود الرئيسي."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"أيضا حاول اختيار أسماء واضحة للفروع تعكس العمل الذي تقوم به. على سبيل المثال، إذا كنت تعمل على إضافة ميزة تسجيل الدخول، يمكنك تسمية الفرع \"feature/login\". "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"هذا سيجعل من السهل معرفة الغرض من كل فرع في المستقبل."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":null}},{"type":"heading","attrs":{"textAlign":"right","dir":"rtl","level":2},"content":[{"type":"text","text":"التعامل مع تعارضات الدمج (Merge Conflicts)؛ لا داعي للقلق! "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"قد تكون سمعت عن تعارضات الدمج من قبل، وربما تشعر بالخوف منها، لكنها ليست معقدة كما قد تبدو."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"تعارض الدمج يحدث عندما يقوم أكثر من شخص بتعديل نفس الجزء من الكود. في هذه الحالة، يطلب منك Git التدخل واختيار التعديلات التي ترغب في الاحتفاظ بها. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"سيعرض Git الأجزاء المتعارضة من الكود، ومن ثم يمكنك أن تقرر أي جزء تريد الاحتفاظ به أو دمج التغييرات المختلفة معًا."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"اعتبر تعارضات الدمج فرصة لمراجعة الكود بتمعن واتخاذ القرار المناسب حول كيفية دمج التغييرات المختلفة."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":null}},{"type":"heading","attrs":{"textAlign":"right","dir":"rtl","level":2},"content":[{"type":"text","text":"استخدم gitignore للحفاظ على ترتيب مشروعك "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"في بعض الأحيان، قد يحتوي المشروع على ملفات لا ترغب في أن يقوم Git بتتبعها، مثل الملفات المؤقتة أو ملفات الإعدادات المحلية (Local configs)، وهنا يأتي دور ملف "},{"type":"text","marks":[{"type":"code"}],"text":"gitignore"},{"type":"text","text":"."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"ملف "},{"type":"text","marks":[{"type":"code"}],"text":"gitignore"},{"type":"text","text":" يسمح لك بتحديد الملفات التي تريد أن يتجاهلها Git ولا يقوم بتتبعها، على سبيل المثال، يمكنك استبعاد ملفات الإعدادات التي لا تحتاج إلى مشاركتها مع الآخرين."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"مهم جدا أن تتأكد من إضافة الملفات الشائعة مثل \"env\" التي تحتوي على متغيرات بيئة التشغيل (Environment variables) وأيضا \"node_modules\" إلى ملف "},{"type":"text","marks":[{"type":"code"}],"text":"gitignore"},{"type":"text","text":"، حتى يبقى مستودعك نظيفًا وخاليًا من الملفات غير الضرورية."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":null}},{"type":"heading","attrs":{"textAlign":"right","dir":"rtl","level":2},"content":[{"type":"text","text":"اسحب (Pull) قبل أن ترفع (Push) "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"قد تصادف أحيانًا رسالة خطأ عند محاولة رفع (push) تغييراتك إلى المستودع. السبب غالبًا هو أن زملاءك قد أجروا تغييرات لم تحصل عليها بعد."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"الحل بسيط، تأكد دائمًا من عمل سحب (pull) للتغييرات من المستودع قبل أن تقوم بدفع (push) تغييراتك. هذا يضمن أن الكود لديك محدث ومُزامن مع آخر التغييرات، مما يقلل من فرص حدوث التعارضات ويسهل عملية الدمج."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":null}},{"type":"heading","attrs":{"textAlign":"right","dir":"rtl","level":2},"content":[{"type":"text","marks":[{"type":"bold"}],"text":"أهم الأوامر "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"إليك أبرز الأوامر الأكثر شيوعًا واستخدامًا في Git، حتى إن كنت تعتمد على برامج جاهزة لإدارة وظائف Git مثل SourceTree أو VSCode، فإن فهمك العميق لهذه الأوامر سيكشف لك العديد من الجوانب المهمة والمفيدة."}]},{"type":"codeBlock","attrs":{"language":"git"},"content":[{"type":"text","text":"# Clone a Repository\ngit clone \n\n# Stage Changes for Commit\ngit add \n\n# Commit Changes\ngit commit -m \"Commit message\"\n\n# Push Changes to the Remote Repository\ngit push\n\n# Force Push Changes (use with caution)\ngit push --force\n\n# Reset Working Directory to Last Commit\ngit reset --hard\n\n# Create a New Branch\ngit branch \n\n# Switch to a Different Branch\ngit checkout \n\n# Merge Changes from Another Branch\ngit merge \n\n# View Status of Working Directory\ngit status\n\n# View Commit History\ngit log\n\n# Undo Last Commit (use with caution)\ngit reset --soft HEAD^\n\n# Discard Changes in Working Directory\ngit restore \n\n# Pull changes from remote repo\ngit pull \n\n# Fetch changes from remote repo\ngit fetch "}]},{"type":"paragraph","attrs":{"textAlign":"right","dir":null}},{"type":"heading","attrs":{"textAlign":"justify","dir":"rtl","level":2},"content":[{"type":"text","marks":[{"type":"bold"}],"text":"الفرق بين git و github "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"إن Git و GitHub تقنيتان مكملتان لبعضهما، حيث يعد Git نظامًا للتحكم في الإصدارات، بينما GitHub هو خدمة استضافة سحابية تساعد فرق العمل على إدارة مستودعات الأكواد البرمجية (repositories)."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"تم إطلاق GitHub في عام 2008 لتسهيل البرمجة التعاونية باستخدام Git، وهو ما جعلها منصة رائدة في المجال وجذبت ملايين المستخدمين عالميًا. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"بالإضافة إلى ميزات Git التقليدية، توفر GitHub ميزات إضافية مثل تتبع الأخطاء، وإدارة المهام، والتكامل المستمر (CI)."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"تعمل GitHub بنظام freemium، حيث تتوفر ميزات مجانية مع خيار الاشتراك للوصول إلى الميزات المتقدمة. وهي مملوكة لشركة Microsoft منذ 2018. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"ورغم وجود خدمات منافسة مثل GitLab و Bitbucket، تظل GitHub الأكثر شعبية عالميًا."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":null}},{"type":"heading","attrs":{"textAlign":"justify","dir":"rtl","level":2},"content":[{"type":"text","marks":[{"type":"bold"}],"text":"خاتمة"}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"للوهلة الأولى، قد يبدو Git نظامًا معقدًا ويصعب التعامل معه، لكن بمجرد أن تفهم آلياته وتعتاد استخدامه، ستدرك مدى أهميته وستسأل نفسك كيف كنت تدير مشاريعك البرمجية بدونه. "}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"إن Git يعد بمثابة صمام أمان قوي لمشروعك، حيث يتيح لك استرجاع الإصدارات السابقة، وتتبع التغييرات، والتعامل مع الأخطاء بكل سهولة، مما يجعله أداة لا غنى عنها في تطوير البرمجيات."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"في هذا المقال، حاولت تقديم شرح لأهم المفاهيم الأساسية، بالإضافة إلى استعراض الأوامر الأكثر شيوعًا في Git التي قد تحتاج استخدامها عند إدارة المستودعات والتعاون في تطوير البرمجيات."}]},{"type":"paragraph","attrs":{"textAlign":"justify","dir":"rtl"},"content":[{"type":"text","text":"هناك العديد من الأوامر الأخرى والتعديلات التي قد تجدها مفيدة كجزء من عملك مع Git. لمعرفة المزيد حول جميع الخيارات المتاحة لك، يمكنك تشغيل الأمر التالي للحصول على معلومات مفيدة:"}]},{"type":"codeBlock","attrs":{"language":"git"},"content":[{"type":"text","text":"git --help"}]},{"type":"paragraph","attrs":{"textAlign":"right","dir":"rtl"},"content":[{"type":"text","text":"كما يمكنك أيضًا قراءة المزيد حول Git والاطلاع على وثائقه من "},{"type":"text","marks":[{"type":"link","attrs":{"href":"https://git-scm.com/","target":"_blank","rel":"noopener noreferrer nofollow","class":null}}],"text":"الموقع الرسمي"},{"type":"text","text":" لـ Git."}]},{"type":"paragraph","attrs":{"textAlign":"right","dir":"rtl"},"content":[{"type":"text","text":"وفقنى الله وإياك إلى ما يحبه ويرضاه ،،"}]}]}

كل ما تريد معرفته عن Git