Extension:Math（数学）

MediaWiki扩展手册

Math 发行状态： 稳定版
实现	标签
描述	可呈現数学的公式
作者	Moritz Schubotz, Tomasz Wegrzanowski, Brooke Vibber, Johannes Stegmüller, André Greiner-Petter, 以及其他贡献者
最新版本	持續更新
兼容性政策	快照跟随MediaWiki发布。 master分支不向后兼容。
数据库更改	是
表	math mathoid mathlatexml
许可协议	GNU通用公眾授權條款2.0或更新版本
下載	下載扩展 Git [?]: 浏览存储库 (Phabricator · GitHub) Gerrit代码复核 Git提交日誌 下載原始碼(tarball壓縮)
参数 $wgMathEnableWikibaseDataType $wgMathDefaultLaTeXMLSetting $wgMathUseInternalRestbasePath $wgMathMathMLUrl $wgMathFullRestbaseURL $wgMathLaTeXMLUrl $wgMathInternalRestbaseURL $wgMathConcurrentReqs $wgMathTexMaxLength $wgMathValidModes $wgMathWikibasePropertyIdSymbolRepresents $wgMathEntitySelectorFallbackUrl $wgMathoidCli $wgMathWikibasePropertyIdQuantitySymbol $wgMathDisableTexFilter $wgMathMathMLTimeout $wgMathWikibasePropertyIdInDefiningFormula $wgMathWikibasePropertyIdHasPart $wgMathEnableFormulaLinks $wgMathWikibasePropertyIdDefiningFormula $wgMathEnableExperimentalInputFormats $wgMathLaTeXMLTimeout $wgMathSvgRenderer $wgMathTexVCService
标签 ‎<math>
使用的函数钩 GetPreferences LoadExtensionSchemaUpdates MaintenanceRefreshLinksInit ParserAfterTidy ParserFirstCallInit ParserOptionsRegister ResourceLoaderGetConfigVars SpecialPage_initList UserGetDefaultOptions WikibaseClientDataTypes WikibaseRepoDataTypes
提供的函数钩 MathRenderingResultRetrieved MathFormulaPostRender
前往translatewiki.net翻譯Math扩展
問題	开启的任务 · 报告错误

数学（Math）扩展提供呈現数学公式的支持。

更多有关安装和配置此扩展（包括旧版本）的信息，可在Extension:数学/高级设定 中查阅。

請參閱擴充功能:數學/語法中目前可使用此擴充功能的概述。

• 下载文件，并解压Math文件夹到extensions/目录中。
  开发者和代码贡献人员应改从Git安装此扩展，输入：

  cd extensions/
  git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Math
  

• 請新增下列代码到您的LocalSettings.php 文件的底部：

  wfLoadExtension( 'Math' );
  

• 如果您使用的是MediaWiki 1.42之前的版本，請執行update.php 腳本來建立必要的資料庫表。 如果您是在MediaWiki 1.42+中安裝Math，則不再需要這麼做。
• 要查看純文本輸出之外的數學輸出模式，請按照以下說明啟用各種數學輸出模式。
• 如果您在尝试使用RESTBase时遇到表示公式的问题，您可以尝试使用以下修复
• 完成 – 請导航至您的wiki上的Special:Version，以验证此扩展已成功安装。

使用Vagrant安装：

• 如果你有使用Vagrant ，请通过vagrant roles enable math --provision安装

您还应该转到页面Special:MathStatus以查看Math扩展的所有组件现在是否正常工作。 对于你遇到的任何问题，最好的办法是在https://phabricator.wikimedia.org创建一个任务。

可惜还没有经过良好测试的关于安装Mathoid 和RESTBase 以使用Math扩展的指南，但至少有个进展中的草稿。 Extension:Math/RESTBase 请贡献。

此外，GitHub上有个通过RESTBase和MW 1.28的Mathoid安装并设置MediaWiki的教程。

一旦安裝之後，您可以在‎<math>標籤內使用TeX 標記語法寫公式。例如：

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

會生成：

${\displaystyle E=m{c}^2}$

輸出類型取決於您用來閱讀頁面的軟體。 如果可的以話，数学扩展会依次尝试输出MathML，否則它就輸出SVG图片（将字符转换成<path> elements）或PNG图片（最低优先级）。 基本數學功能支持適用於所有瀏覽器。但是，為獲得最佳結果，你可能需要變更你的設定值：

• 對於Firefox或其他Gecko瀏覽器，請安裝原生的MathML擴展功能和數學字體。
  NVDA、VoiceOver或Orca的螢幕朗读器提供无障碍的支持。 NVDA需要MathPlayer外掛程式来读出數學公式。
• 对于Safari或者其他WebKit浏览器，你也可以安装数学字体并通过在浏览器的自定义样式表插入一些CSS规则來启用本機的MathML呈現。
  屏幕朗读器VoiceOver提供无障碍支持，屏幕朗读器Orca尚未做到。
• 對Chrome而言，您必須在瀏覽器的自訂樣式表中 插入一些CSS規則，才能使用ChromeVox螢幕閱讀器獲得無障礙支援，或使用MathJax外掛程式進行視覺化渲染。

$wgMathValidModes设置保持著一個数组，其包含可以用于渲染的输出模式的名称。 如果多个模式启用，已登录的用户可以在用户参数设置页面的appearance面板中设置个人偏好。

你也可以使用$wgDefaultUserOptions设置来设置哪个模式是默认的，比如：

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

模式： 'mathml'

警告：	Mathoid is no longer actively developed in favor of Native MathML mode. 它最終會被中止。

您可以使用Mathoid，这是一个在服务器端使用MathJax将texvc输入转换为MathML+SVG渲染的应用。 Mathoid目前是維基百科上使用的數學渲染模式。

“Mathoid as a service”是Math扩展的推荐方法，也是默认方法。如果您不向LocalSettings.php添加任何其他设置，Math将使用Beta cluster的Mathoid和RESTBase 服务来渲染所有数学公式。默认设置为：

// 将MathML设为默认渲染选项
$wgDefaultUserOptions['math'] = 'mathml';
$wgMathUseInternalRestbasePath = false;
$wgMathFullRestbaseURL = 'https://wikimedia.org/api/rest_';
$wgMathMathMLUrl = 'https://mathoid-beta.wmflabs.org';

警告：	Wikimedia plans to discontinue RESTBase services including the Mathoid endpoint used by Math extension by default, though there is no specific EOL date yet. 對於使用比較新版本的MediaWiki網站，更建議使用Native MathML模式。

您可以修改这些设置去使用不同的Mathoid和RESTBase服务，可能包括您自己的。

您还可以在本地服务器上将Mathoid作为命令行实用程序运行。 要使用此方法，建议使用以下设置：

// 将MathML设为默认渲染选项
$wgDefaultUserOptions['math'] = 'mathml';
// 请提前创建一个config.yaml。模板位于Mathoid存储库中。
$wgMathoidCli = ['/path/to/mathoid/cli.js', '-c', '/path/to/mathoid/config.yaml'];
// 因为Mathoid，将MediaWiki的内存限制提高到1.2G。
$wgMaxShellMemory = 1228800;

setsebool -P httpd_execmem 1
setsebool -P httpd_setrlimit 1

模式： 'png'

自MediaWiki 1.32起，此模式也需要Mathoid伺服器才能運作。 在舊版本中，它需要安裝texvc和texvccheck，這可能需要最多的設定工作。

模式： 'latexml'

使用LaTeXML工具。 渲染是透過線上服務完成的（以$wgLaTeXMLUrl設定，預設值為https://latexml.formulasearchengine.com/convert）。

模式： 'native'

此模式將透過PHP從LaTeX產生MathML，而「無需」Mathoid。 請注意此模式沒有影像回退功能，因此只有在瀏覽器支援MathML的情況下，公式才能正確顯示。 Firefox和Safari很早就引入了MathML支援 (2006 和 2008)，但Chromium-based的瀏覽器對MathML的支援則是最近才加入的 (Chrome 109是在2023年發行的)。

模式： 'mathjax'

此模式與 Native MathML 模式 (透過 PHP 從 LaTeX 產生 MathML) 運作相同，但會使用 MathJax 3 來呈現 MathML。 因此，它將適用於不支援MathML的瀏覽器，但會在頁面檢視時載入MathJax函式庫（捆綁在Math的擴充功能中）。

警告：	之前，MediaWiki 1.19-1.25 中提供了基於 MathJax 2 的 MathJax 模式。 想在MediaWiki 1.26-1.41版中使用MathJax渲染方程式的話，詳見擴展:SimpleMathJax 。

模式： 'source'

此模式將轉送Latex的輸入而不進行渲染，並將其顯示在由$ :formula $所包圍的‎<span>元素中。

如果您只想要原始的latex公式，請務必設定$wgMathDisableTexFilter為'always'(請參閱下文)，否則會因為PNG敘述的檢查失敗而出現錯誤。

扩展会创建一系列跟踪分类 ，以检测错误和不被推荐的特性。 他們的訊息鍵以math-開頭。 管理員可以透過編輯該 wiki 的 MediaWiki 命名空間中的訊息值，來變更該 wiki 中追蹤類別的名稱。 Special:TrackingCategories會列出每個追蹤分類的名稱、訊息名稱和相關敘述。

• 您可以使用Firefox的MathML copy扩展以将公式复制到其他应用，例如Microsoft Word（视频）或者Google文档（带有g(Math)插件）（视频）
• 您可以在‎<math>元素添加forcemathmode属性，以覆盖用户首选和默认渲染模式，例如强制渲染图像为<math forcemathmode="png">...</math>。
• 渲染公式的所有图像都存储在缓存中，并且在查看或编辑页面时不会自动重新创建。 要强制重新渲染页面的所有公式，使用?action=purge&mathpurge=true操作来刷新。 例如，URL https://en.wikipedia.org/w/index.php?title=Integral&action=purge&mathpurge=true会强制重新渲染w:Integral文章。 然后你需要绕过浏览器缓存以便让新创建的公式图像实际上已下载。

如果Math扩展有问题，您可以在Phabricator报告。此外，您应检查您的问题与页面CoverageTest生成的自动化单元测试有何关系。

旧版本以及更多信息可参考Extension:数学/高级设定 。

• Extension:Math/Roadmap
• Mathoid
• 擴展:SimpleMathJax - 提供在wiki上渲染数学公式的另一种方法，无需texvc或LaTeX
• Texvc PHP替代
• Manual:Enable TeX/problems
• 手册:數學

此扩展用于一个或多个维基媒体项目。 这可能意味着扩展足够稳定、运作足够良好，可以用在这样的高流量的网站上。 请在维基媒体的CommonSettings.php和InitialiseSettings.php配置文件中查找此扩展的名称以查看哪些网站安装了该扩展。 特定wiki上的已安装的扩展的完整列表位于Special:Version页面。

此扩展在以下wiki农场/托管网站和/或软件包中提供： BlueSpice Canasta Fandom Miraheze ProWiki Telepedia wiki.gg WikiForge 這不是一份權威名單。 即使某些wiki农场/托管网站和/或软件包未在这里列出，它们也可能提供此扩展。 请检查你的wiki农场/托管网站或软件包以确认提供情况。