Merge branch 'master' of github.com:javascript-tutorial/ar.javascript.info

Author: dvmhmdsd

1-js/01-getting-started/2-manuals-specifications/article.md

@@ -1,42 +1,40 @@
+# المراجع و المواصفات
 
-# Manuals and specifications
+هذا الكتاب هو _دورة تعليميه_. يهدف الى تعليمك اللغه تدريجيا. و لكن إذا كنت علي علم بالأساسيات فسوف تحتاج الى مصدر آخر.
 
-This book is a *tutorial*. It aims to help you gradually learn the language. But once you're familiar with the basics, you'll need other sources.
+## الوصف
 
-## Specification
+[وصف The ECMA-262](https://www.ecma-international.org/publications/standards/Ecma-262.htm) يحتوي على المعلومات الإكثر عمقاً و تفصيلاً و رسميةً عن جافاسكريبت.و هي تقوم بتعريف اللغه.
 
-[The ECMA-262 specification](https://www.ecma-international.org/publications/standards/Ecma-262.htm) contains the most in-depth, detailed and formalized information about JavaScript. It defines the language.
+و لكن كونها بهذه الرسمية, تجعل فهمها من اول مره صعب. لذلك إذا كنت تريد مصدر المعلومه الأكثر وثوقاً عن تفاصيل اللغه, الوصف هو المكان الصحيح. لكنها ليست للإستعمال اليومي.
 
-But being that formalized, it's difficult to understand at first. So if you need the most trustworthy source of information about the language details, the specification is the right place. But it's not for everyday use.
+نسخة وصف جديدة تُصدر كل عام. فيما بين هذه الإصدارات, آخر مسودة وصف توجد في <https://tc39.es/ecma262/>.
 
-A new specification version is released every year. In-between these releases, the latest specification draft is at <https://tc39.es/ecma262/>.
+لكى تقرأ عن خصائص التطور الحاد الجديد, بما فى ذلك "المعايير التقريبيه" (ما يسمي "المرحلة 3"), انظر للمقترحات في <https://github.com/tc39/proposals>.
 
-To read about new bleeding-edge features, including those that are "almost standard" (so-called "stage 3"), see proposals at <https://github.com/tc39/proposals>.
+أيضاً, إذا كنت تطور من أجل المتصفح, إذاهناك مواصفات اخري مشمولة في [الجزء الثاني](info:browser-environment) من الدورة التعليميه.
 
-Also, if you're in developing for the browser, then there are other specs covered in the [second part](info:browser-environment) of the tutorial.
+## المراجع
 
-## Manuals
+- **MDN (Mozilla) JavaScript Reference** هذا دليل بأمثلة ومعلومات أخرى. مصدر جيد للحصول على معلومات تفصيلية حول ميزات اللغة ، وطرق الكائنات المضمنة ، وما إلى ذلك.
 
-- **MDN (Mozilla) JavaScript Reference** is a manual with examples and other information. It's great to get in-depth information about individual language functions, methods etc.
+  يمكن ان تجدها في <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.
 
-    One can find it at <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.
+  ايضاً, غالباً ما يكون من الأفضل استخدام بحث عبر الإنترنت بدلاً من ذلك. فقط إستخدم "[مصطلح] MDN" للإستعلام, مثال. <https://google.com/search?q=MDN+parseInt> لتبحث عن دالة `parseInt`.
 
-    Although, it's often best to use an internet search instead. Just use "MDN [term]" in the query, e.g. <https://google.com/search?q=MDN+parseInt> to search for `parseInt` function.
+* **MSDN** – مراجع ميكروسوفت يوجد بها معلومات كثيرة, متضمنه جافاسكريبت (غالباً يشار إليها JScript). إذا كنت تريد شيئا أكثر تخصصا عن انترنت اكسبلورر, من الأفضل الذهاب إلى: <http://msdn.microsoft.com/>.
 
+  أيضاً, يمكن غن نستخدم بحث الإنترنت بعبارات مثل "RegExp MSDN" or "RegExp MSDN jscript".
 
-- **MSDN** – Microsoft manual with a lot of information, including JavaScript (often referred to as JScript). If one needs something specific to Internet Explorer, better go there: <http://msdn.microsoft.com/>.
+## جدول التوافق
 
-    Also, we can use an internet search with phrases such as "RegExp MSDN" or "RegExp MSDN jscript".
+جافاسكريبت لغه فى سياق متطور, خصائص جديدة تضاف إليها بإنتظام.
 
-## Compatibility tables
+لتري دعمهم ما بين المتصفحات و المحركات الأخري, أنظر:
 
-JavaScript is a developing language, new features get added regularly.
+- <http://caniuse.com> - جدول الدعم لكل خاصيه, مثال. لترى اى من المحركات يدعم دوال التشفير الحديث: <http://caniuse.com/#feat=cryptography>.
+- <https://kangax.github.io/compat-table> - جدول بمواصفات و محركات اللغه و قابلية دعم كل محرك لكل خاصية.
 
-To see their support among browser-based and other engines, see:
+كل هذه المصادر مفيدة في تطوير الحياة الواقعيه, لأنها تحتوي علي معلومات قيّمة عن تفاصيل و دعم اللغة .
 
-- <http://caniuse.com> - per-feature tables of support, e.g. to see which engines support modern cryptography functions: <http://caniuse.com/#feat=cryptography>.
-- <https://kangax.github.io/compat-table> - a table with language features and engines that support those or don't support.
-
-All these resources are useful in real-life development, as they contain valuable information about language details, their support etc.
-
-Please remember them (or this page) for the cases when you need in-depth information about a particular feature.
+من فضلك تذكر هذه المصادر (او هذه الصفحه) فى حالات إذا كنت تريد معلومات اعمق عن خاصية معينة.

1-js/02-first-steps/04-variables/1-hello-variables/solution.md

@@ -1,7 +1,7 @@
-In the code below, each line corresponds to the item in the task list.
+في الكود أدناه ، يتوافق كل سطر مع العنصر في قائمة المهام.
 
 ```js run
-let admin, name; // can declare two variables at once
+let admin, name; // نستطيع تعريف متغيريين في خطوة واحده
 
 name = "John";
 

1-js/02-first-steps/04-variables/1-hello-variables/task.md

@@ -1,10 +1,10 @@
-importance: 2
+مهم: 2
 
 ---
 
-# Working with variables
+# العمل مع المتغيرات
 
-1. Declare two variables: `admin` and `name`.
-2. Assign the value `"John"` to `name`.
-3. Copy the value from `name` to `admin`.
-4. Show the value of `admin` using `alert` (must output "John").
+1. قم بتعريف متغيريين: `admin` و `name`.
+2. ضع القيمة `"John"` الى `name`.
+3. أنسخ القيمة من `name` الي `admin`.
+4. أعرض قيمة `admin` بأستخدام `alert` (يجب أن تكون "John").

1-js/02-first-steps/04-variables/2-declare-variables/solution.md

@@ -1,21 +1,21 @@
-## The variable for our planet
+## المتغير لكوكبنا
 
-That's simple:
+ذلك بسيط:
 
 ```js
 let ourPlanetName = "Earth";
 ```
 
-Note, we could use a shorter name `planet`, but it might be not obvious what planet it refers to. It's nice to be more verbose. At least until the variable isNotTooLong.
+ملاحظة, نحن نستطيع كتابة أسم قصير مثل `planet`, ولكن قد لا يكون واضحًا ما يشير إليه الكوكب. من الجيد أن تكون أكثر تطولًا. علي الاقل يكون اسم المتغير ليس طويل للغاية.
 
-## The name of the current visitor
+## أسم الزائر الحالي
 
 ```js
 let currentUserName = "John";
 ```
 
-Again, we could shorten that to `userName` if we know for sure that the user is current.
+للمرة الثانية, نحن نستطيع كتابة `userName` أذا كنا نعلم من يكون المستخدم الحالي.
 
-Modern editors and autocomplete make long variable names easy to write. Don't save on them. A name with 3 words in it is fine.
+المحررات الحديثة والاكمال الذاتي تنشئ اسماء متغيرات طويلة وسهلة للكتابة. لا تحفظها. الاسم الذي يتكون من ثلاث كلمات يكون جيد.
 
-And if your editor does not have proper autocompletion, get [a new one](/code-editors).
+وأذا كان المحرر الخاص بك لا يحتوي علي خاصية الاكمال الذاتي, يمكنك الحصول عليه [واحدة جديده](/code-editors).

1-js/02-first-steps/04-variables/2-declare-variables/task.md

@@ -1,8 +1,8 @@
-importance: 3
+مهم: 3
 
 ---
 
-# Giving the right name
+# كتابة الأسم بشكل صحيح
 
-1. Create a variable with the name of our planet. How would you name such a variable?
-2. Create a variable to store the name of a current visitor to a website. How would you name that variable?
+1. إنشاء متغير باسم كوكبنا. كيف تسمي مثل هذا المتغير؟
+2. أنشئ متغيرًا لتخزين اسم الزائر الحالي لموقع الويب. كيف يمكنك تسمية هذا المتغير؟

1-js/02-first-steps/04-variables/3-uppercast-constant/solution.md

@@ -1,5 +1,5 @@
-We generally use upper case for constants that are "hard-coded". Or, in other words, when the value is known prior to execution and directly written into the code.
+نستخدم بشكل عام الأحرف الكبيرة للثوابت "ذات الترميز الصلب". أو بمعنى آخر ، عندما تكون القيمة معروفة قبل التنفيذ ومكتوبة مباشرة في الشفرة.
 
-In this code, `birthday` is exactly like that. So we could use the upper case for it.
+في هذا الكود, `birthday` هو بالضبط مثل ذلك. حتى نتمكن من استخدام الحروف الكبيرة لذلك.
 
-In contrast, `age` is evaluated in run-time. Today we have one age, a year after we'll have another one. It is constant in a sense that it does not change through the code execution. But it is a bit "less of a constant" than `birthday`: it is calculated, so we should keep the lower case for it.
+في المقابل, `age` يتم حسابة في وقت التشغيل. اليوم نحن نمتلك عمر, بعد عام من حصولنا على واحدة أخرى. إنه ثابت بمعنى أنه لا يتغير من خلال تنفيذ التعليمات البرمجية. لكنها أقل قليلا من الثابت `birthday`: انه محسوب, لذلك يجب علينا العمل بالحروف الصغيرة.

1-js/02-first-steps/04-variables/3-uppercast-constant/task.md

@@ -1,24 +1,24 @@
-importance: 4
+مهم: 4
 
 ---
 
-# Uppercase const?
+# الثابت ذات الحرف الكبيره؟
 
-Examine the following code:
+أفحص الكود التالي:
 
 ```js
 const birthday = '18.04.1982';
 
 const age = someCode(birthday);
 ```
 
-Here we have a constant `birthday` date and the `age` is calculated from `birthday` with the help of some code (it is not provided for shortness, and because details don't matter here).
+هنا نحن نمتلك ثابت يحزن قيمة التاريخ `birthday` و ثابت أخر يسمي `age` يحسب قيمة العمر من الثابت `birthday` مع مساعدة الداله بعض الكود (لم يتم توفيرها لتصغيرها ، ولأن التفاصيل لا تهم هنا)
 
-Would it be right to use upper case for `birthday`? For `age`? Or even for both?
+هل من الصحيح أستخدام الحروف الكبيره للثابت `birthday` ؟ او للثابت `age`؟ او حتي لكليهما؟
 
 ```js
-const BIRTHDAY = '18.04.1982'; // make uppercase?
+const BIRTHDAY = '18.04.1982'; // هل نجعل الاسم ذات حروف كبيره؟
 
-const AGE = someCode(BIRTHDAY); // make uppercase?
+const AGE = someCode(BIRTHDAY); // هل نجعل الاسم ذات حروف كبيره؟
 ```