مساعدة API ميدياويكي
هذه صفحة توثيق ميدياويكي API التي تم إنشاؤها تلقائيا.
وثائق وأمثلة: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=wbformatvalue
(main | wbformatvalue)
- هذه الوحدة تتطلب صلاحيات القراءة.
- المصدر:WikibaseClient
- الترخيص: GPL-2.0-or-later
يهييء DataValues.
معلمات محددة:
المعلمات العامة الأخرى متاحة.
- generate
صيغة الناتج المطلوب للتوليد.
- إحدى القيم التالية: text/html، text/html; disposition=verbose، text/html; disposition=verbose-preview، text/plain، text/x-wiki
- الافتراضي: text/x-wiki
- datavalue
البيانات للتهيئة. هذا ينبغي أن يكون تسلسل JSON لكائن DataValue.
- هذه المعلمة مطلوبة.
- datatype
نوع بيانات القيمة. هذا مختلف عن نوع القيمة
- إحدى القيم التالية: commonsMedia، external-id، geo-shape، globe-coordinate، monolingualtext، quantity، string، tabular-data، time، url، wikibase-item، wikibase-property
- property
رقم الخاصية الذي تنتمي له قيمة البيانات، ينبغي أن يتم استخدامه بدلا من معامل datatype.
- options
الخيارات التي يجب أن يستخدمها المُنسِّق. يتم توفيرها ككائن JSON.
الخيارات المدعومة هي:
- lang
- اللغة التي يجب تنسيق القيمة بها (كود لغة ميدياويكي).
- applyRounding
- ما إذا كان سيتم تطبيق التقريب على الرقم. يمكن أن يكون قيمة منطقية (تلقائية / بدون تقريب) أو عدد صحيح (أس آخر أرقام عشرية مهمة). مفيد فقط لقيم الكمية.
- applyUnit
- ما إذا كان سيتم تضمين الوحدة في الناتج (قيمة منطقية). مفيد فقط لقيم الكمية.
- showcalendar
- ما إذا كان سيتم عرض نموذج التقويم. يمكن أن يكون قيمة منطقية (دائمًا / لا يتم عرضها أبدًا) أو السلسلة
"auto"(تحديد ما إذا كان سيتم العرض تلقائيًا). مفيد فقط لقيم الوقت.
أمثلة:
- تنسيق قيمة سلسلة بسيطة.
- api.php?action=wbformatvalue&datavalue=%7B%22value%22%3A%22hello%22%2C%22type%22%3A%22string%22%7D [فتح في ملعب]
- تنسيق قيمة سلسلة كURL في HTML.
- api.php?action=wbformatvalue&datavalue=%7B%22value%22%3A%22http%3A%5C%2F%5C%2Facme.org%22%2C%22type%22%3A%22string%22%7D&datatype=url&generate=text%2Fhtml [فتح في ملعب]
- تنسيق قيمة الوقت كنص عادي، مع إظهار نموذج التقويم تلقائيًّا إذا لزم الأمر.
- api.php?action=wbformatvalue&datavalue=%7B%22value%22%3A%7B%22time%22%3A%22%2B1879-03-14T00%3A00%3A00Z%22%2C%22timezone%22%3A0%2C%22before%22%3A0%2C%22after%22%3A0%2C%22precision%22%3A11%2C%22calendarmodel%22%3A%22http%3A%5C%2F%5C%2Fwww.wikidata.org%5C%2Fentity%5C%2FQ1985727%22%7D%2C%22type%22%3A%22time%22%7D&datatype=time&generate=text%2Fplain&options=%7B%22showcalendar%22%3A%22auto%22%7D [فتح في ملعب]