امتداد:الرياضيات

This page is a translated version of the page Extension:Math and the translation is 99% complete.

Outdated translations are marked like this.

Languages:

**الدليل المرجعي لامتدادات ميدياويكي**
Math حالة الإصدار مستقر

تنفيذ	وسم
بيان	يسمح بعرض الصيغ الرياضية
المؤلف/المؤلفون	موريتز شوبوتز، توماس فيجرزانوفسكي، بروك فايبر، يوهانس ستيغمولر، أندريه غرينر بيتر، وغيرها
آخر إصدار	تحديثات مستمرة
سياسة التوافق	تصدر اللقطات البرمجية مع ميدياويكي. الإصدار الرئيسي لا يتوافق مع الإصدارات السابقة.
تغييرات قاعدة البيانات	نعم
جداول math mathoid mathlatexml
المتغيرات $wgMathEnableWikibaseDataType $wgMathDefaultLaTeXMLSetting $wgMathoidCli $wgMathMathMLUrl $wgMathFullRestbaseURL $wgMathLaTeXMLUrl $wgMathInternalRestbaseURL $wgMathConcurrentReqs $wgMathTexMaxLength $wgMathValidModes $wgMathWikibasePropertyIdSymbolRepresents $wgMathEntitySelectorFallbackUrl $wgMathEnableExperimentalInputFormats $wgMathWikibasePropertyIdQuantitySymbol $wgMathDisableTexFilter $wgMathMathMLTimeout $wgMathWikibasePropertyIdInDefiningFormula $wgMathWikibasePropertyIdHasPart $wgMathEnableFormulaLinks $wgMathWikibasePropertyIdDefiningFormula $wgMathLaTeXMLTimeout $wgMathTexVCService $wgMathSvgRenderer $wgMathHTTPProxy
الوسوم `‎<math>`
الروابط المستخدمة EditPage::showEditForm:initial GetPreferences LoadExtensionSchemaUpdates ParserAfterTidy ParserFirstCallInit ParserOptionsDefaults ResourceLoaderGetConfigVars SpecialPage_initList UserGetDefaultOptions WikibaseClientDataTypes WikibaseRepoDataTypes
الروابط المقدمة MathRenderingResultRetrieved MathFormulaPostRender
Licence	رخصة جنو العمومية 2.0 أو ما بعدها
التنزيل	تنزيل الامتداد غت ^[?]: تصفح المستودع (Phabricator · GitHub) مراجعة الكود البرمجي على غيريت تاريخ الالتزام على غت تنزيل المصدر في صيغة تاربول
ترجم الامتداد Math لو كان متوفرا على translatewiki.net
المسائل	المهام المفتوحة · الإبلاغ عن عطل تقني

يوفر امتداد الرياضيات (Math) الدعم لعرض الصيغ الرياضية.

يمكن العثور على مزيد من المعلومات حول تثبيت هذه الإضافة وإعدادها، بما في ذلك الإصدارات الأقدم، على الرابط Extension:Math/advancedSettings .

اطلع على نظرة عامة حول ما يمكن القيام به حالياً باستخدام هذه الإضافة على Extension:Math/Syntax.

التثبيت

هذا الامتداد يأتي مع إصدار ميدياويكي 1.38 وما بعده. يتعيّن أن تتبع كافة تعليمات الضبط الباقية.

نزّل الملف/الملفات وضعها في دليل يحمل اسم ‎Math داخل مجلد ‎extensions/‎ لديك.
يجب على مطوري البرمجيات والمساهمين بالكود البرمجي تثبيت الامتداد من غت بدلا من ذلك، مستخدمين:
```
cdextensions/
gitclonehttps://gerrit.wikimedia.org/r/mediawiki/extensions/Math
```
أضف الكود التالي في الجزء الأسفل من ملف LocalSettings.php :
```
wfLoadExtension( 'Math' );
```
إذا كنت تستخدم إصداراً من ميدياويكي يسبق الإصدار 1.42، فقم بتشغيل البرنامج النصي update.php لإنشاء جداول قاعدة البيانات اللازمة. لم يعد هذا ضرورياً إذا كنت تقوم بتثبيت الامتداد في ميدياويكي 1.42 أو إصدار أحدث.
لرؤية الصيغ الرياضية بتنسيق يتجاوز مجرد النص العادي، اتبع التعليمات أدناه لتفعيل مختلف أنماط عرض الصيغ الرياضية.
إذا واجهت مشاكل في تمثيل الصيغ عند محاولة استخدام RESTBase، فيمكنك تجربة استخدام patch التالي.
Yes تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.

تنصيب Vagrant:

لو كنت تستخدم Vagrant ، ثبته مستخدما vagrant roles enable math --provision

علاوةً على ذلك، ينبغي عليك زيارة الصفحة Special:MathStatus للتحقق مما إذا كانت جميع مكونات امتداد Math تعمل الآن. بالنسبة لأي مشكلات تواجهها، فإن الخيار الأفضل هو إنشاء مهمة على https://phabricator.wikimedia.org.

للأسف، لا يوجد دليل مُختبَر جيداً لتثبيت Mathoid وRESTBase للعمل مع امتداد Math، ولكن توجد على الأقل مسودة قابلة للاستخدام. Extension:Math/RESTBase ، يرجى المساهمة.

بالإضافة إلى ذلك، يتوفر [دليل على غت هب لتثبيت وإعداد ميدياويكي مع RESTBase وMathoid في الإصدار ميدياويكي 1.28].

الاستخدام

بمجرد التثبيت، يمكنك كتابة المعادلات باستخدام صيغة ترميز TeX داخل الوسم ‎<math>. على سبيل المثال:

<math>E=mc^2</math>

النتيجة كما يأتي:

$E = m c^{2}$

عرض الرياضيات

يعتمد نوع المخرجات على البرنامج الذي تستخدمه لقراءة الصفحة. إذا أمكن ذلك، تُخرج انتداد Math صيغة MathML. وبخلاف ذلك، فإنها تُخرج صوراً بصيغة SVG (مع تحويل المحارف إلى عناصر <path>) أو PNG. يعمل دعم الرياضيات الأساسية مع جميع المتصفحات، ولكن للحصول على أفضل النتائج، قد تحتاج إلى تغيير إعداداتك:

بالنسبة لمتصفح فايرفوكس أو غيره من المتصفحات القائمة على محرك جيكو، ثبّت إضافة Native MathML وخطوط الرياضيات.
توفر برامج قراءة الشاشة NVDA وVoiceOver وOrca دعماً لإمكانية الوصول. لقراءة الرياضيات، يحتاج برنامج NVDA إلى الملحق MathPlayer.
بالنسبة لمتصفح سفاري أو غيره من المتصفحات القائمة على محرك ويب كيت، يمكنك أيضاً تثبيت خطوط رياضية وتفعيل العرض الأصلي لـ MathML عن طريق إدراج بعض قواعد CSS في ورقة الأنماط المخصصة لمتصفحك.
يوفر قارئ الشاشة VoiceOver دعماً لإمكانية الوصول، في حين أن قارئ الشاشة Orca لا يوفر ذلك بعد.
بالنسبة لمتصفح كروم، يجب عليك إدراج بعض قواعد CSS في ورقة الأنماط المخصصة للمتصفح للحصول على دعم إمكانية الوصول باستخدام قارئ الشاشة ChromeVox أو العرض المرئي باستخدام الملحق MathJax.

إعدادات الضبط

اسم الإعداد	القيمة الافتراضية	الوصف
$wgMathValidModes	`[ 'source', 'native', 'mathjax' ]`	يحدد الوضع المسموح به على الخادم.
$wgMathDisableTexFilter	`'new'`	To access this at run-time, use MathConfig::texCheckDisabled(). Do not use the non-normalized configuration directly.
$wgMathFullRestbaseURL	`'https://wikimedia.org/api/rest_'`	تحصل إضافة الرياضيات على الإعدادات الافتراضية من المحرر المرئي، إن توفرت. التفاصيل.
$wgMathPreferRestbaseURL	`true`	(رفع) ما إذا كان ينبغي السماح باستخدام مسار RESTBase الداخلي بدلاً من $wgMathFullRestbaseURL و$wgVisualEditorFullRestbaseURL. اضبط القيمة على 1 إذا كنت ترغب في استخدام RESTBase خارجي في جميع الحالات.

أوضاع الرياضيات

يحتوي الإعداد $wgMathValidModes على مصفوفة بأسماء أوضاع الإخراج التي يمكن استخدامها لعملية العرض (الرندر). في حال تفعيل أوضاع متعددة، يمكن للمستخدمين المسجلين تحديد تفضيلاتهم الشخصية من خلال قسم المظهر في صفحة تفضيلات المستخدم الخاصة بهم.

يمكنك أيضاً استخدام الإعداد $wgDefaultUserOptions لتحديد أي من هذه الأوضاع يجب أن يكون الوضع الافتراضي، على سبيل المثال:

$wgDefaultUserOptions['math'] = 'mathml';

Mathoid

الوضع: 'mathml'

تحذير تحذير: لم يعد Mathoid قيد التطوير النشط، وذلك لصالح وضع MathML الأصلي. سيتم إيقاف تطويره في نهاية المطاف.

يمكنك استخدام Mathoid، وهو تطبيق يستخدم MathJax من جهة الخادم لتحويل مدخلات texvc إلى صيغة عرض MathML+SVG. تُعد Mathoid حالياً وضع عرض المعادلات الرياضية المستخدم في ويكيبيديا.

Mathoid كخدمة

تُعد "Mathoid كخدمة" النهج الموصى به والافتراضي لامتداد Math. ففي حال عدم إضافة أي إعدادات إضافية إلى ملف LocalSettings.php، سيستخدم الامتداد خدمات Mathoid وRESTBase الخاصة بمجمع البيتا لتوليد وعرض جميع الصيغ الرياضية. وتتمثل الإعدادات الافتراضية فيما يلي:

// تعيين MathML كخيار العرض الافتراضي
$wgDefaultUserOptions['math'] = 'mathml';
$wgMathUseInternalRestbasePath = false;
$wgMathFullRestbaseURL = 'https://wikimedia.org/api/rest_';
$wgMathMathMLUrl = 'https://mathoid-beta.wmflabs.org';

تحذير تحذير: تخطط مؤسسة ويكيميديا لإيقاف خدمات "1 دولار"، بما في ذلك نقطة نهاية Mathoid التي يستخدمها امتداد Math بشكل افتراضي، وذلك رغم عدم تحديد موعد نهائي للخدمة حتى الآن. بالنسبة للمواقع التي تستخدم إصدارات أحدث من ميدياويكي، يُنصح باستخدام وضع MathML الأصلي بدلاً من ذلك.

يمكنك تعديل هذه الإعدادات لاستخدام خدمات Mathoid وRESTBase مختلفة، بما في ذلك ربما خدماتك الخاصة.

واجهة سطر الأوامر لـ Mathoid

بدلاً من ذلك، يمكنك تشغيل Mathoid كأداة سطر أوامر على الخادم المحلي. لاستخدام هذا الأسلوب، يُوصى بالإعدادات التالية:

// تعيين MathML كخيار العرض الافتراضي
$wgDefaultUserOptions['math'] = 'mathml';
// يرجى إنشاء ملف config.yaml مسبقاً. توجد القوالب في مستودع Mathoid.
$wgMathoidCli = ['/path/to/mathoid/cli.js', '-c', '/path/to/mathoid/config.yaml'];
// ارفع حد الذاكرة في ميدياويكي إلى 1.2 جيجابايت من أجل Mathoid.
$wgMaxShellMemory = 1228800;

إذا كنت تشغّل ميدياويكي على نظام يتضمن SELinux وظهرت لك الرسالة Mathoid cli '/path/to/mathoid/cli.js' is not executable في سجل الأخطاء، فيمكنك تنفيذ الأمر التالي للتأكد من أن خادم Apache يسمح بتغيير حدود النظام:

setsebool -P httpd_execmem 1
setsebool -P httpd_setrlimit 1

LaTeX

إصدار ميدياويكي:

≤ 1.39

الوضع: 'png'

بدءاً من الإصدار 1.32 من ميدياويكي، سيتطلب هذا الوضع أيضاً خادم Mathoid ليعمل. في الإصدارات الأقدم، يتطلب الأمر تثبيت texvc وtexvccheck، وهي الخطوة التي قد تستلزم أكبر قدر من العمل لإعدادها.

LaTeXML

الوضع: 'latexml'

يستخدم أداة LaTeXML. تتم عملية العرض (الرندر) عبر خدمة عبر الإنترنت (مُحددة ب $wgLaTeXMLUrl، مع قيمة افتراضية https://latexml.formulasearchengine.com/convert).

MathML أصلي

إصدار ميدياويكي:

≥ 1.40

الوضع: 'native'

سيقوم هذا الوضع بتوليد MathML من LaTeX عبر PHP دون استخدام Mathoid. يُرجى ملاحظة أن هذا الوضع لا يتضمن خياراً بديلاً يعتمد على الصور، لذا لن تُعرض الصيغ بشكل صحيح إلا إذا كان المتصفح يدعم MathML. طرح كل من متصفحي فايرفوكس وسفاري الدعم لـ MathML في وقت مبكر (عامي 2006 و2008)، في حين أن هذا الدعم في المتصفحات القائمة على Chromium يُعد إضافة حديثة للغاية (بدءاً من الإصدار 109 لمتصفح كروم، الذي أُطلق عام 2023).

MathJax

إصدار ميدياويكي:

≥ 1.42

الوضع: 'mathjax'

يعمل هذا الوضع بنفس آلية وضع MathML الأصلي (أي توليد MathML من LaTeX باستخدام PHP)، ولكنه يستخدم MathJax 3 لعرض MathML. وبالتالي، سيعمل هذا الحل في المتصفحات التي لا تدعم MathML، مع تحمل عبء تحميل مكتبة MathJax (المُضمَّنة في امتداد Math) عند عرض الصفحة.

تحذير تحذير: سابقاً، وُفر وضع MathJax يعتمد على MathJax 2 في الإصدارات 1.19-1.25 من ميدياويكي. لاستخدام MathJax لعرض الصيغ الرياضية في ميدياويكي 1.26-1.41، طالع Extension:SimpleMathJax .

بدون عرض

الوضع: 'source'

سيقوم هذا الوضع بتمرير مدخلات LaTeX دون معالجتها، وعرضها داخل عنصر ‎<span> محاطاً بـ $ :formula $.

تأكد من ضبط القيمة على $wgMathDisableTexFilter أو 'always' (انظر أدناه) إذا كنت ترغب فقط في الحصول على صيغة LaTeX الخام؛ وإلا فسيظهر خطأ بسبب فشل التحقق من وجود صور PNG.

تصنيفات التتبع

تُنشئ الإضافة عدداً من تصنيفات التتبع لاكتشاف الأخطاء والميزات المُلغاة. تبدأ مفاتيح رسالتهم بـ math-. يمكن للإداريين تغيير اسم فئة التتبع في الويكي عن طريق تعديل قيمة الرسالة في نطاق ميدياويكي الخاص بتلك الويكي. يعرض Special:TrackingCategories اسم كل تصنيف تتبع، ومفتاح الرسالة، والوصف.

صفحة ميدياويكي	افتراضي	الوصف
MediaWiki:Math-tracking-category-error	Category:Pages with math errors	الصفحات التي تحتوي على خطأ في صيغة المعادلة يؤدي إلى فشل العرض.
MediaWiki:Math-tracking-category-render-error	Category:Pages with math render errors	الصفحات التي شهدت خطأً مؤقتاً في مسار المعالجة الرسومية أدى إلى فشل عملية العرض؛ وعادةً ما تُحل هذه المشكلات من تلقاء نفسها.
MediaWiki:Math-tracking-category-texvc-deprecation	Category:Pages that use a deprecated format of the math tags	الصفحات التي تستخدم صيغة texvc المُلغاة مثل `$ % \and \or \part \ang \C \H \bold \Bbb\ \pagecolor`، والتي ينبغي استبدالها بصيغة LaTeX القياسية `\$ \% \land \lor \partial \angle \Complex \mathbb{H} \mathbf \mathbb (removed)`. طالع Extension:Math/Roadmap .
MediaWiki:Math-tracking-category-mhchem-deprecation	Category:Pages that use a deprecated format of the chem tags	ترميز كيميائي مهجور، انظر Extension:Math/Roadmap#Step 1 Part C: Manual fixing of mhchem syntax.

نصائح وحيل

يمكنك استخدام إضافة MathML copy لمتصفح فايرفوكس لنسخ المعادلات إلى تطبيقات أخرى مثل مايكروسوفت وورد ([فيديو https://www.youtube.com/watch?v=FDMfT27zE54])، أو مستندات جوجل باستخدام إضافة g(Math) ([فيديو https://www.youtube.com/watch?v=KKwF6IKRkHU&hd=1]).
يمكنك تجاوز وضع العرض الافتراضي أو الوضع الذي يفضله المستخدم عن طريق إضافة السمة forcemathmode إلى العنصر ‎<math>؛ على سبيل المثال، لفرض عرض صورة ما بـ <math forcemathmode="native">...</math>.
تُخزَّن جميع صور الصيغ المُعالجة (المُصيَّرة) في ذاكرة مؤقتة، ولا يُعاد إنشاؤها تلقائياً عند عرض الصفحة أو تحريرها. لإجبار إعادة عرض جميع الصيغ في الصفحة، قم بمحو مختزن الصفحة باستخدام الإجراء ?action=purge&mathpurge=true. على سبيل المثال، سيؤدي الرابط https://en.wikipedia.org/w/index.php?title=Integral&action=purge&mathpurge=true إلى فرض إعادة عرض مقالة w:Integral. بعد ذلك، تحتاج إلى تجاوز ذاكرة التخزين المؤقت للمتصفح لضمان تحميل الصور الجديدة التي أُنشئت للمعادلات فعلياً.

الإبلاغ عن خطأ

إذا كانت هناك مشكلة في امتداد الرياضيات، فيمكنك الإبلاغ عنها عبر الفابريكيتور. بالإضافة إلى ذلك، ينبغي عليك التحقق من علاقة مشكلتك باختبارات الوحدة الآلية التي يتم إنشاؤها انطلاقاً من الصفحة CoverageTest.

مزيد من القراءة

انظر Extension:Math/advancedSettings للإصدارات القديمة ومزيد من المعلومات.

صفحات فرعية

انظر أيضا

Extension:Math/Roadmap
Mathoid
Extension:SimpleMathJax – طريقة بديلة لتوفير دعم لعرض الصيغ الرياضية داخل الويكي، دون الحاجة إلى texvc أو LaTeX.
Texvc PHP Alternative
Manual:Enable TeX/problems
Manual:Math

هذا الامتداد يستخدم على واحد من مشاريع ويكيميديا أو أكثر من واحد. يعني هذا الأمر أن الامتداد مستقر ويعمل/تعمل جيدا بما فيه الكفاية ليستخدم/لتستخدم في مواقع تتمتع بمستوى زيارات مرتفع مثل هذه. ابحث عن اسم هذا الامتداد في ملفات الضبط CommonSettings.php وكذلك InitialiseSettings.php كي ترى أين تنصب. توجد قائمة كاملة بالامتدادات المنصبة على موقع ويكي بعينه على صفحة Special:Version الخاصة بموقع الويكي.

هذا الامتداد مشمول في الحزم أو مزارع الويكي التالية أو كليهما:

Retrieved from "https://www.mediawiki.org/w/index.php?title=Extension:Math/ar&oldid=8557887"