Do not create the indexTerms.html file when webhelp.show.indexterms.link==no
Posted: Wed Dec 07, 2022 7:35 pm
Currently, WebHelp always creates the indexTerms.html file, even if the webhelp.show.indexterms.link parameter is set to no.
In our situation, we have legacy <indexterm> elements in our content that we do not actively update. We set webhelp.show.indexterms.link==no to avoid publishing them. Unfortunately, the indexTerms.html file was still created and indexed by our corporate web portal's search engine, and so it still shows up in the search results for many customer queries (because it contains so many common terms by definition).
It would be useful if the WebHelp build could suppress the indexTerms.html file completely when webhelp.show.indexterms.link==no, as there is no way to navigate to it once the header link is removed.
We could delete the legacy <indexterm> elements from our content, but even then the indexTerms.html file is created with no entries, and so it would still be nice to suppress this useless file when webhelp.show.indexterms.link==no.
A testcase is included:
To run,
1. Publish the project.xml DITA-OT project file.
In our situation, we have legacy <indexterm> elements in our content that we do not actively update. We set webhelp.show.indexterms.link==no to avoid publishing them. Unfortunately, the indexTerms.html file was still created and indexed by our corporate web portal's search engine, and so it still shows up in the search results for many customer queries (because it contains so many common terms by definition).
It would be useful if the WebHelp build could suppress the indexTerms.html file completely when webhelp.show.indexterms.link==no, as there is no way to navigate to it once the header link is removed.
We could delete the legacy <indexterm> elements from our content, but even then the indexTerms.html file is created with no entries, and so it would still be nice to suppress this useless file when webhelp.show.indexterms.link==no.
A testcase is included:
To run,
1. Publish the project.xml DITA-OT project file.