WordPress插件:MathJax-LaTeX

August 18th, 2021 | 分类: 【部署】

【安装】

安装插件 MathJax-LaTeX :

官网:http://knowledgeblog.org/
下载:https://cn.wordpress.org/plugins/mathjax-latex/

安装:可以直接在 WordPress 后台的插件管理页面中,搜索 MathJax-LaTeX 后在线安装。

部署 MathJax 服务到本地:

wget https://github.com/mathjax/MathJax/archive/master.zip && unzip master.zip

将 MathJax 文件夹整个移动到 WordPress 的 mathjax-latex 插件目录下

sudo mv MathJax YOUR_WORDPRESS_PATH/wp-content/plugins/mathjax-latex/

更改 MathJax 所有者为 nginx :

sudo -R nginx:nginx YOUR_WORDPRESS_PATH/wp-content/plugins/mathjax-latex/

【配置】

1. 访问 WordPress 后台

2. 插件 》 启用 MathJax-LaTeX 插件。

3. 设置 》 MathJax-LaTeX 插件配置中启用本地 MathJax 服务:

Use MathJax CDN Service? 勾选

Custom MathJax location? 设置为 MathJax 脚本所在的路径,即:https:///domain.name/MathJax/es5/tex-chtml.js

【注意】因为同源策略和跨域问题,请保证 tex-chtml.js 的路径与网站一致。

同源策略指的是浏览器对不同源的脚本或者文本的访问方式进行的限制。

比如源a的js不能读取或设置引入的源b的元素属性。

经测试,如果跨域:
1. FireFox 正常显示
2. Chrome 正常显示
3. iPad Safari 正常显示
4. iMac Safari 无法加载 tex-chtml.js
5. Internet Explorer 无法加载 tex-chtml.js

当修正为同源,错误消除。

【注意】注意,mathjax版本3不再支持11之前的ie版本。

polyfill 库以支持早期的浏览器版本(请参见 browser support 页了解详细信息)。特别是,要允许mathjax版本3与ie11一起工作,请包括:

<script src="https://polyfill.io/v3/polyfill.min.js?features=es6"></script>

在加载mathjax的脚本之前。

官网:https://polyfill.io/v3/
源码:https://github.com/financial-times/polyfill-service

参考:https://www.osgeo.cn/mathjax/output/browser.html

【测试】

输出质能转换方程:E=mc^2

使用 WordPress 短代码表达:

[latex]E=mc^2[/latex]

\(E=mc^2\)

使用 MathJax 原生标签表达:

$$E=mc^2$$

$$E=mc^2$$

\(E=mc^2\)

\(E=mc^2\)

【参考】

参考:https://geomatlab.com/mathjax/

【排错】

报错:wp-content/uploads/sites/x/hummingbird-assets/output/chtml/fonts/woff-v2/MathJax_Size1-Regular.woff

因为 hummingbird 接管了部分 字体/JS/CSS 导致路径丢失。那么直接把相关文件写入 hummingbird-assets 目录。

下载:https://github.com/mathjax/MathJax

解压后把 MathJax-master/es5/output 整个目录复制到 wp-content/uploads/sites/x/hummingbird-assets/ 目录下。