Jump to content

ويكي دوال:الأسئلة الشائعة

From Wikifunctions
This page is a translated version of the page Wikifunctions:FAQ and the translation is 98% complete.
Outdated translations are marked like this.
اختصار:
WF:FAQ

هذه صفحة مخصصة للأسئلة الشائعة حول وظائف ويكي. من فضلك، لا تتردد في طرح سؤالك الخاص في صفحة النقاش، إذا لم يكن سؤالك مدرجًا هنا!

يرجى أيضًا الاطلاع على الأسئلة الشائعة على ميتا بخصوص المزيد من الأسئلة العامة حول ويكي دوال وويكيبيديا المجردة.

المقدمة

ما هو هذا المشروع؟

ويكي دوال هو مشروع ويكيميديا ​​جديد يوفر قائمة بجميع أنواع الدوال التي يمكن لأي شخص الاتصال بها وكتابتها وصيانتها واستخدامها. كما أنها توفر التكنولوجيا الأساسية التي ستمكن في النهاية من ترجمة المقالات المستقلة لغويا من ويكيبيديا المجردة إلى ويكيبيديا بأي لغة. سيسمح هذا للجميع بالمساهمة وقراءة المقالات بلغاتهم المفضلة.

ما هي الدالة؟

الدوال هي شكل من أشكال المعرفة التي يمكنها الإجابة على الأسئلة، مثل عدد الأيام التي مرت بين تاريخين أو المسافة بين مدينتين. يمكن للدوال الأكثر تعقيدًا أن تجيب على أسئلة أكثر تعقيدًا، مثل قيمة حجم شكل ثلاثي الأبعاد، أو المسافة بين المريخ والزهرة في تاريخ معين، أو ما إذا كان هناك نوعان على قيد الحياة في نفس الوقت.

نحن نستخدم بالفعل الدوال في العديد من أنواع الاستعلامات المعرفية، مثل طرح سؤال على محرك البحث. القوالب، مثل قالب:تحويل و قالب:العمر في ويكيبيديا الإنجليزية، هي أيضًا أمثلة على الدوال المستخدمة بالفعل في العديد من الويكيبيديات، المكتوبة في نصوص الويكي و وحدات لوا ونسخها يدويًا إلى كل ويكي حيثما تم احتياجها.

ما هو التنفيذ (التطبيق)؟

التنفيذ هو طريقة معينة لتنفيذ دالة. التنفيذ عبارة عن وصفة تسرد الخطوات المطلوبة لتشغيل الدالة. قد يكون جزءًا من التعليمات البرمجية في لغة برمجة أو مجموعة من الاستدعاءات لوظائف أخرى. قد يكون للوظيفة العديد من التطبيقات، والتي يجب أن تكون جميعها متكافئة.

ما هو الاختبار؟

الاختبار هو وسيلة لتحديد ما إذا كانت دالة معينة تفعل الشيء الصحيح. عادةً ما تحتوي الدالة على عدة اختبارات، يحدد كل منها بعض المدخلات للدالة والشروط التي يجب أن يستوفيها مخرج الإدخال المحدد.

على سبيل المثال، قد يتضمن مختبرو دالة "حالة العنوان" ما يلي: "abc" يجب أن يصبح "Abc"؛ "war and peace" يجب أن يصبح "War and Peace"؛ "война и мир" يجب أن يصبح "Война и мир"؛ و"123" يجب أن يظل "123".

ما هي الميزات المتوفرة الآن، والتي ستكون متاحة قريبًا، وما هي الميزات البعيدة؟

  • عند الإطلاق:
    • لدينا إمكانية الحصول على دوال تعمل مع السلاسل النصية والبوليانية.
    • سيتم تدويل ويكي دوال بالكامل من البداية. ويمكن استخدامها بأي لغة.
  • تطوير مستمر:
    • الأنواع العامة والدوال العامة غير مدعومة بشكل كامل.
    • ستكون إضافة الأنواع، في الوقت الحالي، أمرًا يقتصر على فريق التطوير. وفي المستقبل، سيتمكن المجتمع من إضافة المزيد من الأنواع. هناك الكثير من العمل الذي يتعين القيام به في المستقبل لجعل الأنواع تتصرف بشكل أكثر سلاسة.
      • أحد الأنواع المثيرة للاهتمام بشكل خاص هو البيانات الثنائية، وخاصة الملفات.
    • نحن ندعم حاليًا لغتي برمجة لعمليات التنفيذ: جافاسكريبت وبايثون. وفي المستقبل، نريد دعم المزيد.
    • حاليًا، غير ممكن استدعاء دوال أخرى من التنفيذات المكتوبة بأي لغة برمجة. وهذا ممكن حاليًا فقط من خلال التكوين.
  • في المستقبل:
    • سيكون من الممكن استدعاء دوال ويكي دوال من مشاريع ويكيميديا أخرى ودمج النتائج المحصل عليها في إصدار الصفحة.
    • سيكون من الممكن استخدام البيانات من ويكي بيانات في الدوال.
    • سيكون من الممكن استدعاء مجموعات البيانات من نطاقات البيانات المعروفة.

كيف تكون ويكي دوال متعددة اللغات؟

ويكي دوال وويكيبديا المجردة متعددة اللغات بعدة طرق مختلفة والتي لا تؤثر بعضها ببعض:

  • "'ويكي دوال متعدد اللغات من حيث المحتوى وواجهة المستخدم."' يمكن للمستخدمين قراءة و استدعاء وظائف على ويكي دوال بأي لغة طبيعية. هنا مثلا دالة "الإضافة إلى السلسلة" بالإنجليزية, بالبولوندية، وبالعبرية, و هذه الدالة متاحة بالعديد من اللغات.
  • "'المساهمين يمكنهم تحرير وتحسين ويكي دوال باستخدام لغتهم."' حتى التنفيذات يمكن تحريرها باللغة الطبيعية للمساهمين. على سبيل المثال تركيب دالة "و" يمكن تحريرها باللغات الألمانية, الإنجليزية، أو أي لغة أخرى يعني حوالي 300 لغة.
  • "'دوال ويكي دوال يمكن استخدامها لخلق نتائج لأي لغة طبيعية."' المجتمع ينشأ عدد متزايد من الدوال لدعم توليد النصوص في العديد من اللغات الطبيعية. لدينا دوال بريتون, الروهنجيا, الإنجليزية و العديد من اللغات الأخرى.
  • "الدوال في ويكيدوال يمكن تطبيقها بمختلف لغات البرمجة."' على سبيل المثال، دالة الضم يتم تنفيذها بكل من جافا سكريبت و بايثون.

ما هي لغات البرمجة التي تدعمها ويكيدوال حاليا؟ وما هي لغات البرمجة التي سيتم دعمها في المستقبل؟

حاليًا، ويكي دوال تدعم تطبيقات مكتوبة بجافا سكريبت وبايثون. ونحن نخطط لإضافة دعم لغات برمجة أكثر في المستقبل. ونأمل بإضافة لغة برمجة واحدة أخرى في الأقل في 2025 (ولكن لم تقرر بعد أي واحد).

كيف يمكن لويكي دوال تتكامل مع المشاريع الأخرى؟

ويكي_دوال هي الخطوة الأولى نحو بناء ويكيبيديا المجردة. سينصب تركيزنا في المدى القريب على دعم المجتمع وإجراء تحسينات بناءً على الملاحظات. بالتزامن مع ذلك، سنبدأ عملية دمجه مع ويكيبيديا وويكي بيانات، مما سيمكن من تطبيقات واقعية أوسع ويقربنا من رؤية ويكيبيديا المجردة.

سيتمكن المساهمون من استدعاء الدوال المخزنة على موقع ويكي_دوال من داخل مواقع الويكي الخاصة بهم. ستُعرض نتيجة استدعاء الدالة لقراء الويكي. يمكن استخدام ذلك، على سبيل المثال، لحساب عمر شخص ما، أو الكثافة السكانية بناءً على بيانات السكان والمساحة من ويكي بيانات، أو لرسم بياني ودمجه في مقالة معينة.

هناك خيار آخر لدمج ويكي_دوال، وهو تضمين واجهة تفاعلية لاستدعاء الدوال داخل الويكي. يمكن استخدام ذلك، على سبيل المثال، في مقالة ويكيبيديا لحساب نتيجة معادلة فيزيائية بشكل ديناميكي بناءً على متغيرات يقدمها القارئ، أو لرسم الدوال الرياضية والتفاعل معها، وغير ذلك.

ما الذي لا تمثله ويكي_دوال؟

من فضلك، راجع ويكي_دوال:ويكي دوال ليست لمزيد من المعلومات حول ذلك.

تحت أي ترخيص ستكون الدوال والمحتوى المشتق؟

بناءً على النقاش الذي جرى في ميتا خلال شهري نوفمبر وديسمبر 2021، ستكون جميع المساهمات في ويكي_دوال وفي مشاريع ويكيبيديا المجردة عمومًا متاحةً تحت تراخيص حرة. وتحديدًا:

هناك بعض الأمور التي سيتم تناولها مستقبلًا، مثل مسألة ترخيص المحتوى المُوَلَّد من المحتوى المُجَرَّد. ننوي إعداد وثيقة أشمل مع القسم القانوني حول كيفية إعادة استخدام الرموز البرمجية من ويكي دوال بسهولة، مع مراعاة شروط الترخيص.

المساهمة

أنا جديد هنا. ما الذي يجب علي فعله وكيف يمكنني المساعدة؟

أهلًا وسهلًا بك! يسعدنا جدًا انضمامك إلينا! هناك العديد من الفرص للمساهمة في ويكي دوال، من إنشاء دوال جديدة إلى تحسين وترجمة التوثيق. إذا كنت تبحث عن طرق للمشاركة، نقترح عليك حسب قدرتك اقتراح دالة جديدة حول موضوع يهمك، أو حتى إنشاء هذه الدالة، أو توفير بعض الاختبارات، أو تجربة كتابة تنفيذ، أو المساعدة في الترجمة، أو قراءة التوثيق وتحسينه، أو المساعدة في تنظيم المجتمع.

كيف يمكنني إنشاء دالة أو تنفيذ أو اختبار جديد؟

لمعرفة كيفية إنشاء دالة جديدة أو تنفيذ أو اختبار، راجع ويكي دوال:تقديم.

لمعرفة المزيد من التفاصيل حول كيفية إنشاء تنفيذات، راجع ويكي دوال: كيفية إنشاء تنفيذات.

ما الذي يجب أن أقوم بتحريره أولاً؟

إذا كنت تستطيع الكتابة بعدة لغات، ابحث عن الدوال التي لا تملك تسمياتٍ وأوصافًا بلغتك بعد، وساعد في إضافتها.

إذا كان لديك اهتمام بمجال يمكن أن يضم دوال في ويكي دوال، ولكنه لا يضمها بعد، أو إذا كانت لديك المزيد من الأفكار للدوال، فانتقل إلى صفحة اقتراح دوال جديدة، واعرض أفكارك.

إذا كنتَ مُبرمجًا بلغة جافا سكريبت أو بايثون، فربما ترغب في التحقق من الدوال التي لا تملك تنفيذات بلغة جافا سكريبت أو بايثون حتى الآن، ومُحاولة كتابتها.

أين يمكنني الذهاب للحصول على المساعدة؟

يجب أن تكون محطتك الأولى هي بوابة المساعدة حيث ستجد جميع الوثائق المتعلقة باستخدام وتحرير ويكي دوال. إذا كنت لا تزال تواجه مشكلة، فانشر رسالة على دردشة المشروع ، وسيقوم شخص ما بالإجابة على سؤالك.

كيف نقوم بفرز أو تصنيف الدوال؟

Tracked in Phabricator:
Task T285424

في الوقت الحالي، أفضل طريقة لفرز أو تصنيف الدوال هي القيام بذلك يدويًا من خلال الصفحات في نطاق ويكي دوال. خيار آخر سيكون من خلال صفحة نقاش الدالة المعنية. سنراقب هذه الجهود، وسنناقش مع المجتمع التغييرات التي ستكون مفيدة لهذه المهمة في النظام.