Extension:Math/zh

数学（Math）扩展提供渲染数学公式的支持. 有关当前此扩展的功能的概述，请参考m:Help:显示公式.

更多有关安装和配置此扩展（包括旧版本）的信息，可在中查阅.



查看数学公式
数学扩展会依次尝试输出MathML、SVG图片（将字符转换成&lt;path>）或PNG图片（最低优先级）. 输出的结果将取决于你使用的设备的兼容性. 基本數學支持適用於所有瀏覽器. 但是，為獲得最佳渲染，可能需要進行特定的調整：


 * 對於Firefox或其他Gecko瀏覽器，需要安裝Native MathML擴展和數學字體. 无障碍支持由NVDA、VoiceOver或Orca提供.  而且，NVDA需要MathPlayer来读出公式.
 * 对于Safari或者其他WebKit浏览器，你可能也需要安装数学字体并通过向浏览器参数设置的自定义样式表安装一些CSS规则启用本地MathML渲染.

无障碍支持由VoiceOver屏幕朗读器提供，但是还没有Orca.


 * 对于Chrome，您必须像通过ChromeVox向您的浏览器的自定义样式表插入一些CSS规则以获取访问支持，或者通过MathJax扩展获取视觉渲染.
 * 在一些版本的Internet Explorer中，可以使用MathPlayer作为一种辅助技术.

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

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

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



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

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

Mathoid
模式： 'mathml'

您可以使用Mathoid，这是一个在服务器端使用MathJax将texvc输入转换为MathML+SVG渲染的应用. 这是最推荐的选项，Mathoid是维基百科上使用的数学渲染模式.



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

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



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

LaTeX
模式： 'png'

Since MediaWiki 1.32, this mode will also require a Mathoid server to work. In older versions, it requires installing texvc and texvccheck, which may require the most setup work.

LaTeXML
模式： 'latexml'

Uses the LaTeXML utility. The rendering is done via an online service (set with $wgLaTeXMLUrl, which has a default value of https://latexml.formulasearchengine.com/convert).



未渲染
模式： 'source'

This mode will forward the Latex input without rendering, presenting it in a element, surrounded by $ :formula $.

Make sure to set $wgMathDisableTexFilter to 'always' (see below) if you only want the raw latex formula, else an error will appear due to the failed check for PNG depictions.



重要的配置设置列表


跟踪分类
扩展会创建一系列跟踪分类，以检测错误和不被推荐的特性. 分类的准确名称由MediaWiki名字空间内的页面决定.



提示与技巧

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



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



延伸阅读
旧版本以及更多信息可参考.

子页面


參見

 * - 提供在wiki上渲染数学公式的另一种方法，无需texvc或LaTeX
 * - 提供在wiki上渲染数学公式的另一种方法，无需texvc或LaTeX
 * - 提供在wiki上渲染数学公式的另一种方法，无需texvc或LaTeX