Skip to content

Commit 4edfab1

Browse files
authored
Merge pull request #50 from atefBB/patch-2
Review `hello world` Arabic translation
2 parents 5b03df3 + fbf454e commit 4edfab1

1 file changed

Lines changed: 20 additions & 21 deletions

File tree

1-js/02-first-steps/01-hello-world/article.md

Lines changed: 20 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
1-
# أهلاً, بالعالم!
1+
# أهلاً، بالعالم!
22

33
هذا الجزء من البرنامج التعليمي عن أساسيات لغة الجافا سكريبت، اللغة نفسها.
44

5-
لكن نحتاج إلى بيئة عمل من أجل تشغيل النصوص الخاصة بنا، وبما أن هذا الكتاب عبر الانترنت، لذافإن المتصفح خيار جيد.سوف نقوم بالاحتفاظ بالأوامر الخاصة بالمتصفح (مثل `alert`) للحد الأدنى بحيث لا تقضي وقتًا عليها إذا كنت تخطط للتركيز على بيئة أخرى (مثل Node.js). سوف نركز على الجافا سكريبت في المتصفح [الجزء التالي](/ui) من البرنامج التعليمي.
5+
لكن نحتاج إلى بيئة عمل من أجل تشغيل النصوص الخاصة بنا، وبما أن هذا الكتاب عبر الانترنت، لذافإن المتصفح خيار جيد. سوف نقوم بالاحتفاظ بالأوامر الخاصة بالمتصفح (مثل `alert`) للحد الأدنى بحيث لا تقضي وقتًا عليها إذا كنت تخطط للتركيز على بيئة أخرى (مثل Node.js). سوف نركز على الجافا سكريبت في المتصفح [الجزء التالي](/ui) من البرنامج التعليمي.
66

7-
لذا أولاً, دعونا نرفق نص برمجي في صفحة الويب. بالنسبة للبيئات التي تعمل على الخوادم (مثل Node.js), يمكنك تنفيذها من خلال استخدام أمر مثل `"node my.js"`.
7+
لذا أولاً، دعونا نرفق نصا برمجيا في صفحة الويب. بالنسبة للبيئات التي تعمل على الخوادم (مثل Node.js)، يمكنك تنفيذها من خلال استخدام أمر مثل `"node my.js"`.
88

99

1010
## الوسم "script"
1111

12-
يمكن وضع برامج الجافاسكريبت في أي جزء في مستند HTML باستخدام وسم`<script>`.
12+
يمكن وضع برامج الجافاسكريبت في أي جزء في مستند HTML باستخدام وسم `<script>`.
1313

1414
على سبيل المثال:
1515

@@ -23,7 +23,7 @@
2323

2424
*!*
2525
<script>
26-
alert( 'أهلاً, بالعالم!' );
26+
alert( 'أهلاً، بالعالم!' );
2727
</script>
2828
*/!*
2929

@@ -46,42 +46,42 @@
4646
الوسم `<script>` يحتوي على بعض الخصائص التي نادراً مايتم استخدامها في وقتنا الحاضر، لكن يمكن أن تجدها في الشفرات البرمجية القديمة:
4747

4848
الخاصية `type`: <code>&lt;script <u>type</u>=...&gt;</code>
49-
: معيار HTML القديم, HTML4, يتطلب أن يحتوي وسم script على `type`. عادة ما كان `type="text/javascript"`. لم تعد مطلوبة الآن. وأيضاً,معايير HTML الحديثةغيرت معني هذه الخاصية. والآن، يمكن أن تستخدم لوحدات الجافا سكريبت. لكن هذا الموضوع متقدم، وسنتحدث عن الوحدات في جزءآخر من البرنامج التعليمي.
49+
: معيار HTML القديم، HTML4، يتطلب أن يحتوي وسم script على `type`. عادة ما كان `type="text/javascript"`. لم تعد مطلوبة الآن. وأيضاً، معايير HTML الحديثة غيرت معنى هذه الخاصية. والآن، يمكن أن تستخدم لوحدات الجافا سكريبت. لكن هذا الموضوع متقدم، وسنتحدث عن الوحدات في جزء آخر من البرنامج التعليمي.
5050

5151
الخاصية `language`: <code>&lt;script <u>language</u>=...&gt;</code>
5252
: كان الغرض من استخدام هذه الخاصية هو إظهار لغة النص البرمجي، لم تعد هذه الخاصية منطقية الآن لأن الجافا سكريبت هي اللغة الافتراضية. فليست هناك حاجة لاستخدامها.
5353

5454
التعليقات قبل وبعد النصوص البرمجية.
55-
: في الكتب والأدلة القديمة جداً، قد تجد تعليقات داخل وسم `<script>` , مثل هذا:
55+
: في الكتب والأدلة القديمة جداً، قد تجد تعليقات داخل وسم `<script>`، مثل هذا:
5656

5757
```html no-beautify
5858
<script type="text/javascript"><!--
5959
...
6060
//--></script>
6161
```
6262

63-
لاستم استخدام هذه الخدعة في الجافاسكريبت الحديثة. تخفي هذه التعليقات شفرات الجافاسكريبت في المتصفحات القديمة التي لاتعرف كيفية عمل معالجة للوسم `<script>. نظراً لأن المتصحات التي تم إصدارها في آخر 15 عاماً لاتوجد فيها هذه المشكلة، فإن هذا النوع من التعليقات يمكن أن يساعدك في تحديد الشفرة القديمة حقاً.
63+
لا يتم استخدام هذه الخدعة في الجافاسكريبت الحديثة. تخفي هذه التعليقات شفرات الجافاسكريبت في المتصفحات القديمة التي لاتعرف كيفية عمل معالجة للوسم `<script>. نظراً لأن المتصفحات التي تم إصدارها في آخر 15 عاماً لا توجد فيها هذه المشكلة، فإن هذا النوع من التعليقات يمكن أن يساعدك في تحديد الشفرة القديمة حقاً.
6464

6565

6666
## النصوص البرمجية الخارجية
6767

68-
إذا كان لدينا عدد كبير من أكواد الجافا سكريبت، فإننا يمكن أن نضعها في ملف منفصل.
68+
إذا كان لدينا عدد كبير من شيفرات الجافا سكريبت، فإننا يمكن أن نضعها في ملف منفصل.
6969

70-
يتم إرفاق ملفات النصوص البرمجية HTML باستخدام خاصية `src` :
70+
يتم إرفاق ملفات النصوص البرمجية HTML باستخدام خاصية `src`:
7171

7272
```html
7373
<script src="/path/to/script.js"></script>
7474
```
7575

76-
هنا, `/path/to/script.js` هو مسار منفرد للنص البرمجي من جذر الموقع. يمكن أيضاً توفير مسار نسبي من خلال الصفحة الحالية.. على سبيل المثال، `src="script.js"` تعني أن الملف `"script.js"` في نفس المجلد.
76+
هنا، `/path/to/script.js` هو مسار منفرد للنص البرمجي من جذر الموقع. يمكن أيضاً توفير مسار نسبي من خلال الصفحة الحالية. على سبيل المثال، `src="script.js"` تعني أن الملف `"script.js"` في نفس المجلد.
7777

7878
يمكن أن نعطي المسار الكامل أيضاً. على سبيل المثال :
7979

8080
```html
8181
<script src="https://cdnjs.cloudflare.com/ajax/libs/lodash.js/4.17.11/lodash.js"></script>
8282
```
8383

84-
لكي نرفق العديد من النصوص البرمجية، استخدم To attach several scripts, use الوسوم بصورة مضاعفة:
84+
لكي نرفق العديد من النصوص البرمجية، استخدم To attach several scripts، use الوسوم بصورة مضاعفة:
8585

8686
```html
8787
<script src="/js/script1.js"></script>
@@ -90,17 +90,17 @@
9090
```
9191

9292
```smart
93-
كقاعدة، يتم وضع النصوص البرمجية البسيطة داخل HTML. والنصوص المعقدة يتم وضعها في ملفات منفصلة.
93+
القاعدة أن يتم وضع النصوص البرمجية البسيطة داخل HTML. والنصوص المعقدة يتم وضعها في ملفات منفصلة.
9494
95-
فائدة الملفات المنفصلة هي أن المتصفح يقوم بتحميلهاوتخزينها في[ذاكرة التخزين المؤقتة](https://en.wikipedia.org/wiki/Web_cache).
95+
فائدة الملفات المنفصلة هي أن المتصفح يقوم بتحميلها وتخزينها في [ذاكرة التخزين المؤقتة](https://en.wikipedia.org/wiki/Web_cache).
9696
9797
الصفحات الأخرى التي تشير إلى نفس النص البرمجي سوف تحصل عليه من ذاكرة التخزين المؤقتة بدلاً من تنزيله، لذا فإن الملف يتم تحميله مرة واحدة.
9898
9999
هذا يقلل من الحركة ويجعل الصفحات تكون أسرع.
100100
```
101101

102-
````warn header="إذا `src` تم تعيين, يتم تجاهل محتوى النص البرمجي."
103-
وسم `<script>` منفرداً لايمكن أن يحتوي على خاصية `src` والكود بداخله.
102+
````warn header="إذا `src` تم تعيين، يتم تجاهل محتوى النص البرمجي."
103+
وسم `<script>` منفرداً لايمكن أن يحتوي على خاصية `src` والشيفرة بداخله.
104104

105105
هذا لايعمل:
106106

@@ -110,7 +110,7 @@
110110
</script>
111111
```
112112

113-
يجب اختيار إما خارجي `<script src="…">` أو عادي `<script>` باستخدام الكود.
113+
يجب اختيار إما خارجي `<script src="…">` أو عادي `<script>` باستخدام الشيفرة.
114114

115115
يمكن تقسيم المثال أعلاه إلى نصين برمجيين لكي يعمل:
116116

@@ -124,9 +124,8 @@
124124
125125
## ملخص
126126
127-
- يمكن استخدام وسم `<script>` لإضافة كود الجافا سكريبت إلى صفحة.
128-
- الخصائص `type` و `language` غير مطلوبة.
127+
- يمكن استخدام وسم `<script>` لإضافة شيفرة الجافا سكريبت إلى صفحة.
128+
- الخصائص `type` و`language` غير مطلوبة.
129129
- يمكن إدراج النص البرمجي في ملف خارجي باستخدام `<script src="path/to/script.js"></script>`.
130130
131-
132-
هناك الكثير لتتعلمه عن نصوص المتصفح البرمجية وتفاعلها مع صفحة الويب. ولكن دعنا نضع في اعتبارنا أن هذا الجزء من البرنامج التعليمي مخصص للغة جافا سكريبت ، لذلك لا ينبغي أن نشتت انتباهنا بالتطبيقات الخاصة بالمتصفح. سنستخدم المتصفح كوسيلة لتشغيل جافا سكريبت ، وهو مناسب جدًا للقراءة عبر الإنترنت ، ولكن واحدًا فقط من بين العديد.
131+
هناك الكثير لتتعلمه عن نصوص المتصفح البرمجية وتفاعلها مع صفحة الويب. ولكن دعنا نضع في اعتبارنا أن هذا الجزء من البرنامج التعليمي مخصص للغة جافا سكريبت، لذلك لا ينبغي أن نشتت انتباهنا بالتطبيقات الخاصة بالمتصفح. سنستخدم المتصفح وسيلةً لتشغيل جافا سكريبت، وهو مناسب جدًا للقراءة عبر الإنترنت، ولكنه واحد فقط من بين العديد.

0 commit comments

Comments
 (0)