codecogs是一个latex公式渲染服务,它根据get请求返回一个svg图片。例如:codecogs,这个服务的缺点是比较慢。
本文介绍ubuntu下搭建类似codecogs的公式渲染服务。
一、安装latex
sudo apt-get install latex
sudo apt-get install latex-cjk-chinese
二、latex命令介绍
latex命令用于把tex文件转换成pdf文件或者dvi文件。dvi是一种设备无关的可打印文件格式。
输入dvi按两次tab可以找到dvisvgm,此命令将dvi文件转为svg。
三、编写服务程序
使用flask编写服务,通过命令行的方式调用latex获取svg。在返回时需要注意两点:
- 设置好content-type,否则客户端不知道你返回的是什么格式的图片
- 跨域访问并不需要设置,因为加载的是静态资源
使用latex命令时需要注意:
- documentclass必须是minimal,这样能够保证生成的文件尽量小。
dvisvgm --no-fonts --no-styles
,把dvi转为svg时取消导出字体和格式,而只是简单导出一张图片,否则客户端找不到这些字体和格式。
TODO:
- 添加缓存功能:可能没有必要
- 添加统计功能:统计不同网站的请求次数
import os
from flask import Flask, request, Response
app = Flask(__name__)
file_id = 0
latex_dir = os.path.join(os.path.expanduser("~"), "latex-server")
if not os.path.exists(latex_dir):
os.mkdir(latex_dir)
def gets(formula):
global file_id
file_id += 1
tex_file, dvi_file, svg_file = [os.path.join(latex_dir, "{}.{}".format(file_id, file_type)) for file_type in "tex dvi svg".split()]
open(tex_file.format(file_id), mode='w').write(r"""
\documentclass{minimal}
\begin{document}
$%s$
\end{document}
""" % formula)
os.system("latex --output-directory {} {}".format(latex_dir, tex_file))
"""
no-fonts no-styles不带字体,c2,2表示横竖都缩放两倍
"""
os.system("dvisvgm --no-fonts --no-styles -c2,2 -o {} {}".format(svg_file, dvi_file))
svg = open(svg_file).read()
for i in "tex dvi log aux svg".split():
filename = os.path.join(latex_dir, "{}.{}".format(file_id, i))
if os.path.exists(filename):
os.remove(filename)
return svg
@app.route("/render")
def render():
formula = request.args['formula']
print(formula)
resp = gets(formula)
return Response(response=resp, headers={
"Access-Control-Allow-Origin": "*",
"Content-Type": "image/svg+xml"
})
if __name__ == '__main__':
app.run(host='0.0.0.0', port=9988, debug=True)
四、LaTex 的 web 替代品及其存在问题
基于 HTML(svg)+CSS LaTex 渲染只实现了 Latex 非常少的一部分功能——公式渲染。
MathJax
MathJax 出现于 2011 年,发展至今已经有 6、7 个年头了。其特点是对数学公式的渲染支持度很高。对开发者来讲,其缺点是 js API 有点奇怪,渲染比较慢,好在支持服务器端渲染。MathJax 首先有个配置文件:
MathJax.Hub.Config({
extensions: ["tex2jax.js"],
jax: ["input/TeX", "output/SVG"],
tex2jax: {
inlineMath: [
['$', '$'],
["\\(", "\\)"],
],
displayMath: [
['$$', '$$'],
["\\[", "\\]"]
],
processEscapes: true
},
"SVG": {
availableFonts: ["TeX"]
}
});
然后将调用渲染API,转为美观的LaTex效果,如下。由于渲染很慢,所以渲染过程是一个异步执行的队列。
MathJax.Hub.Queue(['Typeset', MathJax.Hub]);
KaTex
相对于 MathJax, KaTex 是后起之秀,是可汗学院的公式渲染方案。API 设计,对前端工程师更加友好。KaTex 的特点是渲染很快,KaTex 的 API 是一个同步调用。
katex.render("c = \\pm\\sqrt{a^2 + b^2}", element);
KaTex 由于发展比较晚,大约 2013 年,对 LaTex 语法的支持程度可能不如 MathJax,比如不支持中文。
KaTex 也支持服务器端渲染。
var html = katex.renderToString("c = \\pm\\sqrt{a^2 + b^2}");
//=> <span class="katex">...</span>
MathQuill
跟 MathJax、KaTex 不同,MathQuill 是一个真正意义上的公式编辑器,一边输入一边渲染,输出可以是 Tex,但是对于复杂的公式,这种输入方式还是有很大的局限性,输入过程还是需要记住一些 LaTex 命令。
使用 MathJax、KaTex方案的共同问题是用HTML、CSS来渲染公式,非常冗长,如果采用了服务器端渲染,很容易超出数据库字段的长度限制,一个简单的公式,就会产生很多 HTML 结构。
参考资料
https://cloud.tencent.com/developer/article/1015883
原文地址:https://www.cnblogs.com/weiyinfu/p/10126152.html