Doxygen为Docbook输出创建空的图像标题



我使用doxygen 1.8.14来创建docbook输出。图像用标记

image docbook Legend.png "Coloring and Graph Scheme" width=10cm

生成的文档簿是

<figure>
<title></title>
<mediaobject>
<imageobject>
<imagedata width="10cm" align="center" valign="middle"
scalefit="1" fileref="Legend.png"></imagedata>
</imageobject>
<caption>Coloring and Graph Scheme</caption>
</mediaobject>
</figure>

注意<title>是空的(标记中的标题字符串转到<caption>元素(。这导致文档的"数字列表"部分看起来像这样:

1.1. ........................... 8
1.2. ........................... 9
2.1. .......................... 13
2.2. .......................... 14
2.3. .......................... 16

(因为"图形列表"使用图形<title>内容,而不是<caption>内容(。在我开始用perl一行代码破解标题之前,有没有我忽略了什么?也许是在多西根构型?

正确的文档簿代码是

<figure>
<title>Coloring and Graph Scheme</title>
<mediaobject>
<imageobject>
<imagedata width="10cm" align="center" valign="middle"
scalefit="1" fileref="Legend.png"></imagedata>
</imageobject>
</mediaobject>
</figure>

在1.8.14版本中,标题被写为标题,在主版本中,直到现在,标题都被写在了错误的地方。为此,我提出了一个撤回doxygen的提议(https://github.com/doxygen/doxygen/pull/6638)。

解决方法是使用:

docbookonly
<figure>
<title>Coloring and Graph Scheme</title>
<mediaobject>
<imageobject>
<imagedata width="10cm" align="center" valign="middle"
scalefit="1" fileref="Legend.png"></imagedata>
</imageobject>
</mediaobject>
</figure>
enddocbookonly

而不是:

image docbook Legend.png "Coloring and Graph Scheme" width=10cm

EDIT:拉取请求的代码已经集成在github上的master中。

最新更新