Index not generating in PDF

[Boreas]

Hello,
I am trying to generate an index for a PDF. I used the <indexterm>word to index</indexterm> element expecting it to make the magic, but although the PDF displays the Index bookmark, the section is not generated, and the Index bookmark is not clickable.
What's missing?

Regards
Carole

[Radu]

Hi Carole,

If you are using Oxygen 15.2 or newer with the DITA Open Toolkit bundled with Oxygen, the index page should be automatically generated when creating the PDF.

If not, you have three choices:

1) Install and use the commercial RenderX XEP to generate the PDF.
2) Merge the changes which were made to resolve the DITA OT issue in your used DITA OT distribution:

https://github.com/dita-ot/dita-ot/issues/1569

3) Download and use the latest DITA OT 2.0.1 to create the PDF.

Regards,
Radu

[Boreas]

Hello,

I am using Oxygen 16. Should work. But does not.

Regards
Carole

[Radu]

Hi Carole,

I'm not sure.
It probably depends on the place where you place the indexterm in the topic.
Could you try to create a small DITA Project (map + topic with index term) on which the issue could be reproduced and send it to us? support@oxygenxml.com

Regards,
Radu

[Boreas]

Hello,

I made a quick test, I generated the PDF with the PDF transformation scenario of OXygen, (out of the box not using my plugin) it works. Index terms are displayed.
This means, that there is something broken in my plugin that does not allow the index terms to be generated....Any idea where I should start looking.

Carole

[Radu]

Hi Carole,

Do you mean you have a PDF customization folder set up?
It probably overwrites some XSLT template which deals with indexterm generation.
In order to give you further hints I would need to see how your customization PDF folder looks like.
If you want you can zip the customization and send us an email support@oxygenxml.com.

Regards,
Radu

[Radu]

Hi Carole,

Thanks for the samples, I will also post the solution here for completion:

First for the solution:

Your PDF plugin contains an older indexer XSLT stylesheet:

com.media5.refpdf\cfg\fo\xsl\index_fop.xsl

which should probably be overwritten completely with the one from:

OXYGEN_INSTALL_DIR/frameworks/dita/DITA-OT/plugins/org.dita.pdf2/xsl/fo/index_fop.xsl

Now for the advice:

Your plugin provides a PDF customization directory. My advice in such cases is not to copy the entire set of XSLT stylesheets from the base PDF plugin to the customization directory. Because if you do so, when you integrate your plugin in a newer DITA OT, your plugin will not benefit of various improvements which have been made in the XSLT stylesheets which come with the base PDF plugin.

The top level XSLT from your customization folder is:

com.media5.refpdf\cfg\fo\xsl\custom.xsl

I usually advice that this custom.xsl should overwrite directly the XSLT templates which need to be changed instead of importing lots of other XSLT stylesheets, some of them having certain changes in certain templates.
So your custom plugin would have only one XSLT stylesheet (the custom.xsl) in which you would copy the content of the templates that you overwrite and change it.

Regards,
Radu