انتقل إلى المحتوى

قاموس المصطلحات

قاموس يشرح بالعربية كل مصطلح إنجليزي تقرؤه في هذا الدليل وفي واجهة ليڤانت غيت (LevantGit): commit وbranch وpush وpull request وrepository وغيرها. المصطلحات تبقى مكتوبة بالإنجليزية هنا وفي الواجهة معًا، لأن هذه هي الكلمات التي تراها في الأوامر وفي أي مرجع تبحث فيه لاحقًا؛ والقاموس يشرحها ولا يستبدلها.

كيف نكتب المصطلح داخل الجملة

القاعدة مثال
المصطلح مفردًا كما هو أنشئ commit جديدًا.
مع أداة التعريف: الـ ملتصقة افتح الـ repository على المتصفح.
الجمع بصيغته الإنجليزية راجع الـ commits الأخيرة.
الأفعال عربية والمصطلح إنجليزي نفّذ push · أنشئ branch · افتح pull request
الأوامر والمسارات داخل `backticks` git push -u origin main

لا نكتب: «ادفع التعديلات» ولا «الإيداع» ولا «طلب الدمج» ولا «المستودع». المصطلح إنجليزي دائمًا. أمّا الكلمات العامة — ملف، مجلد، كلمة مرور، إعدادات، حساب، بريد — فتبقى عربية.

ونقول كود (والجمع أكواد) لا «شيفرة»؛ فهي الكلمة التي يستعملها المطوّرون فعلًا.

أساسيات Git

المصطلح الشرح
Git الأداة التي تتتبّع تغييرات مشروعك على جهازك.
repository (اختصارًا repo) مجلد المشروع الذي يتتبّعه Git، ومعه كامل تاريخه.
commit لقطة محفوظة من مشروعك في لحظة معيّنة، مع رسالة تصف ما تغيّر.
commit message السطر الذي تصف فيه ما فعلته في هذه الـ commit.
branch خط عمل مستقل داخل الـ repository، تجرّب فيه دون المساس بالبقية.
default branch الـ branch الأساسي للمشروع، واسمه غالبًا main.
clone إنزال نسخة كاملة من repository إلى جهازك.
push إرسال الـ commits من جهازك إلى الخادم.
pull جلب تغييرات الخادم ودمجها في نسختك المحلية.
fetch جلب التغييرات دون دمجها.
merge دمج تغييرات branch في آخر.
merge conflict تعارض يقع حين يعدّل طرفان السطر نفسه، فيطلب منك Git أن تختار.
fast-forward دمج بلا commit جديد، لأن الـ branch الهدف لم يتغيّر.
rebase إعادة بناء الـ commits فوق قاعدة جديدة لتاريخ أنظف.
squash ضغط عدة commits في واحدة عند الدمج.
checkout / switch الانتقال بين الـ branches أو استعادة ملفات.
working directory ملفات مشروعك كما تراها الآن على القرص.
staging area المنطقة التي تجهّز فيها التغييرات قبل الـ commit (git add).
HEAD مؤشّر يدلّ على موضعك الحالي في التاريخ.
detached HEAD حالة يشير فيها HEAD إلى commit لا إلى branch.
remote نسخة المشروع على الخادم كما يعرفها جهازك.
origin الاسم الافتراضي للـ remote الأساسي.
upstream المشروع الأصل الذي اشتققت منه، أو الـ branch الذي يتتبّعه branchك.
diff الفرق بين نسختين من الملفات.
log سجل الـ commits.
revert إلغاء أثر commit بإنشاء commit معاكسة.
reset إرجاع الـ branch إلى commit سابقة.
stash حفظ تغييرات غير مكتملة جانبًا مؤقتًا.
tag اسم ثابت لنقطة في التاريخ، يُستخدم للإصدارات.
force push دفع يعيد كتابة تاريخ الخادم — خطر على الـ branches المشتركة.
.gitignore ملف يحدّد ما لا يتتبّعه Git.
Git LFS امتداد لتخزين الملفات الكبيرة خارج تاريخ الـ repository.
partial clone / shallow clone استنساخ ناقص متعمّد لتسريع تنزيل المشاريع الضخمة.

ليڤانت غيت — الحساب والـ repositories

المصطلح الشرح
dashboard صفحتك الأولى بعد الدخول: نشاط مشاريعك ومنظماتك.
profile صفحتك العامة على levantgit.com/<username>.
organization حساب جماعي يملك repositories ويضم teams.
team مجموعة أعضاء داخل الـ organization بصلاحيات محدّدة.
owner مالك الـ repository أو الـ organization.
collaborator من أُضيف إلى repository ليعمل عليه.
public / private repository يراه الجميع، أو أنت ومن تسمح له.
fork نسخة من repository شخص آخر تحت حسابك.
star تمييز repository لتعود إليه لاحقًا.
watch متابعة repository لتصلك إشعاراته.
template repository repository يُنشأ منه غيره بالبنية نفسها.
mirror نسخة تتزامن تلقائيًا مع repository آخر (pull mirror أو push mirror).
migration نقل repository من خدمة أخرى (مثل GitHub) إلى ليڤانت غيت.
archive تجميد repository للقراءة فقط.
README ملف التعريف الذي يظهر في صفحة الـ repository.
blame عرض يبيّن من غيّر كل سطر ومتى.

Issues والمراجعة

المصطلح الشرح
issue بطاقة لمهمة أو خلل أو نقاش.
label تصنيف ملوّن يُلصق بالـ issues والـ pull requests.
milestone هدف يجمع issues ضمن مهلة.
pull request (PR) طلب مراجعة تغييرات branch ودمجها. ليس له علاقة بأمر git pull.
draft pull request PR غير جاهز للمراجعة بعد.
review مراجعة زميل لتغييراتك: approve أو request changes أو تعليق.
reviewer من طُلبت منه المراجعة.
assignee من أُسندت إليه الـ issue أو الـ PR.
CODEOWNERS ملف يحدّد من يُطلب لمراجعة أي ملفات.
auto-merge دمج يقع تلقائيًا حين تنجح كل الفحوصات.

الصلاحيات والحماية

المصطلح الشرح
permissions ما يستطيع كل شخص فعله في الـ repository.
unit قسم من الـ repository يمكن تشغيله أو إطفاؤه (Code، Issues، Wiki…).
protected branch branch محمي: يمنع الـ force push ويشترط شروطًا قبل الدمج.
protected tag tag لا يستطيع تعديله إلا من سُمح له.
status check فحص آلي يجب أن ينجح قبل الدمج.
required approvals عدد الاعتمادات اللازمة قبل الدمج.
access token بديل كلمة المرور عند الاتصال عبر HTTPS.
SSH key مفتاح يثبت هويتك للخادم دون كلمة مرور.
deploy key مفتاح SSH بصلاحية على repository واحد.
2FA التحقق بخطوتين عند الدخول.
webhook نداء يرسله ليڤانت غيت إلى خدمتك عند وقوع حدث.
payload البيانات التي يرسلها الـ webhook.

Actions و packages

المصطلح الشرح
Actions نظام تشغيل مهام آلية عند كل push أو pull request.
workflow ملف YAML في .gitea/workflows/ يصف المهام.
job / step المهمة داخل الـ workflow، والخطوة داخل المهمة.
runner الجهاز الذي ينفّذ الـ jobs فعليًا.
workflow run تشغيلة واحدة للـ workflow.
secret قيمة سرّية (مثل token) تستعملها الـ workflows دون إظهارها.
variable قيمة غير سرّية تستعملها الـ workflows.
badge صورة صغيرة تعرض حالة آخر تشغيلة.
package registry مكان نشر حزم مشروعك (npm، PyPI، Composer…).

ملاحظة للمترجمين

هذا القاموس يحكم الدليل وواجهة الموقع العربية معًا. عند بناء ملف اللغة العربية (locale_ar.ini) تبقى أسماء المفاهيم إنجليزية — Pull Requests، Commits، Issues، Branches — ويُعرَّب ما حولها: الأزرار والرسائل والنصوص التوضيحية. هكذا يجد المستخدم في الواجهة الكلمة نفسها التي قرأها هنا.

أسئلة شائعة

ما معنى commit بالعربي؟

الـ commit لقطة محفوظة من مشروعك في لحظة معيّنة، معها رسالة تصف ما تغيّر. تُترجم أحيانًا بـ «إيداع»، لكننا نبقيها commit في هذا الدليل لأنها الكلمة التي تراها في الأمر git commit وفي واجهة ليڤانت غيت وفي أي مرجع تبحث فيه لاحقًا.

ما الفرق بين pull request و git pull؟

الـ pull request طلب تفتحه في واجهة ليڤانت غيت لمراجعة تغييرات branch ودمجها في آخر، ويجري النقاش والـ review فيه قبل الدمج. أمّا git pull فأمر تنفّذه في الطرفية ليجلب تغييرات الخادم ويدمجها في نسختك المحلية. الاسم متشابه والوظيفة مختلفة تمامًا، فلا تخلط بينهما.

ما معنى repository؟

الـ repository (اختصارًا repo) مجلد مشروعك الذي يتتبّعه Git ومعه كامل تاريخه: كل commit، وكل branch، وكل نسخة سابقة من كل ملف. لديك نسخة منه على جهازك ونسخة على ليڤانت غيت، وتزامن بينهما بـ push وpull. يكون public يراه الجميع، أو private لك ولمن تسمح له.

ما الفرق بين Git وليڤانت غيت؟

Git أداة تعمل على جهازك وتتتبّع تغييرات مشروعك محليًّا. وليڤانت غيت (LevantGit) خدمة استضافة مجانية عربية مبنية على Gitea، تحفظ نسخة من الـ repository على الخادم لتشاركها وتتعاون عليها. تحتاج Git لتعمل يوميًّا، وتحتاج ليڤانت غيت لتنشر عملك وتصل إليه من أي جهاز.

لماذا تبقى مصطلحات Git بالإنجليزية في هذا الدليل؟

لأن هذه هي الكلمات التي تراها فعلًا في الأوامر وفي واجهة ليڤانت غيت وفي أي مرجع تبحث فيه لاحقًا. ترجمة commit إلى «إيداع» تجعلك تقرأ كلمة لا تجدها في أي مكان آخر. القاموس يشرح المصطلح بالعربية ولا يستبدله؛ أمّا الكلمات العامة — ملف، مجلد، إعدادات — فتبقى عربية.

ماذا بعد؟