Page 1 of 1

how to build list of tables and figures and an index

Posted: Thu Sep 30, 2004 11:08 pm
by fastjack

as I now started to write a rather long document using docbook, I wonder how to get all those neat features that I remember from my old LaTEX days.

Especially the generation of lists such as which figures or tables I used where and with which caption, automatic numbering, correct page number reference in the resulting PDF ...

I checked the oxygenxml users guide and saw that there are such lists. How was it done?

What about an index? Can I tag words and let oxygenxml let to build the index automatically?

Where can I read about these things?

Regards and thanks

Posted: Fri Oct 01, 2004 8:57 am
by fastjack
I can answer my own question here, in part.

To include an index:
Insert <indexterm><primary>The term</primary></indexterm> at any place which you want to refer to in the index.
Then your index will be generated at the place where you insert the <index/> tag.
This seems straightforward and quite easy.

To have figures numbered automatically:
If you use <figure>...</figure> then all will be good. You can also set a <title>my description</title> to give your figure a name, which will then be shown as well. If you give your figure an id="a-name" you can easily refer to it with <xref linkend="a-name"/>.

But: here I have still a problem! I want to have my figures automatically compiled into a list of figures - including the page numbers of their occurrences.

How? A hint?


Posted: Fri Oct 01, 2004 10:39 am
by Dan
For the Oxygen User Guide we are not specifying a special parameter for generating the list of figures. It is done automatically by the Docbook.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
<title>Section1 Title</title>
<title>A figure</title>
<graphic fileref=""/>

Using docbook/xsl/fo/docbook.xsl, it generates the list of figures.

Make sure you are using the latest docbook stylesheets. For a list of docbook XSL parameters, see:

Best regards,

Posted: Fri Oct 01, 2004 10:48 am
by fastjack

Uhm. You are right! I don't know why I did not expect that list at the beginning of the document. And that it gets built automatically... very unintuitive, normally you have to do something to get results :-).

So stupid. I was all time trying to add it to the end of my document and did not see the list at the beginning. I still don't believe it. *lol*

Thank you :)


Re: how to build an index

Posted: Thu Jun 12, 2008 8:50 am
by julie
I am trying to create an index using the following elemnts as mentioned:
<indexterm><primary>The term</primary></indexterm>
But I could not find <primary> in the element list. Please help

Re: how to build list of tables and figures and an index

Posted: Thu Jun 12, 2008 9:07 am
by Radu
Dear Julie,

The discussion above is about editing Docbook documents in Oxygen.
For DITA the "indexterm" can contain other elements.
See here: ... xterm.html in the Contains section.