Translate Chapter 4 git-daemon and smart-http sections to Arabic

- Translated `book/04-git-server/sections/git-daemon.asc` and `book/04-git-server/sections/smart-http.asc` to Arabic. - Preserved technical terms in parentheses next to Arabic translation. - Kept AsciiDoc formatting intact. - Updated `status.json` to mark translated files as 100% complete. Co-authored-by: essa01442 <73353997+essa01442@users.noreply.github.com>
progit · essa01442 · Mar 20, 2026 · Mar 20, 2026 · Mar 20, 2026 · Mar 20, 2026
commit 0f3a66bcd64cdba95d26648238fa70b873e2a46b
diff --git a/book/04-git-server/sections/generating-ssh-key.asc b/book/04-git-server/sections/generating-ssh-key.asc
@@ -1,13 +1,13 @@
 [[_generate_ssh_key]]
-=== Generating Your SSH Public Key
+=== Generating Your SSH Public Key (إنشاء مفتاحك العام لـ SSH)
 
 (((SSH keys)))
-Many Git servers authenticate using SSH public keys.
-In order to provide a public key, each user in your system must generate one if they don't already have one.
-This process is similar across all operating systems.
-First, you should check to make sure you don't already have a key.
-By default, a user's SSH keys are stored in that user's `~/.ssh` directory.
-You can easily check to see if you have a key already by going to that directory and listing the contents:
+تتم مصادقة (authenticate) العديد من خوادم Git باستخدام المفاتيح العامة لـ SSH (SSH public keys).
+من أجل توفير مفتاح عام (public key)، يجب على كل مستخدم في نظامك إنشاء واحد إذا لم يكن لديه واحد بالفعل.
+هذه العملية متشابهة عبر جميع أنظمة التشغيل (operating systems).
+أولاً، يجب عليك التحقق للتأكد من أنه ليس لديك مفتاح (key) بالفعل.
+بشكل افتراضي، يتم تخزين مفاتيح SSH (SSH keys) الخاصة بالمستخدم في دليل `~/.ssh` الخاص بذلك المستخدم.
+يمكنك بسهولة التحقق لمعرفة ما إذا كان لديك مفتاح بالفعل عن طريق الانتقال إلى ذلك الدليل وسرد (listing) محتوياته:
 
 [source,console]
 ----
@@ -17,9 +17,9 @@ authorized_keys2  id_dsa       known_hosts
 config            id_dsa.pub
 ----
 
-You're looking for a pair of files named something like `id_dsa` or `id_rsa` and a matching file with a `.pub` extension.
-The `.pub` file is your public key, and the other file is the corresponding private key.
-If you don't have these files (or you don't even have a `.ssh` directory), you can create them by running a program called `ssh-keygen`, which is provided with the SSH package on Linux/macOS systems and comes with Git for Windows:
+أنت تبحث عن زوج (pair) من الملفات تسمى شيئاً مثل `id_dsa` أو `id_rsa` وملف مطابق بامتداد `.pub`.
+الملف `.pub` هو مفتاحك العام (public key)، والملف الآخر هو المفتاح الخاص (private key) المقابل.
+إذا لم تكن لديك هذه الملفات (أو ليس لديك حتى دليل `.ssh`)، يمكنك إنشاؤها عن طريق تشغيل برنامج يسمى `ssh-keygen`، والذي يتم توفيره مع حزمة SSH على أنظمة Linux/macOS ويأتي مع Git لنظام Windows (Git for Windows):
 
 [source,console]
 ----
@@ -35,13 +35,13 @@ The key fingerprint is:
 d0:82:24:8e:d7:f1:bb:9b:33:53:96:93:49:da:9b:e3 schacon@mylaptop.local
 ----
 
-First it confirms where you want to save the key (`.ssh/id_rsa`), and then it asks twice for a passphrase, which you can leave empty if you don't want to type a password when you use the key.
-However, if you do use a password, make sure to add the `-o` option; it saves the private key in a format that is more resistant to brute-force password cracking than is the default format.
-You can also use the `ssh-agent` tool to prevent having to enter the password each time.
+أولاً يؤكد المكان الذي تريد حفظ المفتاح فيه (`.ssh/id_rsa`)، ثم يطلب مرتين إدخال عبارة مرور (passphrase)، والتي يمكنك تركها فارغة إذا كنت لا تريد كتابة كلمة مرور (password) عند استخدام المفتاح.
+ومع ذلك، إذا كنت تستخدم كلمة مرور (password)، فتأكد من إضافة الخيار `-o`؛ فهو يحفظ المفتاح الخاص (private key) بتنسيق أكثر مقاومة لاختراق كلمات المرور بالقوة الغاشمة (brute-force password cracking) من التنسيق الافتراضي.
+يمكنك أيضاً استخدام أداة `ssh-agent` لتجنب الاضطرار إلى إدخال كلمة المرور (password) في كل مرة.
 
-Now, each user that does this has to send their public key to you or whoever is administrating the Git server (assuming you're using an SSH server setup that requires public keys).
-All they have to do is copy the contents of the `.pub` file and email it.
-The public keys look something like this:
+الآن، يجب على كل مستخدم يفعل ذلك إرسال مفتاحه العام (public key) إليك أو إلى الشخص الذي يدير خادم Git (بافتراض أنك تستخدم إعداد خادم SSH (SSH server setup) يتطلب مفاتيح عامة).
+كل ما عليهم فعله هو نسخ محتويات الملف `.pub` وإرسالها بالبريد الإلكتروني.
+تبدو المفاتيح العامة (public keys) كالتالي:
 
 [source,console]
 ----
@@ -54,4 +54,4 @@ mZ+AW4OZPnTPI89ZPmVMLuayrD2cE86Z/il8b+gw3r3+1nKatmIkjn2so1d01QraTlMqVSsbx
 NrRFi9wrf+M7Q== schacon@mylaptop.local
 ----
 
-For a more in-depth tutorial on creating an SSH key on multiple operating systems, see the GitHub guide on SSH keys at https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent[^].
+للحصول على برنامج تعليمي (tutorial) أكثر تعمقاً حول إنشاء مفتاح SSH (SSH key) على أنظمة تشغيل (operating systems) متعددة، راجع دليل GitHub حول مفاتيح SSH على https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent[^].
diff --git a/book/04-git-server/sections/git-daemon.asc b/book/04-git-server/sections/git-daemon.asc
@@ -1,28 +1,28 @@
-=== Git Daemon
+=== Git Daemon (الخادم الخفي لـ Git)
 
 (((serving repositories, git protocol)))
-Next we'll set up a daemon serving repositories using the "`Git`" protocol.
-This is a common choice for fast, unauthenticated access to your Git data.
-Remember that since this is not an authenticated service, anything you serve over this protocol is public within its network.
+بعد ذلك سنقوم بإعداد خادم خفي (daemon) يقدم المستودعات (serving repositories) باستخدام بروتوكول "`Git`".
+هذا خيار شائع للوصول السريع وغير المصادق عليه (fast, unauthenticated access) إلى بيانات Git الخاصة بك.
+تذكر أنه نظراً لأن هذه ليست خدمة مصادق عليها (authenticated service)، فإن أي شيء تقدمه (serve) عبر هذا البروتوكول يكون عاماً (public) داخل شبكته.
 
-If you're running this on a server outside your firewall, it should be used only for projects that are publicly visible to the world.
-If the server you're running it on is inside your firewall, you might use it for projects that a large number of people or computers (continuous integration or build servers) have read-only access to, when you don't want to have to add an SSH key for each.
+إذا كنت تقوم بتشغيل هذا على خادم خارج جدار الحماية (firewall) الخاص بك، فيجب استخدامه فقط للمشاريع المرئية علناً (publicly visible) للعالم.
+إذا كان الخادم الذي تقوم بتشغيله عليه يقع داخل جدار الحماية (firewall) الخاص بك، فيمكنك استخدامه للمشاريع التي يتمتع فيها عدد كبير من الأشخاص أو أجهزة الكمبيوتر (خوادم التكامل المستمر (continuous integration) أو البناء (build servers)) بوصول للقراءة فقط (read-only access)، عندما لا ترغب في الاضطرار إلى إضافة مفتاح SSH (SSH key) لكل منها.
 
-In any case, the Git protocol is relatively easy to set up.
-Basically, you need to run this command in a daemonized manner:(((git commands, daemon)))
+على أي حال، من السهل نسبياً إعداد (set up) بروتوكول Git.
+في الأساس، تحتاج إلى تشغيل هذا الأمر بطريقة الخفي (daemonized manner):(((git commands, daemon)))
 
 [source,console]
 ----
 $ git daemon --reuseaddr --base-path=/srv/git/ /srv/git/
 ----
 
-The `--reuseaddr` option allows the server to restart without waiting for old connections to time out, while the `--base-path` option allows people to clone projects without specifying the entire path, and the path at the end tells the Git daemon where to look for repositories to export.
-If you're running a firewall, you'll also need to punch a hole in it at port 9418 on the box you're setting this up on.
+يسمح الخيار `--reuseaddr` للخادم بإعادة التشغيل (restart) دون انتظار انتهاء مهلة الاتصالات القديمة (old connections to time out)، بينما يسمح الخيار `--base-path` للأشخاص باستنساخ (clone) المشاريع دون تحديد المسار بأكمله (entire path)، والمسار الموجود في النهاية يخبر الخادم الخفي لـ Git (Git daemon) بمكان البحث عن المستودعات (repositories) لتصديرها (export).
+إذا كنت تقوم بتشغيل جدار حماية (firewall)، فستحتاج أيضاً إلى إحداث ثقب (punch a hole) فيه عند المنفذ (port) 9418 على الجهاز الذي تقوم بإعداد هذا عليه.
 
-You can daemonize this process a number of ways, depending on the operating system you're running.
+يمكنك جعل هذه العملية خفية (daemonize this process) بعدة طرق، اعتماداً على نظام التشغيل (operating system) الذي تقوم بتشغيله.
 
-Since `systemd` is the most common init system among modern Linux distributions, you can use it for that purpose.
-Simply place a file in `/etc/systemd/system/git-daemon.service` with these contents:
+نظراً لأن `systemd` هو نظام التهيئة (init system) الأكثر شيوعاً بين توزيعات Linux (Linux distributions) الحديثة، فيمكنك استخدامه لهذا الغرض.
+ببساطة ضع ملفاً في `/etc/systemd/system/git-daemon.service` بهذه المحتويات:
 
 [source,console]
 ----
@@ -46,21 +46,21 @@ Group=git
 WantedBy=multi-user.target
 ----
 
-You might have noticed that Git daemon is started here with `git` as both group and user.
-Modify it to fit your needs and make sure the provided user exists on the system.
-Also, check that the Git binary is indeed located at `/usr/bin/git` and change the path if necessary.
+ربما لاحظت أنه يتم بدء تشغيل الخادم الخفي لـ Git (Git daemon) هنا باستخدام `git` كمجموعة (group) ومستخدم (user) على حد سواء.
+قم بتعديله ليناسب احتياجاتك وتأكد من وجود المستخدم (user) المقدم على النظام.
+تحقق أيضاً من أن الملف الثنائي لـ Git (Git binary) موجود بالفعل في `/usr/bin/git` وقم بتغيير المسار (path) إذا لزم الأمر.
 
-Finally, you'll run `systemctl enable git-daemon` to automatically start the service on boot, and can start and stop the service with, respectively, `systemctl start git-daemon` and `systemctl stop git-daemon`.
+أخيراً، ستقوم بتشغيل `systemctl enable git-daemon` لبدء تشغيل الخدمة (service) تلقائياً عند التمهيد (boot)، ويمكنك بدء الخدمة وإيقافها (start and stop the service) باستخدام `systemctl start git-daemon` و `systemctl stop git-daemon` على التوالي.
 
-On other systems, you may want to use `xinetd`, a script in your `sysvinit` system, or something else -- as long as you get that command daemonized and watched somehow.
+على الأنظمة الأخرى، قد ترغب في استخدام `xinetd`، وهو برنامج نصي (script) في نظام `sysvinit` الخاص بك، أو شيء آخر -- طالما أنك تحصل على هذا الأمر كخفي (daemonized) ومراقب (watched) بطريقة ما.
 
-Next, you have to tell Git which repositories to allow unauthenticated Git server-based access to.
-You can do this in each repository by creating a file named `git-daemon-export-ok`.
+بعد ذلك، يجب عليك إخبار Git بالمستودعات (repositories) التي يجب السماح فيها بالوصول غير المصادق عليه (unauthenticated) المستند إلى خادم Git (Git server-based access).
+يمكنك القيام بذلك في كل مستودع عن طريق إنشاء ملف يسمى `git-daemon-export-ok`.
 
 [source,console]
 ----
 $ cd /path/to/project.git
 $ touch git-daemon-export-ok
 ----
 
-The presence of that file tells Git that it's OK to serve this project without authentication.
+يخبر وجود ذلك الملف Git أنه لا بأس بتقديم (serve) هذا المشروع دون مصادقة (authentication).