Doxygen создает пустые заголовки изображений для вывода в Docbook - PullRequest
Новая
       42

Doxygen создает пустые заголовки изображений для вывода в Docbook

0 голосов
/ 23 ноября 2018

Я использую Doxygen 1.8.14 для создания выходных документов.Изображения помечены 

\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 one-liner, я что-то упустил из виду?Возможно, в конфигурации doxygen?

Правильный код документа: 

<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 Ответ

0 голосов
/ 23 ноября 2018

В версии 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

РЕДАКТИРОВАТЬ: Кодзапроса на извлечение был интегрирован в master на github.

...