Lesson 2 / الدرس 2

Installing git, and telling it who you are / تثبيت git وتعريفه بمن أنت

Two commands to check it is there, and three to configure it. The name and email you set here are stamped on every commit you will ever make, so it is worth getting right the first time.

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

git --version               is it already installed?

brew install git            macOS
sudo apt install git        Ubuntu, Debian, WSL
sudo dnf install git        Fedora

Check before you install — this is lesson 20 of the terminal course in practice. Git ships with many systems already, and on macOS running git --version the first time may offer to install the developer tools for you.

تحقق قبل التثبيت — وهذا الدرس 20 من دورة الطرفية عمليًا. فـgit يأتي مع أنظمة كثيرة أصلًا، وعلى macOS قد يعرض تنفيذ git --version أول مرة تثبيت أدوات المطوّر لك.

Who you are, on every commit

git config --global user.name "Ahmed Hamdi"
git config --global user.email "ahmed@example.com"
git config --global init.defaultBranch main

git config --list           see everything that is set
git config user.email       see one value

Run these three once per machine. --global means "for me, everywhere" and writes to ~/.gitconfig — one of the hidden files from lesson 11 of the terminal course. Run the demonstration for what each one affects.

نفّذ هذه الثلاثة مرة لكل جهاز. و--global تعني "لي في كل مكان" وتكتب في ~/.gitconfig — أحد الملفات المخفية من الدرس 11 في دورة الطرفية. شغّل العرض لمعرفة ما يؤثر فيه كل واحد.

The email is worth a moment of thought. It appears in the history of every project you contribute to, including public ones, so it is genuinely public. Use an address you are happy to have there — and if you would rather not publish a personal one, GitHub can give you a no-reply address that still links commits to your account. Lesson 16 comes back to this.

Three levels of configuration

Level	Flag	Stored in	Applies to
System	--system	/etc/gitconfig	Every user on the machine
Global	--global	~/.gitconfig	You, in every project
Local	no flag	.git/config	This one project only

The most specific wins, so a local setting overrides your global one. That is how you use a work email in one project and a personal one everywhere else: set the global once, and override it inside that project.

Two more settings worth adding now, both of which prevent a category of confusion later. git config --global pull.rebase false tells git how to combine work when you pull, and stops it asking every time. git config --global core.autocrlf handles the fact that Windows and everything else disagree about line endings — input on macOS and Linux, true on Windows.

وإعدادان آخران يستحقان الإضافة الآن، وكلاهما يمنع صنفًا من الحيرة لاحقًا. فـgit config --global pull.rebase false يخبر git كيف يجمع العمل حين تسحب، ويمنعه من السؤال في كل مرة. وgit config --global core.autocrlf يعالج اختلاف Windows عمّا عداه في نهايات الأسطر — input على macOS وLinux، وtrue على Windows.

في VS Code: تعيش القيم نفسها في الإعدادات ضمن قسم Git، لكن الملف هو المرجع — فـVS Code يقرأ ويكتب ~/.gitconfig نفسه. وفتحه بـgit config --global --edit يريك كل شيء دفعة واحدة، وهو أسرع عادةً من التنقيب في شاشة إعدادات.

Try it live / جرّب بنفسك

<h1>Setting git up</h1>

<h2>What I have</h2>
<pre class="term">$ git --version
…</pre>

<h2>What I set</h2>
<pre class="term">$ git config --global user.name "…"
…</pre>

<h2>My .gitconfig</h2>
<pre class="term">$ cat ~/.gitconfig
…</pre>

<h2>Why this email</h2>
<p>…</p>

<style>
    .term { background: #0f172a; color: #e2e8f0; padding: 1rem;
            border-radius: .5rem; overflow-x: auto; }
</style>

Preview / المعاينة

Check yourself / اختبر نفسك

1. You set user.email after making ten commits. What happens to them?

ضبطت user.email بعد صنع عشر commits. ماذا يحدث لها؟

2. What does --global mean?

ماذا تعني --global؟

3. Why set init.defaultBranch main?

لماذا تضبط init.defaultBranch main؟

Your task / مهمتك

Install or verify git on your machine and configure it properly. Report the version you have, the three settings you made, and the contents of your ~/.gitconfig afterwards. Then explain, in one paragraph, why the email address you chose is the one you chose — remembering that it will be visible in every project you contribute to.

ثبّت git أو تحقق منه على جهازك واضبطه كما ينبغي. وأبلغ عن النسخة التي عندك، والإعدادات الثلاثة التي ضبطتها، ومحتوى ~/.gitconfig بعدها. ثم اشرح في فقرة لماذا اخترت عنوان البريد الذي اخترته — متذكرًا أنه سيكون مرئيًا في كل مشروع تسهم فيه.

Your real git version نسخة git الحقيقية عندك
The three settings, and your real .gitconfig after الإعدادات الثلاثة، و.gitconfig الحقيقي بعدها
A reason for the email address you chose سبب اختيارك عنوان البريد
It is set BEFORE your first commit مضبوط قبل أول commit