我使用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中。