progit · essa01442 · Mar 20, 2026 · Mar 20, 2026 · Mar 20, 2026 · Mar 20, 2026
diff --git a/book/02-git-basics/sections/aliases.asc b/book/02-git-basics/sections/aliases.asc
@@ -1,13 +1,13 @@
 [[_git_aliases]]
-=== Git Aliases
+=== Git Aliases (الأسماء المستعارة في Git)
 
 (((aliases)))
-Before we move on to the next chapter, we want to introduce a feature that can make your Git experience simpler, easier, and more familiar: aliases.
-For clarity's sake, we won't be using them anywhere else in this book, but if you go on to use Git with any regularity, aliases are something you should know about.
+قبل أن ننتقل إلى الفصل التالي، نريد تقديم ميزة يمكن أن تجعل تجربة Git (Git experience) الخاصة بك أبسط وأسهل وأكثر ألفة: الأسماء المستعارة (aliases).
+من أجل الوضوح، لن نستخدمها في أي مكان آخر في هذا الكتاب، ولكن إذا استمررت في استخدام Git بأي قدر من الانتظام، فإن الأسماء المستعارة (aliases) هي شيء يجب أن تعرفه.
 
-Git doesn't automatically infer your command if you type it in partially.
-If you don't want to type the entire text of each of the Git commands, you can easily set up an alias for each command using `git config`.(((git commands, config)))
-Here are a couple of examples you may want to set up:
+لا يستنتج Git أمرك (command) تلقائياً إذا كتبته جزئياً (partially).
+إذا كنت لا ترغب في كتابة النص الكامل لكل أمر من أوامر Git، يمكنك بسهولة إعداد اسم مستعار (alias) لكل أمر باستخدام `git config`.(((git commands, config)))
+إليك بعض الأمثلة التي قد ترغب في إعدادها:
 
 [source,console]
 ----
@@ -17,34 +17,34 @@ $ git config --global alias.ci commit
 $ git config --global alias.st status
 ----
 
-This means that, for example, instead of typing `git commit`, you just need to type `git ci`.
-As you go on using Git, you'll probably use other commands frequently as well; don't hesitate to create new aliases.
+هذا يعني، على سبيل المثال، أنه بدلاً من كتابة `git commit`، تحتاج فقط إلى كتابة `git ci`.
+مع استمرارك في استخدام Git، ربما ستستخدم أوامر أخرى بشكل متكرر أيضاً؛ لا تتردد في إنشاء أسماء مستعارة (aliases) جديدة.
 
-This technique can also be very useful in creating commands that you think should exist.
-For example, to correct the usability problem you encountered with unstaging a file, you can add your own unstage alias to Git:
+يمكن أن تكون هذه التقنية مفيدة جداً أيضاً في إنشاء الأوامر التي تعتقد أنها يجب أن تكون موجودة.
+على سبيل المثال، لتصحيح مشكلة قابلية الاستخدام (usability problem) التي واجهتها مع إلغاء تجهيز (unstaging) ملف، يمكنك إضافة اسم مستعار (alias) خاص بك للإلغاء (unstage) إلى Git:
 
 [source,console]
 ----
 $ git config --global alias.unstage 'reset HEAD --'
 ----
 
-This makes the following two commands equivalent:
+هذا يجعل الأمرين التاليين متكافئين:
 
 [source,console]
 ----
 $ git unstage fileA
 $ git reset HEAD -- fileA
 ----
 
-This seems a bit clearer.
-It's also common to add a `last` command, like this:
+يبدو هذا أكثر وضوحاً بعض الشيء.
+من الشائع أيضاً إضافة أمر `last` (الأخير)، مثل هذا:
 
 [source,console]
 ----
 $ git config --global alias.last 'log -1 HEAD'
 ----
 
-This way, you can see the last commit easily:
+بهذه الطريقة، يمكنك رؤية آخر عملية تأكيد (last commit) بسهولة:
 
 [source,console]
 ----
@@ -58,13 +58,13 @@ Date:   Tue Aug 26 19:48:51 2008 +0800
     Signed-off-by: Scott Chacon <schacon@example.com>
 ----
 
-As you can tell, Git simply replaces the new command with whatever you alias it for.
-However, maybe you want to run an external command, rather than a Git subcommand.
-In that case, you start the command with a `!` character.
-This is useful if you write your own tools that work with a Git repository.
-We can demonstrate by aliasing `git visual` to run `gitk`:
+كما يمكنك أن تلاحظ، يستبدل Git ببساطة الأمر الجديد بأي شيء تقوم بتعيينه كاسم مستعار له (alias it for).
+ومع ذلك، ربما تريد تشغيل أمر خارجي (external command)، بدلاً من أمر فرعي (subcommand) من Git.
+في هذه الحالة، تبدأ الأمر بحرف `!`.
+هذا مفيد إذا قمت بكتابة أدواتك الخاصة (own tools) التي تعمل مع مستودع Git (Git repository).
+يمكننا توضيح ذلك عن طريق جعل `git visual` اسماً مستعاراً لتشغيل `gitk`:
 
 [source,console]
 ----
 $ git config --global alias.visual '!gitk'
-----
+----
diff --git a/book/02-git-basics/sections/getting-a-repository.asc b/book/02-git-basics/sections/getting-a-repository.asc
@@ -1,47 +1,47 @@
 [[_getting_a_repo]]
-=== Getting a Git Repository
+=== Getting a Git Repository (الحصول على مستودع Git)
 
-You typically obtain a Git repository in one of two ways:
+عادةً ما تحصل على مستودع Git (Git repository) بإحدى طريقتين:
 
-1. You can take a local directory that is currently not under version control, and turn it into a Git repository, or
-2. You can _clone_ an existing Git repository from elsewhere.
+1. يمكنك أخذ دليل محلي (local directory) لا يخضع حالياً للتحكم في الإصدار (version control)، وتحويله إلى مستودع Git، أو
+2. يمكنك _استنساخ (clone)_ مستودع Git موجود من مكان آخر.
 
-In either case, you end up with a Git repository on your local machine, ready for work.
+في كلتا الحالتين، ينتهي بك الأمر بوجود مستودع Git على جهازك المحلي، جاهز للعمل.
 
-==== Initializing a Repository in an Existing Directory
+==== Initializing a Repository in an Existing Directory (تهيئة مستودع في دليل موجود)
 
-If you have a project directory that is currently not under version control and you want to start controlling it with Git, you first need to go to that project's directory.
-If you've never done this, it looks a little different depending on which system you're running:
+إذا كان لديك دليل مشروع لا يخضع حالياً للتحكم في الإصدار (version control) وتريد البدء في التحكم فيه باستخدام Git، فعليك أولاً الانتقال إلى دليل ذلك المشروع.
+إذا لم تفعل ذلك من قبل، فسيبدو الأمر مختلفاً قليلاً بناءً على النظام الذي تقوم بتشغيله:
 
-for Linux:
+لنظام Linux:
 [source,console]
 ----
 $ cd /home/user/my_project
 ----
-for macOS:
+لنظام macOS:
 [source,console]
 ----
 $ cd /Users/user/my_project
 ----
-for Windows:
+لنظام Windows:
 [source,console]
 ----
 $ cd C:/Users/user/my_project
 ----
 
-and type:
+واكتب:
 
 [source,console]
 ----
 $ git init
 ----
 
-This creates a new subdirectory named `.git` that contains all of your necessary repository files -- a Git repository skeleton.
-At this point, nothing in your project is tracked yet.
-See <<ch10-git-internals#ch10-git-internals>> for more information about exactly what files are contained in the `.git` directory you just created.(((git commands, init)))
+يؤدي هذا إلى إنشاء دليل فرعي جديد (new subdirectory) باسم `.git` يحتوي على جميع ملفات المستودع (repository files) الضرورية -- هيكل مستودع Git (Git repository skeleton).
+في هذه المرحلة، لا يتم تتبع (tracked) أي شيء في مشروعك بعد.
+راجع <<ch10-git-internals#ch10-git-internals>> لمزيد من المعلومات حول الملفات الموجودة بالضبط في دليل `.git` الذي قمت بإنشائه للتو.(((git commands, init)))
 
-If you want to start version-controlling existing files (as opposed to an empty directory), you should probably begin tracking those files and do an initial commit.
-You can accomplish that with a few `git add` commands that specify the files you want to track, followed by a `git commit`:
+إذا كنت ترغب في البدء في التحكم في إصدار الملفات الموجودة (على عكس الدليل الفارغ)، فربما يجب عليك البدء في تتبع (tracking) تلك الملفات وإجراء عملية تأكيد أولية (initial commit).
+يمكنك إنجاز ذلك ببضعة أوامر `git add` تحدد الملفات التي تريد تتبعها، متبوعة بأمر `git commit`:
 
 [source,console]
 ----
@@ -50,38 +50,38 @@ $ git add LICENSE
 $ git commit -m 'Initial project version'
 ----
 
-We'll go over what these commands do in just a minute.
-At this point, you have a Git repository with tracked files and an initial commit.
+سنستعرض ما تفعله هذه الأوامر في غضون دقيقة.
+في هذه المرحلة، لديك مستودع Git بملفات متتبعة (tracked files) وعملية تأكيد أولية (initial commit).
 
 [[_git_cloning]]
-==== Cloning an Existing Repository
+==== Cloning an Existing Repository (استنساخ مستودع موجود)
 
-If you want to get a copy of an existing Git repository -- for example, a project you'd like to contribute to -- the command you need is `git clone`.
-If you're familiar with other VCSs such as Subversion, you'll notice that the command is "clone" and not "checkout".
-This is an important distinction -- instead of getting just a working copy, Git receives a full copy of nearly all data that the server has.
-Every version of every file for the history of the project is pulled down by default when you run `git clone`.
-In fact, if your server disk gets corrupted, you can often use nearly any of the clones on any client to set the server back to the state it was in when it was cloned (you may lose some server-side hooks and such, but all the versioned data would be there -- see <<ch04-git-on-the-server#_getting_git_on_a_server>> for more details).
+إذا كنت ترغب في الحصول على نسخة من مستودع Git (Git repository) موجود -- على سبيل المثال، مشروع ترغب في المساهمة فيه -- فإن الأمر الذي تحتاجه هو `git clone`.
+إذا كنت على دراية بأنظمة VCS (أنظمة التحكم في الإصدارات) الأخرى مثل Subversion، فستلاحظ أن الأمر هو "استنساخ (clone)" وليس "سحب (checkout)".
+هذا تمييز مهم -- فبدلاً من الحصول على مجرد نسخة عمل (working copy)، يتلقى Git نسخة كاملة (full copy) من جميع البيانات الموجودة على الخادم تقريباً.
+يتم سحب كل إصدار من كل ملف لسجل (history) المشروع افتراضياً عند تشغيل `git clone`.
+في الواقع، إذا تلف قرص الخادم، يمكنك غالباً استخدام أي من النسخ المستنسخة (clones) على أي عميل (client) لإعادة الخادم إلى الحالة التي كان عليها عند استنساخه (قد تفقد بعض خطافات جانب الخادم (server-side hooks) وما شابه، ولكن ستكون جميع البيانات ذات الإصدارات موجودة -- راجع <<ch04-git-on-the-server#_getting_git_on_a_server>> لمزيد من التفاصيل).
 
-You clone a repository with `git clone <url>`.(((git commands, clone)))
-For example, if you want to clone the Git linkable library called `libgit2`, you can do so like this:
+أنت تستنسخ (clone) مستودعاً (repository) باستخدام `git clone <url>`.(((git commands, clone)))
+على سبيل المثال، إذا كنت تريد استنساخ مكتبة Git القابلة للربط المسماة `libgit2`، فيمكنك القيام بذلك على النحو التالي:
 
 [source,console]
 ----
 $ git clone https://github.com/libgit2/libgit2
 ----
 
-That creates a directory named `libgit2`, initializes a `.git` directory inside it, pulls down all the data for that repository, and checks out a working copy of the latest version.
-If you go into the new `libgit2` directory that was just created, you'll see the project files in there, ready to be worked on or used.
+يؤدي ذلك إلى إنشاء دليل باسم `libgit2`، وتهيئة دليل `.git` بداخله، وسحب (pulls down) جميع البيانات الخاصة بذلك المستودع، واستخراج (checks out) نسخة عمل (working copy) لأحدث إصدار.
+إذا ذهبت إلى دليل `libgit2` الجديد الذي تم إنشاؤه للتو، فسترى ملفات المشروع هناك، جاهزة للعمل عليها أو استخدامها.
 
-If you want to clone the repository into a directory named something other than `libgit2`, you can specify the new directory name as an additional argument:
+إذا كنت تريد استنساخ المستودع (repository) في دليل باسم آخر غير `libgit2`، فيمكنك تحديد اسم الدليل الجديد كوسيطة (argument) إضافية:
 
 [source,console]
 ----
 $ git clone https://github.com/libgit2/libgit2 mylibgit
 ----
 
-That command does the same thing as the previous one, but the target directory is called `mylibgit`.
+يقوم هذا الأمر بنفس الشيء الذي يقوم به الأمر السابق، ولكن يسمى الدليل الهدف `mylibgit`.
 
-Git has a number of different transfer protocols you can use.
-The previous example uses the `https://` protocol, but you may also see `git://` or `user@server:path/to/repo.git`, which uses the SSH transfer protocol.
-<<ch04-git-on-the-server#_getting_git_on_a_server>> will introduce all of the available options the server can set up to access your Git repository and the pros and cons of each.
+يحتوي Git على عدد من بروتوكولات النقل المختلفة (transfer protocols) التي يمكنك استخدامها.
+يستخدم المثال السابق بروتوكول `https://`، ولكن قد ترى أيضاً `git://` أو `user@server:path/to/repo.git`، والذي يستخدم بروتوكول نقل SSH.
+سيعرض <<ch04-git-on-the-server#_getting_git_on_a_server>> جميع الخيارات المتاحة التي يمكن للخادم إعدادها للوصول إلى مستودع Git (Git repository) الخاص بك وإيجابيات وسلبيات كل منها.