Doxygen creates empty image titles for Docbook output
.everyoneloves__top-leaderboard:empty,.everyoneloves__mid-leaderboard:empty,.everyoneloves__bot-mid-leaderboard:empty{ height:90px;width:728px;box-sizing:border-box;
}
I'm using doxygen 1.8.14 to create docbook output. Images are marked up with
image docbook Legend.png "Coloring and Graph Scheme" width=10cm
The resulting docbook is
<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>
Note how the <title> is empty (the title string from markup went to the <caption> element).
This causes the document's "List of figures" section to look like this:
1.1. ........................... 8
1.2. ........................... 9
2.1. .......................... 13
2.2. .......................... 14
2.3. .......................... 16
(because the List of Figures uses the figure <title> contents, not the <caption> content). Before I start hacking or whacking the caption to the title with a perl one-liner, is there something I have overlooked? In the doxygen configuration perhaps?
The correct docbook code is
<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>
image doxygen docbook
asked Nov 23 '18 at 14:45
JensJens
51k1489133
add a comment |
I'm using doxygen 1.8.14 to create docbook output. Images are marked up with
image docbook Legend.png "Coloring and Graph Scheme" width=10cm
The resulting docbook is
<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>
Note how the <title> is empty (the title string from markup went to the <caption> element).
This causes the document's "List of figures" section to look like this:
1.1. ........................... 8
1.2. ........................... 9
2.1. .......................... 13
2.2. .......................... 14
2.3. .......................... 16
(because the List of Figures uses the figure <title> contents, not the <caption> content). Before I start hacking or whacking the caption to the title with a perl one-liner, is there something I have overlooked? In the doxygen configuration perhaps?
The correct docbook code is
<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>
image doxygen docbook
asked Nov 23 '18 at 14:45
JensJens
51k1489133
Although the docbook handling has been greatly rewritten in the current master version of doxygen, I see here also the same problem. What docbook tag has to be used to get it in the table of content?
– albert
Nov 23 '18 at 15:06
Or better formulated how should the section look like?
– albert
Nov 23 '18 at 15:12
@albert The correct tag to use is<title>. A caption is a longer explanation about what an image depicts. In scientific journals you often see captions of many lines. Docbook/XSL-FO also puts the title above or below a figure, depending on what you have in the style sheet customization layer.
– Jens
Nov 23 '18 at 15:16
In the master version it is on the wrong place as well (inside the mediaobject), I'll have to dive into the problem...
– albert
Nov 23 '18 at 15:37
add a comment |
I'm using doxygen 1.8.14 to create docbook output. Images are marked up with
image docbook Legend.png "Coloring and Graph Scheme" width=10cm
The resulting docbook is
<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>
Note how the <title> is empty (the title string from markup went to the <caption> element).
This causes the document's "List of figures" section to look like this:
1.1. ........................... 8
1.2. ........................... 9
2.1. .......................... 13
2.2. .......................... 14
2.3. .......................... 16
(because the List of Figures uses the figure <title> contents, not the <caption> content). Before I start hacking or whacking the caption to the title with a perl one-liner, is there something I have overlooked? In the doxygen configuration perhaps?
The correct docbook code is
<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>
image doxygen docbook
asked Nov 23 '18 at 14:45
JensJens
51k1489133
I'm using doxygen 1.8.14 to create docbook output. Images are marked up with
image docbook Legend.png "Coloring and Graph Scheme" width=10cm
The resulting docbook is
<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>
Note how the <title> is empty (the title string from markup went to the <caption> element).
This causes the document's "List of figures" section to look like this:
1.1. ........................... 8
1.2. ........................... 9
2.1. .......................... 13
2.2. .......................... 14
2.3. .......................... 16
(because the List of Figures uses the figure <title> contents, not the <caption> content). Before I start hacking or whacking the caption to the title with a perl one-liner, is there something I have overlooked? In the doxygen configuration perhaps?
The correct docbook code is
<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>
image doxygen docbook
image doxygen docbook
asked Nov 23 '18 at 14:45
JensJens
51k1489133
asked Nov 23 '18 at 14:45
JensJens
51k1489133
edited Nov 24 '18 at 15:51
Jens
asked Nov 23 '18 at 14:45
JensJens
51k1489133
asked Nov 23 '18 at 14:45
JensJens
51k1489133
asked Nov 23 '18 at 14:45
JensJens
51k1489133
51k1489133
Although the docbook handling has been greatly rewritten in the current master version of doxygen, I see here also the same problem. What docbook tag has to be used to get it in the table of content?
– albert
Nov 23 '18 at 15:06
Or better formulated how should the section look like?
– albert
Nov 23 '18 at 15:12
@albert The correct tag to use is<title>. A caption is a longer explanation about what an image depicts. In scientific journals you often see captions of many lines. Docbook/XSL-FO also puts the title above or below a figure, depending on what you have in the style sheet customization layer.
– Jens
Nov 23 '18 at 15:16
In the master version it is on the wrong place as well (inside the mediaobject), I'll have to dive into the problem...
– albert
Nov 23 '18 at 15:37
add a comment |
Although the docbook handling has been greatly rewritten in the current master version of doxygen, I see here also the same problem. What docbook tag has to be used to get it in the table of content?
– albert
Nov 23 '18 at 15:06
Or better formulated how should the section look like?
– albert
Nov 23 '18 at 15:12
@albert The correct tag to use is<title>. A caption is a longer explanation about what an image depicts. In scientific journals you often see captions of many lines. Docbook/XSL-FO also puts the title above or below a figure, depending on what you have in the style sheet customization layer.
– Jens
Nov 23 '18 at 15:16
In the master version it is on the wrong place as well (inside the mediaobject), I'll have to dive into the problem...
– albert
Nov 23 '18 at 15:37
Although the docbook handling has been greatly rewritten in the current master version of doxygen, I see here also the same problem. What docbook tag has to be used to get it in the table of content?
– albert
Nov 23 '18 at 15:06
Although the docbook handling has been greatly rewritten in the current master version of doxygen, I see here also the same problem. What docbook tag has to be used to get it in the table of content?
– albert
Nov 23 '18 at 15:06
Or better formulated how should the section look like?
– albert
Nov 23 '18 at 15:12
Or better formulated how should the section look like?
– albert
Nov 23 '18 at 15:12
@albert The correct tag to use is
<title>. A caption is a longer explanation about what an image depicts. In scientific journals you often see captions of many lines. Docbook/XSL-FO also puts the title above or below a figure, depending on what you have in the style sheet customization layer.– Jens
Nov 23 '18 at 15:16
@albert The correct tag to use is
<title>. A caption is a longer explanation about what an image depicts. In scientific journals you often see captions of many lines. Docbook/XSL-FO also puts the title above or below a figure, depending on what you have in the style sheet customization layer.– Jens
Nov 23 '18 at 15:16
In the master version it is on the wrong place as well (inside the mediaobject), I'll have to dive into the problem...
– albert
Nov 23 '18 at 15:37
In the master version it is on the wrong place as well (inside the mediaobject), I'll have to dive into the problem...
– albert
Nov 23 '18 at 15:37
add a comment |
1 Answer
1
active
oldest
votes
In version 1.8.14 the title is written as a caption, in the master version til now the title is written, but on the wrong place. For this I made a proposed pull request for doxygen (https://github.com/doxygen/doxygen/pull/6638).
A workaround is to use:
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
instead of:
image docbook Legend.png "Coloring and Graph Scheme" width=10cm
EDIT: Code of pull request has been integrated in master on github.
answered Nov 23 '18 at 17:40
albertalbert
3,02731125
Thank you, that was quick! I hope Dimitry gets around to the first update this year :-)
– Jens
Nov 23 '18 at 18:05
As far as I know he plans to make a release between Christmas and New Year (this year)
– albert
Nov 23 '18 at 18:12
add a comment |
Your Answer
StackExchange.ifUsing("editor", function () {
StackExchange.using("externalEditor", function () {
StackExchange.using("snippets", function () {
StackExchange.snippets.init();
});
});
}, "code-snippets");
StackExchange.ready(function() {
var channelOptions = {
tags: "".split(" "),
id: "1"
};
initTagRenderer("".split(" "), "".split(" "), channelOptions);
StackExchange.using("externalEditor", function() {
// Have to fire editor after snippets, if snippets enabled
if (StackExchange.settings.snippets.snippetsEnabled) {
StackExchange.using("snippets", function() {
createEditor();
});
}
else {
createEditor();
}
});
function createEditor() {
StackExchange.prepareEditor({
heartbeatType: 'answer',
autoActivateHeartbeat: false,
convertImagesToLinks: true,
noModals: true,
showLowRepImageUploadWarning: true,
reputationToPostImages: 10,
bindNavPrevention: true,
postfix: "",
imageUploader: {
brandingHtml: "Powered by u003ca class="icon-imgur-white" href="https://imgur.com/"u003eu003c/au003e",
contentPolicyHtml: "User contributions licensed under u003ca href="https://creativecommons.org/licenses/by-sa/3.0/"u003ecc by-sa 3.0 with attribution requiredu003c/au003e u003ca href="https://stackoverflow.com/legal/content-policy"u003e(content policy)u003c/au003e",
allowUrls: true
},
onDemand: true,
discardSelector: ".discard-answer"
,immediatelyShowMarkdownHelp:true
});
}
});
Sign up or log in
StackExchange.ready(function () {
StackExchange.helpers.onClickDraftSave('#login-link');
});
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
StackExchange.ready(
function () {
StackExchange.openid.initPostLogin('.new-post-login', 'https%3a%2f%2fstackoverflow.com%2fquestions%2f53448764%2fdoxygen-creates-empty-image-titles-for-docbook-output%23new-answer', 'question_page');
}
);
Post as a guest
Required, but never shown
1 Answer
1
active
oldest
votes
1 Answer
1
active
oldest
votes
active
oldest
votes
active
oldest
votes
In version 1.8.14 the title is written as a caption, in the master version til now the title is written, but on the wrong place. For this I made a proposed pull request for doxygen (https://github.com/doxygen/doxygen/pull/6638).
A workaround is to use:
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
instead of:
image docbook Legend.png "Coloring and Graph Scheme" width=10cm
EDIT: Code of pull request has been integrated in master on github.
answered Nov 23 '18 at 17:40
albertalbert
3,02731125
Thank you, that was quick! I hope Dimitry gets around to the first update this year :-)
– Jens
Nov 23 '18 at 18:05
As far as I know he plans to make a release between Christmas and New Year (this year)
– albert
Nov 23 '18 at 18:12
add a comment |
In version 1.8.14 the title is written as a caption, in the master version til now the title is written, but on the wrong place. For this I made a proposed pull request for doxygen (https://github.com/doxygen/doxygen/pull/6638).
A workaround is to use:
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
instead of:
image docbook Legend.png "Coloring and Graph Scheme" width=10cm
EDIT: Code of pull request has been integrated in master on github.
answered Nov 23 '18 at 17:40
albertalbert
3,02731125
Thank you, that was quick! I hope Dimitry gets around to the first update this year :-)
– Jens
Nov 23 '18 at 18:05
As far as I know he plans to make a release between Christmas and New Year (this year)
– albert
Nov 23 '18 at 18:12
add a comment |
In version 1.8.14 the title is written as a caption, in the master version til now the title is written, but on the wrong place. For this I made a proposed pull request for doxygen (https://github.com/doxygen/doxygen/pull/6638).
A workaround is to use:
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
instead of:
image docbook Legend.png "Coloring and Graph Scheme" width=10cm
EDIT: Code of pull request has been integrated in master on github.
answered Nov 23 '18 at 17:40
albertalbert
3,02731125
In version 1.8.14 the title is written as a caption, in the master version til now the title is written, but on the wrong place. For this I made a proposed pull request for doxygen (https://github.com/doxygen/doxygen/pull/6638).
A workaround is to use:
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
instead of:
image docbook Legend.png "Coloring and Graph Scheme" width=10cm
EDIT: Code of pull request has been integrated in master on github.
answered Nov 23 '18 at 17:40
albertalbert
3,02731125
edited Nov 24 '18 at 19:04
answered Nov 23 '18 at 17:40
albertalbert
3,02731125
answered Nov 23 '18 at 17:40
albertalbert
3,02731125
answered Nov 23 '18 at 17:40
albertalbert
3,02731125
3,02731125
Thank you, that was quick! I hope Dimitry gets around to the first update this year :-)
– Jens
Nov 23 '18 at 18:05
As far as I know he plans to make a release between Christmas and New Year (this year)
– albert
Nov 23 '18 at 18:12
add a comment |
Thank you, that was quick! I hope Dimitry gets around to the first update this year :-)
– Jens
Nov 23 '18 at 18:05
As far as I know he plans to make a release between Christmas and New Year (this year)
– albert
Nov 23 '18 at 18:12
Thank you, that was quick! I hope Dimitry gets around to the first update this year :-)
– Jens
Nov 23 '18 at 18:05
Thank you, that was quick! I hope Dimitry gets around to the first update this year :-)
– Jens
Nov 23 '18 at 18:05
As far as I know he plans to make a release between Christmas and New Year (this year)
– albert
Nov 23 '18 at 18:12
As far as I know he plans to make a release between Christmas and New Year (this year)
– albert
Nov 23 '18 at 18:12
add a comment |
Thanks for contributing an answer to Stack Overflow!
- Please be sure to answer the question. Provide details and share your research!
But avoid …
- Asking for help, clarification, or responding to other answers.
- Making statements based on opinion; back them up with references or personal experience.
To learn more, see our tips on writing great answers.
Sign up or log in
StackExchange.ready(function () {
StackExchange.helpers.onClickDraftSave('#login-link');
});
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
StackExchange.ready(
function () {
StackExchange.openid.initPostLogin('.new-post-login', 'https%3a%2f%2fstackoverflow.com%2fquestions%2f53448764%2fdoxygen-creates-empty-image-titles-for-docbook-output%23new-answer', 'question_page');
}
);
Post as a guest
Required, but never shown
Sign up or log in
StackExchange.ready(function () {
StackExchange.helpers.onClickDraftSave('#login-link');
});
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
Sign up or log in
StackExchange.ready(function () {
StackExchange.helpers.onClickDraftSave('#login-link');
});
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
Sign up or log in
StackExchange.ready(function () {
StackExchange.helpers.onClickDraftSave('#login-link');
});
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Although the docbook handling has been greatly rewritten in the current master version of doxygen, I see here also the same problem. What docbook tag has to be used to get it in the table of content?
– albert
Nov 23 '18 at 15:06
Or better formulated how should the section look like?
– albert
Nov 23 '18 at 15:12
@albert The correct tag to use is
<title>. A caption is a longer explanation about what an image depicts. In scientific journals you often see captions of many lines. Docbook/XSL-FO also puts the title above or below a figure, depending on what you have in the style sheet customization layer.– Jens
Nov 23 '18 at 15:16
In the master version it is on the wrong place as well (inside the mediaobject), I'll have to dive into the problem...
– albert
Nov 23 '18 at 15:37