使用doxygen排版数学公式出错的解决方法

原创 2015年07月08日 12:39:06

问题

今天玩了一下doxygen,碰到一个问题

! Undefined control sequence.
l.77 $ y_{\mbox{test}} = \mathbb
                                {E}[y_{\mbox{train}}] = x $
? 
! Emergency stop.

这时候打开生成的网页,所有应该是公式(图片)的地方都只有LATEX代码。

分析

doxygen对代码注释中LATEX公式的处理方法是:

  1. 把公式都提取出来写到一个_formulas.tex文件里
  2. 这个文件先用LATEX编译成DVI格式
  3. 再由dvips转成PostScript格式
  4. 最后由gs(GhostScript)转成图片显示在网页里

上面的错误信息意思是在第2步遇到了问题。

解决

我把上面的公式拎出来用自己的模板编译了一下发现没什么问题,说明LATEX工作是正常的。Google+查阅日志之后发现doxygen调用LATEX的时候默认仅调用了epsfig、graphicx、keyval、graphics、dvips等几个基本的包,其他如amsmath这种常用的包都没有调用。所以如果要排版数学公式的话需要手动把需要的包加进来。

在Linux环境下直接修改doxygen的配置文件即可,在windows下需要通过图形界面,在Expert->LaTeX->EXTRA_PACKAGES填入amsmath、xr、amsfonts三个包即可。

DOxygen for C++使用说明——添加数学公式

参考文献: 1.《Doxygen Including formulas》 2.《 使用doxygen排版数学公式出错的解决方法》...
  • xiamentingtao
  • xiamentingtao
  • 2015年11月09日 08:50
  • 1321

html/css排版一些简单的数学公式

最近做H5应用,遇到了一个棘手的问题,怎么在网页上排版中学题目。问题关键在于,现在的中学题目,具有太丰富的形式,在网页设计的时候,有许多情形要考虑,列几条: - 题目篇幅太长,一般还带有阅读材料,主...
  • dreamer2020
  • dreamer2020
  • 2016年06月10日 18:08
  • 3220

Latex 排版技巧 1——数学公式对齐

在我们排版数学推导式时,很多时候我们希望能够让公式的等号对齐这样更接近人的数学推导习惯如下图效果图使用 begin{aligned} end{aligned将所需对齐的数学公式代码块包起来即可代码如下...
  • u012675539
  • u012675539
  • 2015年07月26日 14:52
  • 2246

Office中数学公式、符号显示为乱码(如小方块)的解决方法

  • 2012年12月20日 18:33
  • 26KB
  • 下载

Word2013 图片或数学公式显示不全解决方法

嵌入式的图片有时只显示部分,原因多是行距为固定值,调整行间距为单倍行距或其他,即可。...
  • zhaizu
  • zhaizu
  • 2015年03月12日 16:21
  • 6877

DOxygen for C++使用说明——添加数学公式

参考文献: 1.《Doxygen Including formulas》 2.《 使用doxygen排版数学公式出错的解决方法》...
  • xiamentingtao
  • xiamentingtao
  • 2015年11月09日 08:50
  • 1321

LaTeX 第五课:数学公式排版

本期的主要内容是数学公式的排版,包含以下内容: 行内公式与行间公式数学结构的输入数学符号的输入多行公式排版 数学公式的排版是 LaTeX 的看家本领,下面我们就来看看吧! --- ...
  • c2a2o2
  • c2a2o2
  • 2018年01月12日 21:41
  • 13

Latex 排版技巧 1——数学公式对齐

在我们排版数学推导式时,很多时候我们希望能够让公式的等号对齐这样更接近人的数学推导习惯如下图效果图使用 begin{aligned} end{aligned将所需对齐的数学公式代码块包起来即可代码如下...
  • u012675539
  • u012675539
  • 2015年07月26日 14:52
  • 2246

WEB排版历练:如何在网文中插入图形形式的数学公式

在网文中推送文章有时会包括许多数学符号和公式,但很多网络平台的网文编辑器并不能像Microsoft Office等图文编辑软件那样可以直接进行数学公式输入、排版和正确显示,造成网络上很多科技类文章的版...
  • Shanghai_Eyoung
  • Shanghai_Eyoung
  • 2017年12月05日 15:57
  • 41

html/css排版一些简单的数学公式

最近做H5应用,遇到了一个棘手的问题,怎么在网页上排版中学题目。问题关键在于,现在的中学题目,具有太丰富的形式,在网页设计的时候,有许多情形要考虑,列几条: - 题目篇幅太长,一般还带有阅读材料,主...
  • dreamer2020
  • dreamer2020
  • 2016年06月10日 18:08
  • 3220
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:使用doxygen排版数学公式出错的解决方法
举报原因:
原因补充:

(最多只允许输入30个字)