ويكي الدوال:مقدمة

تُجري الدوال العمليات الحسابية بناءً على البيانات التي تُزوّدها بها.

ويكي الدوال مشروع مفتوح المصدر يمكّن أي شخص من إنشاء الدوال ومشاركتها مع الآخرين لاستخدامها وتعديلها واختبارها والتعلّم منها.

استخدم الأدلة الإرشادية التالية لتجربة الميزات الأساسية لويكي الدوال. نتطلع لتعليقاتكم ومساهماتكم!

قيّم دالة

يمكنك بنفسك! تجربة الدوال التي ساهم بها المجتمع على ويكي الدوال، اختر واحدة من مكتبة الدوال وأدخل قيم المُدخلات لاكتشاف المخرجات.

خطوات:

1. ابحث عن دالة على الصفحة الرئيسية

   

2. توجّه إلى صفحة الدالة.

   

3. أدخل قيم المدخلات.

   

4. شغّل الدالة.

   

النتائج:

1. هل كان الناتج كما توقّعته؟
2. هل لديك تصويبات أو تعليقات لتبلغ عنها؟

After you run a function, use the 'Copy result link' button beneath the result panel to copy a shareable URL. When someone opens that link, Wikifunctions preloads the same function call and runs it automatically, so they see the inputs and result exactly as you did. This is a quick way to demonstrate reproducible examples or ask others for help with a specific function input/output.

Steps (continue from "Evaluate a Function"):

1. After the result loads, click 'Copy result link' under the result panel.

   

2. Share the URL with others!

Note: the shared link preloads your exact inputs and runs them again, so recipients see the same result unless the underlying implementation has changed since you generated the link.

إنشاء دالة

يمكنك إضافة الدوال الخاصة بك إلى ويكي الدوال! أنشئ دالة جديدة لاستخدامها في تطبيقاتك الخاصة ولتمكين الآخرين من استخدامها أيضًا. يمكنك كتابة دوال جديدة باللغة المفضّلة لديك.

خطوات:

1. توجّه إلى صفحة إنشاء دالة.

   

2. اكتب اسمًا للدالة.

   

3. عرّف مُدخلات الدالة:
   1. إضافة/إزالة حقول الإدخال.
   2. حدد النوع لكل إدخال.
   3. أعطِ اسمًا لكل إدخال.

   

4. حدد نوع مخرجات الدالة.

   

5. اختياري، وفّر قيمًا متعددة اللغات لأيّ من هذه الحقول:
   • اسم الدالة، تسميات أخرى، ومسميّات حقول الإدخال.

   

6. انشر الدالة.

   

النتائج:

1. هل نُشرت الدالة بنجاح؟
2. هل لديك تصويبات أو تعليقات لتبلغ عنها؟

تحرير دالة

يمكنك المساهمة في ويكي الدوال عبر تحرير مكتبة الدوال الخاصة بها. أضف أو عدّل معلومات متعددة اللغات للدوال، وقم بتوسيع وتغيير تعريفات الدوال.

خطوات:

1. ابحث عن دالة في الصفحة الرئيسية.

   

2. توجّه إلى صفحة الدالة.

   

3. انقر على عدل المصدر للاطلاع على خيارات التعديل لهذه الدالة.

   

4. اختياريًا، عدّل قيم:
   1. اسم الدالة،
   2. الأسماء المستعارة للدالة،
   3. قائمة المدخلات
      1. إضافة/إزالة حقول الإدخال
      2. تعدبل نوع الإدخال
      3. تعديل تسميات الإدخال
   4. نوع الإخراج
5. اختياريًا، قدّم قيمًا متعددة اللغات لأي من هذه الحقول:
   1. اسم الدالة
   2. الأسماء المستعارة للدالة
   3. تسميات الإدخال
6. انشر تحديثاتك.

النتائج:

1. هل نُشرت تعديلاتك بنجاح؟
2. هل لديك تصحيحات أو ملاحظات تودّ الإبلاغ عنها؟

إنشاء اختبارات

يمكنك إنشاء اختبارات لتنفيذات الدوال الخاصة بك في ويكي الدوال وذلك للتأكد من أنها تعمل كما ينبغي.

خطوات:

1. ابحث عن دالة في الصفحة الرئيسية أو نفس الدالة التي أنشأتها في سير العمل السابق.

   

2. توجّه إلى صفحة الدالة.

   

3. انقر على الرابط "+" في جدول الاختبارات.

   

4. انقر فوق "$select_function" تحت «استدعاء».
   1. في الحقل تحت «دالة»، اكتب اسم الدالة التي تختبرها واختر الدالة عندما تظهر.
   2. أضف قيمًا للمدخلات في الحقول المخصصة.

   

5. انقر على "$select_function" تحت «التحقق من صحة النتيجة». في الحقل تحت «دالة»، اكتب اسم الدالة التي تريد استخدامها للتحقق من صحة النتيجة.
   1. In the field under "Function", type in the name of the function you want to use to check the result.
   2. بالنسبة لدالة مخرجاتها سلسلة، ستكون هذه «تساوي سلسلة»، ولدالة إخراجها بولياني «منطقي»، ستكون هذه «تساوي بولياني».
   3. أضِف القيمة المتوقعة في الحقل المُعطى (سواء «السلسلة الثانية» أو «البولياني الثاني»).

   

6. انشر تحديثاتك.

النتائج:

1. هل نُشر الاختبار بنجاح؟
2. هل لديك تصحيحات أو ملاحظات تودّ الإبلاغ عنها؟

إنشاء تنفيذ

تُصبح الدوال حيّة وقابلة للاستخدام عبر تنفيذات تُنشأ خصيصًا لتلبية احتياجاتك. في ويكي الدوال يمكنك تشغيل الدوال، تعديلها، أو دمجها باستخدام هذه التنفيذات. راجع القسم أدناه لمعرفة كيفية وصل تنفيذك بدوال. نوصي بإنشاء ووصل اختبار قبل إنشاء التنفيذ. يتوفر دليل أكثر شمولاً لإنشاء التنفيذات على Wikifunctions:How to create implementations.

خطوات:

1. ابحث عن دالة في الصفحة الرئيسية.

   

2. توجّه إلى صفحة الدالة.

   

3. انقر على الرابط "+" في جدول التنفيذات.
4. يمكنك إنشاء تنفيذ جديد بإحدى طريقتين:
   1. نص برمجي
      • اختر لغة البرمجة المطلوبة لكتابة النص البرمجي للدالة.
      • أدخل النص البرمجي الخاص بك.
   2. تركيب:
      • أنشئ تركيبًا باستخدام دوال موجودة.

   

5. انشر تحديثاتك (بعد النقر على السهم الدائري على يمين الصندوق المعنون بـ الاختبارات، وذلك لتجربة حالات الاختبار مع التنفيذ).

النتائج:

1. هل نُشر التنفيذ بنجاح؟
2. هل لديك تصحيحات أو ملاحظات تودّ الإبلاغ عنها؟

وصل تنفيذ أو اختبار بدالة ما

ملاحظة: هذه الميزة متاحة فقط للمسيّرين.

وصّل الاختبارات والتنتفيذات بالدالة لتراها وهي تعمل.

خطوات:

1. ابحث عن دالة في الصفحة الرئيسية.

   

2. توجّه إلى صفحة الدالة.

   

3. اختر اختبارًا واحدًا أو أكثر، أو تنفيذًا واحدًا أو أكثر.

   

4. انقر على الزر “وصل”.

النتائج:

1. هل تغيّرت الحالة (موصول/مفصول) بنجاح؟
2. هل لديك تصحيحات أو ملاحظات تودّ الإبلاغ عنها؟

إدراج دالة في مقالة ويكيبيديا

حان الوقت الآن لإدراج دالة في مقال ويكيبيديا ومشاهدة النتائج.

خطوات:

1. افتح المقالة التي ترغب بإضافة دالة إليها.

   

2. اذهب إلى تبويب عدل وافتح المحرر المرئي.

   

3. انقر على قائمة «إدراج» أعلى المحرر المرئي. مرر لأسفل وانقر على «دالة». سيُفتح مربع حوار.

   

4. ابحث عن الدالة التي ترغب بإدراجها وانقر عليها. أو جرّب إحدى الدوال المقترحة أسفل شريط البحث.

   

5. أدخل المدخلات اللازمة وانقر على زر «إدراج» أعلى اليسار لإدراج الدالة في المقالة.

   

6. يمكنك الآن رؤية مخرجات الدالة في المقالة. يمكنك المتابعة بعدها لنشر التغييرات.

   

7. إذا أردت تعديل الدالة، انقر عليها. ستظهر نافذة منبثقة تحمل اسم الدالة ووصفها. انقر على زر «تعديل».

   

8. بعد ذلك، يمكنك إجراء التغييرات على المدخلات والنقر على «طبق التعديلات» عند الانتهاء من التعديل.

   

النتائج:

1. هل كانت المخرجات كما توقّعت؟
2. هل لديك تصحيحات أو ملاحظات تودّ الإبلاغ عنها؟