1

book/01-introduction/sections/about-version-control.asc

@@ -1,61 +1,61 @@
-=== About Version Control
+=== About Version Control (حول التحكم في الإصدارات)
 
 (((version control)))
-What is "`version control`", and why should you care?
-Version control is a system that records changes to a file or set of files over time so that you can recall specific versions later.
-For the examples in this book, you will use software source code as the files being version controlled, though in reality you can do this with nearly any type of file on a computer.
+ما هو "`version control`" (نظام التحكم في الإصدارات)، ولماذا يجب أن تهتم به؟
+Version control (نظام التحكم في الإصدارات) هو نظام يقوم بتسجيل التغييرات على ملف أو مجموعة من الملفات بمرور الوقت بحيث يمكنك استدعاء إصدارات محددة لاحقاً.
+بالنسبة للأمثلة في هذا الكتاب، ستستخدم كود المصدر البرمجي (software source code) كملفات يتم التحكم في إصداراتها، على الرغم من أنه في الواقع يمكنك القيام بذلك مع أي نوع من الملفات تقريباً على الكمبيوتر.
 
-If you are a graphic or web designer and want to keep every version of an image or layout (which you would most certainly want to), a Version Control System (VCS) is a very wise thing to use.
-It allows you to revert selected files back to a previous state, revert the entire project back to a previous state, compare changes over time, see who last modified something that might be causing a problem, who introduced an issue and when, and more.
-Using a VCS also generally means that if you screw things up or lose files, you can easily recover.
-In addition, you get all this for very little overhead.
+إذا كنت مصمم جرافيك أو ويب وترغب في الاحتفاظ بكل إصدار من صورة أو تخطيط (وهو ما سترغب به بالتأكيد)، فإن استخدام Version Control System (VCS) (نظام التحكم في الإصدارات) هو أمر حكيم جداً.
+إنه يتيح لك إعادة الملفات المحددة إلى حالة سابقة (revert)، وإعادة المشروع بأكمله إلى حالة سابقة، ومقارنة التغييرات بمرور الوقت، ومعرفة من قام بتعديل شيء ما قد يتسبب في مشكلة، ومن أدخل مشكلة ومتى، والمزيد.
+استخدام VCS (نظام التحكم في الإصدارات) يعني أيضاً بشكل عام أنه إذا أفسدت الأمور أو فقدت ملفات، يمكنك بسهولة الاسترداد (recover).
+بالإضافة إلى ذلك، يمكنك الحصول على كل هذا مقابل القليل جداً من العبء الإضافي (overhead).
 
-==== Local Version Control Systems
+==== Local Version Control Systems (أنظمة التحكم في الإصدارات المحلية)
 
 (((version control,local)))
-Many people's version-control method of choice is to copy files into another directory (perhaps a time-stamped directory, if they're clever).
-This approach is very common because it is so simple, but it is also incredibly error prone.
-It is easy to forget which directory you're in and accidentally write to the wrong file or copy over files you don't mean to.
+طريقة Version-control (التحكم في الإصدارات) المفضلة لدى الكثير من الناس هي نسخ الملفات إلى دليل آخر (ربما دليل يحمل طابعاً زمنياً، إذا كانوا أذكياء).
+هذا النهج شائع جداً لأنه بسيط للغاية، ولكنه أيضاً عرضة للخطأ بشكل لا يصدق.
+من السهل أن تنسى الدليل الذي تتواجد فيه وتكتب عن طريق الخطأ في الملف الخاطئ أو تنسخ فوق ملفات لا تقصدها.
 
-To deal with this issue, programmers long ago developed local VCSs that had a simple database that kept all the changes to files under revision control.
+للتعامل مع هذه المشكلة، قام المبرمجون منذ فترة طويلة بتطوير أنظمة VCS (أنظمة التحكم في الإصدارات) محلية تحتوي على قاعدة بيانات بسيطة تحتفظ بجميع التغييرات التي تطرأ على الملفات تحت Revision control (نظام التحكم في المراجعة).
 
-.Local version control diagram
+.Local version control diagram (مخطط نظام التحكم في الإصدارات المحلي)
 image::images/local.png[Local version control diagram]
 
-One of the most popular VCS tools was a system called RCS, which is still distributed with many computers today.
-https://www.gnu.org/software/rcs/[RCS^] works by keeping patch sets (that is, the differences between files) in a special format on disk; it can then re-create what any file looked like at any point in time by adding up all the patches.
+أحد أكثر أدوات VCS (أنظمة التحكم في الإصدارات) شيوعاً كان نظاماً يسمى RCS، والذي لا يزال يتم توزيعه مع العديد من أجهزة الكمبيوتر اليوم.
+يعمل https://www.gnu.org/software/rcs/[RCS^] عن طريق الاحتفاظ بمجموعات التصحيح (patch sets) (أي الاختلافات بين الملفات) بتنسيق خاص على القرص؛ يمكنه بعد ذلك إعادة إنشاء شكل أي ملف في أي وقت عن طريق جمع جميع التصحيحات (patches).
 
-==== Centralized Version Control Systems
+==== Centralized Version Control Systems (أنظمة التحكم في الإصدارات المركزية)
 
 (((version control,centralized)))
-The next major issue that people encounter is that they need to collaborate with developers on other systems.
-To deal with this problem, Centralized Version Control Systems (CVCSs) were developed.
-These systems (such as CVS, Subversion, and Perforce) have a single server that contains all the versioned files, and a number of clients that check out files from that central place.(((CVS)))(((Subversion)))(((Perforce)))
-For many years, this has been the standard for version control.
+المشكلة الرئيسية التالية التي يواجهها الأشخاص هي أنهم بحاجة إلى التعاون مع مطورين على أنظمة أخرى.
+للتعامل مع هذه المشكلة، تم تطوير Centralized Version Control Systems (CVCSs) (أنظمة التحكم في الإصدارات المركزية).
+تحتوي هذه الأنظمة (مثل CVS و Subversion و Perforce) على خادم واحد (single server) يحتوي على جميع الملفات ذات الإصدارات، وعدد من العملاء (clients) الذين يقومون بسحب (check out) الملفات من ذلك المكان المركزي.(((CVS)))(((Subversion)))(((Perforce)))
+لسنوات عديدة، كان هذا هو المعيار للتحكم في الإصدارات.
 
-.Centralized version control diagram
+.Centralized version control diagram (مخطط نظام التحكم في الإصدارات المركزي)
 image::images/centralized.png[Centralized version control diagram]
 
-This setup offers many advantages, especially over local VCSs.
-For example, everyone knows to a certain degree what everyone else on the project is doing.
-Administrators have fine-grained control over who can do what, and it's far easier to administer a CVCS than it is to deal with local databases on every client.
+يوفر هذا الإعداد العديد من المزايا، خاصة على أنظمة VCS (أنظمة التحكم في الإصدارات) المحلية.
+على سبيل المثال، يعرف الجميع إلى حد معين ما يفعله كل شخص آخر في المشروع.
+يتمتع المسؤولون (Administrators) بتحكم دقيق في من يمكنه فعل ماذا، ومن الأسهل بكثير إدارة نظام CVCS (نظام تحكم في الإصدارات مركزي) بدلاً من التعامل مع قواعد البيانات المحلية على كل عميل (client).
 
-However, this setup also has some serious downsides.
-The most obvious is the single point of failure that the centralized server represents.
-If that server goes down for an hour, then during that hour nobody can collaborate at all or save versioned changes to anything they're working on.
-If the hard disk the central database is on becomes corrupted, and proper backups haven't been kept, you lose absolutely everything -- the entire history of the project except whatever single snapshots people happen to have on their local machines.
-Local VCSs suffer from this same problem -- whenever you have the entire history of the project in a single place, you risk losing everything.
+ومع ذلك، فإن هذا الإعداد يحتوي أيضاً على بعض السلبيات الخطيرة.
+الأكثر وضوحاً هو نقطة الفشل الوحيدة (single point of failure) التي يمثلها الخادم المركزي (centralized server).
+إذا تعطل ذلك الخادم لمدة ساعة، فخلال تلك الساعة لا يمكن لأي شخص التعاون على الإطلاق أو حفظ التغييرات ذات الإصدارات لأي شيء يعملون عليه.
+إذا تلف القرص الصلب الموجود عليه قاعدة البيانات المركزية (central database)، ولم يتم الاحتفاظ بنسخ احتياطية (backups) مناسبة، فإنك تفقد كل شيء تماماً -- السجل الكامل (entire history) للمشروع باستثناء أي لقطات (snapshots) فردية قد يمتلكها الأشخاص على أجهزتهم المحلية.
+تعاني أنظمة VCS (أنظمة التحكم في الإصدارات) المحلية من نفس هذه المشكلة -- متى ما كان لديك السجل الكامل للمشروع في مكان واحد، فإنك تخاطر بفقدان كل شيء.
 
-==== Distributed Version Control Systems
+==== Distributed Version Control Systems (أنظمة التحكم في الإصدارات الموزعة)
 
 (((version control,distributed)))
-This is where Distributed Version Control Systems (DVCSs) step in.
-In a DVCS (such as Git, Mercurial or Darcs), clients don't just check out the latest snapshot of the files; rather, they fully mirror the repository, including its full history.
-Thus, if any server dies, and these systems were collaborating via that server, any of the client repositories can be copied back up to the server to restore it.
-Every clone is really a full backup of all the data.
+هنا تتدخل Distributed Version Control Systems (DVCSs) (أنظمة التحكم في الإصدارات الموزعة).
+في نظام DVCS (مثل Git أو Mercurial أو Darcs)، لا يكتفي العملاء (clients) بسحب أحدث لقطة (snapshot) للملفات فحسب؛ بل إنهم يعكسون (mirror) المستودع (repository) بالكامل، بما في ذلك سجله الكامل (full history).
+وبالتالي، إذا تعطل أي خادم، وكانت هذه الأنظمة تتعاون عبر ذلك الخادم، يمكن نسخ أي من مستودعات العملاء مرة أخرى إلى الخادم لاستعادته (restore it).
+كل نسخة (clone) هي في الواقع نسخة احتياطية كاملة (full backup) من جميع البيانات.
 
-.Distributed version control diagram
+.Distributed version control diagram (مخطط نظام التحكم في الإصدارات الموزع)
 image::images/distributed.png[Distributed version control diagram]
 
-Furthermore, many of these systems deal pretty well with having several remote repositories they can work with, so you can collaborate with different groups of people in different ways simultaneously within the same project.
-This allows you to set up several types of workflows that aren't possible in centralized systems, such as hierarchical models.
+علاوة على ذلك، فإن العديد من هذه الأنظمة تتعامل بشكل جيد مع وجود العديد من Remote repositories (المستودعات البعيدة) التي يمكنهم العمل معها، بحيث يمكنك التعاون مع مجموعات مختلفة من الأشخاص بطرق مختلفة في وقت واحد داخل نفس المشروع.
+يتيح لك ذلك إعداد عدة أنواع من مسارات العمل (workflows) غير الممكنة في الأنظمة المركزية، مثل النماذج الهرمية (hierarchical models).

book/01-introduction/sections/command-line.asc

@@ -1,11 +1,11 @@
-=== The Command Line
+=== The Command Line (سطر الأوامر)
 
-There are a lot of different ways to use Git.
-There are the original command-line tools, and there are many graphical user interfaces of varying capabilities.
-For this book, we will be using Git on the command line.
-For one, the command line is the only place you can run _all_ Git commands -- most of the GUIs implement only a partial subset of Git functionality for simplicity.
-If you know how to run the command-line version, you can probably also figure out how to run the GUI version, while the opposite is not necessarily true.
-Also, while your choice of graphical client is a matter of personal taste, _all_ users will have the command-line tools installed and available.
+هناك الكثير من الطرق المختلفة لاستخدام Git.
+هناك أدوات سطر الأوامر (command-line tools) الأصلية، وهناك العديد من واجهات المستخدم الرسومية (graphical user interfaces) ذات الإمكانيات المتفاوتة.
+في هذا الكتاب، سنستخدم Git على سطر الأوامر (command line).
+أولاً، سطر الأوامر (command line) هو المكان الوحيد الذي يمكنك فيه تشغيل _جميع_ أوامر Git -- فمعظم واجهات المستخدم الرسومية (GUIs) تنفذ فقط مجموعة فرعية جزئية من وظائف Git للتبسيط.
+إذا كنت تعرف كيفية تشغيل إصدار سطر الأوامر (command-line version)، فربما يمكنك أيضاً معرفة كيفية تشغيل إصدار واجهة المستخدم الرسومية (GUI version)، بينما العكس ليس صحيحاً بالضرورة.
+أيضاً، في حين أن اختيارك للعميل الرسومي (graphical client) هو مسألة ذوق شخصي، فإن _جميع_ المستخدمين سيكون لديهم أدوات سطر الأوامر (command-line tools) مثبتة ومتاحة.
 
-So we will expect you to know how to open Terminal in macOS or Command Prompt or PowerShell in Windows.
-If you don't know what we're talking about here, you may need to stop and research that quickly so that you can follow the rest of the examples and descriptions in this book.
+لذلك نتوقع منك أن تعرف كيفية فتح نافذة Terminal في نظام macOS أو Command Prompt أو PowerShell في نظام Windows.
+إذا كنت لا تعرف عما نتحدث عنه هنا، فقد تحتاج إلى التوقف والبحث عن ذلك بسرعة حتى تتمكن من متابعة بقية الأمثلة والأوصاف في هذا الكتاب.