Installing and Testing 金宝搏188MathJax

使用mathjax的最简单方法是直接链接到ma金宝搏188thjax分布式网络服务(请参见使用内容交付网络(cdn))In that case,无需自行安装Mathjaxyourself,金宝搏188你可以马上开始使用Mathjax;金宝搏188skip this document oninstallation and go directly toConfiguring 金宝搏188MathJax.

金宝搏188MathJax can be loaded from a public web server or privately from yourhard drive or other local media.以任何一种方式金宝搏188使用Mathjax,你需要一份Mathjax的复印件。金宝搏188There are several ways to dothis: via吉特svnNPMcomposer凉亭,or via apre-packaged archive.We recommend吉特svn,as it is easierto keep your installation up to date with these tools.

通过Git获得Mat金宝搏188hjax

获取Mathjax并使其保持最新状态的最简单方金宝搏188法是使用吉特version control system to access ourGitHub repository.使用命令

git clone https://github.com/金宝搏188mathjax/MathJax.git MathJax

获取并设置Mathjax的副本。金宝搏188

Whenever you want to update 金宝搏188MathJax,您现在可以使用

光盘金宝搏188MathjaxGit远程显示源站

to check if there are updates to 金宝搏188MathJax (this will print severallines of data,but the last line should tell you if your copy is up todate or out of date).If 金宝搏188MathJax needs updating,使用

光盘金宝搏188MathjaxGit拉原点

将Mathjax的副本更新为当前版本。金宝搏188如果你一直这样更新Ma金宝搏188thjax,您将确保有最新的错误修复程序和新功能。188金博宝网站

这将为您提供最新发布的Mathjax版本。金宝搏188OlderReleases在Git中是“标记的”,因此您可以通过名称(在大多数情况下是版本号)来引用它们。使用

光盘金宝搏188MathJaxgit tag -l

要查看所有标记的版本,and use

光盘金宝搏188MathjaxGit结账
             

             

要签出指定版本的Mathjax,金宝搏188where isthe name of the tagged version you want to use.For example,

GIT校验7

would get you version 2.7.0 of 金宝搏188MathJax,尽管有新版本的Mathjax可用。金宝搏188

每个主要版本都有一个应用关键更新的分支(我们努力不修补稳定的版本,但有时需要做出关键的改变)。If you want to use thepatched version of a release,然后检查分支而不是标记。使用

光盘金宝搏188Mathjaxgit分行-R

to get a list of the available branches.主要版本有单独的分支,但与-latest附加的。这些包含了特定版本的补丁。You can check out one ofthe branches just as you would a tagged copy.For example,2.5版本的分支是最新版本.To get thisrelease,使用

光盘金宝搏188MathjaxGit结账2.5版-最新

and to update it when changes occur,使用

光盘金宝搏188MathjaxGit Pull Origin V2.5最新版本

其中一个分支被命名为发展;this branch includes all thelatest changes to 金宝搏188MathJax.尽管我们试图确保这个版本是一个稳定的、可用的Mathjax版本,金宝搏188正在开发中,有时它可能比“发布”版本更不稳定。如果您希望在最新补丁作为新的编号版本正式发布之前获得它们,您可以查看发展branch.

通过SVN获取Mat金宝搏188hjax

If you are more comfortable with the颠覆source control system,你可以使用Github的svn获取Mathjax的服务。金宝搏188If you want to get thelatest revision usingsvn,使用命令

SVN结帐http://github.com/mathjax/金宝搏188mathjax/trunk mathjax

获取并设置Mathjax的副本。金宝搏188

Whenever you want to update 金宝搏188MathJax,您现在可以使用

光盘金宝搏188MathJaxsvn status -u

检查Mathjax是否有更新。金宝搏188如果M金宝搏188athjax需要更新,请使用

光盘金宝搏188MathJaxsvn update

将Mathjax的副本更新为当前版本。金宝搏188如果你一直这样更新Ma金宝搏188thjax,您将确保有最新的错误修复程序和新功能。188金博宝网站

这将为您提供最新发布的Mathjax版本。金宝搏188OlderReleases在由版本号命名的“分支”中可用;例如,最新版本.If you prefer to use one of the olderreleases,然后使用

svn checkout https://github.com/金宝搏188mathjax/MathJax/branches/[名称]金宝搏188

where[name]替换为要签出的分支的名称。分支名称可以在Github 金宝搏188Mathjax页面分支机构标签。

Obtaining 金宝搏188MathJax via an archive

Release versions of 金宝搏188MathJax are available in archive files from the金宝搏188Mathjax Github页面.Thecurrent version is available via the "clone or download" button,或者,您可以使用“发布”选项卡下载旧版本的存档。

Current Version金宝搏188MATJAX-2.7(33.0MB)

查阅更改日志对于2.7版的新功能。

对于以前的版本,see therelease page on GitHub或快速访问

You should download the archive of the branch corresponding to the versionyou need,然后简单地解压它。一旦mathjax目录被解包,金宝搏188you should move it to thedesired location on your server (or your hard disk,如果您是本地使用,而不是通过Web服务器)。One natural location isto put it at the top level of your web server's hierarchy.That wouldlet you refer to the main 金宝搏188MathJax file as/金宝搏188Mathjax/Mathjax.jsfromwithin any page on your server.

If a packaged release receives any important updates,then thoseupdates will be part of thebranch对于那个版本。要获得补丁版本,use the分支机构下拉菜单(在页面菜单最左边)选择所需的发布分支(例如V2.1最新)然后使用页面右侧的绿色“克隆或下载”按钮获取该版本的最新补丁版本(通过其“下载zip”链接)。您也可以在左侧的下拉菜单中选择任何带标记的版本(使用列表顶部的“标记”选项卡),“克隆或下载”按钮将下载该版本。

通过NPM获得Mat金宝搏188hjax

从2.6版开始,it is possible to useNPM安装Mathjax。金宝搏188AssumingNPM安装在您的系统上,只需执行以下命令:

NPM安装Mathjax金宝搏188

Note

The distribution onNPM不包含PNG字体

通过作曲获得Math金宝搏188jax

从2.5版开始,it is possible to use作曲家安装Mathjax。金宝搏188See theComposerdocumentation开始。

Obtaining 金宝搏188MathJax via Bower

从2.3版开始,it is possible to use凉亭安装Mathjax。金宝搏188假设鲍尔安装在你的系统上,只需执行以下命令:

Bower安装Mathjax金宝搏188

对于不带PNG字体的精简副本,请使用

Bower安装组件/Mathjax金宝搏188

测试您的安装

使用中的HTML文件测试directory to see if yourinstallation is working properly:

测试/
    指数.html          #测试默认配置
    指数-images.html   #测试图像字体回退显示
    sample.html         # Sample page with lots of pretty equations
    实例.html       #链接到所有示例页的网页

在浏览器中打开这些文件,查看它们是否正常工作。If you have installed 金宝搏188MathJax on a server,使用这些文件的网址,而不是在本地打开它们。When youview the索引文件文件,你应该看到(过了一会儿)一条消息,马查克斯似乎在工作。金宝搏188如果不是,您应该检查文件是否已完全传输到服务器,并且这些权限允许服务器访问Mathjax目录中的文件和文件夹(确保也验证Mathjax文件夹的权限)。金宝搏188Checking the server logs may helplocate problems with the installation.

关于共享安装的说明

通常情况下,您希望将Mathjax安装在使用M金宝搏188athjax的网页的同一服务器上。有时候,然而,当这可能不切实际时,或者当您想在不同的站点上使用Mathjax安装时。金宝搏188For example,部门服务器位于www.math.yourcollege.edu可能想在网址:www.yourcollege.edurather than installing aseparate copy on the departmental machine.金宝搏188Mathjax确实可以从另一个服务器加载,但是有一个重要的警告-对于跨域脚本,火狐和IE9的同源安全策略。

Firefox's interpretation of the same-origin policy is more strict thanmost other browsers,它会影响字体的加载方式@font-faceCSS指令。金宝搏188Mathjax的html-css和commonHTMLoutput模式使用此指令将基于Web的数学字体加载到apage中,前提是用户没有将它们安装在自己的ownco计算机上。火狐的安全策略,然而,只有当字体与网页本身来自同一服务器时才允许这样做,so if youload 金宝搏188MathJax (and hence its web fonts) from a different server,Firefox won't be able to access those web fonts.在这种情况下,Mathja金宝搏188x的html-css输出模式将在等待fontto下载时暂停(这永远不会发生);它将在大约5秒钟后超时,并切换到图像字体作为回退。金宝搏188MathJax's CommonHTMLoutput mode will simply not show the correct fonts,但没有停顿。同样,IE9及以上版本在其IE9standards mode这也阻止了加载远程字体,所以iTexhibits也有同样的行为。

There is a solution to this,然而,如果您管理安装Mathjax的服务器,金宝搏188and if that server is running theApache Web服务器.In the remote server's金宝搏188MaTjax/字体/文件夹,创建一个名为.htaccessthat contains the following lines:

<文件匹配 “(TTF OTF EOT WOFF)$美元”>
<IfModule 模头.c>
页眉 set 通路-控制-允许-Origin “*”

              IfModule>

               文件匹配>

并确保权限允许服务器读取此文件。(文件名以句点开头,which causes it to be an "invisible" fileon unix-based operating systems.Some systems,尤其是那些具有图形用户界面的,may not allow you to create such files,因此,您可能需要使用命令行界面来完成此操作。)

这个文件应该可以让其他站点的页面从这个服务器加载mathjax,这样Firefox和IE就可以下载基于Web的字体。金宝搏188如果你想限制那些可以访问网页字体的网站,change theAccess-Control-Allow-Origin线条到尺寸,如:

页眉 set 通路-控制-允许-Origin “http://www.math.yourcollege.edu”

所以只有几页www.math.yourcollege.edu将能够从此网站下载字体。参见开放式字体库讨论web-font linking了解更多详细信息。

Firefox and local fonts

火狐的同源安全策略会影响它加载基于Web的字体的能力,as described above.This has implications not onlyto cross-domain loading of 金宝搏188MathJax,but also to using 金宝搏188MathJax locallyfrom your hard disk.firefox对本地文件的相同originpolicy的解释是,页面的“相同域”是该页面所在的目录,或其任何子目录。So ifyou use 金宝搏188MathJax in a page with a文件:/ /URL,and if 金宝搏188MathJax isloaded from a directory other than the one containing the originalpage,then 金宝搏188MathJax will not be able to access the web-based fonts inFirefox.In that case,金宝搏188MathJax will fall back on image fonts todispla金宝搏188y the mathematics.

In order for Firefox to be able to load the fonts properly for a localfile,您的Mat金宝搏188hjax安装必须位于包含使用Mathjax的页面的One的子目录中。这是一个不可原谅的限制,但这是火狐的SecurityModel强加的一个限制,Mathjax不能规避。金宝搏188Currently,this is not aproblem for other browsers.

这个问题的一个解决方案是在本地安装mathjax字体,这样firefox就不必首先使用基于we金宝搏188b的字体。To do that,安装斯蒂克斯字体,or copy the fonts from金宝搏188mathjax/字体/html-css/tex/otf(或基于Web的金宝搏188mathjax/字体/html-css目录),然后重新启动浏览器。

IE9和远程字体

IE9的相同来源策略会影响其加载基于Web的字体的能力,asdescribed above.这并不意味着要跨域加载Mathjax,金宝搏188也可以查看本地页面(使用文件:/ /URL) that accesses 金宝搏188MathJax from a remote site such as aCDN service.在这种情况下,IE9not荣誉Access-Control-Allow-Origin远程服务器的设置(如果网页来自http://URL),and so it从未allows thefont to be accessed.

这个问题的一个解决方案是在本地安装Mathjax字体,这样Mathjax就不必首先使用基于We金宝搏188b的字体。你最好的办法是安装斯蒂克斯字体在你的系统上。