xml editor

[fastjack]

Hi,

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
Daniel

[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?

D

[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.

Ex:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd">
<book>
<title>Title</title>
<chapter>
<title>Section1 Title</title>
<para>Text</para>
<figure>
<title>A figure</title>
<graphic fileref="http://www.docbook.org/graphics/docbook-org-home.gif"/>
</figure>
</chapter>
</book>


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/

Best regards,
Dan

[fastjack]

Uff.

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

Daniel

[julie]

Hi
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
Regards
Julie

[Radu]

Dear Julie,

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/langspec/indexterm.html in the Contains section.

Regards,
Radu