+
عندما تبحث عن `freecodecamp curriculum`، سيُرجع محرك البحث نتائج تطابق *أي* من هذه الكلمات المفتاحية – عادةً مرتبة حسب الصلة (مدى احتمال تطابقها أو ارتباطها بمعظم استعلامك).
لكن ماذا لو أردت نتائج تطابق كلا الكلمتين المفتاحيتين فقط؟ ربما سمعت أنه يمكنك وضع الاستعلام بين علامات اقتباس، مثل `"freecodecamp curriculum"`.
+
+
مع ذلك، هذا الاستعلام يطابق *العبارة* `freecodecamp curriculum` تحديدًا. هذا يعني أن النتائج التي سترىها ستقتصر على المواقع التي تقول `freecodecamp curriculum` معًا، وليس المواقع التي تقول `freecodecamp` وَ `curriculum`.
إذا أردت مطابقة المواقع التي تحتوي على كلا المصطلحين، لكن ليس بالضرورة متجاورين كعبارة، يمكنك وضع بادئة علامة زائد لكل مصطلح هكذا: `+freecodecamp +curriculum`
+
+
بدلاً من ذلك، ربما تهتم بمبادرات freeCodeCamp خارج المنهج. في هذه الحالة، يمكنك وضع بادئة علامة ناقص على المصطلح `curriculum` هكذا: `+freecodecamp -curriculum`.
+
+
هذا سيُرجع نتائج تذكر `freecodecamp`، لكنه يستبعد النتائج التي تذكر أيضًا `curriculum`.
أو ربما لديك موقع محدد تريد البحث فيه، مثل منصتنا الإخبارية؟ يمكنك استخدام `site:` متبوعًا بعنوان URL للموقع الذي تريد البحث فيه: `site:freecodecamp.org/news curriculum`.
+
+
هذا الاستعلام يُرجع كل النتائج من `freecodecamp.org/news` التي تحتوي على كلمة `curriculum`.
بدمج هذه الأدوات، يمكنك صياغة استعلامات محددة جدًا للحصول على المعلومات التي تحتاجها بالضبط.
على سبيل المثال، الاستعلام `site:freecodecamp.org/news +python -curriculum` سيبحث عن مقالات بايثون في موقع الأخبار الخاص بنا، مستبعدًا المقالات التي قد تتحدث عن المنهج.
+
+
قد تختلف عوامل البحث، لذا من المهم دائمًا مراجعة الوثائق الخاصة بمحرك البحث الذي تفضله.
لكن يجب أن تكون الآن قادرًا على الحصول على النتائج الدقيقة التي تريدها من عمليات البحث على الويب.
diff --git a/curriculum/challenges/arabic/blocks/lecture-classes-and-objects/68420bd261d0d35f61922d4b.md b/curriculum/challenges/arabic/blocks/lecture-classes-and-objects/68420bd261d0d35f61922d4b.md
index 3d273ab0f15..a3563a621f7 100644
--- a/curriculum/challenges/arabic/blocks/lecture-classes-and-objects/68420bd261d0d35f61922d4b.md
+++ b/curriculum/challenges/arabic/blocks/lecture-classes-and-objects/68420bd261d0d35f61922d4b.md
@@ -13,6 +13,8 @@ dashedName: how-do-classes-work-and-how-do-they-differ-from-objects
لنلقِ نظرة على ما هي الأصناف، وكيف تستخدمها لإنشاء الكائنات.
+## إنشاء صنف
+
لإنشاء صنف، تستخدم الكلمة المفتاحية `class` متبوعة باسم الصنف ونقطتين. ثم داخل الصنف، يمكنك إضافة مُهيئ، بالإضافة إلى أي خصائص وطرق.
الخصائص تشبه المتغيرات داخل الصنف، وتُستخدم لتخزين البيانات. الطرق هي دوال معرفة داخل الصنف، وهي الأفعال التي يمكن للكائنات التي تُنشأ من الصنف تنفيذها.
@@ -42,6 +44,8 @@ class ClassName:
* `print(self.name.upper())` هو ما ستفعله طريقة `sample_method`، في هذه الحالة، تطبع الاسم بأحرف كبيرة.
+## مثال على صنف `Dog`
+
إذا بدا لك كل هذا كثيرًا، لا تقلق. لنلقِ نظرة على مثال مشابه لصنف `Dog`، وكيف يمكنك إنشاء كائنات منه:
```python
@@ -54,6 +58,8 @@ class Dog:
print(f"{self.name.upper()} says woof woof!")
```
+## إنشاء كائنات من صنف
+
مع هذا الصنف `Dog`، يمكنك إنشاء كائن. إليك الصيغة النحوية الأساسية لإنشاء كائنات من صنف:
```python
@@ -91,6 +97,8 @@ dog_2.bark() # THATCHER says woof woof! I'm 5 years old!
ثم عند استدعاء طريقة `.bark()` على `dog_1` و `dog_2`، يمكنك رؤية كيف تختلف المخرجات، وتستخدم الخصائص الفريدة `name` و `age` التي مررتها عند إنشاء كل كائن.
+## الفروقات بين الأصناف والكائنات
+
باختصار، الفرق بين الصنف والكائن هو أن الصنف هو القالب أو المخطط، والكائن هو ما يُنشأ باستخدام ذلك القالب.
أيضًا، يحدد الصنف البيانات والسلوك الذي يجب أن يمتلكه الكائن، والكائن يحمل البيانات الفعلية ويستخدم ذلك السلوك. تكتب الصنف مرة واحدة، ويمكنك إنشاء العديد من الكائنات منه، كل منها ببيانات مختلفة.
diff --git a/curriculum/challenges/arabic/blocks/lecture-classes-and-objects/6874b7d3b286c538b39d0c25.md b/curriculum/challenges/arabic/blocks/lecture-classes-and-objects/6874b7d3b286c538b39d0c25.md
index 5c8d0a2c21c..0c8efb6144a 100644
--- a/curriculum/challenges/arabic/blocks/lecture-classes-and-objects/6874b7d3b286c538b39d0c25.md
+++ b/curriculum/challenges/arabic/blocks/lecture-classes-and-objects/6874b7d3b286c538b39d0c25.md
@@ -7,6 +7,8 @@ dashedName: what-are-special-methods-and-what-are-they-used-for
# --description--
+## ما هي الطرق الخاصة؟
+
الطرق الخاصة في Python، المعروفة أيضًا باسم "الطرق السحرية" أو "طرق dunder"، هي طرق Python خاصة تبدأ وتنتهي بشرطتين سفليتين مزدوجتين (`__`). كلمة "dunder" نفسها مشتقة من الشرطتين السفليتين المزدوجتين (**d** من double، **under** من underscores).
ربما استخدمت الطرق الخاصة بالفعل دون أن تعرف ذلك. في كل مرة تكتب شيئًا مثل `3 + 4`، يقوم Python بهدوء بتنفيذ `3.__add__(4)` خلف الكواليس. هذه طريقة خاصة تعمل. لذلك، رغم أنه يمكنك *استدعاء* الطرق الخاصة مباشرة، إلا أنك نادرًا ما تفعل ذلك. شيء مثل `3 + 4` أوضح وأسهل في القراءة من استدعاء `3.__add__(4)` بنفسك.
@@ -15,6 +17,8 @@ dashedName: what-are-special-methods-and-what-are-they-used-for
فكر في الطرق الخاصة كمخرجين للأنشطة بين المبرمج ومفسر لغة Python نفسه.
+## متى يستدعي Python الطرق الخاصة
+
تذكر، لا تحتاج إلى استدعاء الطرق الخاصة مباشرة. بدلاً من ذلك، يستدعيها Python تلقائيًا عند حدوث إجراءات معينة. تشمل هذه العمليات:
- **العمليات الحسابية مثل الجمع والطرح والضرب والقسمة وغيرها**. للجمع، تُستدعى `__add__()`، وللطرح `__sub__()`، وللضرب `__mul__()`، وللقسمة `__truediv__()`.
@@ -26,6 +30,8 @@ dashedName: what-are-special-methods-and-what-are-they-used-for
- **عمليات التكرار مثل جعل الكائن قابلًا للتكرار والتقدم عبر العناصر**. تُستدعى `__iter__()` لإرجاع مكرر و `__next__()` لجلب العنصر التالي.
+## لماذا تحتاج الأصناف المخصصة إلى طرق خاصة
+
عادةً، أنواع بيانات Python مثل السلاسل النصية والأرقام تعرف بالفعل كيف تضيف الأشياء، وتربط السلاسل، وتقارن للتساوي، وتُستخدم في الحلقات، وغيرها.
لكن عندما تنشئ صنفك الخاص، لن يعرف Python كيف يتعامل مع الأشياء تلقائيًا.
@@ -57,6 +63,8 @@ print(book1 == book2) # False even though they have the same number of pages
- كانت نتيجة `book1 == book2` هي `False` لأن Python فقط يتحقق مما إذا كان الكائنان نفسهما في الذاكرة، وليس بالمحتوى.
+## تعريف طرقك الخاصة
+
إليك كيف يمكنك تعريف طرق خاصة خاصة بك مثل `__len__()` و `__str__()` و `__eq__()` لتسهيل العمل مع الكائنات التي تُنشأ من صنف `Book`:
```python
@@ -84,6 +92,8 @@ print(str(book2)) # 'Be Your Own Start' has 420 pages
print(book1 == book2) # True
```
+## مثال على عربة التسوق
+
مثال آخر هو عربة التسوق حيث تقوم بما يلي:
- إضافة عناصر إلى العربة
diff --git a/curriculum/challenges/arabic/blocks/lecture-classes-and-objects/6908d38f7cccc31602743340.md b/curriculum/challenges/arabic/blocks/lecture-classes-and-objects/6908d38f7cccc31602743340.md
index 824e69a8701..3e00bb46a4e 100644
--- a/curriculum/challenges/arabic/blocks/lecture-classes-and-objects/6908d38f7cccc31602743340.md
+++ b/curriculum/challenges/arabic/blocks/lecture-classes-and-objects/6908d38f7cccc31602743340.md
@@ -30,6 +30,8 @@ print(my_car.model) # Gallardo
تتيح لك هذه الدوال الوصول إلى الخصائص، إنشاؤها، التحقق منها، وحذفها باستخدام أسماء متغيرة. دعنا نلقي نظرة على كل واحدة منها أثناء العمل.
+## `getattr()`
+
تجعل `getattr()` من الممكن قراءة خاصية من كائن عندما لا تعرف اسمها حتى وقت التشغيل. إذا لم تكن الخاصية موجودة، ترفع استثناء `AttributeError`، إلا إذا وفرت قيمة افتراضية.
لاستخدامها، تمرر الكائن، اسم الخاصية، وقيمة افتراضية اختيارية:
@@ -75,6 +77,8 @@ print(getattr(person, attr_name, 'Attribute not found'))
هنا بالضبط يتألق التعامل الديناميكي مع الخصائص. فهو يسمح لكودك بالاستجابة للمُدخلات والبيانات التي لم يسبق له رؤيتها.
+## عرض الخصائص باستخدام `dir()`
+
بالإضافة إلى ذلك، قد ترغب في استعراض كل الخصائص التي يمتلكها كائن، وليس فقط التي تعرفها مسبقًا. الدالة المدمجة `dir()` تتيح لك ذلك. تعيد قائمة بكل أسماء الخصائص على الكائن. إليك كيفية استخدامها:
```python
@@ -99,6 +103,8 @@ for attr in dir(person):
في الحلقة أعلاه، `callable()` هي دالة مدمجة تعيد `True` إذا كان الكائن الممرر إليها يمكن استدعاؤه كدالة أو طريقة، و `False` خلاف ذلك. بفحص `not callable(getattr(person, attr))`، تتخطى الحلقة الطرق وتطبع فقط خصائص البيانات مثل `name` و `age`.
+## `setattr()`
+
تتيح لك دالة `setattr()` إنشاء خاصية جديدة أو تحديث خاصية موجودة بشكل ديناميكي. الصيغة تبدو هكذا:
```python
@@ -128,6 +134,8 @@ print(config_obj.server_url) # https://api.example.com
print(config_obj.timeout_sec) # 30
```
+## `hasattr()`
+
هناك أيضًا `hasattr()`. قبل أن تفعل شيئًا مع خاصية أو تحذفها، من الممارسات الجيدة التحقق من وجودها. هذا ما تفعله `hasattr()`. تتحقق من وجود الخاصية وتعيد `True` أو `False` بناءً على النتيجة.
إليك الصيغة النحوية الأساسية:
@@ -163,6 +171,8 @@ for attr in required_attributes:
حدث خطأ ERROR لأن `inventory_id` مفقودة من صنف `Product` ومن نسخته.
+## `delattr()`
+
أخيرًا، تتيح لك `delattr()` حذف خاصية بشكل ديناميكي:
```python
diff --git a/curriculum/challenges/arabic/blocks/lecture-introduction-to-git-and-github/6882904fd7063f7258c0aef3.md b/curriculum/challenges/arabic/blocks/lecture-introduction-to-git-and-github/6882904fd7063f7258c0aef3.md
index 11dbb628d7b..62f2ea2cdbe 100644
--- a/curriculum/challenges/arabic/blocks/lecture-introduction-to-git-and-github/6882904fd7063f7258c0aef3.md
+++ b/curriculum/challenges/arabic/blocks/lecture-introduction-to-git-and-github/6882904fd7063f7258c0aef3.md
@@ -7,10 +7,14 @@ dashedName: how-do-you-handle-security-requirements-like-ssh-and-gpg-keys
# --description--
+## ما هي مفاتيح SSH و GPG؟
+
قبل أن تدفع المستودع الخاص بك إلى GitHub، يجب أن تكون مُوثَّقًا. تستخدم مفاتيح SSH و GPG زوجًا من المفتاح العام والخاص. هذا يعني أنك تحتفظ بمفتاح خاص على جهازك المحلي، تستخدمه للمصادقة على نفسك. تشارك مفتاحًا عامًا مع الأشخاص أو الخدمات التي تحتاج إلى التحقق من مصادقتك. بعبارة أخرى، المفتاح الخاص مطلوب لأداء إجراء، والمفتاح العام يُستخدم للتحقق من هذا الإجراء.
مفاتيح GPG، أو GNU Privacy Guard، تُستخدم عادةً لتوقيع الملفات أو الاستدعاءات. يمكن لأي شخص بعد ذلك استخدام مفتاح GPG العام الخاص بك للتحقق من أن توقيع الملف صادر عن مفتاحك وأن محتويات الملف لم تُعدّل أو تُعبث بها. مفاتيح SSH، أو Secure SHell، تُستخدم عادةً للمصادقة على اتصال بعيد بخادم عبر أداة `ssh`. ومع ذلك، كما ستتعلم في هذا الدرس، يمكنك أيضًا استخدام مفتاح SSH لتوقيع الاستدعاءات.
+## توليد مفاتيح SSH و GPG
+
لتوليد مفتاح GPG، ستحتاج إلى تشغيل:
```sh
@@ -27,6 +31,8 @@ ssh-keygen -t ed25519 -C "your_email@example.com"
يجب أن تطلب كلا الأمرين عبارة مرور لتأمين المفتاح. هذه العبارة اختيارية، لكنها موصى بها بشدة.
+## العثور على مفاتيحك العامة
+
بالنسبة لمفاتيح SSH، ستحصل على ملفين - واحد لمفتاحك الخاص، وآخر لمفتاحك العام. أسماء ملفات المفتاح العام تنتهي بـ `.pub`، حتى لا تشارك مفتاحك الخاص عن طريق الخطأ. ستكون هذه الملفات في `~/.ssh`.
أما مفاتيح GPG فستكون في مجلد مخفي ومشفر. بدلاً من ذلك، لعرض مفاتيحك العامة، ستشغل:
@@ -41,6 +47,8 @@ gpg --list-secret-keys --keyid-format=long
gpg --armor --export "` أو ``، يفترض أنه عنصر HTML قياسي. أما إذا بدأ اسم المكوِّن بحرف كبير، فسيعامله React كمكوِّن معرف من المستخدم ويعرضه وفقًا لذلك. هذا التمييز يساعد React على التفريق بين وسوم HTML الأصلية والمكوِّنات التي تنشئها.
+## استخدام مكوِّن
+
لاستخدام هذا المكوِّن `Greeting` في تطبيقنا، نكتب شيئًا مثل هذا:
```jsx
@@ -63,6 +69,8 @@ function Greeting() {
.setter` فوقها:
استخدام `self.radius` داخل `__init__` يضمن تشغيل setter أثناء إنشاء الكائن، لذا يتم التقاط قيم نصف القطر غير الصالحة فورًا.
@@ -78,6 +88,8 @@ print('After modifying the radius:', my_circle.radius) # After modifying the rad
في هذا المثال، setter نصف القطر لا يعيّن نصف القطر فقط، بل ينفذ تحققًا للتأكد من أن نصف القطر ليس رقمًا سالبًا.
+## كيف يستدعي Python الـ Getters والـ Setters
+
بمجرد تعريف getters و setters، تستدعيها Python تلقائيًا خلف الكواليس كلما استخدمت صيغة الخاصية العادية:
```py
@@ -87,6 +99,8 @@ my_circle.radius = 4 # This will call the setter
لاحظ أنه داخل setter، لا يمكنك استخدام نفس اسم الخاصية عند تعيين قيمة جديدة. ذلك لأن `self.radius = value` سيستدعي setter داخل نفسه، مما يؤدي إلى تكرار لا نهائي وخطأ `RecursionError`. لذلك يجب دائمًا استخدام الشكل الذي يبدأ بشرطة سفلية `self._radius = value`.
+## إنشاء Deleter
+
تمامًا كما يمكنك التحكم في كيفية وصول الخاصية عبر getter وكيفية تعديلها عبر setter، يمكنك أيضًا التحكم في كيفية حذفها باستخدام deleter.
يُشغّل deleter منطقًا مخصصًا عند استخدام عبارة del على خاصية. لإنشاء واحد، تستخدم الديكوريتور `@.deleter`:
@@ -134,6 +148,8 @@ except AttributeError as e:
print("Error:", e) # Error: 'Circle' object has no attribute '_radius'
```
+## ملخص
+
النتيجة المستفادة من هذا هي:
- الـ Getters تتيح لك استرجاع قيمة أو حتى حساب قيمة في الوقت الفعلي.
diff --git a/curriculum/challenges/arabic/blocks/lecture-understanding-recursion-and-the-call-stack-python/6a89c69c2abed81397a6c99e.md b/curriculum/challenges/arabic/blocks/lecture-understanding-recursion-and-the-call-stack-python/6a89c69c2abed81397a6c99e.md
index 65bc4313d37..ed0e98e7c44 100644
--- a/curriculum/challenges/arabic/blocks/lecture-understanding-recursion-and-the-call-stack-python/6a89c69c2abed81397a6c99e.md
+++ b/curriculum/challenges/arabic/blocks/lecture-understanding-recursion-and-the-call-stack-python/6a89c69c2abed81397a6c99e.md
@@ -7,6 +7,8 @@ dashedName: what-is-recursion-and-how-does-it-work
# --description--
+## ما هو الاستدعاء الذاتي؟
+
التكرار هو تقنية تستدعي فيها الدالة نفسها. كل استدعاء يعمل على نسخة أصغر من المشكلة الأصلية حتى يصل إلى شرط يوقف التكرار. يُسمى هذا الشرط الذي يوقف التكرار بالحالة الأساسية.
يمكن للدوال المتكررة حل مشكلات ذات عمق غير معروف، مثل التنقل في شجرة الملفات. كما يمكنها أداء مهام أبسط، مثل العد التنازلي من رقم معين.
@@ -20,6 +22,8 @@ def recursive_countdown(number):
recursive_countdown(5)
```
+## إضافة حالة أساسية
+
استدعاء الدالة يطبع `5`، لكنه لا يبدأ العد التنازلي بعد. قبل أن تستدعي الدالة نفسها، يجب تعريف الحالة الأساسية. بدون حالة أساسية يمكن الوصول إليها، ستستمر الدالة في استدعاء نفسها. في النهاية، توقف Python الاستدعاءات وترجع خطأ `RecursionError`.
لهذا العد التنازلي، يجب أن تتوقف الدالة عندما يكون `number` أقل من `1`:
@@ -35,6 +39,8 @@ recursive_countdown(5)
عبارة `if` هي الحالة الأساسية. عندما يكون `number` أقل من `1`، ينهي `return` استدعاء الدالة ذلك.
+## إضافة حالة استدعاء ذاتي
+
لا تزال الدالة بحاجة إلى حالة متكررة. الحالة المتكررة تستدعي الدالة مرة أخرى بمعلمة تحركها نحو الحالة الأساسية. للعد التنازلي، استدعِ `recursive_countdown` مع `number - 1`:
```py
@@ -49,6 +55,8 @@ recursive_countdown(5)
هذا يطبع الأرقام `5`، `4`، `3`، `2`، و`1`.
+## تغيير ترتيب التنفيذ
+
يتغير موضع الاستدعاء المتكرر عند طباعة الأرقام. إذا جاء استدعاء `print()` بعد الاستدعاء المتكرر، تطبع الدالة الأرقام بترتيب تصاعدي:
```py
@@ -63,8 +71,12 @@ recursive_countdown(5)
هذا يطبع الأرقام `1`، `2`، `3`، `4`، و`5`. لفهم السبب، تحتاج إلى فهم مكدس الاستدعاءات.
+## ما هو مكدس الاستدعاءات؟
+
مكدس الاستدعاءات هو هيكل بيانات من نوع آخر داخل أولاً، خارج أولاً تستخدمه Python لتتبع استدعاءات الدوال النشطة. عند استدعاء دالة، تضيف Python إطارًا لذلك الاستدعاء في أعلى المكدس. يحتوي الإطار على معلومات مثل معلمات الدالة والمتغيرات المحلية.
+## تتبع مكدس الاستدعاءات
+
انظر هذا الإصدار من العد التنازلي:
```py
diff --git a/curriculum/challenges/arabic/blocks/lecture-understanding-routing-in-express-js/69a918497b6424e132898217.md b/curriculum/challenges/arabic/blocks/lecture-understanding-routing-in-express-js/69a918497b6424e132898217.md
index ffc9ed22849..89d454f759e 100644
--- a/curriculum/challenges/arabic/blocks/lecture-understanding-routing-in-express-js/69a918497b6424e132898217.md
+++ b/curriculum/challenges/arabic/blocks/lecture-understanding-routing-in-express-js/69a918497b6424e132898217.md
@@ -1,6 +1,6 @@
---
id: 69a918497b6424e132898217
-title: كيف تنشئ معالجات مسارات قابلة للربط باستخدام app.route()؟
+title: كيف تنشئ معالجات مسارات قابلة للربط باستخدام app.route()؟
challengeType: 19
dashedName: how-can-you-create-chainable-route-handlers-using-approute
---
diff --git a/curriculum/challenges/arabic/blocks/lecture-understanding-routing-in-express-js/69a9184b42ae3947e4925016.md b/curriculum/challenges/arabic/blocks/lecture-understanding-routing-in-express-js/69a9184b42ae3947e4925016.md
index 86a860b87b5..a27f96b7f8f 100644
--- a/curriculum/challenges/arabic/blocks/lecture-understanding-routing-in-express-js/69a9184b42ae3947e4925016.md
+++ b/curriculum/challenges/arabic/blocks/lecture-understanding-routing-in-express-js/69a9184b42ae3947e4925016.md
@@ -7,6 +7,8 @@ dashedName: how-does-expressrouter-work
# --description--
+## ما هو `express.Router()`؟
+
في Express، تُعد `express.Router()` ميزة قوية تساعدك على تنظيم مساراتك إلى أجزاء أصغر ومودولية. هذا مفيد بشكل خاص مع نمو التطبيق.
بدلًا من تعريف كل المسارات في ملف كبير واحد، يمكنك تقسيمها إلى ملفات منفصلة باستخدام الموجِّهات. هذا يجعل كودك أسهل في القراءة والصيانة والتوسع.
@@ -17,6 +19,8 @@ dashedName: how-does-expressrouter-work
بمعنى آخر، يسمح لك الموجِّه بتجميع المسارات المرتبطة معًا ثم دمجها لاحقًا في التطبيق الرئيسي.
+## فوائد استخدام الموجِّهات
+
لاستخدام الموجِّهات عدة مزايا:
**فصل الاهتمامات**
@@ -29,6 +33,8 @@ dashedName: how-does-expressrouter-work
**تنظيف الملف الرئيسي**
بدلاً من ملء ملف `app.js` أو `server.js` الرئيسي بالعديد من تعريفات المسارات، يمكنك نقلها إلى الموجِّهات والحفاظ على تركيز الملف الرئيسي على الإعداد والتكوين.
+## مثال: توجيه الطلبات إلى `/users`
+
لننظر إلى مثال بسيط حيث نستخدم `express.Router()` لتعريف مسارات لمسار `/users`.
أولاً، هذا هو ملف `app.js`:
@@ -74,6 +80,8 @@ router.get("/:id", (req, res) => {
module.exports = router;
```
+## كيف يعمل المثال
+
الآن لنلق نظرة أقرب على كيفية عمل كل شيء.
في `app.js`، نستورد `express` ونُنشئ نسخة من تطبيق Express ونعينها إلى متغير اسمه `app`.
@@ -90,6 +98,7 @@ module.exports = router;
* `router.get("/:id")` → `GET /users/:id`: يرد بتفاصيل المستخدم لرقم معرف معين
+## تنظيم التطبيقات الأكبر
استخدام `express.Router()` يحافظ على نظافة الملف الرئيسي وتركيزه على التكوين. جميع المسارات المتعلقة بالمستخدمين مجمعة في `userRoutes.js`.
diff --git a/curriculum/challenges/arabic/blocks/lecture-understanding-security-and-privacy-in-web-applications/6a3b86e9f96f6bbcd0ed8c45.md b/curriculum/challenges/arabic/blocks/lecture-understanding-security-and-privacy-in-web-applications/6a3b86e9f96f6bbcd0ed8c45.md
index 5aefe44aecb..c96821d93d3 100644
--- a/curriculum/challenges/arabic/blocks/lecture-understanding-security-and-privacy-in-web-applications/6a3b86e9f96f6bbcd0ed8c45.md
+++ b/curriculum/challenges/arabic/blocks/lecture-understanding-security-and-privacy-in-web-applications/6a3b86e9f96f6bbcd0ed8c45.md
@@ -11,7 +11,7 @@ HTTPS تعني بروتوكول نقل النص الفائق الآمن. هو ا
كما تعلمت في بعض المحاضرات السابقة، ينقل HTTP البيانات بين متصفحك وموقع الويب. HTTP العادي يرسل هذه البيانات كنص عادي، لذا يمكن لأي شخص اعتراض تلك البيانات النصية.
-لهذا السبب، يستخدم HTTPS بروتوكول تشفير يُسمى أمان طبقة النقل (TLS) لتأمين نقل البيانات. يقوم TLS بتشفير قناة الاتصال بين نقطتين. كانت الأنظمة القديمة تستخدم طبقة المقابس الآمنة (SSL)، التي لا تزال العديد من منصات استضافة الويب تستخدمها اليوم.
+لهذا السبب، يستخدم HTTPS بروتوكول تشفير يُسمى أمان طبقة النقل (TLS) لتأمين نقل البيانات هذا. يقوم TLS بتشفير قناة الاتصال بين نقطتين. استبدل TLS بروتوكول طبقة المقابس الآمنة (SSL) الأقدم، رغم أن العديد من منصات استضافة الويب لا تزال تشير إلى SSL في إعداداتها اليوم.
التشفير يحول تلك البيانات إلى شفرة غير قابلة للقراءة لا يملك مفاتيح فك تشفيرها سوى متصفح المستخدم وخادم الويب.
diff --git a/curriculum/challenges/arabic/blocks/lecture-understanding-security-and-privacy-in-web-applications/6a3b86eac73558aaa2679c15.md b/curriculum/challenges/arabic/blocks/lecture-understanding-security-and-privacy-in-web-applications/6a3b86eac73558aaa2679c15.md
index f5bbc82e2ea..9cc859b15b3 100644
--- a/curriculum/challenges/arabic/blocks/lecture-understanding-security-and-privacy-in-web-applications/6a3b86eac73558aaa2679c15.md
+++ b/curriculum/challenges/arabic/blocks/lecture-understanding-security-and-privacy-in-web-applications/6a3b86eac73558aaa2679c15.md
@@ -7,6 +7,8 @@ dashedName: how-are-cookies-stored-and-what-are-the-security-and-privacy-implica
# --description--
+## ما هي الكوكيز؟
+
الكوكيز هي ملفات نصية صغيرة تحفظها مواقع الويب على جهازك لتتذكر بعض المعلومات عنك.
إليك عملية استقبال وتخزين الكوكيز:
@@ -18,10 +20,14 @@ dashedName: how-are-cookies-stored-and-what-are-the-security-and-privacy-implica
تتيح هذه العملية للموقع تذكر جلسة تسجيل الدخول، وعناصر سلة التسوق، والتفضيلات والإعدادات، وغيرها من المعلومات المهمة.
+## مخاطر أمان تخزين الكوكيز
+
تُدخل طريقة التخزين مخاطر أمان كبيرة. إذا حصل مخترق على وصول مادي إلى جهازك أو استخدم برمجيات خبيثة لقراءة ملفاتك المحلية، يمكنه سرقة كوكيز الجلسة الخاصة بك.
مع كوكيز جلسة مسروقة، يمكن للمهاجم تسجيل الدخول إلى حساباتك من كمبيوتر مختلف تمامًا دون معرفة كلمة المرور.
+## الحماية باستخدام علامات الأمان
+
لحماية المستخدمين ومنع سرقة الكوكيز، يستخدم المطوّرون علامات أمان محددة عند تعيين الكوكيز:
تمنع العلامة `HttpOnly` جافاسكريبت من قراءة ملف الكوكيز. هذا القيد يمنع المهاجمين من سرقة رموز الجلسة عبر هجمات البرمجة عبر المواقع (Cross-Site Scripting).
@@ -33,12 +39,16 @@ dashedName: how-are-cookies-stored-and-what-are-the-security-and-privacy-implica
- `SameSite=Strict` يمنع المتصفح من إرسال الكوكيز في أي طلب عبر موقع.
- `SameSite=Lax` يسمح بالكوكيز في التنقل الآمن على المستوى الأعلى، مثل النقر على رابط، لكنه يمنعها في إرسال النماذج عبر المواقع وطلبات API.
+## التتبع من طرف ثالث
+
للكوكيز أيضًا تداعيات كبيرة على الخصوصية. تتعقب الكوكيز من الطرف الأول أفعالك فقط على الموقع الذي تختاره لزيارته. أما الكوكيز من الطرف الثالث فتتبعك عبر مواقع مختلفة تمامًا.
تضع شبكات الإعلانات هذه الكوكيز على آلاف المواقع الشهيرة. أثناء تصفحك للإنترنت، تقرأ شبكة الإعلانات نفس كوكيز الطرف الثالث مرارًا لبناء ملف شخصي مفصل عن اهتماماتك الشخصية، وتاريخ البحث، وعاداتك على الإنترنت.
يخلق هذا التتبع الخفي قلقًا كبيرًا على الخصوصية لأنه يسمح للشركات بمراقبة حياتك الرقمية دون علمك النشط.
+## القوانين والحمايات الافتراضية
+
بسبب هذه التهديدات، تتطلب قوانين الخصوصية مثل GDPR من المواقع عرض لافتات موافقة على الكوكيز لتعرف ما الذي يفعله الموقع بالكوكيز التي يضعها. تمنحك هذه القوانين الحق القانوني في رفض كوكيز التتبع.
بالإضافة إلى ذلك، تحظر المتصفحات الحديثة الآن كوكيز التتبع من الطرف الثالث افتراضيًا لتوفير حماية خصوصية تلقائية للمستخدمين.
diff --git a/curriculum/challenges/arabic/blocks/lecture-understanding-the-command-line-and-working-with-bash/687e910842f3322350bc8d93.md b/curriculum/challenges/arabic/blocks/lecture-understanding-the-command-line-and-working-with-bash/687e910842f3322350bc8d93.md
index 83fa5cef2ae..6c52ae59c85 100644
--- a/curriculum/challenges/arabic/blocks/lecture-understanding-the-command-line-and-working-with-bash/687e910842f3322350bc8d93.md
+++ b/curriculum/challenges/arabic/blocks/lecture-understanding-the-command-line-and-working-with-bash/687e910842f3322350bc8d93.md
@@ -9,7 +9,7 @@ dashedName: what-is-the-terminal-and-how-does-it-differ-from-the-command-line
دعنا نتعلم عن الطرفية، وكيف تختلف عن سطر الأوامر.
-سطر الأوامر هو واجهة مُدخَل نصي أساسية تتيح للمستخدم إدخال "أوامر"، عادةً على شكل سلسلة من الأحرف، وإرسالها أو تنفيذها، عادةً بالضغط على مفتاح Enter. سترى غالبًا واجهات سطر الأوامر داخل الطرفية.
+سطر الأوامر هو واجهة إدخال نصية أساسية تتيح للمستخدم إدخال "أوامر"، عادةً على شكل سلسلة من الأحرف، وإرسالها أو تنفيذها، عادةً بالضغط على مفتاح Enter. سترى غالبًا واجهات سطر الأوامر داخل الطرفية.
الطرفية هي تطبيق خاص يقدم واجهة سطر أوامر لتنفيذ أوامر على مستوى النظام تتجاوز عمليات القراءة/الكتابة الأساسية. قد تسمع أيضًا عن "محاكيات الطرفية"، وهي تطبيقات تغلف واجهة طرفية أساسية لتقديم ميزات أو وظائف إضافية. لكن لأغراض عامة، يمكنك اعتبارها "طرفيات" أيضًا.
@@ -17,23 +17,21 @@ dashedName: what-is-the-terminal-and-how-does-it-differ-from-the-command-line
لكن كيف يمكنك الوصول إلى الطرفية على نظامك؟
-إذا كنت تستخدم إصدارًا حديثًا من Windows، فربما لديك خياران مختلفان. يقدم Windows تطبيقين مختلفين للأصداف مباشرة: Powershell وCommand Prompt.
+إذا كنت تستخدم إصدارًا حديثًا من Windows، فستجد على الأرجح خيارين مختلفين. يوفر Windows تطبيقين مميزين للـ shell مباشرةً: PowerShell وCommand Prompt.
-كل من هذين الصدَفين يأتي مع تطبيق طرفية خاص به (يشارك اسم الصَدَف نفسه)، لذا يمكنك استخدام قائمة التطبيقات لبدء طرفية Powershell أو طرفية Command Prompt.
+كل من هذين الـ shell يأتي مع تطبيق طرفية خاص به (يشارك اسم الـ shell المعني)، لذا يمكنك استخدام قائمة التطبيقات لبدء طرفية PowerShell أو طرفية Command Prompt.
-يقدم Windows أيضًا محاكي طرفية حديث نسبيًا اسمه Microsoft Terminal.
+يوفر Windows أيضًا محاكي طرفية حديثًا نسبيًا يُسمى Windows Terminal.
-يمكنك تثبيت هذا التطبيق من متجر Windows، ثم تشغيله كما تفعل مع طرفيات Powershell أو Command Prompt. ميزة Microsoft Terminal أنه يسمح لك بالوصول إلى صدَفي Powershell وCommand Prompt من نفس التطبيق، بالإضافة إلى صدَف Linux الخاص بك إذا قمت بتكوين Windows Subsystems for Linux.
+يمكنك تثبيت هذا التطبيق من متجر Windows، ثم تشغيله كما تفعل مع طرفيات PowerShell أو Command Prompt. ميزة Windows Terminal أنه يسمح لك بالوصول إلى كل من shell الخاص بـ PowerShell وCommand Prompt من نفس التطبيق، بالإضافة إلى shell Linux الخاص بك إذا قمت بتكوين Windows Subsystem for Linux.
-يقدم MacOS طرفية تُسمى ببساطة "Terminal". يمكنك الوصول إليها عبر البحث السريع أو من خلال مشغل التطبيقات.
-
-يدعم MacOS أيضًا محاكيات طرفية من جهات خارجية، مثل iTerm أو Ghostty. يمكنك تثبيت هذه التطبيقات من مواقعها الرسمية.
+على macOS، هناك طرفية تُسمى ببساطة "Terminal". يمكنك الوصول إليها من خلال البحث السريع أو من خلال مشغل التطبيقات. كما يوجد دعم لمحاكيات طرفية من جهات خارجية، مثل iTerm أو Ghostty. يمكنك تثبيت هذه التطبيقات من صفحاتها الرئيسية.
في Linux، الطرفية الافتراضية (وكيفية تشغيلها) تعتمد بشكل كبير على التوزيعة وبيئة سطح المكتب التي تستخدمها. هناك دعم كبير لمحاكيات طرفية من جهات خارجية أيضًا. على سبيل المثال، يمكنك إعداد kitty في Arch Linux - ويمكنك تشغيله باستخدام مدير التطبيقات مثل wofi.
يُعتبر Linux الأكثر تنوعًا في تطبيقات الطرفية التي يمكنك الاختيار منها. يمكن تثبيت معظمها عبر مدير الحزم الخاص بتوزيعتك.
-قد يبدو التمييز بين "الطرفية" و"الصدَف" و"سطر الأوامر" دقيقًا أحيانًا. وفي الغالب، يمكن استخدام هذه المصطلحات بالتبادل. لكن من المهم معرفة أن لكل منها معنى محدد، وما هو هذا المعنى.
+قد يبدو التمييز بين "الطرفية" و"الـ shell" و"سطر الأوامر" دقيقًا أحيانًا. وفي الغالب، يمكن استخدام هذه المصطلحات بالتبادل. لكن من المهم معرفة أن لكل منها معنى محدد، وما هو هذا المعنى.
# --questions--
@@ -111,7 +109,7 @@ dashedName: what-is-the-terminal-and-how-does-it-differ-from-the-command-line
## --text--
-في Windows، ما الميزة التي يقدمها Microsoft Terminal مقارنة بالخيارات التقليدية؟
+ما الميزة التي يقدمها Windows Terminal على الخيارات التقليدية في Windows؟
## --answers--
@@ -119,11 +117,11 @@ dashedName: what-is-the-terminal-and-how-does-it-differ-from-the-command-line
### --feedback--
-فكر في الوظائف التي يقدمها Microsoft Terminal والتي لا توفرها الطرفيات التقليدية في Windows.
+فكر في الوظائف التي يوفرها Windows Terminal والتي لا توفرها الطرفيات التقليدية في Windows.
---
-يسمح بالوصول إلى صدَفي Powershell وCommand Prompt من نفس التطبيق.
+يسمح بالوصول إلى كل من shell الخاص بـ PowerShell وCommand Prompt من نفس التطبيق.
---
@@ -131,7 +129,7 @@ dashedName: what-is-the-terminal-and-how-does-it-differ-from-the-command-line
### --feedback--
-فكر في الوظائف التي يقدمها Microsoft Terminal والتي لا توفرها الطرفيات التقليدية في Windows.
+فكر في الوظائف التي يوفرها Windows Terminal والتي لا توفرها الطرفيات التقليدية في Windows.
---
@@ -139,7 +137,7 @@ dashedName: what-is-the-terminal-and-how-does-it-differ-from-the-command-line
### --feedback--
-فكر في الوظائف التي يقدمها Microsoft Terminal والتي لا توفرها الطرفيات التقليدية في Windows.
+فكر في الوظائف التي يوفرها Windows Terminal والتي لا توفرها الطرفيات التقليدية في Windows.
## --video-solution--
diff --git a/curriculum/challenges/arabic/blocks/lecture-understanding-the-command-line-and-working-with-bash/687e9437536d762823fefab3.md b/curriculum/challenges/arabic/blocks/lecture-understanding-the-command-line-and-working-with-bash/687e9437536d762823fefab3.md
index b32baa9ac43..902d6c8bb69 100644
--- a/curriculum/challenges/arabic/blocks/lecture-understanding-the-command-line-and-working-with-bash/687e9437536d762823fefab3.md
+++ b/curriculum/challenges/arabic/blocks/lecture-understanding-the-command-line-and-working-with-bash/687e9437536d762823fefab3.md
@@ -11,20 +11,32 @@ dashedName: what-are-some-shortcuts-you-can-use-in-the-command-line-to-speed-up-
يمكن لاختصارات الطرفية وسطر الأوامر أن تساعدك على تبسيط سير عملك وزيادة إنتاجيتك إلى أقصى حد. بالنسبة لنظامي Linux وmacOS، اللذين يعودان جذورهما إلى Unix، ستكون العديد من هذه الاختصارات متشابهة. لكن بالنسبة لنظام Windows، ستكون هناك بعض الاختلافات.
+## اختصارات سهم للأعلى و سهم للأسفل
+
الاختصار الأول هو مفتاح سهم للأعلى. الضغط على هذا المفتاح يسمح لك بالتنقل للخلف عبر سجل الأوامر، أمرًا واحدًا في كل مرة. ثم يمكن استخدام مفتاح سهم للأسفل للتنقل للأمام عبر سجل الأوامر. هذان المفتاحان يتيحان لك التنقل بسرعة بين الأوامر التي نفذتها سابقًا للعثور على الأمر الذي تحتاج إلى تشغيله مرة أخرى.
-تقدم العديد من الصدوع أيضًا ميزة الإكمال التلقائي، التي تقترح أوامر بناءً على ما بدأت بكتابته. يمكن استخدام مفتاح Tab لملء بقية الاقتراح، مما يملأ سطر الأوامر بسرعة بالصيغة النحوية الكاملة. تختلف طريقة توليد هذه الاقتراحات من صدع لآخر. على سبيل المثال، في zsh تعتمد هذه الاقتراحات على سجل الأوامر الأخير. أما في PowerShell، فتعتمد على الأوامر والمتغيرات والمعلمات المتاحة (مع وزن أقل لمدى استخدامها مؤخرًا).
+## الإكمال التلقائي باستخدام مفتاح Tab
+
+تقدم العديد من الصدفات أيضًا ميزة الإكمال التلقائي، حيث تقترح أوامر بناءً على ما بدأت بكتابته. يمكن استخدام مفتاح Tab لملء بقية الاقتراح، مما يملأ سطر الأوامر بسرعة بالصيغة النحوية الكاملة. ما يتم اقتراحه يعتمد على الصدفة، والأمر الذي تكتبه، وكيفية تكوين الصدفة الخاصة بك. على سبيل المثال، عند كتابة اسم أمر، يقترح Bash و zsh أوامر مطابقة، وعند كتابة معلمة، عادةً ما يقترحان أسماء ملفات ومجلدات مطابقة. يمكن لـ PowerShell إكمال الأوامر، وأسماء المعلمات، والمتغيرات، ومسارات الملفات.
+
+## اختصار Control + L
أحيانًا قد ينتج عن أمر ما الكثير من المخرجات على الطرفية. قد يعيق هذا الضجيج الإضافي سير عملك أو يسبب إزعاجًا. في الطرفيات المبنية على *nix الموجودة في أجهزة Linux وmacOS، يمكنك الضغط على Control + L لمسح الشاشة بالكامل والبدء بموجه نظيف وجديد. في PowerShell، يقوم Control + L أيضًا بمسح الشاشة افتراضيًا، ويمكنك تشغيل الأمر `cls` لنفس النتيجة.
-إذا احتجت إلى مقاطعة أمر لإيقاف تنفيذه، يمكنك استخدام Control + C لقتل العملية. هذا سينهي الأمر ويُنشئ موجهًا جديدًا، مما يسمح لك بالاستمرار في العمل على ما تحتاج إليه. بالنسبة لمستخدمي PowerShell، يُستخدم Control + C أيضًا لنسخ النص - ولن يعمل لإنهاء عملية إلا عندما لا يكون هناك نص محدد للنسخ.
+## اختصار Control + C
+
+إذا كنت بحاجة إلى مقاطعة أمر لإيقاف تنفيذه، يمكنك الضغط على Control + C. يرسل هذا طلب مقاطعة إلى الأمر الذي يعمل في المقدمة، والذي عادةً ما يوقفه ويعيدك إلى موجه جديد، مما يسمح لك بالاستمرار في العمل على ما تحتاج إليه. بعض البرامج تتعامل مع هذا الطلب بنفسها، فقد تطلب منك التأكيد أو الاستمرار في التشغيل بدلاً من ذلك. بالنسبة لمستخدمي PowerShell، يُستخدم Control + C أيضًا لنسخ النص - ولن يعمل لمقاطعة أمر إلا عندما لا يكون السياق غامضًا (مثل عدم تحديد نص للنسخ).
+
+## اختصارات الطرفية المبنية على *nix
الاختصارات التالية متاحة فقط في الطرفيات المبنية على *nix، ولا يوجد لها بديل في PowerShell.
-قد تحتاج أحيانًا إلى تعدد المهام، مما يسمح لعملية أو أمر بالعمل في الخلفية أثناء عملك على شيء آخر. الضغط على Control + Z يضع العملية الحالية في مهمة خلفية ويعيدك إلى سطر الأوامر لتواصل عملك. عندما تحتاج إلى إعادة التركيز على المهمة الخلفية، يمكنك استخدام `fg` لاستعادتها.
+قد تحتاج أحيانًا إلى تعدد المهام، مع إيقاف أمر مؤقتًا أثناء العمل على آخر. الضغط على Control + Z يعلق الأمر الذي يعمل في المقدمة ويعيدك إلى سطر الأوامر، حيث يمكنك متابعة عملك. الأمر المعلق متوقف مؤقتًا، وليس قيد التشغيل. إذا أردت أن يستمر في العمل في الخلفية، استخدم الأمر `bg`. وعندما تحتاج إلى إعادته إلى المقدمة، استخدم الأمر `fg`.
وأخيرًا، قد تحتاج إلى تشغيل أوامر مرتين متتاليتين. يمكنك الضغط على مفتاح سهم للأعلى للتنقل للخلف إلى الأمر الذي تم تشغيله سابقًا، أو يمكنك كتابة علامتي تعجب (`!!`) في سطر الأوامر والضغط على Enter - هذا سيشغل آخر أمر تم تنفيذه تلقائيًا.
+## مرجع اختصارات واجهة سطر الأوامر
+
| Linux، macOS، وPowerShell | |||||||||||||||||
| إكمال اقتراح (الإكمال التلقائي باستخدام Tab) | +إكمال اقتراح (الإكمال باستخدام Tab) | Tab | -Linux، macOS، وPowerShell (مصدر الاقتراح يختلف حسب الصدع - على سبيل المثال، يستخدم zsh سجل الأوامر الأخير، بينما يستخدم PowerShell الأوامر والمتغيرات والمعلمات المتاحة) | +Linux و macOS و PowerShell (تعتمد الاقتراحات على الصدفة، والأمر الذي تكتبه، وتكوينك) | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| مسح الطرفية | @@ -58,12 +70,12 @@ dashedName: what-are-some-shortcuts-you-can-use-in-the-command-line-to-speed-up-|||||||||||||||||
| مقاطعة عملية جارية | Control + C | -Linux، macOS، وPowerShell (في PowerShell يُستخدم أيضًا لنسخ النص، وينهي العملية فقط عندما لا يكون هناك نص محدد للنسخ) | +Linux و macOS و PowerShell (في PowerShell يُستخدم أيضًا لنسخ النص، ويقاطع الأمر فقط عندما لا يكون هناك نص محدد للنسخ) | ||||||||||||||
| نقل عملية إلى الخلفية | +تعليق العملية في المقدمة | Control + Z | -Linux وmacOS فقط، لا يوجد بديل في PowerShell | +Linux و macOS فقط، لا يوجد بديل في PowerShell (استخدم bg لاستئنافها في الخلفية أو fg لاستئنافها في المقدمة) |
|||||||||||||
| إعادة تشغيل الأمر السابق | @@ -123,11 +135,11 @@ dashedName: what-are-some-shortcuts-you-can-use-in-the-command-line-to-speed-up- ### --feedback-- -هذا الاختصار يسمح لك بتعدد المهام أثناء تشغيل عملية. +يتيح لك هذا الاختصار إيقاف أمر مؤقتًا والعودة إليه لاحقًا. --- -يضع العملية الحالية في الخلفية. +يعلق العملية الحالية في المقدمة. --- @@ -135,7 +147,7 @@ dashedName: what-are-some-shortcuts-you-can-use-in-the-command-line-to-speed-up- ### --feedback-- -هذا الاختصار يسمح لك بتعدد المهام أثناء تشغيل عملية. +يتيح لك هذا الاختصار إيقاف أمر مؤقتًا والعودة إليه لاحقًا. --- @@ -143,7 +155,7 @@ dashedName: what-are-some-shortcuts-you-can-use-in-the-command-line-to-speed-up- ### --feedback-- -هذا الاختصار يسمح لك بتعدد المهام أثناء تشغيل عملية. +يتيح لك هذا الاختصار إيقاف أمر مؤقتًا والعودة إليه لاحقًا. ## --video-solution-- diff --git a/curriculum/challenges/arabic/blocks/lecture-understanding-the-command-line-and-working-with-bash/687e944b821130283dc83b2e.md b/curriculum/challenges/arabic/blocks/lecture-understanding-the-command-line-and-working-with-bash/687e944b821130283dc83b2e.md index 47678ad266b..f555e15e041 100644 --- a/curriculum/challenges/arabic/blocks/lecture-understanding-the-command-line-and-working-with-bash/687e944b821130283dc83b2e.md +++ b/curriculum/challenges/arabic/blocks/lecture-understanding-the-command-line-and-working-with-bash/687e944b821130283dc83b2e.md @@ -9,14 +9,20 @@ dashedName: what-is-bash-and-what-are-some-bash-commands دعنا نتعلم عن Bash وبعض أوامره الأساسية. +## ما هو Bash؟ + Bash تعني Bourne Again SHell، وهي على الأرجح أكثر واجهات الأوامر شيوعًا التي ستواجهها في بيئات شبيهة بـ Unix. لذلك، من المفيد جدًا أن تفهم كيفية التنقل في هذه الواجهة واستخدام الأوامر الشائعة. +## أوامر التنقل في نظام الملفات + الأمر الأول هو `pwd`، الذي يطبع الدليل الحالي للعمل في الطرفية. يشير "الدليل الحالي للعمل" إلى الدليل الذي تشير إليه الطرفية حاليًا، وهو أمر مهم معرفته للعديد من هذه الأوامر الأخرى. من الممكن تمامًا أن تكون الطرفية تشير إلى دليل خاطئ. يسمح لك الأمر `cd` بتغيير الأدلة. يمكنك تحديد مسار مطلق يبدأ بشرطة مائلة للأمام (`/`)، أو مسار نسبي بدون بادئة، واستخدام صيغة النقطتين (`..`) للصعود إلى الدليل الأب. الأمر التالي هو `ls`، الذي يعرض محتويات الدليل الحالي للعمل. هذا مفيد لمعرفة ما إذا كان هناك ملف أو مجلد في دليلك. يأخذ أمر `ls` أيضًا علامات لعرض الملفات المخفية (العلامة `-a`)، أذونات الملفات (العلامة `-l`)، وميزات أخرى. ستتعلم المزيد عن علامات الأوامر في الدرس التالي. يمكنك أيضًا استخدام `less` أو `cat` لعرض محتويات ملف. +## أوامر إدارة الملفات + ماذا لو لم يحتوي الدليل على الملف أو المجلد الذي تحتاجه؟ هناك أوامر تسمى `mkdir` و `touch` تسمح لك بإنشائها. ينشئ `mkdir` دليلًا جديدًا أو مجلدًا، و`touch` ينشئ ملفًا جديدًا. كلا الأمرين يقبلان اسم الملف أو المجلد الذي تريد إنشاؤه. على سبيل المثال، `touch readme.md` ينشئ ملف Markdown جديد باسم `readme.md`. ربما لم يكن يجب تسمية ملفك الجديد `readme.md`، بل يجب أن يكون `readthis.md`. لحسن الحظ، يسمح لك الأمر `mv` بنقل (أو إعادة تسمية) ملف. يأخذ اسم الملف القديم واسم الملف الجديد. @@ -25,8 +31,12 @@ Bash تعني Bourne Again SHell، وهي على الأرجح أكثر واجه يمكن استخدام الأمر `cp` لنسخ ملف أو مجلد إلى موقع جديد. على عكس الأمر `mv`، لا يحذف الأمر `cp` الملف الأصلي - ولنسخ مجلد، ستحتاج إلى تمرير العلامة `-r`. +## إخراج النص في وحدة التحكم + يمكن اعتبار الأمر `echo` معادل Bash لدالة `console.log()` أو `print()`. يأخذ `echo` معلمة سلسلة نصية، ملفوفة بين علامات اقتباس، ويطبعها في الطرفية. قد يبدو هذا سخيفًا لتشغيله في الطرفية فقط للحصول على نص في الطرفية، لكن يمكنك ربط `echo` برمز تحكم. يسمح الرمز `>` بتحديد اسم ملف لإنشائه أو استبداله بالسلسلة الجديدة، مثل `echo "Naomi was here." > readme.md`، والرمز `>>` يضيف إلى الملف. +## أوامر Bash الأخرى + هناك العديد من أوامر Bash الأخرى المتاحة لك، مثل `head`، `tail`، `chown`، و `chmod`. سيكون من المستحيل تغطيتها جميعًا في هذا الدرس. لكن يمكنك استخدام الأمر `man` لرؤية الدليل أو صفحة المساعدة لأي أمر تقريبًا. من المحتمل أن تتذكر الأوامر التي تستخدمها بشكل متكرر. وللباقي، يمكنك دائمًا مراجعة صفحة الدليل. diff --git a/curriculum/challenges/arabic/blocks/lecture-understanding-the-command-line-and-working-with-bash/687e947ae3ea7d2867c3d0e1.md b/curriculum/challenges/arabic/blocks/lecture-understanding-the-command-line-and-working-with-bash/687e947ae3ea7d2867c3d0e1.md index a495cecebcc..e5fb2beca7e 100644 --- a/curriculum/challenges/arabic/blocks/lecture-understanding-the-command-line-and-working-with-bash/687e947ae3ea7d2867c3d0e1.md +++ b/curriculum/challenges/arabic/blocks/lecture-understanding-the-command-line-and-working-with-bash/687e947ae3ea7d2867c3d0e1.md @@ -21,25 +21,31 @@ dashedName: what-are-some-command-options-and-flags ميزة هذه الخيارات القصيرة هي أنه يمكنك ربط عدة أعلام معًا. بدلًا من `ls --all --human-readable --size` يمكنك استخدام الحروف المفردة كلها مرة واحدة مع `ls -ahs`. -بعض الخيارات تتوقع تمرير قيمة لها. +بعض الخيارات تتوقع تمرير قيمة لها. طريقة تمرير هذه القيمة تعتمد على ما إذا كان الخيار يتطلب قيمة أم يقبلها بشكل اختياري فقط. -عند استخدام الخيارات بصيغة طويلة، عادةً تحتاج إلى استخدام علامة المساواة. في هذه الصيغة، تُلصق القيمة مباشرةً بالخيار باستخدام رمز المساواة (`=`). إليك مثالًا لتعديل سلوك `ls` ليشمل أو يستبعد الألوان: +عندما يتطلب الخيار بصيغة قصيرة قيمة، عادةً تفصل القيمة بمسافة. على سبيل المثال، هذا هو الخيار بصيغة قصيرة لتعيين `width` لنتيجة `ls`: ```bash -ls --color=never +ls -w 50 ``` -عند استخدام الخيارات بصيغة قصيرة، عادةً تفصل القيمة بمسافة. على سبيل المثال، هذه هي الخيارات بصيغتيها الطويلة والقصيرة لتعيين `width` لنتيجة `ls`: +عندما يتطلب الخيار بصيغة طويلة قيمة، تقبل أدوات GNU مثل `ls` القيمة إما بعد رمز يساوي (`=`) أو مفصولة بمسافة. كلا الأمرين يضبطان نفس العرض: ```bash -ls -w 50 +ls --width=50 ``` ```bash -ls --width=50 +ls --width 50 +``` + +بعض الخيارات بصيغة طويلة تقبل القيمة بشكل اختياري فقط. في هذه الحالة، يجب إرفاق القيمة بالخيار باستخدام رمز يساوي (`=`). على سبيل المثال، خيار `--color` في `ls` يمكن استخدامه بمفرده، أو مع قيمة تشمل أو تستثني الألوان: + +```bash +ls --color=never ``` -لاحظ كيف تستخدم الصيغة القصيرة `-w 50`، بينما تستخدم الصيغة الطويلة `--width=50`. هذا التمييز مهم لتجنب تمرير قيمة الخيار كمعلمة موضعية بدلًا من ذلك. +إذا كتبت `ls --color never` بدلاً من ذلك، سيعامل `ls` كلمة `never` كمعلمة موضعية، أي اسم ملف ليتم عرضه، بدلاً من أن تكون قيمة لخيار `--color`. من المهم معرفة هذا التمييز لتجنب تمرير قيمة الخيار كمعلمة موضعية عن طريق الخطأ. لكن إذا لم تكن متأكدًا، تذكر أنه يمكنك عادةً استخدام علم `--help` لرؤية الصيغة النحوية المتوقعة للخيارات! @@ -119,7 +125,7 @@ ls --width=50 ## --text-- -عند استخدام خيار بصيغة طويلة يتطلب قيمة، ما الصيغة النحوية التي تُستخدم عادةً؟ +عندما يقبل الخيار بصيغة طويلة القيمة بشكل اختياري فقط، مثل `--color` مع `ls`، ما الصيغة التي يجب استخدامها لتمرير القيمة؟ ## --answers-- @@ -127,7 +133,7 @@ ls --width=50 ### --feedback-- -تذكر مثال تعيين `width` باستخدام الخيار بصيغة طويلة. +تذكر ماذا يحدث للقيمة في الأمر `ls --color never`. --- @@ -139,7 +145,7 @@ ls --width=50 ### --feedback-- -تذكر مثال تعيين `width` باستخدام الخيار بصيغة طويلة. +تذكر المثال الخاص بإيقاف الألوان باستخدام خيار `--color`. --- @@ -147,7 +153,7 @@ ls --width=50 ### --feedback-- -تذكر مثال تعيين `width` باستخدام الخيار بصيغة طويلة. +تذكر المثال الخاص بإيقاف الألوان باستخدام خيار `--color`. ## --video-solution-- diff --git a/curriculum/challenges/arabic/blocks/lecture-understanding-the-command-line-and-working-with-bash/687f0a1d5b7c4f21a9d8e123.md b/curriculum/challenges/arabic/blocks/lecture-understanding-the-command-line-and-working-with-bash/687f0a1d5b7c4f21a9d8e123.md index 99d9de7d0f2..7b96c14910c 100644 --- a/curriculum/challenges/arabic/blocks/lecture-understanding-the-command-line-and-working-with-bash/687f0a1d5b7c4f21a9d8e123.md +++ b/curriculum/challenges/arabic/blocks/lecture-understanding-the-command-line-and-working-with-bash/687f0a1d5b7c4f21a9d8e123.md @@ -7,12 +7,16 @@ dashedName: how-do-you-configure-your-system-language-for-bash-and-postgresql-wo # --description-- +## لماذا يهم تخطيط لوحة المفاتيح لديك؟ + تعلم كيف تؤثر لغة النظام وإعدادات لوحة المفاتيح على ورش عمل Bash وPostgreSQL. تتوقع العديد من أدوات البرمجة أن تستخدم الأوامر أحرف لوحة مفاتيح إنجليزية قياسية. في ورش عمل Bash وPostgreSQL، هذا مهم جدًا للرموز مثل الفواصل المنقوطة (`;`)، وعلامات الاقتباس، والشرط المائلة، وغيرها من الأحرف الخاصة. إذا كان نظام التشغيل أو تخطيط لوحة المفاتيح لديك يستخدم لغة غير الإنجليزية، فقد تتصرف بعض الأحرف بشكل مختلف عن المتوقع. هذا قد يؤدي إلى أخطاء مربكة عند إدخال أوامر SQL أو أوامر الطرفية. +## التبديل إلى تخطيط لوحة مفاتيح الولايات المتحدة + للحصول على أفضل تجربة أثناء العمل في هذه الورش، يُنصح بالتبديل مؤقتًا إلى تخطيط لوحة مفاتيح الإنجليزية (الولايات المتحدة) أثناء إكمال الدورة. هذا مفيد خصوصًا إذا كانت أوامر Bash أو PostgreSQL تُنتج أحرفًا غير متوقعة أو أخطاء صيغة نحوية عند كتابة رموز مثل `;` أو `\`. يستخدم GitHub Codespaces تخطيط لوحة المفاتيح المحلي لديك، لذا فإن تغيير التخطيط على جهازك سيؤثر أيضًا على الكتابة داخل Codespaces. @@ -48,6 +52,8 @@ setxkbmap -query setxkbmap us ``` +## اختبار تخطيط لوحة المفاتيح لديك + بعد التبديل بين التخطيطات، اختبر الأحرف التالية في مربع نص أو الطرفية: ```md @@ -58,7 +64,9 @@ setxkbmap us تعامل بعض التخطيطات غير الإنجليزية مع أحرف مثل `'` و`"` كأحرف ميتة، أي أنها تنتظر ضغطة مفتاح تالية بدلاً من الكتابة فورًا. بعد التبديل إلى تخطيط US، يجب أن تُكتب هذه الأحرف فورًا. إذا لم يظهر الحرف فورًا، فهذا دليل على أن التخطيط لم يتبدل بالكامل. -إذا كنت تستخدم تخطيط لوحة مفاتيح مادي غير US مثل AZERTY أو QWERTZ أو متغيرات QWERTY إقليمية، فقد تكون مفاتيح الرموز في مواقع فيزيائية مختلفة. في هذه الحالة، استخدم لوحة المفاتيح على الشاشة أو عارض لوحة المفاتيح في نظام التشغيل لتحديد مواقع مفاتيح مثل `;`، `/`، `\`، `|`، `'`، و`"` بعد التبديل إلى تخطيط US. +## استخدام لوحة مفاتيح فعلية غير أمريكية + +إذا كنت تستخدم تخطيط لوحة مفاتيح فعلية غير أمريكية مثل AZERTY أو QWERTZ أو نسخ QWERTY الإقليمية، فقد تكون مفاتيح الرموز في مواقع فعلية مختلفة. في هذه الحالة، استخدم لوحة المفاتيح على الشاشة أو عارض لوحة المفاتيح في نظام التشغيل لتحديد مواقع مفاتيح مثل ;، /، \\، |، '، و" بعد التبديل إلى تخطيط الولايات المتحدة. يساعد استخدام تخطيط لوحة مفاتيح الإنجليزية (الولايات المتحدة) على ضمان أن أوامر Bash وPostgreSQL تعمل تمامًا كما هو متوقع طوال الورشة. diff --git a/curriculum/challenges/arabic/blocks/lecture-understanding-the-different-types-of-testing/67d2ff1996e4ae9e67170502.md b/curriculum/challenges/arabic/blocks/lecture-understanding-the-different-types-of-testing/67d2ff1996e4ae9e67170502.md index 8c630cf620d..dde4503cc7e 100644 --- a/curriculum/challenges/arabic/blocks/lecture-understanding-the-different-types-of-testing/67d2ff1996e4ae9e67170502.md +++ b/curriculum/challenges/arabic/blocks/lecture-understanding-the-different-types-of-testing/67d2ff1996e4ae9e67170502.md @@ -9,6 +9,8 @@ dashedName: what-is-unit-testing أثناء تصميم تطبيقاتك، غالبًا ما يكون لديك سلسلة من الدوال الصغيرة المسؤولة عن شيء واحد. يُعرف هذا بمبدأ "المسؤولية الواحدة". عندما يكون لديك سلسلة من الدوال الصغيرة، من الأفضل اختبار هذه الدوال للتأكد من أن كل شيء يعمل كما هو متوقع. في هذا الدرس، سنلقي نظرة على كيفية إنشاء اختبار وحدة باستخدام إطار العمل الشائع Jest. +## الدالة التي يجب اختبارها + في هذا المثال، سننشئ دالة مسؤولة عن إرجاع سلسلة نصية مُنسقة حديثًا: ```js @@ -20,6 +22,8 @@ export function getFormattedWord(str) { تحتوي دالة `getFormattedWord` على معلمة تسمى `str` وستتحقق أولًا مما إذا كانت `str` فارغة. إذا كانت كذلك، فستُرجع سلسلة نصية فارغة. وإلا، فستُرجع سلسلة جديدة حيث تُكتب الحرف الأول بحرف كبير. نحن نصدر هذه الدالة حتى نتمكن من استخدامها في ملف اختبار. +## كتابة اختبارك الأول + في ملف منفصل باسم `getFormattedWord.test.js`، يمكننا كتابة بعض الاختبارات للتحقق من أن الدالة تقوم بما يُفترض بها القيام به. في أعلى ملف `getFormattedWord.test.js`، نحتاج أولًا إلى استيراد الدالة بهذه الطريقة: @@ -38,6 +42,8 @@ test('capitalizes the first letter of a word', () => { تُستخدم دالة `expect` لاختبار قيمة. تُدمج مع matcher، وهي دالة تتحقق مما إذا كانت القيمة تتصرف كما هو متوقع. في هذه الحالة، الـ matcher هو `toBe()`. لدى Jest مجموعة متنوعة من matchers لمساعدتك في اختبار القيم الحقيقية، والسلاسل النصية، والأرقام، والمزيد. +## تشغيل اختباراتك + إحدى الطرق لتشغيل اختباراتك هي إضافة سكربت npm إلى ملف `package.json` الخاص بك. إليك مثالًا على سكربت لإطار العمل Jest: ```js @@ -59,6 +65,8 @@ Time: 0.103 s, estimated 1 s Ran all test suites. ``` +## كيف يبدو الاختبار الفاشل + لرؤية كيف يبدو اختبار فاشل، يمكننا عمدًا كسر الاختبار بتحديث الدالة إلى ما يلي: ```js @@ -97,6 +105,8 @@ Time: 0.121 s, estimated 1 s Ran all test suites. ``` +## إضافة اختبار آخر + الآن يمكننا تحديث دالتنا مرة أخرى إلى الأصلية هنا: ```js @@ -116,6 +126,8 @@ test("returns an empty string when no argument is provided", () => { هناك اختبارات أخرى يمكنك إضافتها لجعل الأمور أكثر متانة، لكن هذين الاختبارين الأولين مقدمة جيدة لاختبار الوحدة. +## أُطُر العمل الشائعة للاختبار + عندما يتعلق الأمر باختبار تطبيقات JavaScript، تشمل أطر العمل الشائعة للاختبار Jest وMocha وVitest. اختبار الوحدة مهم لأنه يساعدك على اكتشاف المزيد من الأخطاء البرمجية في برامجك، ويضمن أن كل شيء يعمل كما هو متوقع. كما يمكن أن يكون شكلًا من أشكال التوثيق لتطبيقك لأنه يهدف إلى تمثيل السلوك المتوقع لكودك. diff --git a/curriculum/challenges/arabic/blocks/lecture-understanding-the-different-types-of-testing/67db30fedfa0b22a1a2a570c.md b/curriculum/challenges/arabic/blocks/lecture-understanding-the-different-types-of-testing/67db30fedfa0b22a1a2a570c.md index bd56eda22ed..085192bed9a 100644 --- a/curriculum/challenges/arabic/blocks/lecture-understanding-the-different-types-of-testing/67db30fedfa0b22a1a2a570c.md +++ b/curriculum/challenges/arabic/blocks/lecture-understanding-the-different-types-of-testing/67db30fedfa0b22a1a2a570c.md @@ -27,18 +27,32 @@ dashedName: what-is-the-software-development-life-cycle-and-how-does-it-relate-t لنلقِ نظرة أقرب على كل هذه المراحل بتفصيل أكبر. +## مرحلة التخطيط + في مرحلة التخطيط، يجمع فريق التطوير المتطلبات للعمل المقترح من أصحاب المصلحة. صاحب المصلحة هو شخص له مصلحة مباشرة في نجاح المنتج أو الخدمة. من أمثلة أصحاب المصلحة المستثمرون، المالكون، أو حتى الموظفون الآخرون. تشمل مرحلة التخطيط أيضًا تقدير تكاليف العمل وإنشاء جدول زمني لإنجاز العمل. +## مرحلة التصميم + المرحلة التالية هي مرحلة التصميم. في هذه المرحلة، يقوم فريق البرمجيات بتفصيل المتطلبات وتحديد أفضل الطرق للحلول. يشمل ذلك تحديد الأدوات الخارجية التي يمكن استخدامها للمساعدة، وما هي الأدوات الداخلية التي يجب بناؤها لإنجاز المهمة. +## مرحلة التنفيذ + بعد مرحلة التصميم، تأتي مرحلة التنفيذ. تتضمن هذه المرحلة تقسيم المتطلبات إلى مهام قابلة للإدارة يوزعها الفريق فيما بينهم ويبنونها. +## مرحلة الاختبار + عند الانتهاء من مرحلة التنفيذ، ينتقل فريق البرمجيات إلى مرحلة الاختبار. تشمل هذه المرحلة الاختبار اليدوي والآلي للعمل الجديد. أحيانًا يختبر الفريق التطبيق طوال مرحلة التطوير بأكملها لاكتشاف وإصلاح أي مشكلات تظهر. +## مرحلة التشغيل + المرحلة التالية هي مرحلة التشغيل. هنا ينشر الفريق التغييرات الجديدة إلى بيئة بناء أو اختبار. يسمح ذلك للفريق باختبار التطبيق أكثر وإصلاح أي مشكلات قبل أن تذهب التغييرات إلى الإنتاج. التطبيق الإنتاجي هو التطبيق الذي يستخدمه المستخدمون النهائيون. +## مرحلة الصيانة + المرحلة الأخيرة هي مرحلة الصيانة. تتضمن إصلاح أي مشكلات تظهر من العملاء في التطبيق الإنتاجي. كما تشمل مراقبة النظام لأي تحسينات محتملة على البرمجيات. +## نماذج الشلال والمرنة + أخيرًا، هناك نماذج مختلفة لدورة حياة تطوير البرمجيات تُستخدم في الصناعة، مثل نموذج الشلال (Waterfall) ونموذج أجايل (Agile). نموذج الشلال يتطلب إكمال كل مرحلة من مراحل الدورة قبل بدء المرحلة التالية. بالمقابل، يركز نموذج أجايل على التطوير التكراري بتقسيم العمل إلى دفعات (sprints) ليتمكن الفريق من إجراء تغييرات سريعة وتسليم العمل تدريجيًا. من خلال المرور بدورة حياة تطوير البرمجيات، يمكن لفريق التطوير وأصحاب المصلحة أن يكونوا على نفس الصفحة فيما يتعلق بالمتطلبات، تقديرات التكاليف، والجداول الزمنية. هذا يعزز التعاون والتواصل بشكل أكثر كفاءة. diff --git a/curriculum/challenges/arabic/blocks/lecture-understanding-the-different-types-of-testing/67db31349f3ace2c5c803c33.md b/curriculum/challenges/arabic/blocks/lecture-understanding-the-different-types-of-testing/67db31349f3ace2c5c803c33.md index 1d79cc7e017..4b40094e82c 100644 --- a/curriculum/challenges/arabic/blocks/lecture-understanding-the-different-types-of-testing/67db31349f3ace2c5c803c33.md +++ b/curriculum/challenges/arabic/blocks/lecture-understanding-the-different-types-of-testing/67db31349f3ace2c5c803c33.md @@ -9,6 +9,8 @@ dashedName: what-are-bdd-and-tdd هناك نوعان من أساليب الاختبار يجب أن تعرفهما في تطوير البرمجيات. هذان الأسلوبان هما TDD (التطوير المدفوع بالاختبار) و BDD (التطوير المدفوع بالسلوك). +## التطوير الموجه بالاختبار (TDD) + لنلقِ نظرة أولاً على TDD. التطوير المدفوع بالاختبار هو منهجية تركز على كتابة الاختبارات أولاً قبل بناء الميزات في التطبيق. إليك العملية النموذجية لـ TDD: @@ -29,8 +31,12 @@ dashedName: what-are-bdd-and-tdd بينما تختار بعض فرق البرمجيات اتباع نهج TDD، يُعد TDD موضوعًا مثيرًا للجدل في الصناعة. ستجد العديد من المقالات والفيديوهات التي تدافع عنه وتعارضه في الوقت نفسه. بغض النظر عن رأيك في هذا النهج، من المهم أن تكون على دراية به لأنك قد تواجهه في سيناريوهات واقعية. +## التطوير الموجه بالسلوك (BDD) + الأسلوب الثاني للاختبار الذي سنستعرضه هو التطوير المدفوع بالسلوك (BDD). التطوير المدفوع بالسلوك هو أسلوب يربط سلسلة من الاختبارات بأهداف العمل. يجب كتابة هذه الاختبارات بلغة يفهمها كل من الفنيين وغير الفنيين. +### لغة Gherkin + عند اختبار سلوكيات محددة في تطبيق برمجي، يستخدم BDD عادة لغة Gherkin، التي تُستخدم في الأعمال لوصف السلوكيات والسيناريوهات. تستخدم لغة Gherkin عبارات Given و When و Then عند وصف السيناريوهات. إليك مثال: @@ -43,12 +49,16 @@ dashedName: what-are-bdd-and-tdd **Then** يجب حفظ منشور المدونة وعرضه على الصفحة الرئيسية بالعنوان والمحتوى والطابع الزمني الصحيح. +### كتابة سيناريوهات BDD + أولاً، تريد تعريف سيناريو. تشمل السيناريوهات مثالاً تسجيل المستخدم الدخول إلى تطبيق أو تقديم طلب على موقع ويب. في هذا المثال، السيناريو هو لمستخدم ينشئ منشور مدونة جديد على موقع. بعد تعريف السيناريو، يجب أن تبدأ بعبارة Given. هذه توفر سياقًا لمكان بدء المستخدم قبل تنفيذ الإجراء. تُستخدم عبارة When لتمثيل الإجراء الذي يقوم به المستخدم. أخيرًا، تُستخدم عبارة Then لتمثيل النتيجة المرجوة من الإجراء السابق الذي قام به المستخدم. بمجرد تعريف جميع السيناريوهات، يمكنك كتابة اختبارات لكل سيناريو. +### أُطُر اختبار + أمثلة على أُطُر اختبار BDD تشمل Cucumber و JBehave و SpecFlow. # --questions-- diff --git a/curriculum/challenges/arabic/blocks/lecture-understanding-the-http-request-response-model/68dd97fbd18ede5ae983e342.md b/curriculum/challenges/arabic/blocks/lecture-understanding-the-http-request-response-model/68dd97fbd18ede5ae983e342.md index eddf5af7ff7..0a380fa29bd 100644 --- a/curriculum/challenges/arabic/blocks/lecture-understanding-the-http-request-response-model/68dd97fbd18ede5ae983e342.md +++ b/curriculum/challenges/arabic/blocks/lecture-understanding-the-http-request-response-model/68dd97fbd18ede5ae983e342.md @@ -37,7 +37,7 @@ dashedName: what-are-the-different-kinds-of-assets-that-are-returned-in-an-http- | --- | --- | | HTML | text/html | | CSS | text/css | -| JavaScript | application/javascript | +| JavaScript | text/javascript | | JPEG | image/jpeg | | PNG | image/png | | GIF | image/gif | diff --git a/curriculum/challenges/arabic/blocks/lecture-understanding-the-web-standards-model/69fc757399f4066e674a5161.md b/curriculum/challenges/arabic/blocks/lecture-understanding-the-web-standards-model/69fc757399f4066e674a5161.md index 7615a09c4f2..adaccb0938e 100644 --- a/curriculum/challenges/arabic/blocks/lecture-understanding-the-web-standards-model/69fc757399f4066e674a5161.md +++ b/curriculum/challenges/arabic/blocks/lecture-understanding-the-web-standards-model/69fc757399f4066e674a5161.md @@ -7,29 +7,37 @@ dashedName: what-does-the-lifecycle-of-web-standards-features-look-like # --description-- +## ما هو دورة حياة الميزة؟ + في الدرس السابق، استعرضنا عملية إنشاء معايير الويب: كيف تُكتب المقترحات، وتُراجع، وفي النهاية تُعتمد. دورة حياة ميزة معيار الويب مرتبطة بذلك، لكنها على مستوى أكثر تفصيلاً. تتبع ميزة واحدة منذ لحظة تحديد شخص ما لمشكلة وحتى إصدارها في كل متصفح رئيسي (وربما إهمالها في النهاية). فكر في العملية كدليل القواعد، ودورة الحياة كالأحداث الفعلية التي تحدث أثناء لعب اللعبة. -1. ## الاقتراح - تبدأ كل ميزة بمشكلة اهتم بها شخص ما بما يكفي ليكتبها. يقدم مطوِّر أو مهندس متصفح أو شركة مشكلة على GitHub أو شرحًا يصف ما لا يستطيع الويب فعله حاليًا ولماذا يجب أن يفعل ذلك. في هذه المرحلة، تكون الفكرة غير محددة، مع وجود أسئلة أكثر من الإجابات. الهدف ببساطة هو معرفة ما إذا كان هناك من يشارك نفس المشكلة. +## 1. الاقتراح + +تبدأ كل ميزة بمشكلة اهتم بها شخص ما بما يكفي ليكتبها. يقدم مطوِّر، مهندس متصفح، أو شركة مشكلة على GitHub أو شرحًا يصف ما لا يستطيع الويب فعله حاليًا ولماذا يجب أن يفعل ذلك. في هذه المرحلة، تكون الفكرة غير محددة، مع وجود أسئلة أكثر من الأجوبة. الهدف ببساطة هو معرفة ما إذا كان هناك من يشارك نفس المشكلة. + +## 2. الحضانة + +إذا لاقى الاقتراح صدى، يدخل فترة من النقاش المفتوح والتصميم المبكر. تُرسم الطرق المتنافسة، تُجمع حالات الاستخدام، ويختبر المجتمع الفكرة تحت الضغط. تموت العديد من الاقتراحات هنا، ربما لأن المشكلة ضيقة جدًا، أو لا يوجد حل يرضي الجميع. الناجون يظهرون بشكل أوضح ويحصلون على اهتمام بعض بائعي المتصفحات. + +## 3. المواصفة + +يُكتب الاقتراح الناجح كمواصفة رسمية. يجب تعريف كل حالة حافة، حالة خطأ، وتفاعل مع الميزات الحالية بوضوح. هذه هي النقطة التي تلتقي فيها الفكرة الجيدة بالواقع الصعب. يجب أن تتحول المفاهيم الغامضة إلى قواعد دقيقة يمكن لمهندسين مستقلين قراءتها وتنفيذها بشكل مطابق. + +## 4. اختبار التوافقية -1. ## الحضانة - إذا لاقى الاقتراح صدى، يدخل فترة من النقاش المفتوح والتصميم المبكر. تُرسم الطرق المتنافسة، وتُجمع حالات الاستخدام، ويختبر المجتمع الفكرة تحت الضغط. تموت العديد من الاقتراحات هنا، ربما لأن المشكلة ضيقة جدًا أو لا يوجد حل يرضي الجميع. الناجون يظهرون بشكل أوضح ويحظون على الأقل ببعض اهتمام بائعي المتصفحات. +قبل اعتبار الميزة مستقرة، يجب أن تتصرف بنفس الطريقة في كل متصفح. مجموعة اختبارات منصة الويب من W3C هي الأداة الرئيسية للتحقق من ذلك. هي مجموعة مشتركة من الاختبارات التي يشغلها Chrome وFirefox وSafari وغيرهم على تطبيقاتهم. تعني النتائج المتباينة إما أن المواصفة غامضة، أو أن هناك خطأ برمجي. يجب حل أي منهما قبل تقدم الميزة. -1. ## المواصفة - يُكتب الاقتراح الناجح كمواصفة رسمية. يجب تعريف كل حالة طرفية، وحالة خطأ، وتفاعل مع الميزات الحالية بوضوح. هذه هي النقطة التي تلتقي فيها الفكرة الجيدة بالواقع الصعب. يجب أن تتحول المفاهيم الغامضة إلى قواعد دقيقة يمكن لمهندسين مستقلين قراءتها وتنفيذها بشكل متطابق. +## 5. الإنهاء -1. ## اختبار التوافقية - قبل اعتبار الميزة مستقرة، يجب أن تتصرف بنفس الطريقة في كل متصفح. مجموعة اختبارات منصة الويب الخاصة بـ W3C هي الأداة الرئيسية للتحقق من ذلك. هي مجموعة مشتركة من الاختبارات التي يشغلها Chrome وFirefox وSafari وغيرهم ضد تطبيقاتهم. تعني النتائج المتباينة إما أن المواصفة غامضة أو أن هناك خطأ برمجي. يجب حل أي منهما قبل تقدم الميزة. +بمجرد أن تجتاز عدة تطبيقات مستقلة الاختبارات، تُنهى الميزة. بالنسبة لـ W3C، تصبح توصية، وبالنسبة لـ TC39، تصل للمرحلة 4، وتُدرج بشكل مستقر في المعيار الحي لـ WHATWG. تُرفع الأعلام وتُطرح الميزة للمستخدمين. في هذه المرحلة، تصبح جزءًا من منصة الويب الأساسية، يمكن لكل مطوِّر الاعتماد عليها إلى أجل غير مسمى. -1. ## الإنهاء - بمجرد أن تجتاز عدة تطبيقات مستقلة الاختبارات، تُنهى الميزة. بالنسبة لـ W3C، تصبح توصية، ولـ TC39، تصل إلى المرحلة 4، وتُدرج بشكل مستقر في المعيار الحي لـ WHATWG. تُرفع الأعلام وتُطرح الميزة للمستخدمين. في هذه المرحلة، تصبح جزءًا من منصة الويب الأساسية، يمكن لكل مطوِّر الاعتماد عليها إلى أجل غير مسمى. +## 6. الإهمال -1. ## الإهمال - لا يشيخ كل معيار بشكل جيد. تحل بعض الميزات محلها ميزات أفضل، ويتبين أن بعضها له آثار أمنية أو خصوصية لم تكن واضحة في البداية. عندما تحتاج ميزة إلى الإزالة، تُهمل رسميًا. أي تُدعم لكنها تُعلَن كشيء يجب على المطوِّرين التوقف عن استخدامه. في النهاية، تُزال من المواصفة. الإزالة من المتصفحات بطيئة وحذرة، لأن الوعد الأساسي للويب هو استمرار عمل الصفحات القديمة. تبقى بعض الميزات المهملة في المتصفحات لعقود فقط من أجل التوافقية مع الإصدارات السابقة. +لا يشيخ كل معيار بشكل جيد. تحل ميزات أفضل محل بعضها، ويكتشف أن بعضها له آثار أمنية أو خصوصية لم تكن واضحة في البداية. عندما تحتاج ميزة إلى الإزالة، تُهمل رسميًا. أي تُدعم لكنها تُعلَّم على أنها شيء يجب على المطوِّرين التوقف عن استخدامه. في النهاية، تُزال من المواصفة. الإزالة من المتصفحات بطيئة وحذرة، لأن الوعد الأساسي للويب هو استمرار عمل الصفحات القديمة. تبقى بعض الميزات المهملة في المتصفحات لعقود فقط من أجل التوافقية العكسية. # --questions-- diff --git a/curriculum/challenges/arabic/blocks/lecture-understanding-variables-and-data-types/67fe8597975ea634042cad8f.md b/curriculum/challenges/arabic/blocks/lecture-understanding-variables-and-data-types/67fe8597975ea634042cad8f.md index 9774ebd74a3..ec998de2683 100644 --- a/curriculum/challenges/arabic/blocks/lecture-understanding-variables-and-data-types/67fe8597975ea634042cad8f.md +++ b/curriculum/challenges/arabic/blocks/lecture-understanding-variables-and-data-types/67fe8597975ea634042cad8f.md @@ -7,6 +7,8 @@ dashedName: how-do-you-declare-variables-and-what-are-naming-conventions-to-name # --description-- +## إعلان المتغيرات + في بايثون، المتغيرات تشبه صناديق معنونة لتخزين البيانات من أنواع مختلفة والإشارة إليها. لإنشاء متغير، اكتب اسمه على اليسار، متبوعًا بمعامل التعيين (`=`) والقيمة التي تريد تخزينها على اليمين. إليك مثالًا على كيفية إنشاء متغيري `name` و `age`: ```python @@ -16,6 +18,8 @@ age = 25 في المثال أعلاه، المتغير `name` يحمل القيمة `'John Doe'`. هذه القيمة هي سلسلة نصية، وهي مجموعة من الأحرف تُستخدم لتمثيل النص. تُكتب السلاسل النصية بعلامات اقتباس مفردة أو مزدوجة، مثل `'Hello'` أو `"Hello"`. في الدروس القادمة، ستتعلم المزيد عن التعامل مع السلاسل النصية في بايثون. +## اتباع قواعد التسمية + عند تسمية المتغيرات في بايثون، هناك بعض القواعد المهمة التي يجب أن تضعها في اعتبارك: - يجب أن تبدأ أسماء المتغيرات بحرف أو بشرطة سفلية (`_`) فقط، وليس برقم. @@ -31,6 +35,8 @@ age = 25 SyntaxError: invalid syntax ``` +## اتباع اصطلاحات التسمية + الآن دعنا نستعرض بعض اصطلاحات التسمية الشائعة للمتغيرات في بايثون. أولًا، يجب أن تكون أسماء المتغيرات بأحرف صغيرة، مع فصل الكلمات بشرطة سفلية. هذا يُسمى نمط snake case: @@ -53,6 +59,8 @@ user_age = 30 x = 56 # What do you mean by x? ``` +## كتابة التعليقات + رمز الشباك (`#`) والنص الذي يليه يشكلان تعليقًا. التعليقات تتيح لك إضافة ملاحظات وتوضيحات إلى كودك. في بايثون، تبدأ التعليقات برمز الباوند (`#`)، وتتجاهل اللغة كل شيء بعد رمز `#` في ذلك السطر: diff --git a/curriculum/challenges/arabic/blocks/lecture-understanding-variables-and-data-types/6a03f5d143c8688a9265c0a0.md b/curriculum/challenges/arabic/blocks/lecture-understanding-variables-and-data-types/6a03f5d143c8688a9265c0a0.md index e392ca4fbbc..317f0aab414 100644 --- a/curriculum/challenges/arabic/blocks/lecture-understanding-variables-and-data-types/6a03f5d143c8688a9265c0a0.md +++ b/curriculum/challenges/arabic/blocks/lecture-understanding-variables-and-data-types/6a03f5d143c8688a9265c0a0.md @@ -1,6 +1,6 @@ --- id: 6a03f5d143c8688a9265c0a0 -title: كيف تعمل الدالتان type() و isinstance()؟ +title: كيف تعمل الدالتان type() و isinstance()؟ challengeType: 19 dashedName: how-do-the-type-and-isinstance-functions-work --- diff --git a/curriculum/challenges/arabic/blocks/lecture-what-is-css/672acc03c257524d6a5151e8.md b/curriculum/challenges/arabic/blocks/lecture-what-is-css/672acc03c257524d6a5151e8.md index 9591a97ac90..792f2863a4a 100644 --- a/curriculum/challenges/arabic/blocks/lecture-what-is-css/672acc03c257524d6a5151e8.md +++ b/curriculum/challenges/arabic/blocks/lecture-what-is-css/672acc03c257524d6a5151e8.md @@ -7,10 +7,14 @@ dashedName: how-do-width-and-height-work # --interactive-- +## مقدمة إلى العرض والارتفاع + في CSS، تُستخدم الخاصيتان `width` و`height` للتحكم في أبعاد العناصر على صفحة الويب. يمكن تعريف هذه الخصائص بوحدات مختلفة مثل البكسل (`px`)، النسب المئوية (`%`)، وحدات إطار العرض (`vw`، `vh`)، والمزيد. +## الخاصيتان `width` و `height` + تحدد الخاصية `width` عرض العنصر. إذا لم تحدد عرضًا، فالقيمة الافتراضية تكون `auto`. هذا يسمح للمتصفح بتحديد عرض العنصر بناءً على محتواه، والوالد، ونوع العرض. بالنسبة لعنصر `div`، تجعل `width: auto` العنصر يتمدد ليملأ العرض الكامل لحاويته الوالد. تحدد الخاصية `height` ارتفاع العنصر. بالمثل، يكون الارتفاع `auto` افتراضيًا، مما يعني أنه سيتكيف مع المحتوى الموجود بداخله. @@ -40,6 +44,8 @@ dashedName: how-do-width-and-height-work البكسل هو وحدة قياس ثابتة الحجم في CSS، توفر تحكمًا دقيقًا في الأبعاد. +## الخاصيتان `min-width` و `min-height` + تحدد خاصية `min-width` الحد الأدنى لعرض العنصر. حتى لو كان المحتوى بداخله أصغر، لن ينكمش العنصر إلى أقل من هذه القيمة. تحدد الخاصية `min-height` الحد الأدنى لارتفاع العنصر. تضمن ألا يصبح العنصر أقصر من القيمة المحددة. @@ -73,6 +79,8 @@ dashedName: how-do-width-and-height-work تذكر، إذا كانت `min-width` أو `min-height` أكبر من `width` أو `height`، فإنها تتجاوز القيم الأصغر. هذا يضمن ألا تصبح العناصر صغيرة جدًا، وهو أمر مهم للحفاظ على تصميم متسق وسهل الاستخدام. +## الخاصيتان `max-width` و `max-height` + تحدد الخاصية `max-width` الحد الأقصى لعرض العنصر، حتى إذا كان هناك مساحة كافية ليكون أعرض. تحدد الخاصية `max-height` الحد الأقصى لارتفاع العنصر، بغض النظر عن حجم المحتوى. @@ -104,6 +112,8 @@ dashedName: how-do-width-and-height-work تذكر، عندما تكون `max-width` أو `max-height` أصغر من `width` أو `height`، فإنها تأخذ الأسبقية. هذا مهم للتحكم في الحد الأقصى لحجم العناصر في تخطيطاتك. +## أسبقية الخاصيات + تعطي CSS أولوية للخاصيتين `min-width` و`min-height` على `width` و`height`. بينما تحدد `max-width` و`max-height` الأبعاد إذا تجاوزت القيم الحدود المحددة. على سبيل المثال، إذا عرّفت `width` بقيمة `600px` و`max-width` بقيمة `500px`، فسيقتصر عرض العنصر على `500px`. حيث يتجاوز `max-width` القيمة الأكبر، مما يحافظ على العنصر ضمن الحد الأقصى المحدد. diff --git a/curriculum/challenges/arabic/blocks/lecture-working-with-backgrounds-and-borders/672aa669960f6a596081fcad.md b/curriculum/challenges/arabic/blocks/lecture-working-with-backgrounds-and-borders/672aa669960f6a596081fcad.md index 3562f7d4287..1f53dc34acc 100644 --- a/curriculum/challenges/arabic/blocks/lecture-working-with-backgrounds-and-borders/672aa669960f6a596081fcad.md +++ b/curriculum/challenges/arabic/blocks/lecture-working-with-backgrounds-and-borders/672aa669960f6a596081fcad.md @@ -7,6 +7,8 @@ dashedName: how-to-work-with-background-image-size-repeat-position-and-attachmen # --interactive-- +## مقدمة إلى خصائص الخلفية + عند العمل مع صور الخلفية في CSS، لديك عدة خصائص للتحكم في كيفية عرض هذه الصور. الخصائص الرئيسية التي سنركز عليها هي `background-size`، و`background-repeat`، و`background-position`، و`background-attachment`. @@ -27,6 +29,8 @@ dashedName: how-to-work-with-background-image-size-repeat-position-and-attachmen يُعيّن كود CSS أعلاه صورة خلفية لقطة لعنصر `body`. +## خاصية `background-size` + إذا أردت تحديد حجم صورة الخلفية، يمكنك استخدام خاصية `background-size`. يمكنك استخدام القيمة `contain` لتكبير الصورة إلى أكبر حجم ممكن دون قص أو تمديد. @@ -65,6 +69,8 @@ dashedName: how-to-work-with-background-image-size-repeat-position-and-attachmen ::: +## خاصية `background-repeat` + في الأمثلة السابقة، ربما لاحظت أن صورة الخلفية كانت تتكرر باستمرار. افتراضيًا، تتكرر صور الخلفية أفقيًا وعموديًا لملء العنصر بالكامل. لكن يمكنك التحكم في هذا السلوك. @@ -122,6 +128,8 @@ dashedName: how-to-work-with-background-image-size-repeat-position-and-attachmen ::: +## خاصية `background-position` + لوضع صورة خلفية على الشاشة، يمكنك استخدام خاصية `background-position`. تسمح خاصية `background-position` بتحديد مكان ظهور صورة الخلفية داخل العنصر. يمكنك استخدام كلمات مفتاحية مثل `top`، `bottom`، `left`، `right`، و`center`، أو قيم بكسل أو نسب مئوية محددة. @@ -146,6 +154,8 @@ dashedName: how-to-work-with-background-image-size-repeat-position-and-attachmen يضع كود CSS هذا صورة الخلفية في مركز العنصر أفقيًا وفي الأعلى عموديًا. +## خاصية `background-attachment` + أخيرًا، تحدد خاصية `background-attachment` ما إذا كانت صورة الخلفية تتحرك مع المحتوى عند التمرير أو تبقى ثابتة عند التمرير. القيم الرئيسية هي `scroll` (افتراضيًا)، حيث تتحرك صورة الخلفية مع المحتوى، و`fixed`، حيث تبقى صورة الخلفية في نفس الموضع على الشاشة. @@ -168,6 +178,8 @@ dashedName: how-to-work-with-background-image-size-repeat-position-and-attachmen يُعيّن كود CSS هذا صورة الخلفية لتبقى ثابتة في مكانها حتى عند تمرير الصفحة. +## الخاصية المختصرة `background` + إذا أردت دمج بعض الخصائص في سطر واحد، يمكنك فعل ذلك باستخدام خاصية الاختصار `background`. إليك مثال: diff --git a/curriculum/challenges/arabic/blocks/lecture-working-with-code-editors-and-ides/672d26269456511aa3db614d.md b/curriculum/challenges/arabic/blocks/lecture-working-with-code-editors-and-ides/672d26269456511aa3db614d.md index 9ec632a9b7c..f148fa9e28a 100644 --- a/curriculum/challenges/arabic/blocks/lecture-working-with-code-editors-and-ides/672d26269456511aa3db614d.md +++ b/curriculum/challenges/arabic/blocks/lecture-working-with-code-editors-and-ides/672d26269456511aa3db614d.md @@ -7,8 +7,12 @@ dashedName: what-is-a-code-editor-and-ide # --description-- +## ما هي محررات الكود وبيئات التطوير المتكاملة؟ + قد تظن أنهما نفس الشيء، لكن ليس تمامًا. محرر الكود هو أي تطبيق يسمح لك بتحرير ملفات الكود. أما بيئة التطوير المتكاملة (IDE) فهي تطبيق كامل يسمح لك بترجمة الكود، وتشغيله، وتصحيح الأخطاء أثناء تحريره. +## استكشاف بيئات التطوير المتكاملة الشهيرة + بعض الأمثلة ستساعد في التوضيح. أولًا، دعنا نلقي نظرة على بعض بيئات التطوير المتكاملة الشهيرة. Visual Studio هي بيئة تطوير متكاملة من مايكروسوفت توفر مجموعة شاملة من الأدوات لبناء التطبيقات وتصحيح أخطائها ونشرها عبر منصات مختلفة. @@ -17,6 +21,8 @@ dashedName: what-is-a-code-editor-and-ide Android Studio، الذي طورته Google، هو بيئة تطوير متكاملة مصممة خصيصًا لبناء، وتصحيح الأخطاء، واختبار تطبيقات Android. +## استكشاف محررات الكود الشهيرة + هذه مجرد أمثلة قليلة على بيئات التطوير المتكاملة. الآن، لنلقِ نظرة على بعض محررات الكود الشهيرة. Visual Studio Code هو محرر كود مفتوح المصدر وخفيف الوزن من مايكروسوفت يدعم مجموعة واسعة من لغات البرمجة ويوفر ميزات مثل تصحيح الأخطاء، تمييز الصيغة النحوية، والتحكم في الإصدارات عبر الإضافات. @@ -27,6 +33,8 @@ Visual Studio Code هو محرر كود مفتوح المصدر وخفيف ال قد لاحظت كيف يركز محررو الكود بشكل أساسي على محتوى النص في الملف، بينما تتيح بيئات التطوير المتكاملة أدوات مختلفة لإدارة الكود الخاص بك. +## استكشاف المحررات السحابية + كل هذه الأمثلة برامج محلية يمكنك تشغيلها على جهاز الكمبيوتر الخاص بك، لكن هناك أيضًا محررات قائمة على السحابة يمكنك استخدامها. المحرر المستند إلى السحابة هو أداة عبر الإنترنت تسمح للمستخدمين بكتابة وتحرير وإدارة الكود أو النص مباشرة من خلال متصفح الويب دون الحاجة إلى تثبيت برامج محليًا. @@ -39,6 +47,8 @@ Replit هو منصة عبر الإنترنت توفر بيئة تعاونية ل StackBlitz هو محرر آخر قائم على السحابة. يعمل مباشرة في المتصفح ويتيح لك بناء واختبار ومشاركة مشاريع الويب دون الحاجة إلى إعداد محلي. +## اختيار المحرر المناسب + وهناك العديد من الخيارات الأخرى. بعض الخيارات، مثل Visual Studio Code، قابلة للتوسيع بشكل كبير ويمكنها العمل مع العديد من أنواع المشاريع واللغات. خيارات أخرى قد تكون مخصصة لمجموعة جزئية صغيرة من اللغات أو أنواع المشاريع. التطبيق الذي تستخدمه قد يختلف حسب المشروع المحدد. يجب أن تستكشف الخيارات لترى ما يناسب احتياجاتك أفضل. diff --git a/curriculum/challenges/arabic/blocks/lecture-working-with-code-editors-and-ides/672d456f4ac35950b300e93f.md b/curriculum/challenges/arabic/blocks/lecture-working-with-code-editors-and-ides/672d456f4ac35950b300e93f.md index a3de3305e2e..af74ebb0c95 100644 --- a/curriculum/challenges/arabic/blocks/lecture-working-with-code-editors-and-ides/672d456f4ac35950b300e93f.md +++ b/curriculum/challenges/arabic/blocks/lecture-working-with-code-editors-and-ides/672d456f4ac35950b300e93f.md @@ -7,8 +7,12 @@ dashedName: what-are-several-useful-keyboard-shortcuts-for-maximizing-productivi # --description-- +## اختصارات موروثة من نظام التشغيل + من المحتمل أنك تعرف بالفعل بعض الاختصارات الأساسية، التي ترثها من نظام التشغيل الخاص بك. اختصارات مثل Ctrl + S (ويندوز/لينكس) أو Cmd + S (ماك) للحفظ، وCtrl + C أو Cmd + C للنسخ، وCtrl + V أو Cmd + V للصق تعمل كلها في VS Code. +## اختصارات خاصة بالتطبيق + لكن هناك بعض الاختصارات الخاصة بالتطبيق والتي يمكنها رفع إنتاجيتك. يجدر بالذكر أن بعض هذه الاختصارات قد تختلف حسب نظام التشغيل. على سبيل المثال، Shift + Alt + F يشغّل أداة التنسيق المهيأة لديك (مثل Prettier لمشروع جافاسكريبت) على الملف المفتوح حاليًا. @@ -21,8 +25,12 @@ dashedName: what-are-several-useful-keyboard-shortcuts-for-maximizing-productivi أو ربما لا ترى كودك؟ Ctrl + Plus (ويندوز/لينكس)، أو Cmd + Plus (ماك)، يزيد تكبير المحرر، وCtrl + Minus (ويندوز/لينكس)، أو Cmd + Minus (ماك)، يقلل التكبير. +## اختصار التحرير متعدد الأسطر + ميزة مفيدة أخرى في VS Code هي التحرير متعدد الأسطر، الذي يسمح بإجراء تغييرات عبر عدة أسطر دفعة واحدة. على سبيل المثال، يمكنك وضع عدة مؤشرات باستخدام Ctrl + Alt + Down وCtrl + Alt + Up (ويندوز)، Shift + Alt + Down وShift + Alt + Up (لينكس)، أو Option + Cmd + Down وOption + Cmd + Up (ماك)، لتمديد المؤشر إلى أسطر متتالية. يمكنك أيضًا الضغط مع الاستمرار على Alt (ويندوز/لينكس) أو Option (ماك) والنقر لإضافة مؤشرات على أسطر منفصلة حيثما تحتاجها. بمجرد وضع المؤشرات، أي شيء تكتبه أو تحذفه سيطبق على كل تلك المواقع في نفس الوقت، مما يوفر الكثير من الوقت عند العمل مع كود متكرر. +## لوحة الأوامر ومرجع اختصارات لوحة المفاتيح + أخيرًا، إذا نسيت أيًا من هذه الاختصارات، لديك دائمًا Ctrl + Shift + P (ويندوز/لينكس) أو Cmd + Shift + P (ماك)، التي تفتح لوحة الأوامر لتختار ما تحتاجه.
+
إذا أردت رؤية المستندات فقط، يمكنك النقر على تبويب "المستندات". لديك أيضًا تبويبات للتطبيقات ونتائج الويب.
بديل آخر هو استخدام البحث في مستكشف الملفات. ستجده في أعلى يمين نافذة المستكشف، حيث ترى "بحث في المستندات".
+
+
لديك ثلاث خيارات لتحديد نطاق البحث:
- يمكنك البحث من Home للعثور على الملفات من جهاز الكمبيوتر ومن السحابة بسرعة.
@@ -27,15 +31,37 @@ dashedName: how-to-search-for-files-and-folders-on-your-computer
هذه هي طريقة البحث عن الملفات والمجلدات على Windows. الآن لنرَ كيف تفعل ذلك على macOS.
-أولًا، يمكنك استخدام Spotlight، أداة تساعدك في العثور على الملفات على جهاز Mac. لفتح Spotlight، اذهب إلى شريط القوائم في الأعلى يمينًا وابحث عن أيقونة العدسة المكبرة. إذا لم ترَ هذه الأيقونة في شريط القوائم، يمكنك إضافتها في إعدادات Control Center.
+أولًا، يمكنك استخدام Spotlight، أداة تساعدك في العثور على الملفات على جهاز Mac الخاص بك. لفتح Spotlight، اذهب إلى شريط القوائم في الأعلى على اليمين وابحث عن أيقونة العدسة المكبرة.
+
+
+
+إذا لم ترَ هذه الأيقونة في شريط القوائم، يمكنك إضافتها من إعدادات مركز التحكم.
+
+اذهب إلى الإعدادات، صنّف حسب "مركز التحكم"، انقر على هذا الخيار ثم مرر للأسفل حتى تجد خيار "Spotlight".
+
+
+
+يمكنك أيضًا استخدام اختصار لوحة المفاتيح لفتح Spotlight: Command + Spacebar.
-اذهب إلى الإعدادات، صفِّ حسب "مركز التحكم"، انقر على هذا الخيار ثم مرر للأسفل حتى تجد خيار "Spotlight". يمكنك أيضًا استخدام اختصار لوحة المفاتيح لفتح Spotlight: Command + Spacebar.
+عند فتح Spotlight، سترى بحث Spotlight، حيث يمكنك البحث عن أي ملف أو مجلد بكتابة اسمه.
-عند فتح Spotlight، سترى بحث Spotlight حيث يمكنك البحث عن أي ملف أو مجلد بكتابة اسمه. عند البدء بالكتابة، سترى النتائج مجمعة حسب الفئة، بما في ذلك الاقتراحات، المجلدات، العروض التقديمية، الصور، المستندات، والبحثات ذات الصلة.
+
+
+عندما تبدأ بالكتابة، سترى النتائج مجمعة حسب الفئة، بما في ذلك الاقتراحات، المجلدات، العروض التقديمية، الصور، المستندات، والبحثات ذات الصلة.
يمكنك أيضًا توسيع فئة معينة بالنقر على "عرض المزيد".
-طريقة أخرى للبحث عن الملفات التي فتحتها مؤخرًا هي فتح Finder بالنقر على أيقونة Finder في Dock. ثم اذهب إلى "Recents" في شريط جانبي Finder. هناك ستجد كل الملفات التي شاهدتها مؤخرًا.
+
+
+طريقة أخرى للبحث عن الملفات التي فتحتها مؤخرًا هي فتح Finder بالنقر على أيقونة Finder في Dock.
+
+
+
+ثم، اذهب إلى "المحفوظات" في شريط Finder الجانبي.
+
+
+
+وهناك، ستجد كل الملفات التي شاهدتها مؤخرًا.
هذه هي طريقة البحث عن الملفات والمجلدات على macOS. باستخدام هذه الأدوات، يمكنك تحسين سير عملك والعثور على الملفات والمجلدات التي تحتاجها بسرعة كبيرة.
diff --git a/curriculum/challenges/arabic/blocks/lecture-working-with-file-systems/672ac403a9ba7732b31c6480.md b/curriculum/challenges/arabic/blocks/lecture-working-with-file-systems/672ac403a9ba7732b31c6480.md
index c74283248d2..106bf9bdcbc 100644
--- a/curriculum/challenges/arabic/blocks/lecture-working-with-file-systems/672ac403a9ba7732b31c6480.md
+++ b/curriculum/challenges/arabic/blocks/lecture-working-with-file-systems/672ac403a9ba7732b31c6480.md
@@ -63,6 +63,8 @@ WOFF هو تنسيق خط حديث، صُمم خصيصًا لأغراض تطوي
عادةً ما تُكتب هذه الملفات بتنسيق يسمى Markdown. باستخدام Markdown، يمكنك إنشاء مستندات منظمة تحتوي على عناوين، وعناوين فرعية، وروابط، وصور، وقوائم، وأكثر. لملفات Markdown امتداد `.md` أو `.markdown`.
+
+
هنا يمكنك العثور على ملف `README` لمستودع freeCodeCamp على GitHub: `https://github.com/freeCodeCamp/freeCodeCamp/blob/main/README.md`
يمكنك إنشاء هذا الهيكل التفصيلي والتنسيق باستخدام Markdown.
diff --git a/curriculum/challenges/arabic/blocks/lecture-working-with-forms/672a4cd3d59756726657efb8.md b/curriculum/challenges/arabic/blocks/lecture-working-with-forms/672a4cd3d59756726657efb8.md
index 33e847368ce..7c6813bc6b6 100644
--- a/curriculum/challenges/arabic/blocks/lecture-working-with-forms/672a4cd3d59756726657efb8.md
+++ b/curriculum/challenges/arabic/blocks/lecture-working-with-forms/672a4cd3d59756726657efb8.md
@@ -13,6 +13,8 @@ dashedName: what-are-the-different-types-of-buttons
```
+## نوع `button`
+
تشمل أمثلة أخرى لاستخدام عنصر `button` إرسال نموذج، عرض نافذة منبثقة، أو تبديل قائمة جانبية مفتوحة ومغلقة. يحتوي عنصر `button` على خاصية `type` التي تتحكم في سلوك الزر عند تفعيله. القيمة الأولى الممكنة لخاصية `type` هي النوع `button`. إليك مثالًا على استخدام عنصر `button` مع النوع `button` ونص `Show Alert`:
```html
@@ -40,6 +42,8 @@ btn.addEventListener("click", () => alert("You clicked on the alert button"));
:::
+## نوعا `submit` و `reset`
+
قيمة أخرى ممكنة لخاصية `type` هي القيمة `submit`. إليك مثالًا على استخدام عنصر `button` مع النوع `submit`.
:::interactive_editor
@@ -73,6 +77,8 @@ btn.addEventListener("click", () => alert("You clicked on the alert button"));
في هذا المثال المعدل، يُستخدم عنصر `label` وعنصر `input` لجمع عنوان البريد الإلكتروني للمستخدم. عند نقر المستخدم على زر إعادة التعيين، يمسح كل بيانات المُدخَل الخاصة به. من المهم ملاحظة أن أزرار إعادة التعيين عادةً ليست فكرة جيدة لأنها قد تؤدي إلى إعادة تعيين البيانات عن طريق الخطأ. أيضًا، وجود عدة أزرار في النموذج قد يزدحم واجهة المستخدم.
+## استخدام عنصر `input` كزر
+
طريقة أخرى لإنشاء أزرار في HTML هي استخدام عنصر `input`. يحتوي عنصر `input` أيضًا على خاصية `type` بالقيم الممكنة `submit` و`reset` و`button`. إليك مثالًا على استخدام عنصر `input` مع تعيين `type` إلى `button`:
:::interactive_editor
@@ -97,6 +103,8 @@ document.addEventListener("DOMContentLoaded", () => {
:::
+## الفرق الرئيسي بين `input` و `button`
+
تُستخدم خاصية `value` لعرض نص الزر. فما الفرق بين استخدام عنصري `input` و`button`؟ عناصر `input` هي عناصر فارغة، مما يعني أنها لا يمكن أن تحتوي على عقد فرعية مثل النص، ويمكن أن يكون لها وسم بداية فقط. من ناحية أخرى، يوفر عنصر `button` مرونة أكبر لأنه يمكنك تسكين نصوص وصور وأيقونات بداخله.
# --questions--
diff --git a/curriculum/challenges/arabic/blocks/lecture-working-with-forms/672a4ce6dab9eb735828b48b.md b/curriculum/challenges/arabic/blocks/lecture-working-with-forms/672a4ce6dab9eb735828b48b.md
index 0cdeb7bd1d1..a20d6a632ed 100644
--- a/curriculum/challenges/arabic/blocks/lecture-working-with-forms/672a4ce6dab9eb735828b48b.md
+++ b/curriculum/challenges/arabic/blocks/lecture-working-with-forms/672a4ce6dab9eb735828b48b.md
@@ -9,12 +9,16 @@ dashedName: what-is-client-side-form-validation-in-html-forms
عندما يملأ المستخدم نموذجًا على موقعك، من المهم أن يملأ كل المعلومات اللازمة بالتنسيق الصحيح. تحتوي عناصر التحكم في نماذج HTML، مثل المدخلات، على الكثير من التحقق المدمج الذي يمكنك استخدامه لفحص البيانات غير الصالحة. هذا يساعد على ضمان تصحيح المستخدم لهذه الأخطاء قبل إرسال المعلومات ومعالجتها من قبل الخادم.
+## التحقق على جانب العميل وجانب الخادم
+
مصطلح "جانب العميل" يشير إلى كل ما يحدث على جهاز أو كمبيوتر المستخدم، مثل الجزء من الموقع أو التطبيق الذي تتفاعل معه مباشرة. يشمل ذلك التخطيط، التصميم، وأي ميزات تفاعلية.
مصطلح "جانب الخادم" يشير إلى كل ما يحدث على الخادم، الكمبيوتر، أو النظام الذي يستضيف الموقع أو التطبيق. يشمل ذلك معالجة البيانات، تشغيل التطبيقات، والتعامل مع الطلبات القادمة من جهاز المستخدم.
بينما التحقق على جانب العميل مهم، تحتاج أيضًا إلى التحقق على جانب الخادم لأمان إضافي. يمكن للمستخدمين الخبيثين تجاوز فحوصات جانب العميل، لذا فإن وجود إجراءات قوية على جانب الخادم ضروري. ستتعلم المزيد عن ذلك في وحدة لاحقة. الآن، دعنا نلقي نظرة على بعض أمثلة التحقق من صحة النموذج على جانب العميل.
+## الخاصية `required`
+
أحد الأمثلة الشائعة على التحقق المدمج في النماذج هو استخدام الخاصية `required` في المدخلات. تحدد الخاصية `required` أن المستخدم يحتاج إلى ملء هذا الجزء من النموذج قبل إرساله. إليك مثالًا على استخدام الخاصية `required` في مدخل البريد الإلكتروني.
انقر على زر `Submit Form` دون إدخال عنوان بريد إلكتروني وسترى رسالة منبثقة تطلب منك ملء الحقل.
@@ -33,6 +37,8 @@ dashedName: what-is-client-side-form-validation-in-html-forms
كل متصفح له مجموعة أنماط خاصة به لعرض رسالة التنبيه هذه.
+## التحقق المدمج للبريد الإلكتروني
+
ميزة أخرى لاستخدام مدخل البريد الإلكتروني هي أن مدخلات البريد الإلكتروني تحتوي على تحقق أساسي لضمان تنسيق عناوين البريد الإلكتروني بشكل صحيح. على سبيل المثال، إذا كتبت كلمات عشوائية ونقرت على الإرسال، سيعرض المتصفح تنبيهًا يفيد بفقدان علامة `@`.
اكتب `abc` في حقل البريد الإلكتروني وانقر على زر الإرسال. يجب أن ترى رسالة منبثقة لأنها ليست عنوان بريد إلكتروني صالحًا.
@@ -51,6 +57,8 @@ dashedName: what-is-client-side-form-validation-in-html-forms
من المهم ملاحظة أن المتصفحات تتحقق فقط من صحة أساسية لعناوين البريد الإلكتروني القياسية. يعود إليك إضافة طبقات إضافية من التحقق، والتي ستتعلمها في وحدات لاحقة.
+## الخاصيتان `minlength` و `maxlength`
+
أشكال أخرى من التحقق لمدخلات البريد الإلكتروني هي استخدام الخاصيتين `minlength` و `maxlength`. إليك مثالًا يستخدم التحقق الإضافي.
اكتب `b@m` في الحقل وانقر على زر الإرسال. سترى رسالة منبثقة لأنها لا تفي بالحد الأدنى للطول المطلوب.
diff --git a/curriculum/challenges/arabic/blocks/lecture-working-with-generics-and-type-narrowing/67d301a5f536d1a9e5df1a8c.md b/curriculum/challenges/arabic/blocks/lecture-working-with-generics-and-type-narrowing/67d301a5f536d1a9e5df1a8c.md
index e7fc3b89548..df85ae95dba 100644
--- a/curriculum/challenges/arabic/blocks/lecture-working-with-generics-and-type-narrowing/67d301a5f536d1a9e5df1a8c.md
+++ b/curriculum/challenges/arabic/blocks/lecture-working-with-generics-and-type-narrowing/67d301a5f536d1a9e5df1a8c.md
@@ -9,6 +9,8 @@ dashedName: what-is-type-narrowing-and-how-does-it-work
ستواجه أحيانًا قيمة بنوع عام وتحتاج إلى تضييقها إلى نوع أكثر تحديدًا. على سبيل المثال، قد تحتاج إلى التأكد من أن كائنًا يطابق واجهة قمت بتعريفها. أو أن سلسلة نصية موجودة ضمن قائمة محددة من القيم. هناك عدة طرق لتحقيق ذلك.
+## التضييق باستخدام القيمة الحقيقية
+
الأولى هي التضييق بناءً على القيمة الصحيحة. انظر إلى مثالنا من الدرس السابق:
```js
@@ -39,6 +41,8 @@ console.log(email.value);
بهذه الطريقة، نرجع خطأ إذا كانت `email` قيمة خاطئة. `null` هي قيمة خاطئة. رمي الخطأ ينهي التنفيذ المنطقي لهذا الكود، مما يعني أنه عند الوصول إلى استدعاء `console.log()` يعرف TypeScript أن `email` لا يمكن أن تكون `null`.
+## التسلسل الاختياري
+
التسلسل الاختياري هو أيضًا شكل من أشكال تضييق النوع، على نفس المبدأ بأن الوصول إلى الخاصية لا يمكن أن يحدث إذا كانت قيمة `email` هي `null`.
```js
@@ -46,6 +50,8 @@ const email = document.querySelector
+
التبويب الثاني يسمى `Console`. يعرض هذا التبويب أي أخطاء قد تحدث في الصفحة.
في حالة وجود رابط مكسور، يمكنك التحقق من وحدة التحكم لرؤية رسائل الخطأ الخاصة بالرابط المكسور. الرسالة الشائعة التي تظهر هي خطأ 404، الذي يشير إلى أن الصفحة غير موجودة.
+
+
هذا يخبرنا أن المشكلة في عنوان URL داخل عنصر وسم الرابط. عند فحص قيمة `href` سترى وجود خطأ مطبعي.
الرسالة في وحدة التحكم تظهر الآن `/larn` مع خطأ 404، لكن العنوان الصحيح يجب أن يكون `/learn`. عند تصحيح الرابط، سيعمل كما هو متوقع.
diff --git a/curriculum/challenges/arabic/blocks/lecture-working-with-json/6732b79c6aa77826855a3f11.md b/curriculum/challenges/arabic/blocks/lecture-working-with-json/6732b79c6aa77826855a3f11.md
index fb0c7467f73..f47dd30ae6b 100644
--- a/curriculum/challenges/arabic/blocks/lecture-working-with-json/6732b79c6aa77826855a3f11.md
+++ b/curriculum/challenges/arabic/blocks/lecture-working-with-json/6732b79c6aa77826855a3f11.md
@@ -1,6 +1,6 @@
---
id: 6732b79c6aa77826855a3f11
-title: كيف تعمل دالتا JSON.parse() و JSON.stringify()؟
+title: كيف تعمل دالتا JSON.parse() و JSON.stringify()؟
challengeType: 19
dashedName: how-do-json-parse-and-json-stringify-work
---
diff --git a/curriculum/challenges/arabic/blocks/lecture-working-with-loops-and-sequences/6839e38cdf93ee5a00c79676.md b/curriculum/challenges/arabic/blocks/lecture-working-with-loops-and-sequences/6839e38cdf93ee5a00c79676.md
index ad2c1606fa2..0b7221ab6ed 100644
--- a/curriculum/challenges/arabic/blocks/lecture-working-with-loops-and-sequences/6839e38cdf93ee5a00c79676.md
+++ b/curriculum/challenges/arabic/blocks/lecture-working-with-loops-and-sequences/6839e38cdf93ee5a00c79676.md
@@ -9,6 +9,8 @@ dashedName: what-are-some-common-methods-used-for-lists
في الدرس السابق، تعرّفت على نوع بيانات القائمة وتعلمت كيفية الوصول إلى عناصر القائمة وكذلك تقطيع القائمة. في هذا الدرس، ستستمر في التعرف على القوائم وبعض الطرق الشائعة المرتبطة بها مثل `append()` و`pop()` و`sort()`.
+## إضافة عناصر باستخدام `append()`
+
أول طريقة سننظر إليها هي الطريقة `append()`. تُستخدم هذه الطريقة لإضافة عنصر إلى نهاية القائمة. إليك مثالًا على استخدام الطريقة `append()` لإضافة الرقم `6` إلى قائمة الأرقام:
```py
@@ -29,6 +31,8 @@ print(numbers) # [1, 2, 3, 4, 5, [6, 8, 10]]
لاحظ كيف أن قائمة `even_numbers` بأكملها مسكنة داخل قائمة `numbers`.
+## إضافة عناصر متعددة باستخدام `extend()`
+
لكن إذا أردت إضافة كل الأرقام الفردية من قائمة `even_numbers` إلى نهاية قائمة `numbers`، فيمكنك استخدام الطريقة `extend()`.
الطريقة `extend()` مشابهة للطريقة `append()`، لكن مع `extend()` يمكنك إضافة عدة عناصر من قائمة إلى أخرى. إليك مثالًا على إضافة الأرقام `6` و`8` و`10` من قائمة إلى نهاية قائمة `numbers`:
@@ -43,6 +47,8 @@ print(numbers) # [1, 2, 3, 4, 5, 6, 8, 10]
كما ترى، القائمة المسكنة اختفت وأصبحت مجرد قائمة أرقام.
+## إدخال عناصر عند فهرس محدد
+
لإدخال عنصر في فهرس محدد داخل القائمة، يمكنك استخدام الطريقة `insert()`. تقبل هذه الطريقة معلمتين: الفهرس الذي تريد إدخال العنصر الجديد فيه والعنصر الذي تريد إدخاله.
إليك مثالًا على استخدام الطريقة `insert()`:
@@ -56,6 +62,8 @@ print(numbers) # [1, 2, 2.5, 3, 4, 5]
الكود التالي سيدخل الرقم `2.5` في الفهرس `2` داخل قائمة `numbers`.
+## إزالة عناصر من قائمة
+
إذا أردت إزالة عنصر من قائمة، يمكنك استخدام الطريقة `remove()`. تأخذ الطريقة `remove()` قيمة العنصر الذي تريد إزالته كمعلمة:
```py
@@ -88,6 +96,8 @@ numbers = [1, 2, 3, 4, 5]
numbers.pop() # The number 5 is returned
```
+## مسح قائمة
+
إذا كنت بحاجة إلى تفريغ القائمة، يمكنك استخدام الطريقة `clear()` بهذه الطريقة:
```py
@@ -97,6 +107,8 @@ numbers.clear()
print(numbers) # []
```
+## ترتيب قائمة
+
الطريقة التالية التي سننظر إليها هي الطريقة `sort()`. تُستخدم هذه الطريقة لترتيب العناصر في مكانها. إليك مثالًا على ترتيب قائمة أرقام عشوائية في مكانها:
```py
@@ -120,6 +132,8 @@ print(sorted_numbers) # [1, 2, 19, 35, 41, 67]
كل من الطريقة `sort()` والدالة `sorted()` تقبلان معلمتين اختياريتين هما `key` و`reverse`. ستتعلم المزيد عن هذه المعلمات الاختيارية في درس مستقبلي عندما تتعلم عن الصفوف المرتبة. ستتعلم أيضًا المزيد عن الدوال المدمجة الأخرى مثل `sorted()` في دروس قادمة.
+## عكس قائمة
+
الطريقة التالية التي سننظر إليها هي الطريقة `reverse()`. هذه الطريقة تعكس قائمة العناصر في مكانها بهذه الطريقة:
```py
@@ -129,6 +143,8 @@ numbers.reverse()
print(numbers) # [1, 2, 3, 4, 5, 6]
```
+## إيجاد فهرس عنصر
+
آخر طريقة سننظر إليها هي الطريقة `index`. تُستخدم هذه الطريقة لإيجاد أول فهرس يمكن العثور فيه على عنصر داخل القائمة. إليك مثالًا على استخدام الطريقة `index` لإيجاد اللغة `'Java'` في قائمة `programming_languages`:
```py
diff --git a/curriculum/challenges/arabic/blocks/lecture-working-with-loops-and-sequences/6839e3a99ba37f09b9d0059b.md b/curriculum/challenges/arabic/blocks/lecture-working-with-loops-and-sequences/6839e3a99ba37f09b9d0059b.md
index c1f4be23fe0..8b575872596 100644
--- a/curriculum/challenges/arabic/blocks/lecture-working-with-loops-and-sequences/6839e3a99ba37f09b9d0059b.md
+++ b/curriculum/challenges/arabic/blocks/lecture-working-with-loops-and-sequences/6839e3a99ba37f09b9d0059b.md
@@ -7,6 +7,8 @@ dashedName: what-are-tuples-and-how-do-they-work
# --description--
+## ما هو الصف المرتب؟
+
الصف المرتب هو نوع بيانات في Python يُستخدم لإنشاء متتالية مرتبة من القيم. يمكن أن تحتوي الصفوف المرتبة على مجموعة مختلطة من أنواع البيانات مثل هذا:
```py
@@ -28,6 +30,8 @@ TypeError: 'tuple' object does not support item assignment
"""
```
+## الوصول إلى عناصر الصف المرتب
+
للوصول إلى عنصر من صف مرتب، يمكنك استخدام ترميز الأقواس ورقم الفهرس:
```py
@@ -55,6 +59,8 @@ IndexError: list index out of range
"""
```
+## استخدام دالة البناء `tuple()`
+
طريقة أخرى لإنشاء صف مرتب هي باستخدام دالة البناء `tuple()` مثل هذا:
```py
@@ -64,6 +70,8 @@ tuple(developer) # ('J', 'e', 's', 's', 'i', 'c', 'a')
يمكنك تمرير متكررات مختلفة مثل السلاسل النصية والقوائم وحتى صفوف مرتبة أخرى إلى دالة البناء `tuple()`.
+## التحقق مما إذا كان عنصر موجودًا في الصف المرتب
+
للتحقق مما إذا كان عنصر موجودًا في صف مرتب، يمكنك استخدام الكلمة المفتاحية `in` مثل هذا:
```py
@@ -73,6 +81,8 @@ programming_languages = ('Python', 'Java', 'C++', 'Rust')
'JavaScript' in programming_languages # False
```
+## فك القيم من الصف المرتب
+
يمكنك أيضًا فك تجميع العناصر من صف مرتب تمامًا كما فعلت مع القوائم:
```py
@@ -98,6 +108,8 @@ print(rest) # [34, 'Rust Developer']
هنا، القيمة في `name` هي `'Alice'`، و`rest` هي قائمة تتألف من الرقم `34` والسلسلة النصية `'Rust Developer'`.
+## تقطيع الصفوف المرتبة
+
تمامًا كما في القائمة، يمكنك استخدام عامل القطع على صف مرتب لاستخراج جزء منه. إليك مثالًا لاستخراج العناصر `'pie'` و`'cookies'` إلى صف مرتب منفصل:
```py
@@ -107,6 +119,8 @@ desserts[1:3] # ('pie', 'cookies')
تذكر أن الرقم الأول يمثل فهرس البداية للاستخراج بينما الرقم الثاني يمثل فهرس النهاية. لكن لاحظ أن العنصر عند فهرس النهاية غير مشمول في الصف المرتب المستخرج.
+## إزالة عناصر من الصف المرتب
+
إذا كنت بحاجة إلى حذف عنصر من صف مرتب، فهذا غير ممكن لأن الصفوف المرتبة غير قابلة للتغيير. لذا هذا المثال سينتج عنه خطأ:
```py
@@ -120,6 +134,8 @@ TypeError: "tuple" object doesn't support item deletion
"""
```
+## الاختيار بين الصفوف المرتبة والقوائم
+
متى قد تستخدم صف مرتب بدلًا من قائمة؟
إذا كنت بحاجة إلى مجموعة ديناميكية من العناصر حيث يمكنك الإضافة والحذف والتحديث، فعليك استخدام قائمة. إذا كنت تعلم أنك تتعامل مع مجموعة ثابتة وغير قابلة للتغيير من البيانات، فعليك استخدام صف مرتب.
@@ -171,7 +187,7 @@ print(developer[1]) # ?
## --text--
-ما النتيجة لهذا الكود التالي؟
+ما النتيجة للكود التالي؟
```py
desserts = ('cake', 'pie', 'cookies', 'ice cream')
@@ -212,7 +228,7 @@ desserts[1:3]
## --text--
-ما النتيجة لهذا الكود التالي؟
+ما النتيجة للكود التالي؟
```py
developer = ("Jane Doe", 23, "Python Developer")
diff --git a/curriculum/challenges/arabic/blocks/lecture-working-with-loops-and-sequences/6839e4b003571c149bcda122.md b/curriculum/challenges/arabic/blocks/lecture-working-with-loops-and-sequences/6839e4b003571c149bcda122.md
index 7fc2f1f45b6..b71a05c7615 100644
--- a/curriculum/challenges/arabic/blocks/lecture-working-with-loops-and-sequences/6839e4b003571c149bcda122.md
+++ b/curriculum/challenges/arabic/blocks/lecture-working-with-loops-and-sequences/6839e4b003571c149bcda122.md
@@ -7,6 +7,8 @@ dashedName: what-are-the-enumerate-and-zip-functions-and-how-do-they-work
# --description--
+## تتبع فهرس حلقة `for`
+
في الدروس السابقة تعلمت كيفية العمل مع حلقة `for`، التي تُستخدم لتكرار كتلة من الكود عددًا محددًا من المرات. إليك مثالًا على استخدام حلقة `for` لطباعة كل لغة من قائمة `languages` في وحدة التحكم:
```py
@@ -28,6 +30,8 @@ for language in languages:
index += 1
```
+## استخدام الدالة `enumerate()`
+
بينما هذه الطريقة تعمل، هناك طريقة أسهل باستخدام دالة `enumerate()`. دالة `enumerate()` تتعقب الفهرس لقابل للتكرار وتُرجع كائن enumerate.
إذا مررنا قائمة `languages` إلى دالة `enumerate()` وحولنا القيمة المرجعة إلى قائمة باستخدام دالة `list()`، فستبدو هكذا:
@@ -79,6 +83,8 @@ Index 3 and language Russian
Index 4 and language Chinese
```
+## استخدام الدالة `zip()`
+
حتى الآن كنا نكرر فقط على قائمة واحدة. لكن ماذا لو احتجت إلى التكرار على عدة قابلات للتكرار بالتوازي؟ يمكنك استخدام دالة `zip()` لذلك، التي تجمع القوائم في أزواج من العناصر وتُرجع مكررًا من صفوف مرتبة.
إذا مررنا قائمة من `developers` و `ids` إلى دالة `zip()` وحولنا القيمة المرجعة إلى قائمة باستخدام دالة `list()`، فستبدو هكذا:
diff --git a/curriculum/challenges/arabic/blocks/lecture-working-with-loops-and-sequences/6839e4d62ae09d1661e4cf9b.md b/curriculum/challenges/arabic/blocks/lecture-working-with-loops-and-sequences/6839e4d62ae09d1661e4cf9b.md
index de587759dd0..518d3fba098 100644
--- a/curriculum/challenges/arabic/blocks/lecture-working-with-loops-and-sequences/6839e4d62ae09d1661e4cf9b.md
+++ b/curriculum/challenges/arabic/blocks/lecture-working-with-loops-and-sequences/6839e4d62ae09d1661e4cf9b.md
@@ -21,6 +21,8 @@ print(even_numbers)
ينشئ هذا المثال قائمة جديدة فارغة تُسمى `even_numbers` ويدور عبر متتالية أرقام بين `0` و `20`. داخل الحلقة، هناك شرط يتحقق مما إذا كان العدد الحالي له باقي `0` عند قسمته على `2`. يُستخدم هذا لتحديد ما إذا كان العدد زوجيًا. إذا كان الشرط `True`، تُضاف القيمة الحالية `num` إلى نهاية قائمة `even_numbers`. أخيرًا، نطبع قائمة `even_numbers` في وحدة التحكم.
+## ما هو التعميم القائم على القوائم؟
+
بينما يعمل هذا الكود، هناك طريقة أكثر اختصارًا لكتابته باستخدام التوليد القائم على القوائم. يسمح لك التوليد القائم على القوائم بإنشاء قائمة جديدة في سطر واحد عبر دمج حلقة وشرط مباشرة داخل الأقواس المربعة. هذا يجعل الكود أقصر وغالبًا أسهل في القراءة.
إليك المثال المعاد صياغته من قبل باستخدام الأقواس المربعة:
@@ -32,6 +34,8 @@ print(even_numbers)
في هذا المثال المعاد صياغته، تُنشأ قائمة `even_numbers` باستخدام سطر واحد من الكود. يقوم التوليد القائم على القوائم بالتكرار عبر الأرقام من `0` إلى `20`، ويشمل فقط الأرقام القابلة للقسمة على `2`. هذا الأسلوب أكثر اختصارًا ويُلغي الحاجة إلى حلقة وكتلة شرطية منفصلة.
+## استخدام التعبيرات الشرطية في التعميم القائم على القوائم
+
لنلقِ نظرة على مثال آخر لنفهم بشكل أفضل كيف تعمل تراكيب القوائم:
```py
@@ -48,6 +52,8 @@ print(result)
[(1, 'Odd'), (2, 'Even'), (3, 'Odd'), (4, 'Even'), (5, 'Odd')]
```
+## تصفية القوائم باستخدام `filter()`
+
طريقة أخرى لإنشاء قائمة بدءًا من قابل للتكرار موجود هي الدالة `filter()`. إليك مثالًا لإنشاء قائمة جديدة تحتوي فقط على الكلمات التي يزيد طولها عن أربعة أحرف:
```py
@@ -62,6 +68,8 @@ print(long_words) # ['mountain', 'river', 'cloud']
تُستخدم الدالة `filter()` لاختيار عناصر من قابل للتكرار تحقق شرطًا معينًا. تقبل الدالة `filter()` دالة وقابل للتكرار كمعاملات. في هذا المثال، نمرر دالة `is_long_word` إلى `filter()` للتحقق مما إذا كان عدد أحرف الكلمة الحالية أكبر من `4`. تُضاف كل الكلمات التي يزيد عدد أحرفها عن `4` إلى قائمة جديدة وتُعيَّن إلى المتغير `long_words`.
+## تحويل القوائم باستخدام `map()`
+
بعيدًا عن الدالة `filter()`، هناك بعض الدوال الأخرى المفيدة عند العمل مع القوائم. دالة أخرى يجب معرفتها هي `map()`، التي تأخذ قابل للتكرار وتطبق دالة على كل عنصر منه. إليك مثالًا لاستخدام دالة `map()` لتحويل قائمة درجات الحرارة من سلسيوس إلى فهرنهايت:
```py
@@ -76,6 +84,8 @@ print(fahrenheit) # [32.0, 50.0, 68.0, 86.0, 104.0]
تمامًا مثل الدالة `filter()`، تقبل `map()` دالة وقابل للتكرار كمعاملات. تأخذ الدالة `to_fahrenheit` درجة حرارة وتحولها من سلسيوس إلى فهرنهايت.
+## جمع القيم باستخدام `sum()`
+
الدالة الأخيرة التي سننظر إليها هي `sum()`. تُستخدم هذه الدالة للحصول على مجموع عناصر قابل للتكرار مثل قائمة أو صف مرتب. إليك مثالًا لاستخدام دالة `sum()`:
```py
diff --git a/curriculum/challenges/arabic/blocks/lecture-working-with-loops-and-sequences/683d6a3fe8c1060ffb1f9b78.md b/curriculum/challenges/arabic/blocks/lecture-working-with-loops-and-sequences/683d6a3fe8c1060ffb1f9b78.md
index 968cff434ed..1f8433a62ec 100644
--- a/curriculum/challenges/arabic/blocks/lecture-working-with-loops-and-sequences/683d6a3fe8c1060ffb1f9b78.md
+++ b/curriculum/challenges/arabic/blocks/lecture-working-with-loops-and-sequences/683d6a3fe8c1060ffb1f9b78.md
@@ -9,6 +9,8 @@ dashedName: what-are-some-common-methods-for-tuples
في الدرس السابق، تعلمت كيفية العمل مع نوع البيانات الصف المرتب. في هذا الدرس، ستتعلم بعض الطرق الشائعة التي ستستخدمها عند العمل مع الصفوف المرتبة.
+## طريقة `count()`
+
الطريقة الأولى التي سنغطيها هي `count()`. تُستخدم هذه الطريقة لتحديد عدد المرات التي يظهر فيها عنصر في صف مرتب. إليك مثالًا على التحقق من عدد المرات التي تظهر فيها السلسلة النصية `Rust` في صف مرتب اسمه `programming_languages`:
```py
@@ -36,6 +38,8 @@ TypeError: tuple.count() takes exactly one argument (0 given)
"""
```
+## طريقة `index()`
+
الطريقة التالية التي سننظر إليها هي طريقة `index()`. تُستخدم هذه الطريقة لإيجاد الفهرس الذي يوجد فيه عنصر معين في صف مرتب. إليك مثالًا على استخدام طريقة `index()` لإيجاد الفهرس للسلسلة النصية `Java`:
```py
@@ -74,6 +78,8 @@ programming_languages.index('Python', 2, 5) # 2
النتيجة الآن هي الفهرس `2` لأننا نبدأ البحث من الفهرس `2`، ونبحث حتى الفهرس `5` لكن دون تضمينه.
+## دالة `sorted()`
+
دالة أخرى تُستخدم كثيرًا مع الصفوف المرتبة هي دالة `sorted()`. في درس سابق تعلمت عن طريقة `sort()` للقوائم. حسنًا، يمكن استخدام دالة `sorted()` على أي قابل للتكرار بما في ذلك الصفوف المرتبة.
إليك مثالًا على إنشاء قائمة جديدة من الأرقام باستخدام دالة `sorted()`:
@@ -106,6 +112,8 @@ print(sorted(programming_languages, reverse=True))
# ['Rust', 'Rust', 'Python', 'Python', 'Java', 'C++']
```
+## الخلاصة
+
الصفوف المرتبة نوع بيانات شائع في Python. فهم كيفية التعامل معها، إلى جانب بعض الطرق والدوال المفيدة، سيساعدك على كتابة كود أكثر كفاءة.
# --questions--
diff --git a/curriculum/challenges/arabic/blocks/lecture-working-with-loops/6732c05595ca7d422b9e55ff.md b/curriculum/challenges/arabic/blocks/lecture-working-with-loops/6732c05595ca7d422b9e55ff.md
index fc8aa2a1adb..e2964c713b1 100644
--- a/curriculum/challenges/arabic/blocks/lecture-working-with-loops/6732c05595ca7d422b9e55ff.md
+++ b/curriculum/challenges/arabic/blocks/lecture-working-with-loops/6732c05595ca7d422b9e55ff.md
@@ -7,10 +7,14 @@ dashedName: what-is-the-for-in-loop-and-when-should-you-use-it
# --interactive--
+## ما هو حلقة `for...in`؟
+
تُستخدم حلقة `for...in` بشكل أفضل عندما تحتاج إلى التكرار على خصائص كائن. ستكرر هذه الحلقة جميع الخصائص القابلة للعدّ في الكائن، بما في ذلك الخصائص الموروثة والخصائص غير الرقمية.
الخاصية الموروثة هي خاصية تُورث من سلسلة النموذج الأولي للكائن. الخاصية غير الرقمية هي خاصية ليست رقمًا أو سلسلة نصية يمكن تحويلها إلى رقم.
+## صيغة حلقة `for...in`
+
إليك الصيغة النحوية الأساسية لحلقة `for...in`:
```js
@@ -21,6 +25,8 @@ for (variable in object) {
المتغير في المثال يمثل الخاصية الحالية للكائن التي يتم التكرار عليها.
+## التكرار على خصائص كائن
+
لنلقِ نظرة على بعض الأمثلة لتفهم كيف تعمل حلقة `for...in` بشكل أفضل.
في هذا المثال الأول لدينا كائن `fruit` ونريد التكرار على كل خاصية وتسجيل القيمة في وحدة التحكم.
@@ -47,6 +53,8 @@ for (const prop in fruit) {
النتائج التي ستُسجل في وحدة التحكم ستكون `apple`، و`red`، و`0.99`.
+## التكرار على كائن مسكن
+
في هذا المثال الثاني، لدينا كائن مسكن ونريد التكرار على كل خاصية وتسجيل القيمة في وحدة التحكم.
:::interactive_editor
@@ -79,6 +87,8 @@ John
{ street: '123 Main St', city: 'Anytown', state: 'CA' }
```
+## تسكين حلقات `for...in`
+
إذا أردت التكرار على خصائص كائن `address`، يمكنك تسكين حلقة `for...in` أخرى داخل الأولى.
:::interactive_editor
@@ -133,6 +143,8 @@ for (const prop in person) {
"CA"
```
+## متى تستخدم حلقة `for...in`
+
تُعتبر حلقة `for...in` مفيدة عندما تحتاج إلى التكرار على خصائص كائن.
لا يُنصح باستخدام حلقة `for...in` للتكرار على عناصر مصفوفة. بدلاً من ذلك، استخدم حلقة `for...of` أو طرق المصفوفة الأخرى مثل `forEach`، و`map`، و`filter`، و`reduce`، التي ستتعلمها في دروس لاحقة.
diff --git a/curriculum/challenges/arabic/blocks/lecture-working-with-nano/688170ebc58d8d3b1ae493a2.md b/curriculum/challenges/arabic/blocks/lecture-working-with-nano/688170ebc58d8d3b1ae493a2.md
index f2eba87a565..bc1b8a9f310 100644
--- a/curriculum/challenges/arabic/blocks/lecture-working-with-nano/688170ebc58d8d3b1ae493a2.md
+++ b/curriculum/challenges/arabic/blocks/lecture-working-with-nano/688170ebc58d8d3b1ae493a2.md
@@ -7,16 +7,22 @@ dashedName: what-is-nano
# --description--
+## تحرير الملفات في الطرفية
+
عند العمل في الطرفية، لا تتوفر دائمًا محررات النصوص القياسية، لكن هناك برامج مصممة لتحرير الملفات مباشرة من داخل الطرفية.
تتضمن بيئات العمل في لينكس عادة محرر نصوص. Vi أو Vim هما الأكثر شيوعًا. قد تحتاج إلى تثبيت Emacs وNano يدويًا، لكنهما متوفران بسهولة في معظم التوزيعات.
التحدي مع Vim هو أن له منحنى تعلم حاد. إذا لم تكن معتادًا عليه، قد لا تعرف حتى كيف تغلق التطبيق! Emacs أسهل قليلاً في الاستخدام، لكنه يحتوي على مجموعة كبيرة من اختصارات لوحة المفاتيح.
+## ما هو Nano؟
+
Nano أبسط بكثير وأسهل في الاستخدام، خاصة للمبتدئين. يمكنك البدء بسرعة وتحرير ملف باستخدام Nano، ويقدم التطبيق مساعدة على الشاشة للاختصارات الأساسية.
المقابل لذلك هو نقص قابلية التوسعة. على عكس Vim أو Emacs، التي يمكن توسيعها بإضافات لتصبح بيئات تطوير كاملة، Nano بسيط جدًا.
+## استكشاف واجهة Nano
+
لنلق نظرة على ما يمكن أن يفعله Nano. لفتح ملف، يمكنك إدخال `nano | Linux、macOS 和 PowerShell | ||||
| 完成建議（Tab 補全） | +完成建議（Tab 自動完成） | Tab | -Linux、macOS 和 PowerShell（建議來源依 shell 而異 — 例如 zsh 使用最近的指令歷史，而 PowerShell 使用可用的指令、變數和引數） | +Linux、macOS 和 PowerShell（建議內容取決於 shell、你正在輸入的命令，以及你的組態） |
|---|---|---|---|---|
| 清除終端機 | @@ -58,12 +70,12 @@ dashedName: what-are-some-shortcuts-you-can-use-in-the-command-line-to-speed-up-||||
| 中斷正在執行的行程 | Control + C | -Linux、macOS 和 PowerShell（在 PowerShell 中此組合鍵也用於複製文字，且只有在沒有選取文字時才會終止行程） | +Linux、macOS 和 PowerShell（在 PowerShell 中此快捷鍵也用於複製文字，且只有在沒有選取文字時才會中斷命令） | |
| 將行程移到背景 | +暫停前景行程 | Control + Z | -僅限 Linux 和 macOS，PowerShell 無對應功能 | +僅限 Linux 和 macOS，PowerShell 無對應快捷鍵（使用 bg 讓它在背景繼續執行，或使用 fg 讓它回到前景） |
| 重新執行先前的指令 | @@ -123,11 +135,11 @@ dashedName: what-are-some-shortcuts-you-can-use-in-the-command-line-to-speed-up- ### --feedback-- -此捷徑允許你在一個處理程序執行時同時多工處理。 +此快捷鍵讓你暫停命令，稍後再回來繼續。 --- -它將目前的行程放到背景。 +它會暫停目前的前景行程。 --- @@ -135,7 +147,7 @@ dashedName: what-are-some-shortcuts-you-can-use-in-the-command-line-to-speed-up- ### --feedback-- -此捷徑允許你在一個處理程序執行時同時多工處理。 +此快捷鍵讓你暫停命令，稍後再回來繼續。 --- @@ -143,7 +155,7 @@ dashedName: what-are-some-shortcuts-you-can-use-in-the-command-line-to-speed-up- ### --feedback-- -此捷徑允許你在一個處理程序執行時同時多工處理。 +此快捷鍵讓你暫停命令，稍後再回來繼續。 ## --video-solution-- diff --git a/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-command-line-and-working-with-bash/687e944b821130283dc83b2e.md b/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-command-line-and-working-with-bash/687e944b821130283dc83b2e.md index 093dce2e548..16562b2afb2 100644 --- a/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-command-line-and-working-with-bash/687e944b821130283dc83b2e.md +++ b/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-command-line-and-working-with-bash/687e944b821130283dc83b2e.md @@ -9,14 +9,20 @@ dashedName: what-is-bash-and-what-are-some-bash-commands 讓我們來了解 Bash 及其一些基本指令。 +## 什麼是 Bash？ + Bash 代表 Bourne Again SHell，可以說是在類 Unix 環境中你最常遇到的 shell。因此，了解如何操作這個 shell 並使用常見指令會非常有幫助。 +## 檔案系統導覽指令 + 第一個指令是 `pwd`，它會將目前的工作目錄列印到終端機。所謂「工作目錄」是指終端機目前指向的目錄，這對許多其他指令來說是非常重要的資訊。 你的終端機很可能指向錯誤的目錄。`cd` 指令允許你更改目錄。你可以指定以斜線（`/`）為前置式的絕對路徑、沒有前置式的相對路徑，並使用雙點（`..`）語法移動到父目錄。 下一個指令是 `ls`，它會列出你目前工作目錄的內容。這有助於查看你的目錄中是否存在某個檔案或資料夾。`ls` 指令也接受旗標來顯示隱藏檔案（`-a` 旗標）、檔案權限（`-l` 旗標）以及其他特性。你將在下一課中學習更多關於指令旗標的內容。你也可以使用 `less` 或 `cat` 來查看檔案的內容。 +## 檔案管理指令 + 如果目錄中不包含你需要的檔案或資料夾怎麼辦？有一些稱為 `mkdir` 和 `touch` 的指令可以讓你創建它們。`mkdir` 創建一個新的目錄或資料夾，而 `touch` 創建一個新的檔案。這兩個指令都接受你想要創建的檔案或資料夾名稱。例如，`touch readme.md` 創建一個名為 `readme.md` 的新的 Markdown 檔案。 也許你的新檔案不應該命名為 `readme.md`，而應該是 `readthis.md`。幸運的是，`mv` 指令允許你移動（或重新命名）檔案。它接受舊檔案名稱和新檔案名稱。 @@ -25,8 +31,12 @@ Bash 代表 Bourne Again SHell，可以說是在類 Unix 環境中你最常遇 `cp` 指令可用來將檔案或目錄複製到新位置。與 `mv` 指令不同，`cp` 指令不會移除原始檔案－而且若要複製目錄，你需要傳入 `-r` 旗標。 +## 在主控台輸出文字 + `echo` 指令可以被視為 Bash 中等同於 `console.log()` 或 `print()` 函式（程式）。`echo` 接受一個用引號包住的字串引數，並將其列印到終端機。這看起來在終端機執行只是為了在終端機中取得文字似乎很愚蠢，但你其實可以將 `echo` 串鏈到控制符號。`>` 符號允許你指定一個檔案名稱來創建或覆寫該檔案，並寫入新的字串，例如 `echo "Naomi was here." > readme.md`，而 `>>` 符號則會將內容附加到該檔案。 +## 其他 Bash 指令 + 還有許多 Bash 指令可供你使用，例如 `head`、`tail`、`chown` 和 `chmod`。在本課程中涵蓋所有指令是不可能的。但你可以使用 `man` 指令來查看幾乎任何指令的手冊或說明頁。 你很可能會記住你最常使用的指令。至於其他指令，你隨時都可以查看說明頁。 diff --git a/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-command-line-and-working-with-bash/687e947ae3ea7d2867c3d0e1.md b/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-command-line-and-working-with-bash/687e947ae3ea7d2867c3d0e1.md index c839d2183a7..55cfa994dd5 100644 --- a/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-command-line-and-working-with-bash/687e947ae3ea7d2867c3d0e1.md +++ b/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-command-line-and-working-with-bash/687e947ae3ea7d2867c3d0e1.md @@ -21,25 +21,31 @@ dashedName: what-are-some-command-options-and-flags 這些短選項的優點是你可以將多個旗標串鏈在一起。你可以使用 `ls -ahs` 一次性使用所有單個字母，而不是 `ls --all --human-readable --size`。 -某些選項可選方案需要傳遞一個值給它們。 +有些選項期望傳入一個值。你如何傳入該值取決於該選項是必須要值還是選用接受值。 -當使用長格式選項時，通常需要使用等號。在此語法中，值會直接與選項使用等號（`=`）符號連接。以下是修改 `ls` 行為以包含或排除顏色的範例： +當短格式選項需要值時，通常會用空格分隔該值。舉例來說，以下是設定 `ls` 結果中 `width` 的短格式選項： ```bash -ls --color=never +ls -w 50 ``` -使用短格式選項時，通常會用空格分隔值。例如，以下是設定 `ls` 結果中 `width` 的長格式和短格式選項： +當長格式選項需要值時，像 `ls` 這類 GNU 工具接受值放在等號（`=`）符號之後，或用空格分隔。這兩個指令都設定相同的寬度： ```bash -ls -w 50 +ls --width=50 ``` ```bash -ls --width=50 +ls --width 50 +``` + +有些長格式選項只選用接受值。對這些選項，值必須用等號（`=`）符號附加在選項後面。舉例來說，`ls` 的 `--color` 選項可以單獨使用，或帶有包含或排除顏色的值： + +```bash +ls --color=never ``` -請注意簡短形式使用 `-w 50`，而完整形式使用 `--width=50`。了解這個區別很重要，以避免將選項值誤傳為位置引數。 +如果你寫成 `ls --color never`，`ls` 會把 `never` 當作位置引數，也就是要列出的檔案名稱，而不是 `--color` 的值。這個區別很重要，避免誤把選項值當成位置引數傳入。 但如果你不確定，請記得你通常可以使用 `--help` 旗標來查看選項的預期語法！ @@ -119,7 +125,7 @@ ls --width=50 ## --text-- -當使用需要值的長格式選項時，通常使用什麼語法？ +當長格式選項只選用接受值時，像 `ls` 的 `--color`，你應該用什麼語法來傳入值？ ## --answers-- @@ -127,7 +133,7 @@ ls --width=50 ### --feedback-- -請記住使用長格式選項設定 `width` 的範例。 +記住 `ls --color never` 中值會發生什麼事。 --- @@ -139,7 +145,7 @@ ls --width=50 ### --feedback-- -請記住使用長格式選項設定 `width` 的範例。 +記住關閉顏色的 `--color` 選項範例。 --- @@ -147,7 +153,7 @@ ls --width=50 ### --feedback-- -請記住使用長格式選項設定 `width` 的範例。 +記住關閉顏色的 `--color` 選項範例。 ## --video-solution-- diff --git a/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-command-line-and-working-with-bash/687f0a1d5b7c4f21a9d8e123.md b/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-command-line-and-working-with-bash/687f0a1d5b7c4f21a9d8e123.md index 462735b66cb..4aa74692cc2 100644 --- a/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-command-line-and-working-with-bash/687f0a1d5b7c4f21a9d8e123.md +++ b/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-command-line-and-working-with-bash/687f0a1d5b7c4f21a9d8e123.md @@ -7,12 +7,16 @@ dashedName: how-do-you-configure-your-system-language-for-bash-and-postgresql-wo # --description-- +## 為什麼你的鍵盤配置很重要？ + 讓我們來了解你的系統語言和鍵盤設定如何影響 Bash 和 PostgreSQL 工作坊。 許多程式設計工具期望命令使用標準英文鍵盤字元。在 Bash 和 PostgreSQL 工作坊中，這對於分號（`;`）、引號、斜線和其他特殊字元尤其重要。 如果你的作業系統或鍵盤配置使用非英文語言設定，有些字元可能會與預期不同，這可能導致輸入 SQL 命令或終端機命令時出現令人困惑的錯誤。 +## 切換到美式鍵盤配置 + 為了在進行這些工作坊時獲得最佳體驗，建議在完成課程期間暫時切換到英文（美國）鍵盤配置。當 Bash 或 PostgreSQL 的命令在輸入像 `;` 或 `\` 這類符號時產生意外字元或語法錯誤，這尤其有幫助。 GitHub Codespaces 使用你本地的鍵盤配置，因此在你自己的電腦上更改配置也會影響 Codespaces 中的輸入。 @@ -48,6 +52,8 @@ setxkbmap -query setxkbmap us ``` +## 測試你的鍵盤配置 + 切換配置後，在文字框或終端機中測試以下字元： ```md @@ -58,7 +64,9 @@ setxkbmap us 某些非英文配置將像 `'` 和 `"` 這類字元視為死鍵，意即它們會等待後續按鍵而非立即輸入。切換到 US 配置後，這些字元應該會立即輸入。如果字元仍無法立即出現，表示你的配置尚未完全切換。 -如果你使用非美式實體鍵盤配置，例如 AZERTY、QWERTZ 或區域性 QWERTY 變體，符號鍵可能位於不同的實體位置。在這種情況下，切換到 US 配置後，請使用作業系統的螢幕鍵盤或鍵盤檢視器來尋找像 `;`、`/`、`\`、`|`、`'` 和 `"` 這些鍵。 +## 使用非美式實體鍵盤 + +如果你使用非美式實體鍵盤配置，例如 AZERTY、QWERTZ 或區域性 QWERTY 變體，符號鍵可能位於不同的實體位置。這種情況下，切換到美式配置後，請使用你的作業系統的螢幕鍵盤或鍵盤檢視器來找到像是 ;、/、\\、|、' 和 " 這些鍵。 使用英文（美國）鍵盤配置有助於確保 Bash 和 PostgreSQL 命令在整個工作坊中完全符合預期行為。 diff --git a/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-different-types-of-testing/67d2ff1996e4ae9e67170502.md b/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-different-types-of-testing/67d2ff1996e4ae9e67170502.md index e5d329a9384..ba34e508340 100644 --- a/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-different-types-of-testing/67d2ff1996e4ae9e67170502.md +++ b/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-different-types-of-testing/67d2ff1996e4ae9e67170502.md @@ -9,6 +9,8 @@ dashedName: what-is-unit-testing 當你設計你的應用程式時，你經常會有一系列負責單一任務的小函式（程式）。這被稱為「單一職責原則」。當你有一系列小函式時，最好測試這些函式以確保一切如預期運作。在本課程中，我們將探討如何使用流行的 Jest 測試框架來創建單元測試。 +## 要測試的函式 + 在此範例中，我們將創建一個負責傳回新格式化字串的函式（程式）： ```js @@ -20,6 +22,8 @@ export function getFormattedWord(str) { 這個 `getFormattedWord` 函式有一個名為 `str` 的參數，並且會先檢查 `str` 是否為空。如果是，則傳回一個空字串。否則，會傳回一個新的字串，其中第一個字母已大寫。我們正在匯出這個函式，以便在測試檔案中使用它。 +## 撰寫你的第一個測試 + 在一個獨立的 `getFormattedWord.test.js` 檔案中，我們可以撰寫一些測試來驗證該函式是否如預期般運作。 在 `getFormattedWord.test.js` 檔案的頂部，我們需要先這樣匯入函式（程式）： @@ -38,6 +42,8 @@ test('capitalizes the first letter of a word', () => { `expect` 函式用來測試一個值。它會與一個 matcher 結合，matcher 是一個函式，用來檢查該值是否如預期般運作。在這個例子中，matcher 是 `toBe()`。Jest 有各種 matcher 幫助你測試真值、字串、數字等等。 +## 執行你的測試 + 執行測試的一種方法是為你的 `package.json` 檔案添加 npm 腳本。以下是 Jest 框架的範例腳本： ```js @@ -59,6 +65,8 @@ Time: 0.103 s, estimated 1 s Ran all test suites. ``` +## 失敗測試的樣子 + 要查看失敗測試的樣子，我們可以故意將函式更新為以下內容來破壞測試： ```js @@ -97,6 +105,8 @@ Time: 0.121 s, estimated 1 s Ran all test suites. ``` +## 新增另一個測試 + 現在我們可以將我們的函式（程式）更新回原本的內容： ```js @@ -116,6 +126,8 @@ test("returns an empty string when no argument is provided", () => { 你可以添加其他測試來使事情更強固，但這前幾個測試是單元測試的良好入門。 +## 常見的測試框架 + 在測試 JavaScript 應用程式時，一些常見的測試框架包括 Jest、Mocha 和 Vitest。 單元測試很重要，因為它能幫助你在你的程式中捕捉更多錯誤，並確保一切如預期般運作。它也可以作為你的應用程式的一種文件形式，因為它旨在表述你的程式的預期行為。 diff --git a/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-different-types-of-testing/67db30fedfa0b22a1a2a570c.md b/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-different-types-of-testing/67db30fedfa0b22a1a2a570c.md index c510ed80a5f..79b146acb5e 100644 --- a/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-different-types-of-testing/67db30fedfa0b22a1a2a570c.md +++ b/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-different-types-of-testing/67db30fedfa0b22a1a2a570c.md @@ -27,18 +27,32 @@ dashedName: what-is-the-software-development-life-cycle-and-how-does-it-relate-t 讓我們更詳細地仔細看看所有那些階段。 +## 規劃階段 + 在規劃階段，開發團隊會從利害關係人收集對擬議工作的需求。利害關係人是對產品或服務的成功有既得利益的人。利害關係人的範例可能是投資者、擁有者，甚至是其他員工。規劃階段還包括估算工作的成本以及建立工作的完成排程。 +## 設計階段 + 下一個階段是設計階段。在此階段，軟體團隊會拆解需求並決定最佳的解決方案方法。這包括決定可以使用哪些外部工具來協助進行，以及需要建立哪些內部工具來完成工作。 +## 實作階段 + 在設計階段之後，你有實作階段。這涉及軟體團隊將需求拆解成可管理的任務，然後彼此分配並建置完成。 +## 測試階段 + 一旦實作階段完成，軟體團隊便進入測試階段。這包括對新工作進行手動和自動測試。有時團隊會在整個開發階段中測試應用程式，以便發現並修正任何出現的問題。 +## 部署階段 + 下一個階段是部署階段。這是團隊將新變更部署到建置或測試環境的地方。這讓團隊能夠進一步測試應用程式並在變更進入生產環境之前修正任何問題。生產環境中的應用程式是終端用戶將會使用的應用程式。 +## 維護階段 + 最後階段是維護階段。這包括修正生產應用程式中客戶反映的任何問題。這也包括監控系統，以尋找軟體可能的改進。 +## 瀑布模型與敏捷模型 + 最後，業界中使用不同的軟體開發生命週期模型，例如 Waterfall 和 Agile。Waterfall 模型要求生命週期的每個階段必須在下一階段開始之前完成。相反地，Agile 模型則專注於透過將工作拆分為衝刺來進行反覆的開發，使團隊能夠快速進行變更並隨時間交付工作。 透過軟體開發生命週期，開發團隊和利害關係人可以在需求、成本估算和排程方面達成共識。這使得整體的協作和通訊更加高效。 diff --git a/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-different-types-of-testing/67db31349f3ace2c5c803c33.md b/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-different-types-of-testing/67db31349f3ace2c5c803c33.md index 397e0432679..e8a5fa6dcdd 100644 --- a/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-different-types-of-testing/67db31349f3ace2c5c803c33.md +++ b/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-different-types-of-testing/67db31349f3ace2c5c803c33.md @@ -9,6 +9,8 @@ dashedName: what-are-bdd-and-tdd 在軟體開發中，你應該了解兩種測試方法。這些方法是 TDD（Test-Driven Development）和 BDD（Behavior-Driven Development）。 +## 測試驅動開發（TDD） + 讓我們先來看看 TDD。測試驅動開發是一種強調先撰寫測試，再建置應用程式特性的開發方法。 以下是 TDD 的典型處理程序： @@ -29,8 +31,12 @@ dashedName: what-are-bdd-and-tdd 雖然有些軟體團隊會選擇遵循 TDD 方法，但 TDD 在業界是一個具爭議性的話題。你會發現有許多文章和影片同時支持和反對 TDD。不論你對這種方法的看法如何，了解它仍然很重要，因為你可能會在實際情境中遇到它。 +## 行為驅動開發（BDD） + 第二種我們將探討的測試方法是行為驅動開發（BDD）。行為驅動開發是一種將一系列測試與商務目標對齊的方法。這些測試應該以技術人員和非技術人員都能理解的語言撰寫。 +### Gherkin 語言 + 在測試軟體應用程式中的特定行為時，BDD 通常使用 Gherkin 語言，該語言用於商務中描述行為和情境。Gherkin 語言在描述情境時使用 Given、When 和 Then 述語。 以下是一個範例： @@ -43,12 +49,16 @@ dashedName: what-are-bdd-and-tdd **然後** 部落格文章應該被存檔並以正確的標題、內容和時間戳記顯示在首頁。 +### 撰寫 BDD 場景 + 你首先要定義一個情境。範例情境包括使用者登入應用程式或在網站上下訂單。在此範例中，情境是使用者在網站上建立新的部落格文章。 在定義情境後，你應該從 Given 述語開始。這提供使用者在執行動作前的背景關係。When 述語用來表述使用者所採取的動作。 最後，Then 述語用來表述使用者先前採取動作所期望的結果。當你定義完所有情境後，你可以為每個情境撰寫測試。 +### 測試框架 + BDD 測試框架的範例包括 Cucumber、JBehave 和 SpecFlow。 # --questions-- diff --git a/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-http-request-response-model/68dd97fbd18ede5ae983e342.md b/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-http-request-response-model/68dd97fbd18ede5ae983e342.md index fd4a143ed71..a4f8ab73603 100644 --- a/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-http-request-response-model/68dd97fbd18ede5ae983e342.md +++ b/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-http-request-response-model/68dd97fbd18ede5ae983e342.md @@ -33,11 +33,11 @@ HTTP 回應傳回的資產包括基於文字的資產、多媒體資產、字型 以下是這些常見資產及其內容型別的表格： -| Asset Type | Content-Type Header | +| 資產類型 | Content-Type 標頭 | | --- | --- | | HTML | text/html | | CSS | text/css | -| JavaScript | application/javascript | +| JavaScript | text/javascript | | JPEG | image/jpeg | | PNG | image/png | | GIF | image/gif | @@ -49,11 +49,11 @@ HTTP 回應傳回的資產包括基於文字的資產、多媒體資產、字型 | OTF | font/otf | | MP4 | video/mp4 | | WebM | video/webm | -| Ogg (Video) | video/ogg | +| Ogg (影片) | video/ogg | | MP3 | audio/mpeg | | AAC | audio/aac | | WAV | audio/wav | -| Ogg (Audio) | audio/ogg | +| Ogg (音訊) | audio/ogg | | JSON | application/json | | XML | application/xml | | PDF | application/pdf | diff --git a/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-web-standards-model/69fc757399f4066e674a5161.md b/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-web-standards-model/69fc757399f4066e674a5161.md index 2186db215b2..fea5a2a4c95 100644 --- a/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-web-standards-model/69fc757399f4066e674a5161.md +++ b/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-the-web-standards-model/69fc757399f4066e674a5161.md @@ -7,29 +7,37 @@ dashedName: what-does-the-lifecycle-of-web-standards-features-look-like # --description-- +## 什麼是特性生命週期？ + 在上一課，我們探討了建立網頁標準的流程：提案如何撰寫、審查，並最終定案。 網頁標準特性的生命週期相關，但更細緻。它追蹤一個特性從有人發現問題開始，一直到它在所有主要瀏覽器中發布（甚至最後可能被淘汰）。 把這個流程想成規則書，而生命週期則是你實際玩遊戲時發生的事情。 -1. ## 提案 - 每個特性都始於有人在意到一個問題並願意將其寫下。開發者、瀏覽器工程師或公司會在 GitHub 提出議題或說明，描述目前網路無法做到的事以及為何應該做到。在這個階段，想法還很模糊，問題多於答案。目標只是要確認是否有人也認同這個痛點。 +## 1. 提案 + +每個特性都始於有人在意並寫下的一個問題。開發者、瀏覽器工程師或公司會在 GitHub 提出議題或說明，描述目前網路無法做到的事以及為什麼應該做到。在這個階段，想法還很模糊，問題多於答案。目標只是想知道是否有人也認同這個痛點。 + +## 2. 孵育期 + +如果提案引起共鳴，它會進入公開討論和早期設計階段。會草擬出競爭方案、收集使用案例，社群會對這個想法進行壓力測試。許多提案會在這裡夭折，可能是因為問題太冷門，或沒有解法能滿足所有人。存活下來的提案會有更清晰的輪廓，並至少獲得部分瀏覽器廠商的興趣。 + +## 3. 規格 + +存活的提案會被寫成正式的規格。每個邊緣案例、錯誤狀況和與現有特性的互動都必須明確定義。這是好點子遇上現實的時刻。模糊的概念必須變成兩位獨立工程師都能讀懂並一模一樣實作的精確規則。 + +## 4. 互通性測試 -1. ## 孵育 - 如果提案引起共鳴，它會進入公開討論和早期設計階段。會草擬出競爭方案、收集使用案例，社群會對這個想法進行壓力測試。許多提案會在此階段夭折，可能是因為問題太過小眾，或沒有解法能滿足所有人。存活下來的提案會有更清晰的輪廓，並至少獲得部分瀏覽器廠商的關注。 +在特性被視為穩定之前，它必須在每個瀏覽器中表現一致。W3C Web Platform Tests 套件是驗證這點的主要工具。這是一套由 Chrome、Firefox、Safari 等瀏覽器共同執行的測試。若結果不一致，代表規格有歧義或有人有錯誤。這兩者都必須解決後，特性才能繼續推進。 -1. ## 規格 - 存活的提案會被寫成正式的規格。每個邊緣案例、錯誤狀況，以及與現有特性的互動都必須明確定義。這是好點子面對現實的時刻。模糊的概念必須變成兩位獨立工程師都能讀懂並完全相同實作的精確規則。 +## 5. 最終定案 -1. ## 互通性測試 - 在特性被視為穩定之前，它必須在每個瀏覽器中表現一致。W3C Web Platform Tests 套件是驗證這點的主要工具。這是一套由 Chrome、Firefox、Safari 等瀏覽器共同執行的測試集合。測試結果若有差異，代表規格不夠明確，或有人實作有錯誤。這兩者都必須解決，特性才能繼續推進。 +當多個獨立實作通過測試後，特性就會被最終定案。對 W3C 來說是推薦標準，對 TC39 是第 4 階段，對 WHATWG 是穩定的活文件標準。旗標會被移除，特性會正式推送給使用者。此時，它成為基礎網路平台的一部分，每個開發者都能永遠依賴它。 -1. ## 定案 - 一旦多個獨立實作通過測試，該特性就會被定案。對 W3C 來說是推薦標準，對 TC39 是第 4 階段，對 WHATWG 是穩定的活文件標準。旗標會被移除，特性會正式發佈給使用者。此時，它成為基礎網路平台的一部分，每個開發者都能永久依賴它。 +## 6. 棄用 -1. ## 棄用 - 並非每個標準都能隨時間保持良好。有些特性被更好的取代，有些則發現當初未察覺的安全或隱私問題。當特性需要被淘汰時，它會被正式標記為棄用，也就是仍被支援但建議開發者停止使用。最終它會從規格中移除。瀏覽器移除這些特性時非常謹慎且緩慢，因為網路的核心承諾是舊網頁能繼續運作。有些棄用特性會因向後相容義務而在瀏覽器中存在數十年。 +並非每個標準都能隨時間保持良好。有些特性被更好的取代，有些則發現當初沒有察覺的安全或隱私問題。當特性需要被淘汰時，它會被正式棄用，也就是仍然支援但標記為開發者應該停止使用。最終會從規格中移除。瀏覽器移除特性是緩慢且謹慎的，因為網路的核心承諾是舊網頁能繼續運作。有些棄用的特性會因為向後相容義務，在瀏覽器中存在數十年。 # --questions-- diff --git a/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-variables-and-data-types/67fe8597975ea634042cad8f.md b/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-variables-and-data-types/67fe8597975ea634042cad8f.md index 4859a3ce610..2db5230eb34 100644 --- a/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-variables-and-data-types/67fe8597975ea634042cad8f.md +++ b/curriculum/challenges/chinese-traditional/blocks/lecture-understanding-variables-and-data-types/67fe8597975ea634042cad8f.md @@ -7,6 +7,8 @@ dashedName: how-do-you-declare-variables-and-what-are-naming-conventions-to-name # --description-- +## 宣告變數 + 在 Python 中，變數就像帶有標籤的盒子，用來儲存和取用不同型別的資料。要創建變數，請先在左邊寫變數名稱，接著是指定運算子（`=`），然後在右邊寫你想儲存的值。以下是如何創建 `name` 和 `age` 變數的範例： ```python @@ -16,6 +18,8 @@ age = 25 在上述範例中，變數 `name` 儲存的值是 `'John Doe'`。這個值是一個字串，字串是一系列用來表述文字的字元。字串以單引號或雙引號書寫，例如 `'Hello'` 或 `"Hello"`。在未來的課程中，你將學習更多關於在 Python 中操作字串的方法。 +## 遵守命名規則 + 在 Python 中命名變數時，有一些重要規則你應該記住： - 變數名稱只能以字母或底線（`_`）開頭，不能以數字開頭。 @@ -31,6 +35,8 @@ age = 25 SyntaxError: invalid syntax ``` +## 遵守命名慣例 + 現在讓我們來看看 Python 中變數的一些常見命名慣例。 首先，變數名稱應該全部小寫，並用底線分隔字詞。這稱為蛇底式命名法（snake case）： @@ -53,6 +59,8 @@ user_age = 30 x = 56 # What do you mean by x? ``` +## 撰寫註解 + 井字號符號（`#`）和其後的文字組成註解。註解讓你可以在程式碼中添加筆記和說明。 在 Python 中，註解以井字號符號（`#`）開始，語言會忽略該行中 `#` 符號後的所有內容： diff --git a/curriculum/challenges/chinese-traditional/blocks/lecture-what-is-css/672acc03c257524d6a5151e8.md b/curriculum/challenges/chinese-traditional/blocks/lecture-what-is-css/672acc03c257524d6a5151e8.md index 01ea7ba93a0..3af6fb2d8e8 100644 --- a/curriculum/challenges/chinese-traditional/blocks/lecture-what-is-css/672acc03c257524d6a5151e8.md +++ b/curriculum/challenges/chinese-traditional/blocks/lecture-what-is-css/672acc03c257524d6a5151e8.md @@ -7,10 +7,14 @@ dashedName: how-do-width-and-height-work # --interactive-- +## 寬度和高度介紹 + 在 CSS 中，`width` 和 `height` 屬性用於控制網頁元素的尺寸。 這些屬性可以用不同的單位定義，例如像素（`px`）、百分比（`%`）、視窗單位（`vw`、`vh`）等。 +## `width` 和 `height` 屬性 + `width` 屬性指定元素的寬度。如果你沒有指定寬度，則預設值會設定為 `auto`。這讓瀏覽器根據元素的內容、父容器和顯示型別來決定元素的寬度。對於 `div` 元素，`width: auto` 會使其擴展以填滿父容器的整個寬度。 `height` 屬性指定元素的高度。同樣地，高度的預設值是 `auto`，這表示它會根據內部內容進行調整。 @@ -40,6 +44,8 @@ dashedName: how-do-width-and-height-work 像素是 CSS 中固定大小的測量單位，提供對尺寸的精確控制。 +## `min-width` 和 `min-height` 屬性 + `min-width` 屬性指定元素可以擁有的最小寬度。即使內部內容較小，元素也不會縮小到低於此值。 `min-height` 指定元素的最小高度。它確保元素不會比設定的值更矮。 @@ -73,6 +79,8 @@ dashedName: how-do-width-and-height-work 請記住，如果 `min-width` 或 `min-height` 大於 `width` 或 `height`，它們將會改寫較小的值。這確保元素不會變得過小，這對於維護一致且可用的設計非常重要。 +## `max-width` 和 `max-height` 屬性 + `max-width` 指定元素可以擴展到的最大寬度，即使有足夠的空間讓它更寬。 `max-height` 指定元素可以增長到的最大高度，無論內容大小為何。 @@ -104,6 +112,8 @@ dashedName: how-do-width-and-height-work 請記住，當 `max-width` 或 `max-height` 小於 `width` 或 `height` 時，它們具有優先權。這對於控制佈局中元素的最大尺寸非常重要。 +## 屬性優先 + CSS 優先使用 `min-width` 和 `min-height`，而非 `width` 和 `height`。如果值超過限制，`max-width` 和 `max-height` 會限制尺寸。 例如，如果你將 `width` 設定為 `600px` 且 `max-width` 設定為 `500px`，該元素的寬度將被限制在 `500px`。`max-width` 會改寫較寬的設定，使元素保持在指定的最大尺寸內。 diff --git a/curriculum/challenges/chinese-traditional/blocks/lecture-working-with-backgrounds-and-borders/672aa669960f6a596081fcad.md b/curriculum/challenges/chinese-traditional/blocks/lecture-working-with-backgrounds-and-borders/672aa669960f6a596081fcad.md index ea70e53b781..6a52597297b 100644 --- a/curriculum/challenges/chinese-traditional/blocks/lecture-working-with-backgrounds-and-borders/672aa669960f6a596081fcad.md +++ b/curriculum/challenges/chinese-traditional/blocks/lecture-working-with-backgrounds-and-borders/672aa669960f6a596081fcad.md @@ -7,6 +7,8 @@ dashedName: how-to-work-with-background-image-size-repeat-position-and-attachmen # --interactive-- +## 背景屬性介紹 + 當在 CSS 中處理背景影像時，你有多個屬性可用來控制這些影像的顯示方式。 我們將專注的主要屬性是 `background-size`、`background-repeat`、`background-position` 和 `background-attachment`。 @@ -27,6 +29,8 @@ dashedName: how-to-work-with-background-image-size-repeat-position-and-attachmen 上述 CSS 為 `body` 元素設定了一個貓咪背景影像。 +## `background-size` 屬性 + 如果你想設定背景影像的大小，可以使用 `background-size` 屬性。 你可以使用 `contain` 將影像縮放到盡可能大而不裁切或拉伸。 @@ -65,6 +69,8 @@ dashedName: how-to-work-with-background-image-size-repeat-position-and-attachmen ::: +## `background-repeat` 屬性 + 在前面的範例中，你可能注意到背景影像會持續重複。 預設情況下，背景影像會在水平方向和垂直方向重複，以填滿整個元素。然而，你可以控制此行為。 @@ -122,6 +128,8 @@ dashedName: how-to-work-with-background-image-size-repeat-position-and-attachmen ::: +## `background-position` 屬性 + 要在螢幕上定位背景影像，可以使用 `background-position` 屬性。 `background-position` 屬性允許你設定背景影像在元素中的顯示位置。你可以使用關鍵字如 `top`、`bottom`、`left`、`right` 和 `center`，或是特定的像素或百分比數值。 @@ -146,6 +154,8 @@ dashedName: how-to-work-with-background-image-size-repeat-position-and-attachmen 這段 CSS 程式碼將背景影像水平置中並垂直置頂於元素。 +## `background-attachment` 屬性 + 最後，`background-attachment` 決定背景影像在頁面滾動時是隨內容一起滾動還是保持固定。 主要的值有 `scroll`（預設值），背景影像會隨內容捲動，以及 `fixed`，背景影像會固定在螢幕上的相同位置。 @@ -168,9 +178,11 @@ dashedName: how-to-work-with-background-image-size-repeat-position-and-attachmen 這段 CSS 程式碼設定背景影像在頁面捲動時保持固定位置。 +## `background` 簡寫屬性 + 如果你想將幾個屬性合併成一行，可以使用簡寫的 `background` 屬性來達成。 -這裡有一個範例： +以下是一個範例： :::interactive_editor diff --git a/curriculum/challenges/chinese-traditional/blocks/lecture-working-with-code-editors-and-ides/672d26269456511aa3db614d.md b/curriculum/challenges/chinese-traditional/blocks/lecture-working-with-code-editors-and-ides/672d26269456511aa3db614d.md index 44f886e218a..570ce335aa1 100644 --- a/curriculum/challenges/chinese-traditional/blocks/lecture-working-with-code-editors-and-ides/672d26269456511aa3db614d.md +++ b/curriculum/challenges/chinese-traditional/blocks/lecture-working-with-code-editors-and-ides/672d26269456511aa3db614d.md @@ -7,8 +7,12 @@ dashedName: what-is-a-code-editor-and-ide # --description-- +## 什麼是程式碼編輯器和整合開發環境？ + 你可能會以為這兩者是一樣的，但其實不完全相同。程式碼編輯器是任何允許你編輯程式碼檔案的應用程式。IDE，或稱整合開發環境，是一個完整的應用程式，讓你在編輯程式碼的同時，可以建置、執行和偵錯你的程式碼。 +## 探索熱門的整合開發環境 + 一些範例會有助於理解。 首先，讓我們來看看幾個流行的整合開發環境。Visual Studio 是微軟提供的一個整合開發環境，提供一套完整的工具，用於建置、偵錯及部署跨多個平台的應用程式。 @@ -17,6 +21,8 @@ dashedName: what-is-a-code-editor-and-ide Android Studio 是由 Google 開發的整合開發環境，專門用於建置、偵錯和測試 Android 應用程式。 +## 探索熱門的程式碼編輯器 + 這些只是一些整合開發環境的範例。現在，讓我們來看看幾個受歡迎的程式碼編輯器。 Visual Studio Code 是微軟推出的輕量級、開放原始碼程式碼編輯器，支援廣泛的程式設計語言，並透過擴充套件提供偵錯、語法凸顯標示和版本控制等功能。 @@ -27,6 +33,8 @@ Windows 使用者也可以使用 Notepad++，這是一款免費且開源的文 你可能已注意到，程式碼編輯器主要專注於檔案的文字內容，而 IDE 則提供各種工具來管理你的程式碼。 +## 探索雲端編輯器 + 這些範例都是你可以在你的電腦上執行的區域的程式，但也有你可以使用的雲端編輯器。 基於雲端的編輯器是一種線上工具，允許使用者直接透過網頁瀏覽器撰寫、編輯及管理程式碼或文字，無需在區域的電腦安裝軟體。 @@ -39,6 +47,8 @@ Replit 是一個線上平台，提供一個協作環境讓使用者能夠直接 StackBlitz 是另一個雲端編輯器。它直接在瀏覽器中執行，讓你在不需要任何區域設定的情況下建置、測試和分享網頁專案。 +## 選擇合適的編輯器 + 還有許多其他選項。有些選項，例如 Visual Studio Code，具有高度擴充性，能支援多種專案類型和程式語言。其他選項則可能專門針對少數程式語言或專案類型設計。 你使用的應用程式可能會因特定專案而異。你應該探索這些選項，以了解哪一個最適合你的需求。 diff --git a/curriculum/challenges/chinese-traditional/blocks/lecture-working-with-code-editors-and-ides/672d456f4ac35950b300e93f.md b/curriculum/challenges/chinese-traditional/blocks/lecture-working-with-code-editors-and-ides/672d456f4ac35950b300e93f.md index cfcf4888132..9a7b3d648ad 100644 --- a/curriculum/challenges/chinese-traditional/blocks/lecture-working-with-code-editors-and-ides/672d456f4ac35950b300e93f.md +++ b/curriculum/challenges/chinese-traditional/blocks/lecture-working-with-code-editors-and-ides/672d456f4ac35950b300e93f.md @@ -7,8 +7,12 @@ dashedName: what-are-several-useful-keyboard-shortcuts-for-maximizing-productivi # --description-- +## 繼承自作業系統的快捷鍵 + 你可能已經熟悉一些基本的快捷鍵，這些快捷鍵是從你的作業系統繼承而來。像是 Ctrl + S（Windows/Linux）或 Cmd + S（macOS）用來存檔，Ctrl + C 或 Cmd + C 用來複製，還有 Ctrl + V 或 Cmd + V 用來貼上，這些在 VS Code 都適用。 +## 應用程式專屬快捷鍵 + 但有一些是應用程式專屬的，仍然可以提升你的生產力。值得注意的是，這些快捷鍵在不同作業系統上可能會有所不同。 例如，Shift + Alt + F 會對目前開啟的檔案執行你所組態的格式化工具（像是 JavaScript 專案中的 Prettier）。 @@ -21,8 +25,12 @@ dashedName: what-are-several-useful-keyboard-shortcuts-for-maximizing-productivi 還是你根本看不清楚程式碼？Ctrl + Plus（Windows/Linux）或 Cmd + Plus（macOS）會放大編輯器的縮放比例，而 Ctrl + Minus（Windows/Linux）或 Cmd + Minus（macOS）會縮小它。 +## 多行編輯快捷鍵 + VS Code 另一個有用的功能是多列編輯，讓你能一次修改多列。舉例來說，你可以用 Ctrl + Alt + Down 和 Ctrl + Alt + Up（Windows）、Shift + Alt + Down 和 Shift + Alt + Up（Linux）、或 Option + Cmd + Down 和 Option + Cmd + Up（macOS）來將游標延伸到連續的列。你也可以按住 Alt（Windows/Linux）或 Option（macOS）並點擊，在你需要的不同列上新增游標。游標放好後，你輸入或刪除的任何內容都會同時套用到所有這些位置，這在處理重複程式碼時能節省很多時間。 +## 指令調色盤與鍵盤快捷鍵參考 + 最後，如果你忘記任何這些快捷鍵，你隨時可以按 Ctrl + Shift + P（Windows/Linux）或 Cmd + Shift + P（macOS），這會開啟命令調色盤，讓你選擇你需要的任何指令。