Page 1 of 1
how to build list of tables and figures and an index
Posted: Thu Sep 30, 2004 11:08 pm
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
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
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"
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: http://www.sagehill.net/docbookxsl/
Posted: Fri Oct 01, 2004 10:48 am
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*
Re: how to build an index
Posted: Thu Jun 12, 2008 8:50 am
I am trying to create an index using the following elemnts as mentioned:
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
The discussion above is about editing Docbook documents in Oxygen.
For DITA the "indexterm" can contain other elements.
See here: http://docs.oasis-open.org/dita/v1.0/la ... xterm.html
in the Contains