Merge pull request #1 from 0ud/main

added basic file structure

Author: binhunaish

basics-doc/index.md

@@ -1,9 +1,14 @@
 ---
+title: مقدمة
 sidebar_position: 1
 ---
 
-# وثائقي جديد
+# مرحبًا
 
-هذه بداية قسم **الأساسيات** على المسار `/basics-doc`.
+مرحبًا بك في قسم الأساسيات, هنا تجد ما تحتاجه من المعلومات للبدء في مسيرتك البرمجية مرتبة على عدة أقسام:
 
-يمكنك إضافة صفحات أخرى داخل مجلد `basics-doc` وستظهر تلقائيا في الشريط الجانبي.
+* التعريف: فيه نبذة هامة عن علم البرمجة وكيف يقرأ الحاسوب النصوص التي نكتبها.
+
+* لغات البرمجة: فيه التعريف بمفهوم لغات البرمجة وأنواعها والفرق بينها.
+
+* مجالات البرمجة: نستعرض فيه أبرز أقسام ومجالات البرمجة الشهيرة مع نبذة عن كل واحد منها.

basics-doc/التعريف/_category_.json

@@ -0,0 +1,4 @@
+{
+  "label": "التعريف",
+  "position": 1
+}

basics-doc/التعريف/البرمجة.md

@@ -0,0 +1,20 @@
+---
+title: "البرمجة"
+sidebar_position: 2
+---
+
+## التعريف بالبرمجة
+
+البرمجة هي عملية إعطاء الأوامر للحاسوب لغرض تنفيذ أمر معين سواءً عن طريق كتابة نصوص وأوامر ( وهي الطريقة الأكثر شيوعًا في وقتنا الحاضر ), أو من خلال ربط دائرة كهربائية أو قطع ميكانيكية بصورة معينة لتعطي نتائج محددة ( وهو المستعمل في بعض الاختصاصات الهندسية ), أو من خلال عمل ثقوب في ورقة مخصصة يتعرف الكمبيوتر على هذه الثقوب ويترجمها إلى أوامر وهي الطريقة المستعملة سابقًا في بداية ظهور الحواسيب في صورها البدائية.
+
+## عناصر البرمجة
+
+تتكون عملية البرمجة من عدة عناصر:
+
+1- المبرمِج: وهو الإنسان المختص بتنفيذ هذه العملية.
+
+2- المستخدم النهائي: وهو المستفيد من مُخرجات عملية البرمجة كمستخدمي التطبيقات والزبائن أو حتى المبرمج نفسه في بعض الأحيان.
+
+3- البرنامج: وهو مجموعة الأوامر التي يضعها المبرمج في الحاسوب.
+
+4- الحاسوب: وهو المسؤول عن معالجة البرنامج وأخذ المدخلات وإعطاء النتيجة النهائية, وقد يتفاعل المستخدم معه أحيانًا.

basics-doc/التعريف/البرنامج.md

@@ -0,0 +1,22 @@
+---
+title: "البرنامج"
+sidebar_position: 1
+---
+
+## مقدمة
+
+قبل أن نبدأ في تعلم البرمجة, علينا أن نعلم ماهية الذي نتعلمه. فعلينا أن نعرف: ما هو البرنامج؟ وما هي البرمجة؟ وما الفرق بين البرنامج والتطبيق؟
+
+## البرنامج
+
+يمكننا تعريف البرنامج بأنه مجموعة من الأوامر يقوم المبرمج بتوجيهها إلى الكمبيوتر لتنفيذ غرض معين, وهذا أبسط وأشمل تعريف.
+
+يشمل هذا التعريف كل سطر برمجي يكتبه المستخدم ولو لم يكن موجهًا للمستفيد النهائي والمستخدم النهائي للتطبيق, بل قد تكون أداة خاصة بالمبرمجين تساهم في عملية البرمجة فكل هذا يُطلق عليه " البرنامج ".
+
+نتعلم مما سبق: أن البرنامج هو أوامر برمجية يضعها المبرمج وقد تكون في قطعة إلكترونية صغيرة, أو إضافة للمتصفح, أو حتى الكود البرمجي الخاص بالثلاجة وأجهزة المطبخ الذكية!
+
+## أمثلة شهيرة
+
+يعد نظام التشغيل ( سواءً كان ويندوز, ماك, لينكس, أو غير ذلك ) مجموعةً من البرامج التي تعمل معًا لتوفير بيئة قابلة للاستعمال من قبل المستخدم ويمكنه تثبيت البرامج والتطبيقات الأخرى عليها.
+
+كما ويعد نظام قطعة الإدخال والإخراج ( BIOS ) من أشهر الأمثلة فهي برنامج يربط بين مكونات الحاسوب المتنوعة ( المعالج, كرت الشاشة, الذاكرة العشوائية, الذاكرة التخزينية, وغيرها ) ويجعلها تعمل معًا ويعطي نافذة ربط بين الجزء المادي من الحاسوب والجزء البرمجي

basics-doc/التعريف/التطبيق.md

@@ -0,0 +1,24 @@
+---
+title: "التطبيق"
+sidebar_position: 3
+---
+
+## التعريف بالتطبيق
+
+هو نوع من أنواع البرامج يستهدف المستخدم النهائي بشكل خاص ويمكن للمستخدم التفاعل معه ويتكون من عدة برامج تعمل مع بعضها في نسق معين لتنفيذ غرض واحد
+
+## الفرق بينه وبين البرنامج
+
+* الفئة المستهدفة: البرنامج واسع يستفيد منه المبرمج أو المستخدم النهائي, أما التطبيق فهو موجه للمستخدم النهائي بصورة أساسية.
+
+* التصميم: البرنامج قد يخلو من واجهة رسومية ويكون بتصميم صعب نسبيًا للمستخدم النهائي, أما التطبيق فيحتوي على واجهة رسومية وتصميم جذاب وسهل الاستخدام.
+
+* الوظيفة: يؤدي البرنامج وظيفة واحدة, أما التطبيق فهو أوسع ومتعدد الوظائف.
+
+* الاعتمادية: قد يكون البرنامج مستقلًا لا يعتمد على نظام التشغيل, أما التطبيق فيتم تثبيته فوق نظام التشغيل فهو جزء من نظام التشغيل.
+
+## الفرق بينه وبين نظام التشغيل
+
+نظام التشغيل مجموعة برامج تمثل الجزء البرمجي من الحاسوب فهي التي تربط بين الجزء المادي من الحاسوب وبين المستخدم النهائي. ويتكون من الأساس أو اللب بالإضافة إلى الواجهة وقد تكون الواجهة رسومية أو غير رسومية. ويتم تحميل التطبيقات فوق نظام التشغيل لتكون جزءًا منه.
+
+وتعتمد التطبيقات على السطور البرمجية والمكتبات الموجودة في نظام التشغيل لتبني نفسها عليها.

basics-doc/لغات البرمجة/_category_.json

@@ -0,0 +1,4 @@
+{
+  "label": "لغات البرمجة",
+  "position": 2
+}

basics-doc/لغات البرمجة/التصنيف العام.md

@@ -0,0 +1,42 @@
+---
+
+title: "التصنيف العام"
+sidebar_position: 3
+
+---
+
+## طرق التصنيف
+
+لغات البرمجة كثيرة جدًا يصعب إحصاؤها إلا أن المستخدم والشائع منها ليس بالكثير, مع هذا يمكننا أن نصنفها إلى أقسام رئيسية بطريقتين:
+
+1- بالاعتماد على قربها وبعدها من لغة الآلة
+
+2- بالاعتماد على طريقة تحويل السطر البرمجي إلى لغة يستطيع الحاسوب فهمها
+
+### التصنيف بالاعتماد على القرب والبعد من لغة الآلة
+
+1- لغات عالية المستوى: وهي اللغات التي يكون النص البرمجي فيها أقرب إلى لغة البشر, سهلة القراءة والبرمجة, إلا أنها بعيدة من أجزاء الحاسوب الأساسية فلا يمكنها - بشكل مباشر - التعديل على الذاكرة العشوائية للكمبيوتر أو القطع المادية, كما أنها تعاني من كونها أبطأ نسبيًا من اللغات منخفضة المستوى
+
+2- لغات منخفضة المستوى: وهي اللغات التي يكون النص البرمجي فيها أقرب إلى لغة الآلة, صعب القراءة نسبيًا, إلا أنها يمكنها مباشرة جميع أجزاء الحاسوب بلا عوائق وتكون في العادة أكثر سرعةً من اللغات عالية المستوى
+
+#### مثال
+
+فيما يلي مثال لطباعة جملة ترحيبية بلغة بايثون ( وهي لغة عالية المستوى ), قم بمقارنته بنفس الأمر لو كان بلغة التجميع الموجودة في الدرس السابق.
+
+```python
+print("Hello World")
+```
+
+### التصنيف بالاعتماد على طريقة الترجمة
+
+1- لغات مجمّعة: يقوم الحاسوب بجمع البرنامج كله وتحويله مرةً واحدة إلى ملف بلغة الآلة.عند تشغيل هذا الملف يقوم الحاسوب بقراءة ملف يتكون من 0 و 1 يمكن له قراءتها بسهولة وبسرعة
+
+2- لغات مترجمة: يقوم الحاسوب بعد فتح البرنامج بقراءته سطرًا تلو الآخر وتحويل كل سطر إلى لغة الآلة
+
+النتيجة: قد تظهر طريقة العمل متشابهة في الحالتين إلا أنها تختلف اختلافًا كبيرًا وذلك في عدة وجوه من أبرزها:
+
+* إذا غيرت سطرًا واحدًا في البرنامج المجمّع, يجب عليك انتظار الحاسوب ليبني البرنامج كله ويجمعه مرة أخرى مما يجعل التغييرات الطفيفة تأخذ وقتًا كبيرا. أما في البرنامج المترجم, سيقوم الحاسوب بإعادة بناء السطر الذي تغير فقط مع إبقاء باقي الأجزاء.
+
+* السرعة: بما أن اللغات المجمّعة تنتج ملف نهائي مكتوب بلغة الآلة, سيكون تشغيل البرنامج للمرة الثانية بعد بناءه فوريًا وسريعًا, أما في اللغات المترجمة فيجب على الحاسوب أن يترجم الأوامر سطرًا بعد الآخر في كل مرة تقوم بتشغيل البرنامج بها.
+
+إذن: لكل نوع فائدة واستخدام خاص ويعتمد اختيار اللغة المناسبة على الاستخدام المراد والسرعة المطلوبة والبساطة والتعقيد للبرنامج

basics-doc/لغات البرمجة/اللغات الاجرائية.md

@@ -0,0 +1,19 @@
+---
+title: "اللغات الاجرائية"
+sidebar_position: 4
+
+---
+
+## نبذة تعريفية
+
+تعد اللغات الاجرائية من أهم ركائز البرمجة, وهي ليست لغات برمجة بذاتها وإنما تستعمل مع لغات البرمجة كعامل مساعد. ونستطيع أن نعرّفها بأنها لغات تستعمل لغرض الترتيب, وبيان هيكلية موقع \ مستند ما. تشتمل على ذكر النصوص والعناصر فقط.
+
+## أبرز اللغات
+
+* HTML: تُستعمل مع مواقع الويب لتطوير واجهات المستخدمين.
+
+* XML: وهي شبيهة بلغة ( HTML ) إلا أن استخدامها أوسع فهي تستعمل مع لغات برمجة متنوعة ولا نستخدمها في واجهات المواقع وإنما تستخدم في خزن البيانات الأساسية كإعدادات تطبيق ما.
+
+ويشابهها في الوظيفة لغات ( YAML, TOML ).
+
+* JSON: وهي واسعة الاستعمال تستخدم في مجال الويب مع لغة ( JavaScript و PHP ) وتستعمل أيضًا مع باقي لغات البرمجة في جميع المجالات مثل ( Python, Java, C# ) وغيرها. فكل لغة تقريبا لديها مكتبة أوامر يمكنها من خلالها قراءة ملفات ( JSON ) والتعامل مع البيانات المخزونة فيها.

basics-doc/لغات البرمجة/لغة التجميع.md

@@ -0,0 +1,52 @@
+---
+
+title: "لغة التجميع"
+sidebar_position: 2
+
+---
+
+## التعريف بها
+
+لغة التجميع هي من أقدم اللغات البرمجية وهي أقدم لغة يتم استعمالها في عصرنا الحاضر وإن كان استخدامها قد قلَّ بسبب ظهور ما هو أحدث منها.
+
+## مكانتها
+
+تعد لغة التجميع عنصر مفصلي مهم في تأريخ البرمجة إذ أنها أول محاولة ناجحة لتقريب لغة الآلة الثنائية إلى المبرمجين لتمكن لهم كتابة البرامج المتنوعة
+
+وتعد أيضًا اللغة الأقرب للغة الآلة بل يمكن أن نقول أنها لغة الآلة ذاتها لكن بصورة مبسطة بعيدة عن الأصفار والواحدات
+
+## تكوينها وطريقة عملها
+
+تتواصل لغة التكوين مع قطع الحاسوب المادية بشكل مباشر وتقوم بالتعديل في ذاكرة الحاسوب العشوائية بلا وساطة مما يشكل خطرًا كبيرًا في حالة وقع خطأ من المبرمج.
+
+لكن هذا الأمر كان إيجابيًا في الوقت ذاته إذ أن انعدام الوساطة بين الحاسوب والبرنامج يؤدي إلى تنفيذ الأوامر بأقصى سرعة ممكنة دون وجود بطء ناتج من عملية ترجمة الأوامر البرمجية إلى أوامر يفهمها الحاسوب
+
+## مثال عليها
+
+المثال التالي يطبع جملة ( Hello World ) بلغة التجميع ويظهرها أمام المستخدم
+
+```asm6502
+section .data
+ hello: db 'Hello world!',10 ; في البداية نقوم بتحديد الجملة التي نريد طباعتها
+ helloLen: equ $-hello ; نطلب من الكمبيوتر اعطاءنا عدد الحروف في الجملة لغرض حجز مكان يكفي في الذاكرة العشوائية للنتيجة المرادة 
+section .text
+ global _start 
+_start: 
+; هذا الجزء من الأوامر يطلب من الحاسوب استدعاء أمر الطباعة
+ mov eax,4
+ mov ebx,1
+; هذا الجزء يطلب طباعة الجملة
+ mov ecx,hello
+ mov edx,helloLen
+; هذا الجزء ينبه الحاسوب بانتهاء الأوامر المرادة وإغلاق التطبيق
+ int 80h
+ mov eax,1
+ mov ebx,0
+ int 80h;
+```
+
+النتيجة:
+
+```
+Hello World
+```

basics-doc/لغات البرمجة/ماهيتها.md

@@ -0,0 +1,18 @@
+---
+title: "ماهيتها"
+sidebar_position: 1
+---
+
+## نبذة تأريخية
+
+كما أن للبشر لغات يتكلمون بها ويتواصلون مع بعضهم, للحاسوب أيضًا لغة يتفاعل بها وتُكتب فيها الأوامر تسمى اللغة " الثنائية " وتتكون من حرفين " 0 " و " 1 " فهي محصورة في احتمالين فقط إما " 0 " ويعني أن الدائرة الكهربائية مغلقة و " 1 " الذي يعني أن الدائرة الكهربائية مفعلة. ثم يحول الحاسوب هذه الإشارات الكهربائية إلى أوامر ويخرج منها بنتائج.
+
+## ظهور لغات البرمجة
+
+تصعب على الإنسان كتابة الصفر والواحد وخصوصًا على المدى البعيد ولو افترضنا هذا ممكنًا فسيصعب قراءة الأمر البرمجي وخاصةً إن كان الأمر طويلًا مما أدى إلى ظهور لغات البرمجة: وهي رموز وحروف يمكن للإنسان قراءتها وفهمها ثم يقوم الكمبيوتر بتحويلها إلى لغة الصفر والواحد.
+
+مثال:
+
+``` Hello World -> 01001000 01100101 01101100 01101100 01101111 00100000 01110111 01101111 01110010 01101100 01100100 ```
+
+تقوم أداة تسمى " المترجم " بتحويل الكلمة التي يكتبها المبرمج إلى أصفار وواحدات يمكن للحاسوب فهمها وتطبيقها مما أدى إلى تسهيل عملية كتابة الأوامر البرمجية وجعلها قريبة من المبرمج ويستطيع الحاسوب قراءتها في الوقت ذاته